كيفية تثبيت واجهة سطر أوامر Gemini على Ubuntu: دليل خطوة بخطوة شامل

المتطلبات المسبقة

قبل البدء في تثبيت Gemini CLI على Ubuntu، قم بإعداد ما يلي:

• إصدار Ubuntu: 20.04 LTS أو أحدث (22.04 و 24.04 و 26.04 مدعومة بالكامل).
• الوصول الإداري: امتيازات Sudo لإدارة الحزم.
• اتصال بالإنترنت: مطلوب لتنزيل Node.js وحزم npm والمصادقة.
• حساب Google: مطلوب لتسجيل الدخول عبر OAuth للوصول إلى نماذج Gemini.
• الأجهزة الموصى بها: على الأقل 4 جيجابايت من ذاكرة الوصول العشوائي واثنين من نواة المعالج لضمان أداء سلس أثناء الجلسات التفاعلية.

المعرفة الأساسية المفترضة: تعرف كيفية فتح طرفية وتشغيل أوامر apt و bash الأساسية.

الخطوة 1: تحديث حزم النظام

ابدأ بتحديث قائمة الحزم الخاصة بك وترقية الحزم الموجودة لمنع تعارضات التبعيات:

sudo apt update && sudo apt upgrade -y

تضمن هذه الخطوة حصولك على أحدث تحديثات الأمان ومعلومات المستودع.

الخطوة 2: تثبيت Node.js الإصدار 20 أو أحدث

يتطلب Gemini CLI Node.js الإصدار 20 أو أحدث. غالبًا ما تتضمن مستودعات Ubuntu الافتراضية إصدارات أقدم (مثل Node 18 على Ubuntu 24.04).

الطريقة الموصى بها: مستودع NodeSource

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

بديل: استخدام nvm (مدير إصدارات Node)

لتسهيل إدارة الإصدارات:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20

تحقق من التثبيت:

node --version
npm --version

يجب أن ترى ناتجًا مشابهًا لـ v20.x.x لـ Node.js وإصدار npm مطابق.

الخطوة 3: تثبيت Gemini CLI

التثبيت العام (موصى به للاستخدام اليومي)

npm install -g @google/gemini-cli

هذا يجعل أمر gemini متاحًا على مستوى النظام.

اختبار سريع بدون تثبيت دائم

إذا كنت تريد تجربته أولاً:

npx @google/gemini-cli

التثبيت على مستوى المستخدم (لتجنب مشكلات الصلاحيات)

إذا واجهت أخطاء صلاحيات مع التثبيت العام:

mkdir -p ~/.local/bin
npm config set prefix '~/.local'
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @google/gemini-cli

الخطوة 4: التحقق من التثبيت

تحقق من تثبيت Gemini CLI بشكل صحيح:

gemini --version

من المتوقع أن يُظهر الناتج الإصدار الحالي لـ Gemini CLI.

الخطوة 5: التشغيل والمصادقة

شغّل CLI للمرة الأولى:

gemini

ستطلب الأداة منك تسجيل الدخول باستخدام حساب Google. ستفتح نافذة متصفح تلقائيًا. أكمل عملية OAuth وعُد إلى الطرفية.

بعد المصادقة الناجحة، يتم تحميل واجهة Gemini CLI التفاعلية. استخدم /help لرؤية الأوامر المتاحة.

الممارسة الأفضل: انتقل إلى دليل مشروعك قبل التشغيل:

cd ~/my-project
gemini

المشاكل الشائعة واستكشاف الأخطاء وإصلاحها

• 'gemini: command not found': أعد تشغيل الطرفية أو نفذ source ~/.bashrc. تحقق من متغير PATH الخاص بك باستخدام echo $PATH.

• Permission denied during npm install: استخدم طريقة التثبيت على مستوى المستخدم المذكورة أعلاه بدلاً من sudo npm.

• Node.js version error: أعد تشغيل إعداد NodeSource أو بدّل الإصدارات باستخدام nvm. تأكد باستخدام node --version.

• Authentication fails: عطّل مانعات الإطارات المنبثقة في المتصفح، تأكد من تمكين الكوكيز، وحاول مرة أخرى. امسح ذاكرة التخزين المؤقت لـ npm إذا لزم الأمر: npm cache clean --force.

• Network timeout or download errors (مثل: ripgrep prebuilt): تأكد من اتصال إنترنت مستقر. أعد محاولة التثبيت أو استخدم npx كحل مؤقت.

• Missing build tools: قم بتثبيت تبعيات التطوير:

sudo apt install -y build-essential python3

• WSL-specific issues: نفذ الأوامر في طرفية Ubuntu عادية بدلاً من WSL إذا حدثت أخطاء في التجميع.

لمزيد من المساعدة، راجع مستودع GitHub الرسمي: https://github.com/google-gemini/gemini-cli.

الخطوات التالية

• استكشف الأوامر الأساسية: اكتب /help، أو /model، أو /settings داخل واجهة سطر الأوامر.
• الاستخدام في المشاريع: اطلب من Gemini شرح الكود، إعادة هيكلة الوظائف، أو إنشاء ملفات جديدة باستخدام أوامر اللغة الطبيعية.
• التخصيص: حرّر ملفات الإعداد في ~/.config/gemini-cli/ للسمات، النماذج الافتراضية، والإضافات.
• التحديث المنتظم: نفذ npm update -g @google/gemini-cli للحصول على أحدث التحسينات.
• دمج الأدوات: جرّب الإضافات المدمجة وخوادم MCP لسير العمل المتقدمة المستندة إلى الوكلاء مثل دمج git.

أنت الآن جاهز لاستخدام Gemini CLI كمساعد قوي للبرمجة بالذكاء الاصطناعي مباشرةً في طرفية Ubuntu الخاصة بك. ابدأ بطلبات بسيطة في مجلد المشروع وابني تدريجياً مهام وكيل أكثر تعقيداً.

برمجة سعيدة مع Gemini!