Goose + JoinGonka Gateway: اپنا پرووائیڈر اور کی (key) keyring میں

مرحلہ 1: Goose انسٹال کریں۔ پروجیکٹ کی دستاویزات میں CLI کے لیے سرکاری طریقے:

# macOS and Linux: the script puts the binary in ~/.local/bin
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# macOS, Homebrew
brew install block-goose-cli

ویری ایبل CONFIGURE=false goose configure وزرڈ بند کر دیتا ہے، جو اسکرپٹ ورنہ انسٹال کے فوراً بعد چلاتا ہے: پرووائیڈر انسٹالر کنفیگر کرے گا۔ اگر ~/.local/bin ڈائریکٹری PATH میں نہ ہو تو اسکرپٹ خود بتا دے گا۔ Windows کے لیے اسی ریپوزٹری میں download_cli.ps1 اسکرپٹ موجود ہے، جبکہ ڈیسک ٹاپ ایپ دستاویزات کے صفحے سے ڈاؤن لوڈ ہوتی ہے؛ ایپ اور CLI ایک ہی سیٹنگز پڑھتے ہیں، اس لیے نیچے دی گئی ہر بات دونوں پر لاگو ہے۔ تصدیق — goose --version۔

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

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

npx @joingonka/setup --tool goose

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

• گیٹ وے کا ایڈریس اور نیٹ ورک کے تین ماڈلز اصل کانٹیکسٹ ونڈوز کے ساتھ custom_providers/custom_joingonka.json پرووائیڈر فائل بنائے گا، اجازتوں 600 کے ساتھ۔ نام custom_joingonka اور CUSTOM_JOINGONKA_API_KEY وہی ہیں جو Goose خود "JoinGonka" نام سے اخذ کرتا ہے، اس لیے وزرڈ سے آئی کلید صحیح جگہ لگے گی؛
• JoinGonka کو DeepSeek V4 Flash ماڈل کے ساتھ ڈیفالٹ پرووائیڈر بنائے گا — مگر صرف اسی صورت میں جب پرووائیڈر ابھی منتخب نہ ہوا ہو یا ہمارا منتخب ہوا ہو خالی یا نیٹ ورک سے ہٹے ماڈل کے ساتھ۔ دوسرے کی پسند پر ہاتھ نہیں ڈالتا، بلکہ آزمانے کی کمانڈ چھاپتا ہے: goose session --provider custom_joingonka --model …؛
• کلید secrets.yaml میں رکھے گا، صرف اسی صورت میں جب Goose کا سیکرٹ اسٹور یقینی طور پر فائل پر مبنی ہو؛ ورنہ صاف بتا دے گا کہ ایک مرحلہ باقی ہے، — تفصیلات کلید سے متعلق سیکشن میں؛
• تبدیل شدہ فائلوں کی بیک اپ کاپیاں بنائے گا اور آخر میں گیٹ وے پر ایک لائیو درخواست بھیجے گا تاکہ فوراً کلید، ایڈریس اور ماڈل کی جانچ ہو جائے۔

انسٹالر سیٹنگز کی ڈائریکٹری اسی طرح تلاش کرتا ہے جیسے Goose خود: Linux اور macOS پر ~/.config/goose، Windows پر %APPDATA%\Block\goose\config، اور GOOSE_PATH_ROOT مقرر ہونے پر <root>/config۔ مختلف ماڈل --model فلیگ سے مقرر ہوتا ہے، اختصاراً deepseek، glm یا minimax؛ واضح طور پر دیا گیا ماڈل ہمیشہ لکھا جاتا ہے۔ بغیر سوال موڈ کلید ماحول کے ویری ایبل سے لیتا ہے:

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

انسٹالر جو کچھ کرتا ہے، اسے ہاتھ سے بھی لکھا جا سکتا ہے۔ پرووائیڈر ایک الگ JSON فائل ہے ~/.config/goose/custom_providers/custom_joingonka.json؛ فائل کا نام اور name فیلڈ کی ویلیو ایک جیسی ہونی چاہیے:

{
  "name": "custom_joingonka",
  "engine": "openai",
  "display_name": "JoinGonka",
  "description": "JoinGonka Gateway — Gonka AI inference (OpenAI-compatible)",
  "api_key_env": "CUSTOM_JOINGONKA_API_KEY",
  "base_url": "https://gate.joingonka.ai/v1/chat/completions",
  "models": [
    { "name": "deepseek-ai/DeepSeek-V4-Flash-0731", "context_limit": 380000 },
    { "name": "zai-org/GLM-5.3-Flash", "context_limit": 390000 },
    { "name": "MiniMaxAI/MiniMax-M2.7", "context_limit": 200000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Goose کے ماڈل انٹری میں رسپانس کے لیے الگ کوئی حد نہیں ہے۔ اس طرح کے ماڈلز کے لیے یہ ریکویسٹ میں کوئی حد نہیں بھیجتا (ہم نے اس کی ریکویسٹ لاگ سے تصدیق کی ہے)، اور اسٹریمنگ موڈ میں گیٹ وے خود ماڈل کی حد کے مطابق رسپانس کو محدود کرتا ہے: DeepSeek V4 Flash کے لیے 32,768 ٹوکن، GLM-5.3 Flash اور MiniMax M2.7 کے لیے 8192 ٹوکن۔ اس کے لیے گلوبل ویری ایبل GOOSE_MAX_TOKENS سیٹ کرنے کی ضرورت نہیں ہے: یہ تمام پرووائیڈرز کے لیے ایک ساتھ کام کرتا ہے۔

Goose پرووائیڈر فائل کو سخت JSON پارسنگ کے ساتھ پڑھتا ہے: کوئی کمنٹ یا زائد کوما ہونے پر پرووائیڈر لسٹ سے غائب ہو جاتا ہے۔ اسے وزرڈ (goose configure → Custom Providers) سے بھی بنایا جا سکتا ہے، لیکن وزرڈ کانٹیکسٹ ونڈو کے بارے میں نہیں پوچھتا — اسے ہاتھ سے لکھنا پڑے گا۔

ڈیفالٹ پرووائیڈر اور ماڈل ~/.config/goose/config.yaml میں رہتے ہیں۔ Goose خود اسے اس طرح ریکارڈ کرتا ہے:

active_provider: custom_joingonka
providers:
  custom_joingonka:
    enabled: true
    model: deepseek-ai/DeepSeek-V4-Flash-0731
    configured: true

پرانا لے آؤٹ — فائل کی روٹ میں فلیٹ کیز GOOSE_PROVIDER اور GOOSE_MODEL — بھی کام کرتا ہے: Goose اسے پڑھتا ہے اور سیٹنگز پہلی بار سیو کرتے وقت خود اسے نئے فارمیٹ میں تبدیل کرتا ہے، جیسا کہ ہمارے پاس goose configure کے بعد ہوا ہے۔ خالی فائل پر انسٹالر فلیٹ کیز ہی لکھتا ہے — کوئی بھی ورژن انہیں سمجھتا ہے۔ ایک جیسے نام کے اینوائرمنٹ ویری ایبلز فائل سے زیادہ اہم ہوتے ہیں: اگر وہ شیل میں سیٹ ہوں، تو config.yaml کا انتخاب کام نہیں کرے گا اور انسٹالر اس بارے میں خبردار کرے گا۔

Goose کی provider فائل میں صرف secret کا نام موجود ہے — CUSTOM_JOINGONKA_API_KEY۔ یہ قدر کو ترتیب سے تلاش کرتا ہے: اسی نام کے environment variable میں، پھر سسٹم کے secret store میں (keyring، macOS پر — Keychain)، پھر config کے ساتھ موجود secrets.yaml فائل میں۔ secrets اُس فائل میں اُس وقت جاتے ہیں جب Goose کا store فائل پر مبنی ہو، اور وہاں وہ سادہ متن میں، 600 permissions کے ساتھ پڑے رہتے ہیں۔ البتہ config.yaml میں Goose keys بالکل تلاش نہیں کرتا (دستاویزات)۔

Store فائل پر مبنی اُس وقت بنتا ہے جب keyring بند ہو — GOOSE_DISABLE_KEYRING variable میں کوئی بھی قدر یا config.yaml میں GOOSE_DISABLE_KEYRING: true سطر، — یا پھر دستیاب نہ ہو: graphical session کے بغیر سرور، کنٹینر، CI۔ دوسری صورت میں Goose لاگ میں لکھتا ہے «Keyring unavailable. Using file storage for secrets.» اور خود ہی فائل پر منتقل ہو جاتا ہے — کنٹینر میں ہم نے بالکل یہی دیکھا۔ Installer keyring میں لکھ نہیں سکتا، اور آپ کی طرف سے اسے بند بھی نہیں کرے گا: ورنہ Goose وہ secrets دیکھنا چھوڑ دیتا جو پہلے سے وہاں موجود ہیں۔ اسی سے یہ منظرنامے بنتے ہیں:

باقی ایک قدم۔ goose configure چلائیں اور wizard کے سوالات کے جواب دیں — ہمارے رن میں وہ ایسے دکھائی دے رہے تھے:

• What would you like to configure? → Configure Providers;
• Which model provider should we use? → JoinGonka (ہمارے ہاں وہ پہلے تھا);
• Would you like to set CUSTOM_JOINGONKA_API_KEY? (optional) → Yes، پھر Enter value for CUSTOM_JOINGONKA_API_KEY پر key پیسٹ کریں — حروف کی جگہ مربعے نمودار ہوں گے۔ Key فوراً محفوظ ہو جاتی ہے;
• Would you like to configure advanced settings? → No;
• Select a model — فہرست Goose گیٹ وے سے حاصل کرتا ہے: MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731, zai-org/GLM-5.3-Flash۔ کرسر پہلی سطر پر ہوتا ہے — installer کے منتخب کردہ model کو برقرار رکھنے کے لیے تیروں سے DeepSeek V4 Flash منتخب کریں۔ تصدیقی درخواست کے بعد wizard «Configuration saved successfully» سطر پر اختتام پذیر ہوگا۔

Goose Desktop میں راستہ یہ ہے: Settings → Models → Configure providers → JoinGonka → key → Submit۔ Key ہاتھ سے پیسٹ نہیں کرنی تو اسے کسی variable میں رکھیں اور اسی shell سے wizard چلائیں: Goose لکھے گا «CUSTOM_JOINGONKA_API_KEY is set via environment variable» اور قدر محفوظ کرنے کی پیشکش کرے گا:

read -s CUSTOM_JOINGONKA_API_KEY && export CUSTOM_JOINGONKA_API_KEY
goose configure

اور صرف ایک بار چلانے کے لیے key بغیر محفوظ کیے بھی دی جا سکتی ہے: CUSTOM_JOINGONKA_API_KEY=jg-your-key goose session, PowerShell میں — $env:CUSTOM_JOINGONKA_API_KEY = "jg-your-key"; goose session۔ Environment variable محفوظ قدر پر فوقیت رکھتا ہے، مگر صرف shell بند ہونے تک قائم رہتا ہے۔

پہلے دیکھیں کہ Goose حقیقت میں کون سی ترتیبات دیکھ رہا ہے:

goose info -v

«goose Configuration» بلاک میں GOOSE_PROVIDER: custom_joingonka اور ماڈل آئی ڈی کے ساتھ GOOSE_MODEL لائنیں ہونی چاہئیں۔ پھر — انٹرایکٹیو سیشن کے بغیر ایک بار چلائیں: کسی خالی ڈائریکٹری میں واضح بگ والی فائل رکھیں اور اسے ڈھونڈنے کو کہیں۔

goose run --no-session -t "Read calc.py and tell me in one sentence whether it has a bug."

--no-session فلیگ رن کو ہسٹری میں محفوظ نہیں کرتا۔ ہیڈر میں ● new session · custom_joingonka deepseek-ai/DeepSeek-V4-Flash-0731 جیسی لائن نظر آئے گی، پھر ٹول کال — cat calc.py کمانڈ کے ساتھ ▸ shell — اور ملنے والے بگ کے ساتھ جواب۔ ایک بار چلانے کے لیے دوسرا ماڈل --model سے مقرر ہوتا ہے: zai-org/GLM-5.3-Flash یا MiniMaxAI/MiniMax-M2.7۔ 23 ستمبر 2026 کو ہمارے رن میں نیٹ ورک کے تینوں ماڈلز نے «درخواست → ٹول → نتیجہ → جواب» کا چکر مکمل کیا۔ Goose CLI بطور ڈیفالٹ ماڈلز کی استدلال چھپاتا ہے — اگر آؤٹ پٹ ٹرمینل میں جائے تو GOOSE_CLI_SHOW_THINKING=1 ویری ایبل سے اسے دکھایا جا سکتا ہے۔ گیٹ وے کی طرف سے درخواست ڈیش بورڈ میں نظر آتی ہے: «استعمال» سیکشن، «ماڈل کے مطابق» اور «کیز کے مطابق» کی تقسیم۔

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

ایک ایجنٹ چیٹ کے مقابلے میں ٹوکن مختلف طریقے سے خرچ کرتا ہے۔ معیاری کنفیگریشن میں، Goose ماڈل کو اٹھارہ بلٹ ان ٹولز کی تفصیلات بھیجتا ہے اور ہمارے رن میں ہر قدم پر آپ کے سوال سے پہلے ہی تقریباً 4.6 ہزار ان پٹ ٹوکن خرچ ہو رہے تھے۔ "ایک فائل پڑھیں اور غلطی تلاش کریں" کام میں دو سے تین مراحل اور 10-15 ہزار ٹوکن لگے، جس میں زیادہ تر ان پٹ تھا؛ سیشن کا نام بنانے کے لیے Goose ایک مختصر درخواست خود کرتا ہے۔ غیر ضروری ایکسٹینشنز کو goose configure → Toggle Extensions میں بند کیا جا سکتا ہے — یہ ان پٹ کم کرنے کا سب سے آسان طریقہ ہے۔

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

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

درست خرچ اور بیلنس کیبنٹ کے "Usage" اور "Billing" سیکشنز میں دیکھیں۔ ڈیفالٹ طور پر DeepSeek V4 Flash کیوں سیٹ ہے — جس کی نیٹ ورک میں سب سے زیادہ آؤٹ پٹ لمٹ ہے — اس کی تفصیل ماڈل کے جائزے میں دی گئی ہے۔

تصدیق کا موڈ۔ بطور ڈیفالٹ Goose auto موڈ میں چلتا ہے — مکمل خودمختار: خود فائلیں بدلتا اور حذف کرتا ہے، کمانڈیں چلاتا ہے اور ایکسٹینشنز استعمال کرتا ہے، کچھ پوچھے بغیر۔ اپنے پروجیکٹ پر یہ سہولت دیتا ہے، مگر کسی اور کے کوڈ پر موڈ سخت کرنا بہتر ہے:

# inside a session
/mode smart_approve

# permanently, as a line in config.yaml
GOOSE_MODE: smart_approve

یہ خود Goose کی خصوصیت ہے، ماڈل پرووائیڈر پر منحصر نہیں۔

ماڈل تبدیلی۔ سیشن کے اندر — آئی ڈی کے ساتھ /model کمانڈ، مثلاً /model zai-org/GLM-5.3-Flash؛ ایک رن کے لیے — goose run اور goose session میں --model فلیگ؛ مستقل طور پر — goose configure یا config.yaml میں model سطر۔ پرووائیڈر اس دوران وہی رہتا ہے۔ سوچنے والا GLM-5.3 Flash پیچیدہ منطق کے لیے اچھا ہے، مگر اس کے جواب کی حد — 8192 ٹوکن، اور اس کا ایک حصہ سوچ پر خرچ ہوتا ہے — تفصیلات ماڈل ریویو میں۔

بغیر نگرانی رنز۔ goose run اسکرپٹس اور CI کے لیے موزوں ہے: -q فلیگ آؤٹ پٹ میں صرف ماڈل کا جواب رکھتا ہے، --output-format json تجزیے کے لیے نتیجہ دیتا ہے۔ پابندیاں --max-turns (انسان کی شرکت کے بغیر ایجنٹ کتنے مراحل چلتا ہے) اور --max-tool-repetitions (ایک ہی آرگیومنٹس کے ساتھ ایک ٹول لگاتار کتنی بار کال ہو سکتا ہے) لوپ میں پھنسنے سے بچاتی ہیں۔

پرائیویسی۔ Goose میں گمنام استعمال کے اعداد و شمار بطور ڈیفالٹ بند ہیں (GOOSE_TELEMETRY_ENABLED)۔ گیٹ وے پرامپٹس اور جوابات کا مواد محفوظ نہیں کرتا — اعداد و شمار میں صرف خرچ کے مجموعے رہتے ہیں۔