omp (Oh My Pi) + JoinGonka Gateway: ماڈل رولز کے ساتھ ایجنٹ

مرحلہ 1: omp انسٹال کریں۔ پروجیکٹ کے README سے سرکاری طریقے:

# macOS and Linux
curl -fsSL https://omp.sh/install | sh

# Homebrew
brew install can1357/tap/omp

# via Bun (requires Bun 1.3.14 or newer)
bun install -g @oh-my-pi/pi-coding-agent

# Windows (PowerShell)
irm https://omp.sh/install.ps1 | iex

مرحلہ 2: کلید حاصل کریں۔ gate.joingonka.ai/register پر رجسٹر کریں، پتہ تصدیق کریں اور "API-کلیدیں" کے حصے میں jg- سابقے کے ساتھ ایک کلید بنائیں۔ نیٹ ورک کے تمام ماڈلز کے لیے ایک کلید اور ایک بیلنس کام کرتا ہے۔

مرحلہ 3: انسٹالر چلائیں۔

npx @joingonka/setup --tool omp

انسٹالر کلید پوچھے گا — کمانڈ لائن آرگیومنٹس میں یہ نہیں دی جاتی تاکہ شیل کی تاریخ میں نہ رہ جائے — اور چار کام کرے گا:

• ~/.omp/agent/models.yml میں joingonka پرووائیڈر لکھے گا: گیٹ وے کا پتہ، openai-completions پروٹوکول، لٹرل کلید اور نیٹ ورک کے تین ماڈلز حقیقی کانٹیکسٹ ونڈوز اور جواب کی حدوں کے ساتھ؛ فائل کو 600 اجازتیں ملیں گی؛
• ڈیفالٹ ماڈل — ~/.omp/agent/config.yml میں modelRoles.default — DeepSeek V4 Flash پر سیٹ کرے گا، مگر صرف اسی صورت میں جب کردار خالی ہو یا نیٹ ورک سے نکل جانے والے ماڈل کی طرف اشارہ کرے: کسی اور کا انتخاب یہ نہیں چھینتا، بلکہ بتاتا ہے کہ کیسے تبدیل کرنا ہے؛
• لکھنے سے پہلے پچھلی فائل کا بیک اپ لے گا، اور باقی پرووائیڈرز، کردار اور تبصرے جیسے تھے ویسے رہیں گے؛
• آخر میں گیٹ وے پر ایک لائیو درخواست بھیجے گا اور سیدھا بتائے گا کہ کلید، پتہ اور ماڈل قبول ہوئے یا نہیں۔

دوسرا ڈیفالٹ ماڈل --model فلیگ سے مقرر ہوتا ہے deepseek، glm یا minimax کے مخفف کے ساتھ — واضح طور پر بتایا گیا ماڈل ہمیشہ لکھا جاتا ہے۔ ڈاٹ فائلز اور سرورز کے لیے ایک بغیر سوال والا موڈ ہے، جس میں کلید ماحولیاتی متغیر سے لی جاتی ہے:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool omp --model glm --non-interactive

کنفگز کے غیر معیاری مقام کا انسٹالر خود خیال رکھتا ہے: نامزد پروفائل (OMP_PROFILE) اور منتقل شدہ ایجنٹ ڈائریکٹری (PI_CODING_AGENT_DIR)۔ وراثتی models.json کو یہ اسی طرح models.yml میں منتقل کرتا ہے جیسے خود omp کرتا — پچھلے پرووائیڈرز غائب نہیں ہوں گے۔ اور اگر ساتھ پرانا settings.json ہو config.yml کے بغیر، تو انسٹالر config.yml نہیں بنائے گا تاکہ omp اپنی سیٹنگز کی منتقلی نہ چھوڑے: یہ ایک بار omp چلانے اور کمانڈ دہرانے کو کہے گا۔

انسٹالر جو کچھ کرتا ہے، وہ سب ہاتھ سے لکھا جا سکتا ہے۔ فائلیں صرف دو ہیں، اور ہر ایک کا اپنا کام ہے: models.yml پرووائیڈرز اور ماڈلز بیان کرتی ہے، config.yml سیٹنگز محفوظ رکھتی ہے — بشمول یہ کہ کون سا ماڈل کس رول پر ہے۔

# ~/.omp/agent/models.yml
providers:
  joingonka:
    baseUrl: https://gate.joingonka.ai/v1
    api: openai-completions
    apiKey: jg-your-key
    models:
      - id: deepseek-ai/DeepSeek-V4-Flash-0731
        name: DeepSeek V4 Flash (Gonka)
        input: [text]
        contextWindow: 380000
        maxTokens: 32768
        reasoning: true
      - id: zai-org/GLM-5.3-Flash
        name: GLM-5.3 Flash (Gonka)
        input: [text]
        contextWindow: 390000
        maxTokens: 8192
        reasoning: true
      - id: MiniMaxAI/MiniMax-M2.7
        name: MiniMax M2.7 (Gonka)
        input: [text]
        contextWindow: 200000
        maxTokens: 8192

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

کلید کو براہِ راست لکھنا سب سے بے جھنجھٹ طریقہ ہے: omp کسی بھی ماحول سے شروع ہو جاتا ہے، اور فائل کو chmod 600 ~/.omp/agent/models.yml کمانڈ سے بند کر دینا کافی ہے۔ کلید فائل سے باہر رکھنی ہو تو apiKey میں متغیر کا نام لکھیں، مثلاً JOINGONKA_API_KEY، اور اسے اُس شیل میں ایکسپورٹ کریں جہاں سے omp چلاتے ہیں: کلید حل کرنے کا یہی طریقہ پروجیکٹ کی دستاویزات میں بیان ہوا ہے۔

اختیاری فیلڈ cost (فی ملین ٹوکن قیمت) صرف omp کے انٹرفیس میں سیشن کی لاگت کا اندازہ لگانے کے لیے درکار ہے۔ انسٹالر وہاں انسٹال کے وقت گیٹ وے کی موجودہ قیمت لکھ دیتا ہے؛ ہاتھ سے لکھی کنفگ میں یہ فیلڈ چھوڑی جا سکتی ہے — اس اندازے کا آپ کے بل سے کوئی تعلق نہیں، اصل خرچ ڈیش بورڈ دکھاتا ہے۔

ماڈل سلیکٹر provider/model-id کی صورت میں لکھا جاتا ہے۔ پرووائیڈر کا نام پہلی سلیش پر الگ ہوتا ہے، اس لیے اپنی سلیش والے نیٹ ورک آئی ڈی جیسے ہیں ویسے ہی لکھے جاتے ہیں: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731۔ config.yml بدلنے کے بجائے انٹرفیس سے بھی رول مقرر کیا جا سکتا ہے — سیشن کے اندر /model کمانڈ سے یا omp setup وزرڈ میں۔

omp میں ہر چیز کے لیے ایک ہی ماڈل نہیں بلکہ کرداروں (roles) کے لحاظ سے ماڈل منتخب کیے جاتے ہیں — یہ سیٹنگ کا سب سے اہم پہلو ہے۔ ڈائیلاگ کے لیے ان بلٹ کردار یہ ہیں: default, smol, slow, plan, commit, task, tiny, memory, advisor اور vision۔ سب کو سیٹ کرنے کی ضرورت نہیں: غیر متعین smol اور slow پہلے default کردار کا ماڈل لیتے ہیں، task کردار کے بغیر سب ایجنٹس موجودہ سیشن کے ماڈل پر کام کرتے ہیں، اور commit اور tiny ماڈلز smol کی پیروی کرتے ہیں۔ ایک لائن پر مشتمل کنفیگریشن default مکمل طور پر کارآمد ہے۔

نیٹ ورک کے ماڈلز کے درمیان کرداروں کو تقسیم کرنے کا مقصد بچت نہیں ہے — کیونکہ DeepSeek V4 Flash، GLM-5.3 Flash اور MiniMax M2.7 کی قیمت ایک ہی ہے — بلکہ رویے اور صلاحیت کی بنیاد پر ہے: سوچنے والا ماڈل بہتر منصوبہ بندی کرتا ہے، لمبے جواب والا ماڈل بہتر لکھتا ہے، اور پس منظر کے چھوٹے کاموں کو مرکزی ٹاسک کی قطار میں رکھنے کی ضرورت نہیں ہے۔

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
  slow: joingonka/zai-org/GLM-5.3-Flash
  plan: joingonka/zai-org/GLM-5.3-Flash
  tiny: joingonka/MiniMaxAI/MiniMax-M2.7

retry:
  fallbackChains:
    default:
      - joingonka/zai-org/GLM-5.3-Flash

retry.fallbackChains بلاک رش کے اوقات کے لیے انشورنس ہے: جب مین ماڈل مسلسل 429 کا جواب دے، تو omp بقیہ کام چین کی اگلی انٹری کو منتقل کر دیتا ہے، اور وقفے کے بعد مین پر واپس آ جاتا ہے۔ چین کی کلید کوئی کردار، مخصوص ماڈل یا پورا پرووائیڈر (joingonka/*) ہو سکتی ہے۔

ایک رن کے لیے کردار کو فلیگ کے ذریعے ری ڈیفائن کیا جا سکتا ہے: omp --model slow سیشن کو slow کردار کے ماڈل پر چلاتا ہے، جبکہ --smol، --slow اور --plan خود کردار کے ماڈل کو بدل دیتے ہیں۔ سیشن کے اندر Ctrl+P کرداروں کے ماڈلز کو براؤز کرتا ہے، اور /model انتخاب کھولتا ہے؛ Roles ٹیب میں کرداروں اور ان کے متبادل سیٹ کیے جاتے ہیں۔

کردار کی ویلیو کے ساتھ سوچنے کی سطح لکھی جا سکتی ہے — :low, :medium, :high۔ یہ omp سنٹیکس ہے، اور مخصوص ماڈل اس سطح کو کیسے سمجھتا ہے، یہ اسی پر منحصر ہے: GLM-5.3 Flash کے لیے یہ ایک بائنری سوئچ ہے — تفصیلات ماڈل کے جائزے میں دیکھیں۔ ایک اور مفید تفصیل: کرداروں کو ایک ریپوزٹری کے لیے <repo>/.omp/config.yml فائل کے ذریعے ری ڈیفائن کیا جا سکتا ہے جس میں وہی modelRoles بلاک ہو۔ پرووائیڈرز اور کیز ہوم ڈائریکٹری میں ہی رہتی ہیں، تاکہ کی ریپوزٹری میں نہ جائے۔

پہلے یقینی بنائیں کہ omp پرووائیڈر کو دیکھ رہا ہے:

omp models joingonka

جواب میں تین سطروں کی ایک ٹیبل آتی ہے جس میں کانٹیکسٹ ونڈوز اور جواب کی حد models.yml سے لی گئی اور ہزاروں میں گول کی گئی ہوتی ہیں (آؤٹ پٹ مختصر ہے: omp میں thinking اور images کالم بھی ہیں):

joingonka (3)
model                                context  max-out
deepseek-ai/DeepSeek-V4-Flash-0731      380K      33K
MiniMaxAI/MiniMax-M2.7                  200K     8.2K
zai-org/GLM-5.3-Flash                   390K     8.2K

پھر — بغیر انٹرفیس کے ایک بار چلائیں۔ ایک خالی ڈائریکٹری میں واضح bug والی فائل رکھیں اور اسے ڈھونڈنے کو کہیں:

omp -p "Read calc.py and tell me in one sentence whether it has a bug."

ایجنٹ کو خود ہی ریڈنگ ٹول کال کرنا چاہیے اور لبِ لباب جواب دینا چاہیے — یہ بتاتے ہوئے کہ bug کس ایکسپریشن میں ہے۔ 21 ستمبر 2026 کو ہمارے رن میں یہ چکر — درخواست، ٹول کال، نتیجہ، جواب — DeepSeek V4 Flash اور GLM-5.3 Flash نے صاف طور پر پاس کیا؛ MiniMax M2.7 کے بارے میں — نیچے ٹیبل کی آخری سطر میں۔

تیسری جانچ — گیٹ وے کی طرف سے: ڈیش بورڈ کے "Usage" سیکشن میں درخواست "By models" بریک ڈاؤن میں نظر آئے گی، اور "By keys" بلاک میں آخری درخواست کا وقت اپ ڈیٹ ہو جائے گا۔ اگر وہاں خالی ہو تو omp کسی اور پرووائیڈر کے پاس جا رہا ہے: دیکھیں کہ رولز پر کیا سیٹ ہے، omp config get modelRoles کمانڈ سے۔

اگر کچھ غلط ہو جائے تو تشخیص عام طور پر پیغام سے ہی پڑھی جا سکتی ہے:

ایجنٹ ٹول چیٹ کے مقابلے میں ٹوکن مختلف طرح سے خرچ کرتا ہے: ہر جملے میں omp ایک سسٹم پرامپٹ اور ٹولز کی تفصیلات شامل کرتا ہے، اور ایک کام عام طور پر کئی مراحل میں مکمل ہوتا ہے۔ ہمارے ایک ٹیسٹ میں، صرف ایک ریڈنگ ٹول فعال ہونے کے باوجود، ہر مرحلے میں تقریباً 3.5 ہزار ان پٹ ٹوکن خرچ ہوئے؛ مکمل سیٹ کے ساتھ یہ تعداد اور بڑھ جائے گی۔ اس لیے یہاں فی ٹوکن قیمت اہم ہے۔

JoinGonka Gateway کے ذریعے ٹوکن کی قیمت فی ملین ان پٹ $0.0069 اور آؤٹ پٹ $0.021 ہے — یہ قیمت نیٹ ورک کے تمام ماڈلز کے لیے یکساں ہے اور اس صفحے پر براہ راست سورس سے اپ ڈیٹ ہوتی ہے۔

دائیں جانب والے کالم کے تخمینے ستمبر 2026 کی قیمتوں پر مبنی ہیں۔ موازنہ کرنے کے لیے — omp میں ماڈلز کے لیے ادائیگی کے طریقے:

omp سٹیٹس بار سیشن کے تخمینی اخراجات دکھاتا ہے۔ اس کا حساب models.yml کے cost فیلڈ کے مطابق کیا جاتا ہے: انسٹالر وہاں انسٹالیشن کے وقت گیٹ وے کی قیمت درج کرتا ہے، اور نیٹ ورک پر ڈالر کی قیمت GNK ریٹ کے ساتھ تبدیل ہوتی ہے، لہذا یہ تخمینہ ایک رہنما ہے۔ درست اخراجات اور بیلنس ڈیش بورڈ کے «استعمال» (Usage) اور «بلنگ» (Billing) سیکشنز میں دیکھیں۔ ڈیفالٹ کے طور پر DeepSeek V4 Flash کا انتخاب کیوں کیا گیا، اس کی تفصیل ماڈل کے جائزے میں موجود ہے۔

منظوری کا موڈ۔ بطور ڈیفالٹ omp yolo موڈ میں چلتا ہے: پڑھنے، لکھنے اور کمانڈ چلانے کی خود منظوری دیتا ہے۔ اپنے پروجیکٹ پر یہ سہولت ہے، لیکن کسی اور کے کوڈ پر موڈ سخت کرنے یا کنٹینر میں جانے کی وجہ ہے:

omp config set tools.approvalMode write

write موڈ میں ایجنٹ صرف کمانڈ چلانے کی اجازت مانگتا ہے، always-ask میں لکھنے کی بھی۔ ایک رن کے لیے یہی کام --approval-mode فلیگ کرتا ہے۔ یہ خود omp کی خاصیت ہے، ماڈل پرووائیڈر پر منحصر نہیں۔

Pi اور omp — مختلف کنفگ کے رشتہ دار۔ ایک ٹول کی سیٹنگ دوسرے کو منتقل نہیں ہوتی: ان کی ڈائریکٹریاں، فارمیٹ اور فیلڈ کے نام الگ ہیں۔

ایک سے زیادہ ماحول۔ نامزد پروفائل (omp --profile work یا OMP_PROFILE ویری ایبل) تمام سیٹنگز ~/.omp/profiles/<name>/agent میں منتقل کر دیتا ہے — کام اور ذاتی کیز الگ رکھنے کے لیے آسان۔ موجودہ ایجنٹ ڈائریکٹری پرنٹ کرتا ہے omp config path۔

اگر ایڈیٹر میں ایجنٹ درکار ہو۔ omp ACP پروٹوکول کے ذریعے Zed کے اندر کام کر سکتا ہے — یہی ایجنٹ ہے، وہی سیٹنگز، دوبارہ پرووائیڈر اور رولز سیٹ کرنے کی ضرورت نہیں۔