Pi کی تنصیب اور OmniProxy کی کنفیگریشن

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

سب ایجنٹس کسی کام کا کچھ حصہ دوسرے اسسٹنٹ کو تفویض کرتے ہیں، جبکہ پلان موڈ عمل درآمد شروع ہونے سے پہلے مراحل کو منظم کرتا ہے۔ کوئی بھی خصوصیت ڈیفالٹ طور پر شامل نہیں ہے، لیکن آپ 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 کریں
• انسٹالر انحصار کو پن (pin) کرتا ہے
• 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 یا اس سے بعد کا ورژن پہلے سے انسٹال ہے، تو آپ Quickstart سے متبادل کمانڈ بھی استعمال کر سکتے ہیں:

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 صارفین کو 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 میں ہیں، تو Quickstart پر عمل کرتے ہوئے اس 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 ان کی اسناد کو حل نہ کر سکے۔ ماڈل منتخب کرنے کے بعد، اسے نئے سیشنز کے لیے ڈیفالٹ ماڈل کے طور پر محفوظ کرنے کے لیے 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 کے ساتھ ایک ماڈل منتخب کریں۔ Quickstart میں ایک مثال ٹاسک 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 ↗