Crush + JoinGonka Gateway: Gonka نیٹ ورک کے ماڈلز پر Charm ایجنٹ

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

# Homebrew
brew install charmbracelet/tap/crush

# npm
npm install -g @charmland/crush

# Arch Linux
yay -S crush-bin

# Windows
winget install charmbracelet.crush

# Go
go install github.com/charmbracelet/crush@latest

وہیں Debian، Ubuntu، Fedora اور RHEL، Nix اور Scoop کے پیکیج ریپوزٹریز کا بھی ذکر ہے، اور ریلیز صفحے پر تیار بائنریز موجود ہیں۔ تصدیق کے لیے — crush --version، جواب میں crush version v0.96.1 جیسی لائن آئے گی۔

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

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

npx @joingonka/setup --tool crush

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

• ~/.config/crush/crush.json میں joingonka پرووائیڈر لکھے گا: ٹائپ openai-compat، گیٹ وے کا پتہ، کلید براہِ راست اور نیٹ ورک کے تین ماڈلز کانٹیکسٹ ونڈوز، جواب کی حد اور فی ملین ٹوکن قیمتوں کے ساتھ، جو وہ انسٹال کے وقت ہی گیٹ وے سے لائیو لیتا ہے — انہی کی بنیاد پر Crush سیشن کی لاگت شمار کرتا ہے۔ فائل کو 600 کی اجازتیں ملیں گی؛
• ماڈلز مقرر کرے گا: large سلاٹ میں — DeepSeek V4 Flash، small میں — MiniMax M2.7، جبکہ GLM-5.3 Flash دستی انتخاب کی فہرست میں رہے گا۔ یہ وہ صرف اسی صورت کرے گا جب large سلاٹ خالی ہو یا نیٹ ورک سے نکل چکے ہمارے کسی ماڈل کی طرف اشارہ کرے؛ کسی اور کا انتخاب برقرار رہے گا، اور آؤٹ پٹ میں سوئچ کرنے کا طریقہ بتانے والا اشارہ ہوگا؛
• جانچے گا کہ انتخاب مؤثر ہوگا: Crush انٹرفیس سے چنا گیا ماڈل اسٹیٹ فائل میں رہتا ہے، اور وہی کنفگ کو اوور رائیڈ کرتا ہے، — یہی large اور small والے حصے کا موضوع ہے؛
• بیک اپ بنائے گا، باقی پرووائیڈرز اور سیٹنگز ویسے ہی رہنے دے گا اور گیٹ وے پر ایک لائیو درخواست کے ساتھ اختتام کرے گا، تاکہ فوراً کلید، پتہ اور ماڈل جانچ لیے جائیں۔

دوسرا ماڈل --model فلیگ سے دیا جاتا ہے، مخفف deepseek، glm یا minimax کے ساتھ؛ واضح طور پر بتایا گیا ماڈل ہمیشہ لکھا جاتا ہے۔ غیر معیاری ڈائریکٹریز انسٹالر بالکل Crush کی طرح مدنظر رکھتا ہے: کنفگ کے لیے CRUSH_GLOBAL_CONFIG، اسٹیٹ فائل کے لیے CRUSH_GLOBAL_DATA، نیز XDG_CONFIG_HOME اور XDG_DATA_HOME۔ سرورز اور اسکرپٹس کے لیے بغیر سوال والا موڈ موجود ہے، اس میں کلید ماحولیاتی ویری ایبل سے لی جاتی ہے:

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

Crush کی بنیادی فارمیٹ اب crushrc ہے، مگر انسٹالر crush.json لکھتا ہے: اسے تمام ورژن سمجھتے ہیں۔ اگر آپ کے پاس crushrc پہلے سے موجود ہے تو Crush دونوں فائلیں یکجا کر دے گا، کلیدوں کے ٹکرانے پر crushrc جیت جائے گا، اور انسٹالر اسے چھوتا تک نہیں۔

انسٹالر جو کچھ کرتا ہے، وہ سب ہاتھ سے لکھا جا سکتا ہے۔ یہاں ایک کام کرنے والی ~/.config/crush/crush.json موجود ہے — یہ فائل ہم نے گیٹ وے سے گزار کر دیکھی:

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "joingonka": {
      "name": "JoinGonka (Gonka)",
      "type": "openai-compat",
      "base_url": "https://gate.joingonka.ai/v1",
      "api_key": "jg-your-key",
      "models": [
        { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash (Gonka)",
          "context_window": 380000, "default_max_tokens": 32768,
          "can_reason": true, "supports_attachments": false },
        { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7 (Gonka)",
          "context_window": 200000, "default_max_tokens": 8192,
          "can_reason": false, "supports_attachments": false },
        { "id": "zai-org/GLM-5.3-Flash", "name": "GLM-5.3 Flash (Gonka)",
          "context_window": 390000, "default_max_tokens": 8192,
          "can_reason": true, "supports_attachments": false }
      ]
    }
  },
  "models": {
    "large": { "provider": "joingonka", "model": "deepseek-ai/DeepSeek-V4-Flash-0731" },
    "small": { "provider": "joingonka", "model": "MiniMaxAI/MiniMax-M2.7" }
  }
}

Crush صرف سخت JSON قبول کرتا ہے: ایک تبصرہ یا ٹریلنگ کاما — اور وہ اسٹارٹ نہیں ہوگا۔ قیمت کے فیلڈز (cost_per_1m_in، cost_per_1m_out اور کیش کے لیے دو فیلڈز) صرف لاگت کے کاؤنٹر کے لیے ضروری ہیں: انسٹالر وہاں گیٹ وے کی لائیو قیمت لکھ دیتا ہے، اور ان کے بغیر Crush چلتا رہتا ہے اور صفر دکھاتا ہے — صرف $schema کے اسکیما والا ایڈیٹر انہیں لازمی کے طور پر نمایاں کرے گا۔

crushrc فارمیٹ میں وہی پرووائیڈر — یہ Crush کے بلٹ اِن کمانڈز کے ساتھ عام Bash ہے۔ فائل ~/.config/crush/crushrc:

provider add joingonka \
  --name "JoinGonka (Gonka)" \
  --type openai-compat \
  --base-url "https://gate.joingonka.ai/v1" \
  --api-key "${JOINGONKA_API_KEY:?set JOINGONKA_API_KEY}"

model add joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 \
  --name "DeepSeek V4 Flash (Gonka)" \
  --context-window 380000 --default-max-tokens 32768 --can-reason true

model add joingonka/MiniMaxAI/MiniMax-M2.7 \
  --name "MiniMax M2.7 (Gonka)" \
  --context-window 200000 --default-max-tokens 8192

model add joingonka/zai-org/GLM-5.3-Flash \
  --name "GLM-5.3 Flash (Gonka)" \
  --context-window 390000 --default-max-tokens 8192 --can-reason true

model large joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
model small joingonka/MiniMaxAI/MiniMax-M2.7

یہاں ماڈل کو provider/model-id کی شکل میں پکارا جاتا ہے: پہلے سلیش سے پہلے پرووائیڈر کا نام، اس کے بعد نیٹ ورک کی شناخت جوں کی توں۔ ${JOINGONKA_API_KEY:?…} کی شکل کلید کو فائل سے باہر رکھتی ہے، مگر ایکسپورٹ شدہ ویری ایبل کے بغیر Crush اسٹارٹ نہیں ہوتا — خالی کلید سے درخواستیں بھیجنے سے بہتر ہے کہ شروع ہی میں خرابی آ جائے۔

Crush میں ماڈل ایک ہی بار سب کے لیے منتخب نہیں ہوتا، بلکہ دو سلاٹس کے لیے الگ الگ ہوتا ہے:

نیٹ ورک کا تیسرا ماڈل، ریزننگ GLM-5.3 Flash، پیچیدہ منطق (logic) کے لیے منتخب کیا جاتا ہے، یہ یاد رکھتے ہوئے کہ اس کی رسپانس سیلنگ 8192 ہے اور اس کا کچھ حصہ ریزننگ میں خرچ ہوتا ہے — تفصیلات ماڈل کے جائزے میں ملاحظہ کریں۔ ہر بار چلانے کے لیے ماڈل کا پورا نام دیا جاتا ہے: crush run -m joingonka/zai-org/GLM-5.3-Flash "…"۔ تمام دستیاب نام دیکھنے کے لیے crush models joingonka استعمال کریں۔

اسٹیٹ فائل۔ ctrl+l کے ذریعے انٹرفیس میں منتخب کردہ ماڈل کو Crush crush.json میں نہیں بلکہ مشین اسٹیٹ فائل میں لکھتا ہے: ~/.local/share/crush/crush.json، Windows میں — %LOCALAPPDATA%\crush\crush.json۔ یہ فائل صارف کی کنفیگ اور crushrc دونوں سے زیادہ اہم ہے: Crush انہیں اس ترتیب سے پڑھتا ہے /etc/crush/crush.json → ~/.config/crush/crush.json → ~/.config/crush/crushrc → اسٹیٹ فائل، اور ہر اگلی فائل پچھلی پر فوقیت رکھتی ہے۔ ان سے اوپر صرف پروجیکٹ کی سیٹنگز ہوتی ہیں—اسی ڈائریکٹری میں موجود crush.json یا crushrc۔ آپ کی مشین پر فائلیں کہاں ہیں، یہ crush dirs دکھائے گا۔

ہمارے رن میں، ہم نے ماڈل سلیکشن کھولا—پرووائیڈر "JoinGonka (Gonka)" وہاں "✓ Configured" نشان کے ساتھ موجود ہے—اور MiniMax M2.7 کو منتخب کیا۔ Crush نے جواب دیا "Large model changed to MiniMax M2.7 (Gonka)" اور اسٹیٹ فائل میں درج کیا:

{"models":{"large":{"model":"MiniMaxAI/MiniMax-M2.7","provider":"joingonka","max_tokens":8192}}, …}

اب یہ ماڈل crush.json میں لکھی ہوئی چیز سے زیادہ اہم ہے۔ انسٹالر اس صورتحال کو پہچانتا ہے اور مختلف طریقے سے کام کرتا ہے:

• بغیر --model کے: یہ اسٹیٹ فائل کو نہیں چھیڑتا—یہ آپ کا منتخب کردہ کام ہے—لیکن واضح طور پر خبردار کرتا ہے کہ Crush درحقیقت کس ماڈل کے ساتھ شروع ہوگا: Heads-up: Crush will still start with joingonka/MiniMaxAI/MiniMax-M2.7, not joingonka/deepseek-ai/DeepSeek-V4-Flash-0731۔ یہی عمل ہوگا اگر انٹرفیس میں GLM-5.3 Flash یا کسی اور پرووائیڈر کا ماڈل منتخب ہو۔
• واضح --model کے ساتھ: یہ اسٹیٹ فائل میں صرف ایک انٹری—models.large—درست کرتا ہے، پہلے ایک کاپی محفوظ کرتا ہے، اور لکھتا ہے کہ پہلے کیا تھا اور اب کیا ہو گیا ہے۔ بصورت دیگر فلیگ خاموشی سے اثر نہ کرتا۔ اس طرح کے لانچ کے بعد Crush ہمارے رن میں فلیگ میں بتائے گئے ماڈل پر کھلا۔

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

crush models joingonka

جواب میں تین لائنیں آئیں گی:

joingonka/MiniMaxAI/MiniMax-M2.7
joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
joingonka/zai-org/GLM-5.3-Flash

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

crush run -q "Read calc.py and tell me in one sentence whether it has a bug."

ایجنٹ کو خود ہی فائل پڑھنے کا ٹول کال کرنا چاہیے اور لائن نمبر کے ساتھ اصل بات بتانی چاہیے۔ ہمارے رن میں تینوں ماڈلز نے خرابی پکڑی، کام میں 20-40 سیکنڈ لگے۔ -q فلیگ انتظار کا انڈیکیٹر چھپا دیتا ہے۔ crush run موڈ میں تمام ٹول کالز خودکار طور پر منظور ہو جاتی ہیں، اس لیے اسے اپنے پروجیکٹ میں چلائیں۔ عام انٹرفیس میں (crush کمانڈ) فعال ماڈل اسٹیٹس لائن میں نظر آتا ہے: ◇ DeepSeek V4 Flash (Gonka) via JoinGonka (Gonka)۔ Crush سیشنز اور لاگ پروجیکٹ کی .crush ڈائریکٹری میں رکھتا ہے، جو اپنے .gitignore سے git سے چھپی رہتی ہے؛ لاگ دکھانے کے لیے crush logs۔ گیٹ وے کی طرف سے درخواست ڈیش بورڈ میں نظر آتی ہے: "استعمال" سیکشن، "ماڈل کے مطابق" اور "کی کے مطابق" تقسیم۔

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

ایجنٹ چیٹ کے مقابلے میں ٹوکن مختلف طریقے سے خرچ کرتا ہے: آپ کے ہر جملے کے ساتھ Crush سسٹم پرامپٹ اور اپنے ٹولز کی تفصیلات شامل کرتا ہے، اور کسی کام کو مکمل کرنے میں عام طور پر چند موڑ لگتے ہیں۔ ہماری رن میں، ماڈل کی ہر درخواست میں تقریباً 11.5 ہزار ان پٹ ٹوکن تھے، اور "فائل پڑھنا اور غلطی ڈھونڈنا" کام میں دو-تین درخواستیں اور 23-35 ہزار ٹوکن لگے، جس میں تقریباً سارا ان پٹ تھا۔ اس لیے ٹوکن کی قیمت یہاں اہم ہے۔

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

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

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

اجازتیں۔ Crush کا انٹرفیس بطور ڈیفالٹ کسی بھی ٹول کو کال کرنے سے پہلے اجازت مانگتا ہے۔ --yolo فلیگ ایک ہی بار میں تمام سوالات بند کر دیتا ہے، جبکہ مخصوص طور پر قابلِ اعتماد ٹولز کنفگ میں درج کیے جاتے ہیں:

# crushrc
permissions allow view ls grep

# crush.json
"permissions": { "allowed_tools": ["view", "ls", "grep"] }

یاد رہے کہ crush run خود ہی سب کچھ منظور کر لیتا ہے۔ یہ Crush کی خصوصیت ہے، ماڈل فراہم کنندہ پر اس کا انحصار نہیں۔

درخواست کا ٹائم آؤٹ۔ اگر ماڈل سے طویل عرصے تک جواب کا کوئی حصہ نہ آئے تو Crush درخواست منقطع کر دیتا ہے: ورژن 0.96.1 میں یہ دو منٹ کی خاموشی ہے (دستاویزات 60 سیکنڈ بتاتی ہیں، مگر کوڈ اور ہمارے ٹیسٹ میں دو منٹ ہے)۔ وہ سروس پنگز جن سے گیٹ وے کنکشن برقرار رکھتا ہے، یہ کاؤنٹر ری سیٹ نہیں کرتیں — ہم نے لوکل اسٹینڈ پر تصدیق کی۔ دوسری طرف گیٹ وے مصروف اوقات میں نیٹ ورک سے پہلے ٹوکن کے لیے 150 سیکنڈ تک انتظار کرتا ہے، لہٰذا بفر بڑھا دینا چاہیے:

# crushrc
option request-timeout 300

# crush.json
"options": { "request_timeout": 300 }

کمٹس میں دستخط۔ Crush جو کمٹس اور پل ریکویسٹس بناتا ہے، انہیں بطور ڈیفالٹ Assisted-by: Crush:<model> لائن اور «Generated with Crush» کا اضافہ ملتا ہے۔ اگر یہ نہ چاہیں:

# crushrc
option attribution-trailer-style none
option attribution-generated-with false

# crush.json
"options": { "attribution": { "trailer_style": "none", "generated_with": false } }

میٹرکس۔ Crush ڈیویلپرز کو فرضی نام کے ساتھ استعمال کے اعداد و شمار بھیجتا ہے — صرف میٹا ڈیٹا، پرامپٹس یا جوابات کے بغیر۔ CRUSH_DISABLE_METRICS=1 یا DO_NOT_TRACK=1 ویری ایبل سے بند ہو جاتا ہے۔ گیٹ وے اپنی طرف سے پرامپٹس اور جوابات کا مواد محفوظ نہیں کرتا — اعداد و شمار میں صرف خرچ کے مجموعی اعداد رہتے ہیں۔

کنفگ ہی کوڈ ہے۔ Crush آپ کے شیل کے اختیارات کے ساتھ crushrc اور crush.json دونوں چلاتا ہے: کلید کے فیلڈ میں $(…) لوڈ ہوتے وقت چلے گا، اور پروجیکٹ کا crushrc اس ڈائریکٹری میں آپ کے Crush کھولتے ہی فعال ہو جائے گا۔ کسی اور کے ریپوزٹری میں اس کی کنفگ پڑھے بغیر ایجنٹ نہ چلائیں۔