Pi هو وكيل برمجة بسيط وقابل للتوسع.
إعداد سريع
bash
ollama launch piيقوم هذا بتثبيت Pi إذا لزم الأمر، وتكوين Ollama كموفر خدمات يشمل أدوات الويب، وبدء جلسة تفاعلية لك.
للتكوين دون بدء التشغيل:
shell
ollama launch pi --configالتشغيل مباشرة مع نموذج
shell
ollama launch pi --model qwen3.5:cloudالنماذج السحابية متوفرة أيضًا على ollama.com.
الإضافات
يأتي Pi مزودًا بأربع أدوات أساسية: read و write و edit و bash. تتم إضافة جميع القدرات الأخرى من خلال نظام الإضافات الخاص به.
حزم قدرات عند الطلب يتم استدعاؤها عبر أوامر /skill:name.
التثبيت من npm أو git:
bash
pi install npm:@foo/some-tools
pi install git:github.com/user/repo@v1اطلع على جميع الحزم على pi.dev
بحث الويب
يمكن لـ Pi استخدام أدوات بحث الويب وجلب المحتوى عبر الحزمة @ollama/pi-web-search.
عند تشغيل Pi عبر Ollama، يتم إدارة تثبيت/تحديث الحزم تلقائيًا. للتثبيت يدويًا:
bash
pi install npm:@ollama/pi-web-searchالبحث التلقائي باستخدام pi-autoresearch
يضيف pi-autoresearch حلقات تجارب مستقلة إلى Pi. مستوحى من البحث التلقائي لـ Karpathy، فإنه يحول أي مقياس قابل للقياس إلى هدف تحسين: سرعة الاختبار، حجم الحزمة، وقت البناء، خسارة تدريب النموذج، درجات Lighthouse.
bash
pi install https://github.com/davebcn87/pi-autoresearchأخبر Pi بما تريد تحسينه. فهو يجري التجارب، ويقيم أداء كل منها معياريًا، ويحتفظ بالتحسينات، ويتراجع عن التدهورات، ويكرر العملية — كل ذلك بشكل مستقل. تتبع لوحة تحكم مدمجة كل تشغيل مع تصنيف ثقة للتمييز بين المكاسب الحقيقية وضجيج المعايير.
bash
/autoresearch optimize unit test runtimeيتم حفظ كل تجربة محفوظة تلقائيًا كالتزام. يتم التراجع عن كل تجربة فاشلة. عند الانتهاء، يمكن لـ Pi تجميع التحسينات في فروع مستقلة لمراجعة ودمج نظيفة.
الإعداد اليدوي
التثبيت
ثبت Pi:
bash
npm install -g @earendil-works/pi-coding-agentأضف كتلة تكوين إلى الملف ~/.pi/agent/models.json:
json
{
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"apiKey": "ollama",
"models": [
{
"id": "qwen3-coder"
}
]
}
}
}حدث الملف ~/.pi/agent/settings.json لتعيين الموفر الافتراضي:
json
{
"defaultProvider": "ollama",
"defaultModel": "qwen3-coder"
}