تثبيت Pi وتهيئة OmniProxy

Pi هو مساعد سطر أوامر صغير—برنامج يتحدث معك مباشرة في سطر الأوامر، ويقرأ الملفات، ويكمل المهام. لديه مطالبة نظام قصيرة وعدد قليل فقط من الأدوات افتراضياً. إذا كنت بحاجة إلى أوامر أو سير عمل أو واجهات أخرى، يمكنك إضافتها لاحقاً من خلال الإضافات. الإضافات هي مكونات تضيف قدرات إلى Pi، ويمكنك مشاركتها مع الآخرين بعد إنشائها.

يفوض الوكلاء الفرعيون جزءاً من مهمة إلى مساعد آخر، بينما ينظم وضع الخطة الخطوات قبل بدء التنفيذ. لا يتم تضمين أي من الميزتين افتراضياً، ولكن يمكنك أن تطلب من Pi بناءهما أو تثبيت حزم يشاركها الآخرون.

قبل البدء

يستخدم macOS وLinux نص تثبيت برمجي—أمر واحد يقوم تلقائياً بتنزيل وتثبيت Pi. على Windows، استخدم أمر PowerShell المقدم على الصفحة الرئيسية لـ Pi. PowerShell هي بيئة سطر الأوامر المضمنة في Windows. يمكنك أيضاً تثبيت Pi في WSL، بيئة Linux المتاحة داخل Windows.

إذا اخترت التثبيت باستخدام npm، فأنت بحاجة إلى Node.js 22.19 أو أحدث. npm هو مدير الحزم المستخدم مع Node.js ويمكنه تثبيت Pi من سطر الأوامر.

macOS Linux

install.sh

• curl النص البرمجي الرسمي
• يقوم المثبت بتثبيت التبعيات
• قم بالتحديث باستخدام pi update

Windows

install.ps1

• أمر PowerShell الرسمي
• يوفر Git for Windows بيئة Bash
• يمكنك أيضاً استخدام WSL

Node مثبت بالفعل

npm

• يتطلب Node 22.19+
• اسم الحزمة هو pi-coding-agent
• أضف --ignore-scripts

التثبيت والتشغيل لأول مرة

على macOS أو Linux، افتح سطر أوامر وقم بتشغيل:

curl -fsSL https://pi.dev/install.sh | sh

على Windows، افتح PowerShell وقم بتشغيل:

powershell -c "irm https://pi.dev/install.ps1 | iex"

إذا كان Node.js 22.19 أو أحدث مثبتاً بالفعل، يمكنك أيضاً استخدام الأمر البديل من التشغيل السريع:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

قد يتوقف نص التثبيت البرمجي لطرح أسئلة في سطر أوامر تفاعلي. اتبع المطالبات التي تظهر على الشاشة للمتابعة. إذا كان لديك بالفعل إصدار متوافق من Node، فلن يطرح أمر npm هذا أسئلة. لتثبيت Pi في دليل آخر، أضف --prefix /your/directory. في 2026-10-09، قام هذا بتثبيت Pi 1.1.0.

لا يتطلب تثبيت npm العادي نصوصاً برمجية لدورة حياة التبعية، وهي نصوص برمجية تقوم الحزم بتشغيلها تلقائياً أثناء التثبيت. يقوم نص التثبيت البرمجي بتثبيت التبعيات؛ بعد ذلك، قم بتحديث Pi باستخدام pi update. بالنسبة لتثبيت npm، استخدم طريقة التحديث التي يوفرها مدير الحزم الخاص بك. يجب على مستخدمي Nix التثبيت من flake الخاص بـ Pi. الـ flake هو تكوين Nix يصف البرنامج وتبعياته، ولا يمكن لـ pi update تحديث تثبيت Nix.

بعد التثبيت، تأكد أولاً من أن سطر الأوامر الخاص بك يمكنه العثور على Pi:

pi --version

على Windows، إذا كنت تريد أن تقوم النماذج بتنفيذ أوامر Bash، يوصى بتثبيت Git for Windows لمعظم المستخدمين المحليين. Bash هي بيئة الأوامر التي يستخدمها Pi لتشغيل بعض الأوامر. يتحقق Pi من إعداد shellPath في ~/.pi/agent/settings.json، وGit Bash تحت Program Files، ثم bash.exe على PATH، بهذا الترتيب. يحدد shellPath موقع Bash، بينما PATH هي قائمة الدلائل التي يبحث فيها النظام عن الأوامر.

بعد بدء Pi، يمكنك إدخال !printf 'Bash is working\n' للتحقق منه. إذا كانت ملفاتك وأدواتك موجودة بالفعل في WSL، فقم بتثبيت Pi في بيئة Linux تلك باتباع التشغيل السريع.

بعد ذلك، أدخل المجلد الذي تريد أن يقوم Pi بفحصه أو العمل عليه، ثم ابدأ تشغيله:

cd /path/to/folder
pi

يصبح هذا المجلد نطاق العمل الحالي لـ Pi. يستخدمه Pi لاكتشاف الملفات والتكوين وتجميع الجلسات.

الحصول على قيم الاتصال من OmniProxy

أولاً، احصل على هذه القيم الثلاث من OmniProxy:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy the full ID from the current OmniProxy model list

baseUrl هو نقطة نهاية API التي يرسل إليها Pi الطلبات، ويجب أن تتضمن /v1. apiKey هو المفتاح المستخدم للوصول إلى API. Model ID هو اسم النموذج المراد استدعاؤه ويجب نسخه بالكامل من قائمة نماذج OmniProxy الحالية.

اضبط api على openai-completions، كما هو موضح في مثال API المتوافق. يخبر هذا الحقل Pi بتنسيق API الذي يجب استخدامه عند إرسال الطلبات.

انسخ معرف النموذج بالكامل، بما في ذلك أي شرطات مائلة في الاسم. في 2026-10-09، كان معرفا المرجع في وثائق المزود هما gemini-3.8-flash وgrok-4.7. لا تنسخ اسماً غير موجود في القائمة.

إدخال تكوين الأداة

يتم تخزين تكوين النموذج المخصص على مستوى المستخدم لـ Pi في models.json. يقع هذا الملف في دليل الوكيل، والذي يكون افتراضياً ~/.pi/agent، لذا فإن مساره الكامل هو ~/.pi/agent/models.json. إذا تم تعيين متغير البيئة PI_CODING_AGENT_DIR، يستخدم Pi الدليل المحدد بواسطة ذلك المتغير بدلاً من ذلك. متغير البيئة هو قيمة تكوين يوفرها النظام للبرامج لقراءتها.

أدخل التكوين كما هو موضح في مثال API المتوافق:

{
  "providers": {
    "omniproxy": {
      "baseUrl": "https://your-omniproxy-origin.example/v1",
      "api": "openai-completions",
      "apiKey": "<YOUR_OMNIPROXY_API_KEY>",
      "models": [
        { "id": "gemini-3.8-flash", "input": ["text"] },
        { "id": "grok-4.7", "input": ["text"] }
      ]
    }
  }
}

يسرد providers الخدمات المتصلة، بينما يسرد models النماذج التي يمكن تحديدها. يجب أن يطابق id لكل نموذج معرف النموذج الكامل في قائمة نماذج OmniProxy الحالية. يشير input إلى أن النموذج مهيأ هنا لإدخال النص.

يمكن إدخال apiKey كقيمة حرفية، أو كـ $NAME أو ${NAME} ليقرأها Pi من متغير بيئة. يتم التعامل مع القيمة التي تبدأ بـ ! كأمر ويتم تنفيذها لكل طلب. لا تقم برفع مفتاح حقيقي إلى مستودع. إذا لم تقم البوابة بالتحقق من المفاتيح، يمكنك إدخال سلسلة نصية نائبة تُستخدم فقط على جهازك المحلي. في 2026-10-09، قرأ Pi الملف بنجاح بهذا التكوين.

يؤدي فتح /model إلى إعادة تحميل هذا الملف. /model هي الواجهة في Pi لعرض النماذج وتحديدها. لا تظهر النماذج المخصصة في /model حتى يتمكن Pi من حل بيانات اعتمادها. بعد تحديد نموذج، اضغط على Ctrl+S لحفظه كنموذج افتراضي للجلسات الجديدة.

ملف

models.json

• الدليل الافتراضي: ~/.pi/agent
• أضف إدخالاً تحت providers
• اضبط api على completions

العنوان

baseUrl

• تضمين /v1
• يمكن لـ apiKey الإشارة إلى متغير
• يجب أن يكون معرف النموذج دقيقاً

تحديد

/model

• فتحه يعيد تحميل الملف
• حدد النموذج الذي أضفته للتو
• Ctrl+S يحفظه كافتراضي

التحقق من مهمة حقيقية

بعد إكمال التكوين، يمكنك إجراء فحص غير تفاعلي في دليل يحتوي على ملفات. يعني الوضع غير التفاعلي أن Pi يكمل هذه المهمة الواحدة ثم يخرج بدلاً من الدخول في محادثة مستمرة. استبدل القيمة بعد --model بالمعرف الكامل من قائمة OmniProxy الحالية:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Read the first line of the file you specify. Do not modify the file."

هنا، يُمكّن --tools read أداة القراءة فقط، كما تُعلم المهمة Pi صراحةً بعدم تعديل الملف. في 2026-10-09، قرأ Pi 1.1.0 محتويات الملف بنجاح. استغرقت الاستجابة الأولى حوالي دقيقتين.

يمكنك أيضاً استخدام الوضع التفاعلي: أدخل الدليل، وقم بتشغيل pi، ثم حدد نموذجاً باستخدام /model. تطلب إحدى مهام المثال في التشغيل السريع من Pi شرح كيفية تنظيم المستودع وكيفية تشغيل فحوصاته. لاحظ ما إذا كان يقرأ الملفات ويقدم شرحاً، ثم تحقق من المصدر ومعرف النموذج في سجلات طلبات OmniProxy.

التشغيل

يتم تشغيل pi

• cd أولاً إلى المجلد
• pi --version ينتج مخرجات
• يظهر اسم النموذج في أسفل الواجهة

المهمة

قرأ الدليل

• اسأل عن كيفية تنظيم المستودع
• راجع الملفات التي يسردها
• لا تعتمد فقط على حفظ تكوين ناجح

السجلات

مرئية في البوابة

• المصدر هو Pi
• معرف النموذج يطابق
• احتفظ بالمفتاح على الجهاز المحلي

الأخطاء الشائعة

• لا يمكن العثور على pi: أعد فتح سطر الأوامر وجرب pi --version مرة أخرى. بالنسبة لتثبيت npm، تأكد من أن دليل bin العام موجود على PATH.
• لا تظهر النماذج المخصصة في /model: تأكد من وجود models.json في ~/.pi/agent/، وتحقق من إمكانية حل apiKey، ثم أعد فتح /model.
• يبلغ Windows عن عدم إمكانية العثور على Bash: قم بتثبيت Git for Windows، أو اضبط shellPath في ~/.pi/agent/settings.json. يجب كتابة الشرطات المائلة العكسية في JSON مرتين.
• تم رفض الطلب: تحقق من أن api هو openai-completions وأن baseUrl ينتهي بـ /v1. لا تقم بتمكين خيارات التوافق الإضافية لمجرد أن الخدمة تصف نفسها بأنها متوافقة.
• معرف النموذج غير صالح: انسخه مرة أخرى من قائمة OmniProxy الحالية.

المراجع الرسمية

لأوامر التثبيت، راجع موقع Pi والتشغيل السريع. لملف النموذج، راجع اختيار نموذج والتكوين. لبيئة أوامر Windows، راجع تشغيل Pi على Windows. لمعرفات النماذج المستخدمة في الأمثلة، راجع قائمة نماذج Gemini وصفحة نماذج xAI.

استبدل كل عنصر نائب بقيم من تكوين OmniProxy الخاص بك. لا تنشر أبدًا مفتاحًا حقيقيًا.

نتيجة محفوظة أو HTTP 200 وحدها لا تثبت توافق الوكيل الكامل. تحقق من المصدر والنموذج في سجل طلبات OmniProxy.

المصادر الرسمية · Pi ↗