Pi ایجنٹ کی تنصیب، تشکیل اور پہلی گفتگو کا سبق

Pi انسٹال کرنا مشکل نہیں، صرف ایک کمانڈ کا کام ہے۔ پہلے صرف یہ طے کرنا ہوتا ہے کہ تصدیق کا کون سا طریقہ استعمال کرنا ہے: موجودہ سبسکرپشن یا API Key۔ ذیل میں تنصیب، تصدیق اور پہلی گفتگو کا مکمل طریقہ دیا گیا ہے۔

بنیادی تصور: تصدیق کے دو طریقے

Pi انسٹال ہونے کے بعد کام کرنے کے لیے اسے کسی LLM سروس فراہم کنندہ کی اسناد درکار ہوتی ہیں۔ تصدیق کے دو راستے ہیں، اور اس مضمون میں سمجھنے والی واحد اہم بات یہی ہے:

• سبسکرپشن لاگ اِن (/login)｜API Key

• کیا استعمال کریں｜Claude Pro/Max، ChatGPT Plus/Pro وغیرہ کی سبسکرپشن｜سروس فراہم کنندہ کی جانب سے جاری کردہ API Key

• بلنگ｜پیچیدہ (سبسکرپشن کی حد + ممکنہ اضافی استعمال)｜token کے حساب سے، جتنا استعمال اتنا خرچ

• اسناد کہاں محفوظ ہوں｜~/.pi/agent/auth.json (OAuth token، خودکار تازہ کاری)｜ماحولیاتی متغیر یا auth.json

• کس کے لیے موزوں｜جن کے پاس پہلے سے سبسکرپشن ہو اور جو الگ سے Key کا انتظام نہیں کرنا چاہتے｜جو اخراجات پر درست کنٹرول چاہتے ہوں

ایک بات یاد رکھیں: Anthropic کی سبسکرپشن لاگ اِن (Claude Pro/Max) تھرڈ پارٹی harness چینل کے ذریعے ہوتی ہے اور token کے حساب سے بل بنتا ہے؛ یہ سبسکرپشن پیکیج کی حد استعمال نہیں کرتی۔ Pi کی جانب سے انتباہ دکھائی دینا معمول کی بات ہے۔ مکمل کنٹرول اور اخراجات کی بروقت نگرانی کے لیے API Key زیادہ آسان ہے۔

عملی مرحلے

1. Pi انسٹال کریں

Pi Node.js پر چلتا ہے اور 22.19.0 یا اس سے جدید ورژن درکار ہے۔ پہلے node --version سے تصدیق کریں۔ تنصیب کے لیے ان میں سے کوئی ایک طریقہ اختیار کریں:

# npm سے عالمی تنصیب (--ignore-scripts انحصاری اسکرپٹس کو چھوڑتا ہے، زیادہ محفوظ)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# یا curl انسٹالر استعمال کریں (Node انسٹال نہ ہو تو یہ خود انسٹال کر دے گا)
curl -fsSL https://pi.dev/install.sh | sh

تنصیب کے بعد pi --version سے تصدیق کریں۔ دونوں طریقوں سے حذف کرنے کے لیے npm uninstall -g @earendil-works/pi-coding-agent استعمال کریں۔

2. تصدیق تشکیل دیں

طریقہ اول: API Key (تجویز کردہ)، Key کو ماحولیاتی متغیر کے طور پر مقرر کریں:

export ANTHROPIC_API_KEY=sk-ant-...
pi

یا Pi میں /login چلا کر API Key provider منتخب کریں اور Key کو ~/.pi/agent/auth.json میں محفوظ کریں (0600 اجازت، صرف آپ اسے پڑھ یا لکھ سکتے ہیں)۔ عام سروس فراہم کنندگان کے ماحولیاتی متغیر:

• سروس فراہم کنندہ｜ماحولیاتی متغیر

• Anthropic｜ANTHROPIC_API_KEY

• OpenAI｜OPENAI_API_KEY

• DeepSeek｜DEEPSEEK_API_KEY

• Google Gemini｜GEMINI_API_KEY

• Groq｜GROQ_API_KEY

• xAI｜XAI_API_KEY

• OpenRouter｜OPENROUTER_API_KEY

مکمل فہرست، جس میں درجنوں فراہم کنندگان شامل ہیں، سرکاری Providers دستاویز[1] میں دیکھیں۔

طریقہ دوم: سبسکرپشن لاگ اِن، اگر آپ کے پاس Claude Pro یا ChatGPT Plus جیسی سبسکرپشن ہے تو Pi میں /login چلا کر متعلقہ provider منتخب کریں اور OAuth کا عمل مکمل کریں۔ token کی میعاد ختم ہونے پر Pi اسے خودکار طور پر تازہ کر دے گا۔ دستیاب اختیارات: Claude Pro/Max، ChatGPT Plus/Pro(Codex)، GitHub Copilot، xAI، OpenRouter۔ لاگ آؤٹ کے لیے /logout استعمال کریں۔

Pi کی کمیونٹی بہت فعال ہے، اور Pi Agent کے تازہ ترین ورژن میں Qwen کے token plan کی بھی معاونت شامل ہے۔

ماڈل تشکیل دینے کے بعد /model استعمال کر کے مطلوبہ ماڈل منتخب کیا جا سکتا ہے۔

Pi Agent میں scoped models کا تصور بھی موجود ہے۔

scoped models کا مقصد یہ ہے کہ صارف ctrl + p کے ذریعے چند ماڈلز کے درمیان تیزی سے تبدیل ہو سکے۔ آپ ctrl + l بھی استعمال کر سکتے ہیں۔ متعلقہ تشکیل ~/.pi/agent/settings.json فائل کے enabledModels فیلڈ میں موجود ہے۔

3. پہلی بار شروع کریں

پروجیکٹ ڈائریکٹری میں جا کر شروع کریں:

cd /path/to/your/project
pi

پہلی بار کسی ایسے پروجیکٹ میں داخل ہونے پر جس میں .pi/ تشکیل موجود ہو، Pi پوچھے گا کہ آیا آپ اس پر اعتماد کرتے ہیں۔ پروجیکٹ کی سطح کے وسائل میں ایسا توسیعی کوڈ شامل ہو سکتا ہے جو من مانی کمانڈز چلا سکے، اس لیے Pi آپ کی لاعلمی میں انہیں لوڈ نہیں کرتا۔ اعتماد کا فیصلہ ~/.pi/agent/trust.json میں محفوظ ہو جاتا ہے اور اگلی بار دوبارہ نہیں پوچھا جاتا۔

انٹرفیس اوپر سے نیچے تک چار حصوں پر مشتمل ہے: Header (شارٹ کٹس/لوڈ شدہ وسائل)، Messages، Editor (جہاں آپ ٹائپ کرتے ہیں، بارڈر کا رنگ سوچنے کی سطح ظاہر کرتا ہے)، Footer (ڈائریکٹری/سیشن/token کا استعمال/اخراجات/موجودہ ماڈل)۔ براہِ راست ٹائپ کر کے Enter دبائیں، مثلاً:

اس ریپوزٹری کی ساخت دیکھ کر بتائیں کہ اس کی جانچ کیسے چلائی جاتی ہے۔

Pi بطور ڈیفالٹ ماڈل کو چار ٹولز دیتا ہے: read، write، edit، bash۔ دیگر تین صرف پڑھنے والے ٹولز grep/find/ls بطور ڈیفالٹ بند ہوتے ہیں۔ ضرورت کے وقت --tools سے فعال کریں، مثلاً Pi سے صرف پڑھنے کی اجازت کے ساتھ کوڈ ریویو کرانے کے لیے:

pi --tools read,grep,find,ls -p "اس ریپوزٹری کے کوڈ کے معیار کا جائزہ لیں"

ماڈل تبدیل کرنے کے لیے Ctrl+L یا /model دبائیں؛ باہر نکلنے کے لیے Ctrl+C دو بار یا /quit استعمال کریں؛ پچھلی گفتگو جاری رکھنے کے لیے pi -c چلائیں۔

اصول سمجھیں

تصدیق کی ترجیحی ترتیب: اگر ماحولیاتی متغیر، auth.json اور کمانڈ لائن پیرامیٹر ایک ساتھ تشکیل دیے گئے ہوں تو Pi کمانڈ لائن --api-key > auth.json > ماحولیاتی متغیر > models.json کی ترتیب سے استعمال کرتا ہے۔ عارضی طور پر Key تبدیل کر کے جانچنے کے لیے براہِ راست pi --api-key xxx چلائیں، تشکیل فائل تبدیل نہیں ہوگی۔

پروجیکٹ کا اعتماد input guard ہے، sandbox نہیں: یہ صرف انٹرایکٹو آغاز کے وقت ڈائیلاگ دکھاتا ہے۔ غیر انٹرایکٹو موڈ (pi -p) میں بطور ڈیفالٹ ask استعمال ہوتا ہے، جسے -a/-na سے تبدیل کیا جا سکتا ہے۔ Pi میں بطور ڈیفالٹ sandbox نہیں ہوتا؛ bash تک رسائی ملنے پر ماڈل کوئی بھی کمانڈ چلا سکتا ہے۔ غیر معتبر ریپوزٹری سے نمٹنے کے لیے container isolation درکار ہے، جس کی تفصیل آئندہ سکیورٹی مضمون میں آئے گی۔

عام مسائل

سوال:pi --version پر command not found آتا ہے، لیکن npm کہتا ہے کہ تنصیب مکمل ہو گئی ہے۔
زیادہ امکان ہے کہ npm کی عالمی bin ڈائریکٹری PATH میں شامل نہیں۔npm prefix -g سے راستہ دیکھ کر PATH میں شامل کریں۔ nvm صارفین nvm use چلانا یاد رکھیں۔

سوال: شروع کرتے وقت Node ورژن بہت پرانا بتایا جاتا ہے۔
Pi کو Node 22.19.0+ درکار ہے۔ ورژن مینیجر (fnm/mise/nvm) سے اپ گریڈ کریں یا curl انسٹالر سے انسٹال کروائیں۔

سوال: Claude Pro میں لاگ اِن کرنے کے بعد ہر بار اضافی استعمال کا انتباہ دکھائی دیتا ہے۔
Anthropic کی سبسکرپشن تھرڈ پارٹی چینل کے ذریعے token کے حساب سے بل ہوتی ہے۔ اسے بند کرنے کے لیے ~/.pi/agent/settings.json میں یہ شامل کریں:

{ "warnings": { "anthropicExtraUsage":false } }

سوال: Shift+Enter سے نئی سطر نہیں بنتی۔
Pi modifier keys کی شناخت کے لیے Kitty keyboard protocol استعمال کرتا ہے۔ iTerm2، Kitty اور Ghostty میں اضافی تشکیل کی ضرورت نہیں؛ VS Code 1.109.5+ بھی بطور ڈیفالٹ معاونت کرتا ہے۔ Windows Terminal، WezTerm اور Alacritty میں keys کو forward کرنے کے لیے ایک تشکیل لائن دستی طور پر شامل کرنا ہوگی۔ ٹرمینل کی تشکیل کی دستاویز[2] دیکھیں۔

سوال: مکمل طور پر آف لائن رہنا ہے اور pi.dev سے اپ ڈیٹس کی جانچ نہیں کرانی۔
PI_OFFLINE=1 آغاز کے وقت نیٹ ورک کی تمام کارروائیاں بند کر دیتا ہے۔ صرف ورژن کی جانچ بند کرنی ہو تو PI_SKIP_VERSION_CHECK=1 استعمال کریں۔

حوالہ جاتی مواد

• • Pi فوری آغاز کی دستاویز[3]

• • Pi Providers دستاویز[1] - تمام Provider، ماحولیاتی متغیرات اور cloud provider کی تشکیل

• • Pi Custom Models دستاویز[4] - models.json کے ذریعے حسب ضرورت Provider

• • Pi Settings دستاویز[5]

• • Pi Terminal Setup[2] - مختلف ٹرمینلز کے key configurations

• • Pi GitHub ریپوزٹری[6]

حوالہ جاتی لنکس

[1] سرکاری Providers دستاویز: https://pi.dev/docs/latest/providers
[2] ٹرمینل تشکیل کی دستاویز: https://pi.dev/docs/latest/terminal-setup
[3] Pi فوری آغاز کی دستاویز: https://pi.dev/docs/latest/quickstart
[4] Pi Custom Models دستاویز: https://pi.dev/docs/latest/models
[5] Pi Settings دستاویز: https://pi.dev/docs/latest/settings
[6] Pi GitHub ریپوزٹری: https://github.com/earendil-works/pi