Pi کی تنصیب اور OmniProxy کی ترتیب

Pi ایک چھوٹا ٹرمینل اسسٹنٹ ہے—ایک پروگرام جو کمانڈ لائن میں آپ کے ساتھ براہ راست بات کرتا ہے، فائلیں پڑھتا ہے، اور کام مکمل کرتا ہے۔ اس کا سسٹم پرامپٹ مختصر ہے اور ڈیفالٹ طور پر صرف چند ٹولز ہیں۔ اگر آپ کو دیگر کمانڈز، ورک فلو، یا انٹرفیس کی ضرورت ہے، تو آپ انہیں بعد میں ایکسٹینشنز کے ذریعے شامل کر سکتے ہیں۔ ایکسٹینشنز وہ اجزاء ہیں جو Pi میں صلاحیتیں شامل کرتے ہیں، اور آپ انہیں بنانے کے بعد دوسروں کے ساتھ شیئر کر سکتے ہیں۔

سب ایجنٹس (Subagents) کسی کام کا کچھ حصہ دوسرے اسسٹنٹ کو سونپتے ہیں، جبکہ پلان موڈ عمل درآمد شروع ہونے سے پہلے مراحل کو منظم کرتا ہے۔ کوئی بھی خصوصیت ڈیفالٹ طور پر شامل نہیں ہے، لیکن آپ Pi سے انہیں بنانے یا دوسروں کے شیئر کردہ پیکیجز انسٹال کرنے کے لیے کہہ سکتے ہیں۔

شروع کرنے سے پہلے

macOS اور Linux ایک انسٹالیشن اسکرپٹ استعمال کرتے ہیں—ایک واحد کمانڈ جو خود بخود Pi کو ڈاؤن لوڈ اور انسٹال کرتی ہے۔ Windows پر، Pi ہوم پیج پر فراہم کردہ PowerShell کمانڈ استعمال کریں۔ PowerShell وہ کمانڈ لائن ماحول ہے جو Windows کے ساتھ شامل ہے۔ آپ Pi کو WSL میں بھی انسٹال کر سکتے ہیں، جو Windows کے اندر دستیاب Linux ماحول ہے۔

اگر آپ npm کے ساتھ انسٹال کرنے کا انتخاب کرتے ہیں، تو آپ کو Node.js 22.19 یا اس سے بعد کا ورژن درکار ہے۔ npm وہ پیکیج مینیجر ہے جو Node.js کے ساتھ استعمال ہوتا ہے اور کمانڈ لائن سے Pi انسٹال کر سکتا ہے۔

macOS Linux

install.sh

• سرکاری اسکرپٹ curl کریں
• انسٹالر انحصار (dependencies) کو پن کرتا ہے
• pi update کے ساتھ اپ ڈیٹ کریں

Windows

install.ps1

• سرکاری PowerShell کمانڈ
• Git for Windows Bash فراہم کرتا ہے
• آپ WSL بھی استعمال کر سکتے ہیں

Node پہلے سے انسٹال ہے

npm

• Node 22.19+ درکار ہے
• پیکیج کا نام pi-coding-agent ہے
• --ignore-scripts شامل کریں

پہلی بار Pi انسٹال اور لانچ کریں

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 update کے ساتھ Pi کو اپ ڈیٹ کریں۔ npm انسٹالیشن کے لیے، اپنے پیکیج مینیجر کے ذریعے فراہم کردہ اپ ڈیٹ طریقہ استعمال کریں۔ Nix صارفین کو Pi کے فلیک (flake) سے انسٹال کرنا چاہیے۔ ایک فلیک Nix کنفیگریشن ہے جو سافٹ ویئر اور اس کے انحصار کو بیان کرتی ہے، اور pi update Nix انسٹالیشن کو اپ ڈیٹ نہیں کر سکتا۔

انسٹالیشن کے بعد، پہلے تصدیق کریں کہ آپ کا ٹرمینل Pi کو تلاش کر سکتا ہے:

pi --version

Windows پر، اگر آپ چاہتے ہیں کہ ماڈلز Bash کمانڈز پر عمل کریں، تو زیادہ تر مقامی صارفین کے لیے Git for Windows انسٹال کرنے کی سفارش کی جاتی ہے۔ Bash وہ کمانڈ ماحول ہے جسے Pi کچھ کمانڈز چلانے کے لیے استعمال کرتا ہے۔ Pi ~/.pi/agent/settings.json میں shellPath سیٹنگ، Program Files کے تحت Git Bash، اور پھر PATH پر bash.exe کو اس ترتیب سے چیک کرتا ہے۔ shellPath Bash کے مقام کو بتاتا ہے، جبکہ PATH ان ڈائریکٹریز کی فہرست ہے جنہیں سسٹم کمانڈز تلاش کرنے کے لیے تلاش کرتا ہے۔

Pi شروع کرنے کے بعد، آپ اسے چیک کرنے کے لیے !printf 'Bash is working\n' درج کر سکتے ہیں۔ اگر آپ کی فائلیں اور ٹولز پہلے سے WSL میں ہیں، تو کوئیک اسٹارٹ پر عمل کرتے ہوئے اس Linux ماحول میں Pi انسٹال کریں۔

اگلا، وہ فولڈر درج کریں جس کا 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 فارمیٹ استعمال کرنا ہے۔

مکمل ماڈل ID کاپی کریں، بشمول نام میں کوئی بھی سلیش۔ 2026-10-09 کو، فراہم کنندہ کی دستاویزات میں دو حوالہ IDs 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 ماڈل لسٹ میں مکمل ماڈل ID سے مماثل ہونی چاہیے۔ input بتاتا ہے کہ ماڈل یہاں ٹیکسٹ ان پٹ کے لیے ترتیب دیا گیا ہے۔

apiKey کو ایک لٹریل ویلیو کے طور پر درج کیا جا سکتا ہے، یا $NAME یا ${NAME} کے طور پر تاکہ Pi اسے ماحولیاتی متغیر سے پڑھ سکے۔ ! سے شروع ہونے والی ویلیو کو ایک کمانڈ کے طور پر سمجھا جاتا ہے اور ہر درخواست کے لیے چلایا جاتا ہے۔ کسی ریپوزٹری میں اصلی کلید کمٹ نہ کریں۔ اگر گیٹ وے کلیدوں کی توثیق نہیں کرتا، تو آپ ایک پلیس ہولڈر سٹرنگ درج کر سکتے ہیں جو صرف آپ کی مقامی مشین پر استعمال ہوتی ہے۔ 2026-10-09 کو، Pi نے اس کنفیگریشن کے ساتھ فائل کو کامیابی سے پڑھا۔

/model کھولنے سے یہ فائل دوبارہ لوڈ ہوتی ہے۔ /model Pi میں ماڈلز کو دیکھنے اور منتخب کرنے کے لیے انٹرفیس ہے۔ کسٹم ماڈلز /model میں تب تک ظاہر نہیں ہوتے جب تک Pi ان کی اسناد (credentials) کو حل نہ کر سکے۔ ماڈل منتخب کرنے کے بعد، اسے نئے سیشنز کے لیے ڈیفالٹ ماڈل کے طور پر محفوظ کرنے کے لیے Ctrl+S دبائیں۔

فائل

models.json

• ڈیفالٹ ڈائریکٹری: ~/.pi/agent
• providers کے تحت ایک اندراج شامل کریں
• api کو completions پر سیٹ کریں

پتہ

baseUrl

• /v1 شامل کریں
• apiKey ایک متغیر کا حوالہ دے سکتا ہے
• ماڈل id کا درست ہونا ضروری ہے

منتخب کریں

/model

• اسے کھولنے سے فائل دوبارہ لوڈ ہوتی ہے
• جو ماڈل آپ نے ابھی شامل کیا ہے اسے منتخب کریں
• Ctrl+S اسے ڈیفالٹ کے طور پر محفوظ کرتا ہے

ایک حقیقی کام کے ساتھ تصدیق کریں

کنفیگریشن مکمل کرنے کے بعد، آپ فائلوں پر مشتمل ڈائریکٹری میں نان انٹرایکٹو چیک کر سکتے ہیں۔ نان انٹرایکٹو موڈ کا مطلب ہے کہ Pi اس واحد کام کو مکمل کرتا ہے اور پھر جاری بات چیت میں داخل ہونے کے بجائے باہر نکل جاتا ہے۔ --model کے بعد کی ویلیو کو موجودہ OmniProxy لسٹ سے مکمل ID سے تبدیل کریں:

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 کے درخواست لاگز میں ذریعہ اور ماڈل ID کی تصدیق کریں۔

لانچ کریں

pi لانچ ہوتا ہے

• پہلے فولڈر پر cd کریں
• pi --version آؤٹ پٹ دیتا ہے
• ماڈل کا نام انٹرفیس کے نیچے ظاہر ہوتا ہے

ٹاسک

اس نے ڈائریکٹری پڑھی

• پوچھیں کہ ریپوزٹری کو کیسے منظم کیا گیا ہے
• ان فائلوں کا جائزہ لیں جن کی یہ فہرست دیتا ہے
• صرف کامیاب کنفیگریشن سیو پر انحصار نہ کریں

لاگز

گیٹ وے میں نظر آتے ہیں

• ذریعہ Pi ہے
• ماڈل ID مماثل ہے
• کلید کو مقامی مشین پر رکھیں

عام غلطیاں

• pi نہیں مل سکا: ٹرمینل کو دوبارہ کھولیں اور دوبارہ pi --version آزمائیں۔ npm انسٹالیشن کے لیے، تصدیق کریں کہ گلوبل بن ڈائریکٹری PATH پر ہے۔
• کسٹم ماڈلز /model میں ظاہر نہیں ہوتے: تصدیق کریں کہ models.json، ~/.pi/agent/ میں ہے، تصدیق کریں کہ apiKey حل ہو سکتا ہے، اور پھر /model کو دوبارہ کھولیں۔
• Windows رپورٹ کرتا ہے کہ Bash نہیں مل سکا: Git for Windows انسٹال کریں، یا ~/.pi/agent/settings.json میں shellPath سیٹ کریں۔ JSON میں بیک سلیش کو دو بار لکھا جانا چاہیے۔
• درخواست مسترد کر دی گئی: چیک کریں کہ api، openai-completions ہے اور یہ کہ baseUrl، /v1 پر ختم ہوتا ہے۔ صرف اس لیے اضافی مطابقت کے آپشنز فعال نہ کریں کہ سروس خود کو مطابقت پذیر بتاتی ہے۔
• ماڈل ID غلط ہے: اسے موجودہ OmniProxy لسٹ سے دوبارہ کاپی کریں۔

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

انسٹالیشن کمانڈز کے لیے، Pi website اور Quickstart دیکھیں۔ ماڈل فائل کے لیے، Choose a Model اور Configuration دیکھیں۔ Windows کمانڈ ماحول کے لیے، Run Pi on Windows دیکھیں۔ مثالوں میں استعمال ہونے والی ماڈل IDs کے لیے، Gemini model list اور xAI models page دیکھیں۔

اپنے ذاتی OmniProxy ترتیب سے ہر پلیس ہولڈر کو ویلیوز سے تبدیل کریں۔ کبھی بھی ایک حقیقی کنج شائع نہ کریں۔

محض محفوظ نتیجہ یا HTTP 200 مکمل ایجنٹ مطابقت کی ضمانت نہیں دیتا۔ OmniProxy کی کال ریکارڈ میں ذریعہ اور ماڈل چیک کریں۔

سرکاری ذرائع · Pi ↗