Pi + بوابة JoinGonka — وكيل طرفية على استدلال رخيص

Pi هو وكيل برمجي (coding-agent) طرفي بسيط، وأحد أسرع المشاريع مفتوحة المصدر نموًا في عام 2026. يتم وصف المزودين فيه بشكل تصريحي في ~/.pi/agent/models.json، وأي نقطة نهاية تدعم OpenAI Completions أو Anthropic Messages ستعمل — مما يعني أن JoinGonka Gateway يتصل بكلتا الطريقتين. نماذج شبكة Gonka اللامركزية أرخص بمئات المرات من أسعار البائعين، و3M توكن الأولية مجانية.

يتم تثبيت Pi من خلال npm: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. اسم الحزمة جديد: انتقل المشروع إلى المستودع earendil-works/pi، وأصبحت الحزمة السابقة @mariozechner/pi-coding-agent قديمة ولم تعد تتلقى تحديثات. إذا كان Pi مثبتاً لديك بالاسم القديم، أعد تثبيته؛ يبقى دليل الإعدادات ~/.pi/agent كما هو عند الانتقال.

الطريق السريع: المثبت

أقصر طريقة هي استخدام مثبتنا:

npx @joingonka/setup --tool pi

سيقوم بكتابة المزود مع نماذج الشبكة الحالية في ~/.pi/agent/models.json، وتعيين النموذج الافتراضي في ~/.pi/agent/settings.json (لا يعترض النموذج الذي اخترته بنفسك — فقط علم --model minimax|deepseek|glm الصريح هو الذي يغيره) والتحقق عبر طلب مباشر من قبول البوابة للمفتاح والنموذج. إذا تم نقل دليل الإعدادات عبر المتغير PI_CODING_AGENT_DIR، فسيقوم المثبت بالكتابة فيه. يتم وضع المفتاح كحرفي (literal) في ملف التكوين بصلاحيات 0600 — لا حاجة لتصدير متغير بيئة.

الإعداد اليدوي: المزود في models.json

احصل على مفتاح jg-… عند التسجيل وأضف المزوّد إلى ~/.pi/agent/models.json:

`baseUrl`	`https://gate.joingonka.ai/v1`
`api`	`openai-completions`
`apiKey`	مفتاحك `jg-…` كتابةً حرفية. يفهم Pi أيضاً المراجع `$VAR`/`${VAR}` و`!command`، لكن الكتابة الحرفية تعمل دون متغيّر مُصدَّر — فأبقِ الملف بأذونات `0600`
`models`	مصفوفة: `id`، `name`، `contextWindow`، `maxTokens`

القيم الصحيحة لطرازات الشبكة: deepseek-ai/DeepSeek-V4-Flash-0731 — contextWindow 380000، maxTokens 32768؛ MiniMaxAI/MiniMax-M2.7 — contextWindow 200000، maxTokens 8192؛ zai-org/GLM-5.3-Flash — contextWindow 390000، maxTokens 8192. القيم الافتراضية في Pi (128000/16384) لا تطابق الحدود الفعلية للشبكة، لذا حدّد الحقلين صراحةً. الطراز الافتراضي يقيم في ملف آخَر — ~/.pi/agent/settings.json، في الحقلين defaultProvider وdefaultModel. للتحقق: يجب أن يُظهر pi --list-models الطرازات المضافة.

طريق Anthropic كبديل

توفر البوابة أيضاً Anthropic Messages: مزود بـ api: "anthropic-messages" و baseUrl: "https://gate.joingonka.ai" — بدون المسار /v1/messages، سيقوم العميل بإضافته بنفسه. للعمل اليومي يكفي طريق OpenAI؛ خيار Anthropic مفيد إذا كانت ملحقات Pi الخاصة بك مخصصة لتنسيق Messages.

ملاحظة حول الأمان

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

أي نموذج تختار وما التكلفة

تدعم جميع نماذج الشبكة الثلاثة استدعاء الأدوات (tool calling) والبث (streaming). للجلسات الطويلة والمستودعات الكبيرة — DeepSeek V4 Flash (واحد من أطول سياقات الشبكة ومخرج يصل إلى 32768). MiniMax M2.7 هو الخيار الشامل، و GLM-5.3 Flash هو نموذج استنتاجي (reasoning) بأطول سياق في الشبكة (390K): فهو يقوم بالاستنتاج قبل الرد، لذا لا تقم بخفض maxTokens الخاص به. السعر موحد، والأسعار الحية موجودة في قائمة أسعار البوابة.

إذا لم تكن بساطة Pi كافية، ألقِ نظرة على نسختها المعدلة omp (Oh My Pi): نفس فكرة الموفرين التقريريين (declarative providers)، ولكن مع أدوار النماذج، وخوادم اللغات، والوكلاء الفرعيين. ملفات التكوين الخاصة بهم مختلفة، لذا يتم إعداد omp بشكل منفصل.

يتصل Pi بـ JoinGonka Gateway بإدخال واحد في ~/.pi/agent/models.json: baseUrl gate.joingonka.ai/v1، api openai-completions، مفتاح literal، نماذج مع contextWindow/maxTokens دقيقة. والأسرع هو npx @joingonka/setup --tool pi. قم بتشغيل الوكيل في بيئة معزولة وابدأ بالرموز المجانية الأولية.

← Zed + JoinGonka Gateway — استدلال رخيص داخل المحرر Codex CLI: مفتاحك الخاص بدلاً من الاشتراك →

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

احصل على توكنات مجانية →