MiMo Code + JoinGonka Gateway: Gonka نیٹ ورک ماڈلز پر Xiaomi ایجنٹ

پہلا قدم: MiMo Code انسٹال کریں۔ پروجیکٹ کے README سے سرکاری طریقے:

# macOS and Linux
curl -fsSL https://mimo.xiaomi.com/install | bash

# Windows (PowerShell)
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

# via npm, on any system
npm install -g @mimo-ai/cli

اسکرپٹ بائنری کو ~/.mimocode/bin میں رکھتا ہے اور شیل پروفائل کے ذریعے اس ڈائریکٹری کو PATH میں شامل کرتا ہے (--no-modify-path فلیگ اسے بند کر دیتا ہے)۔ یہ بلڈ Xiaomi کے ریپوزٹری سے ڈاؤن لوڈ کرتا ہے؛ اگر ڈاؤن لوڈ نہ ہو تو npm سے انسٹال کریں — یہی ریلیز ہے، ہمارے پاس دونوں طریقوں سے 0.1.15 آئی۔ تصدیق کریں — mimo --version۔

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

تیسرا قدم: انسٹالر چلائیں۔

npx @joingonka/setup --tool mimo-code

انسٹالر کلید پوچھے گا — کمانڈ لائن آرگیومنٹس میں یہ نہیں بھیجی جاتی — اور وہی دو فائلیں لکھے گا جو MiMo Code میں خود اس کے پرووائیڈر وزرڈ نے لکھی تھیں، بس فوراً مکمل کیٹلاگ اور حدود کے ساتھ:

• گلوبل کنفگ ~/.config/mimocode/mimocode.jsonc میں (یا mimocode.json یا config.json میں، اگر MiMo Code پہلے سے وہاں لکھ رہا ہو) پرووائیڈر joingonka لکھے گا: اڈاپٹر @ai-sdk/openai-compatible، /v1 کے ساتھ گیٹ وے کا پتہ اور کانٹیکسٹ ونڈوز، جواب کی حدوں اور ٹول سپورٹ کے ساتھ نیٹ ورک کے تین ماڈلز؛
• کلید کو MiMo Code کے اپنے کلید اسٹور میں رکھے گا — ~/.local/share/mimocode/auth.json، 600 اجازتوں کے ساتھ۔ کنفگ میں خود کلید نہیں ہوتی، اس لیے اسے بے فکر ہو کر ڈاٹ فائلوں میں رکھا جا سکتا ہے؛
• ڈیفالٹ ماڈل — model فیلڈ — کو DeepSeek V4 Flash پر سیٹ کرے گا، لیکن صرف اسی صورت میں جب یہ منتخب نہ ہو یا کسی ایسے ماڈل کی طرف اشارہ کرے جو نیٹ ورک سے نکل چکا ہو۔ آپ کا کیا ہوا انتخاب، خواہ کسی دوسری گلوبل کنفگ میں ہو، یہ اوور رائیڈ نہیں کرتا؛
• پچھلی فائلوں کی کاپیاں محفوظ کرے گا، دوسروں کے پرووائیڈرز، کلیدوں اور کمنٹس کو نہیں چھوئے گا، اور جو فائل پارس نہ ہو سکے اسے دوبارہ نہیں لکھے گا — رک جائے گا اور بتائے گا کہ کیا درست کرنا ہے؛
• آخر میں گیٹ وے پر ایک لائیو درخواست بھیجے گا اور صاف بتائے گا کہ کلید، پتہ اور ماڈل قبول ہوئے یا نہیں۔

غیر معمولی ڈائریکٹریاں انسٹالر خود مدنظر رکھتا ہے: MIMOCODE_HOME، XDG_CONFIG_HOME، XDG_DATA_HOME اور MIMOCODE_CONFIG۔ --model فلیگ deepseek، glm یا minimax کے اختصار کے ساتھ کوئی اور ڈیفالٹ ماڈل مقرر کرتا ہے؛ ڈاٹ فائلوں اور سرورز کے لیے بغیر سوال کا موڈ موجود ہے:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool mimo-code --non-interactive

اگر MiMo Code چل رہا تھا تو اسے دوبارہ شروع کریں: نیا پرووائیڈر آغاز پر لوڈ ہوتا ہے۔

انسٹالر جو کچھ کرتا ہے، وہ سب ہاتھ سے لکھا جا سکتا ہے۔ فائلیں دو ہیں، اور ہر ایک کا اپنا کام ہے: کنفگ پرووائیڈر اور ماڈلز بیان کرتا ہے، auth.json کلید محفوظ رکھتا ہے۔ دونوں کو جوڑنے کا ذریعہ پرووائیڈر آئیڈنٹیفائر ہے — joingonka دونوں فائلوں میں یکساں ہونا چاہیے۔ کنفگ، ~/.config/mimocode/mimocode.jsonc:

{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": {
        "baseURL": "https://gate.joingonka.ai/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek V4 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 380000, "output": 32768 }
        },
        "zai-org/GLM-5.3-Flash": {
          "name": "GLM 5.3 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 390000, "output": 8192 }
        },
        "MiniMaxAI/MiniMax-M2.7": {
          "name": "MiniMax M2.7 (Gonka)",
          "tool_call": true,
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    }
  },
  "model": "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"
}

کلید، ~/.local/share/mimocode/auth.json، پرمیشنز 600 کے ساتھ:

{
  "joingonka": { "type": "api", "key": "jg-your-key" }
}

ڈیفالٹ ماڈل provider/model-id کے طور پر لکھا جاتا ہے؛ پرووائیڈر پہلے سلیش پر الگ ہوتا ہے، اس لیے اپنے سلیش والے نیٹ ورک آئیڈنٹیفائر جوں کے توں لکھے جاتے ہیں۔

کلید اور کہاں رہ سکتی ہے۔ MiMo Code کا README کنفگ میں ہی کلید رکھنے کا طریقہ بھی دکھاتا ہے — options.apiKey۔ یہ کام کرتا ہے، لیکن پھر کلید ڈاٹ فائلز کے ساتھ آسانی سے کمیٹ ہو سکتی ہے، اور وہاں بھولا ہوا پرانا کلید auth.json والی نئی کلید کو ڈھک دے گا — اسی لیے انسٹالر اپنے بلاک سے options.apiKey ہٹا دیتا ہے۔ پروجیکٹ کی .mimocode/mimocode.jsonc میں تو کلید رکھیں ہی نہیں۔

کون سی فائل بنیادی ہے۔ گلوبل config.json، mimocode.json اور mimocode.jsonc کو MiMo Code اسی ترتیب سے merge کرتا ہے، اگلی پچھلی کو ڈھک دیتی ہے۔ نتیجہ mimo debug config پرنٹ کرتا ہے، اور آپ کے سسٹم پر کنفگ اور کلیدوں کے راستے — mimo debug paths۔

آپ بلٹ اِن وزرڈ کا استعمال کرتے ہوئے فائلوں کے بغیر بھی اپنا پرووائیڈر سیٹ اپ کر سکتے ہیں۔ پہلی بار MiMo Code میں پروجیکٹ ڈائرکٹری کھولتے وقت، یہ پوچھے گا کہ کیا آپ اس فولڈر پر اعتماد کرتے ہیں (Yes, I trust this folder): ایجنٹ کو اس میں فائلیں پڑھنے، ترمیم کرنے اور چلانے کا حق حاصل ہوگا۔ اس کے بعد /connect کمانڈ Select provider کی فہرست کھولتی ہے: اوپر Xiaomi MiMo پلیٹ فارم، Codex اور Claude Code سے امپورٹ کے آپشنز ہوں گے، نیچے پرووائیڈرز کی کیٹلاگ، اور آخر میں + Custom provider ہوگا۔ وزرڈ چھ سوالات پوچھتا ہے:

ہمارے رن میں، وزرڈ نے بغیر کسی حد کے ایک ماڈل کے ساتھ پرووائیڈر بلاک ریکارڈ کیا اور دو اضافی فیلڈز شامل کیں جو انسٹالر استعمال نہیں کرتا: env کے ساتھ JOINGONKA_API_KEY متغیر نام، جہاں MiMo Code کلید تلاش کرے گا، اور options.setCacheKey: true۔ یہ گیٹ وے کے ساتھ کام کرتا ہے، لیکن کنفیگریشن کو مکمل کرنا بہتر ہے: limit کے بغیر mimo models joingonka 1M ٹوکن کی ونڈو دکھائے گا۔ وزرڈ کے بعد انسٹالر کو ایک بار چلانا آسان ہے - یہ اسی بلاک میں حدود کے ساتھ مکمل کیٹلاگ شامل کر دے گا۔

ماڈل کا انتخاب۔ کنفیگ میں مستقل انتخاب کے لیے فیلڈ model ہے۔ انٹرفیس میں، ماڈل /models کمانڈ سے تبدیل کیا جاتا ہے، ایک وقتی رن کے لیے -m فلیگ استعمال ہوتا ہے۔ MiMo Code پرووائیڈر کے کون سے ماڈل دیکھتا ہے اور کس ونڈو کے ساتھ کام کرتا ہے، یہ mimo models joingonka دکھاتا ہے — اس تھریش ہولڈ کے ساتھ جہاں ایجنٹ ہسٹری کو کمپریس کرنا شروع کرے گا:

joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 — window 380K, compacts at 342K
joingonka/MiniMaxAI/MiniMax-M2.7 — window 200K, compacts at 180K
joingonka/zai-org/GLM-5.3-Flash — window 390K, compacts at 351K

نیٹ ورک کے تمام ماڈلز کی قیمت ایک ہی ہے، لہذا انتخاب رویے کے بارے میں ہے۔ ہمارے mimo run ٹیسٹ میں ایک ٹاسک (فائل پڑھنا اور غلطی تلاش کرنا) پر ان کی کارکردگی یہ تھی:

DeepSeek V4 Flash کو ڈیفالٹ کے طور پر کیوں منتخب کیا گیا ہے، یہ ماڈل ریویو میں بیان کیا گیا ہے۔

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

mimo models joingonka
mimo providers list

پہلا کمانڈ اوپر کی مثال کی طرح ونڈوز کے ساتھ نیٹ ورک کے تین ماڈلز کی فہرست دیتا ہے؛ دوسرا کلیدوں کے ذخیرے کا راستہ اور joingonka api لائن پرنٹ کرتا ہے۔ پھر — ایک بار چلائیں۔ پروجیکٹ ڈائریکٹری میں واضح خرابی والی calc.py فائل رکھیں — مثلاً مستطیل کا رقبہ، جہاں اضلاع کو ضرب دینے کے بجائے جمع کیا جاتا ہے — اور اسے تلاش کرنے کو کہیں:

mimo run "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

آؤٹ پٹ میں ایجنٹ اور ماڈل (> build · deepseek-ai/DeepSeek-V4-Flash-0731)، ٹول کال (→ Read calc.py) اور اصل معاملے پر جواب نظر آئے گا — غلط اظہار کی نشاندہی کے ساتھ۔ --format json فلیگ آؤٹ پٹ کو ایونٹس کے سلسلے میں بدل دیتا ہے، جہاں ہر مرحلے پر ٹوکن کاؤنٹر ہوتا ہے، اور -m joingonka/<model-id> کسی دوسرے ماڈل پر چلانے کا آغاز کرتا ہے۔ ہمارے رن میں «درخواست → ٹول کال → نتیجہ → جواب» کا چکر نیٹ ورک کے تینوں ماڈلز نے مکمل کیا۔

تیسرا معائنہ — گیٹ وے کی طرف سے: ڈیش بورڈ میں «استعمال» کے سیکشن میں درخواست «ماڈل کے مطابق» بریک ڈاؤن میں ظاہر ہوگی، اور «کلیدوں کے مطابق» بلاک میں آخری درخواست کا وقت اپ ڈیٹ ہوگا۔

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

ایجنٹ ٹول چیٹ کے مقابلے میں مختلف طریقے سے ٹوکن خرچ کرتا ہے: ہر جملے کے ساتھ MiMo Code ایک سسٹم پرامپٹ، ٹولز کی تفصیل اور ایجنٹ کا سروس کانٹیکسٹ شامل کرتا ہے، اور کام مکمل کرنے کے لیے کئی مراحل کی ضرورت ہوتی ہے۔ ہمارے رن میں، ماڈل کی ہر درخواست نے 22-25 ہزار ان پٹ ٹوکن استعمال کیے اور "فائل پڑھنا اور غلطی تلاش کرنا" کا کام دو مراحل میں تقریباً 45-50 ہزار ٹوکن کا پڑا — جس کا زیادہ تر حصہ ان پٹ ہے۔ اس لیے یہاں فی ٹوکن قیمت اہم ہے۔

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

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

گیٹ وے ماڈلز کے لیے MiMo Code میں اپنی قیمت صفر سمجھی جاتی ہے — ان کے ریکارڈ میں کوئی cost فیلڈ نہیں ہے، اور --format json ایونٹس میں "cost": 0 ہوتا ہے۔ اصل خرچ اور بیلنس اکاؤنٹ کے "استعمال" (Usage) اور "بلنگ" (Billing) سیکشن میں دیکھا جا سکتا ہے۔

اجازات (Permissions). MiMo Code انٹرفیس میں خطرناک اقدامات کے لیے تصدیق مانگتا ہے، لیکن mimo run میں پوچھنے والا کوئی نہیں ہے — اس لیے پروجیکٹ سے باہر رسائی کی درخواست وہ خود مسترد کر دیتا ہے۔ قابل اعتماد ون ٹائم ماحول کے لیے --dangerously-skip-permissions فلیگ (یا MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1 ویری ایبل) موجود ہے: یہ ہر اس چیز کی اجازت دیتا ہے جو کسی واضح اصول سے منع نہ ہو — صرف کنٹینر یا سینڈ باکس کے اندر۔ انٹرفیس میں سیشن کے دوران اسی طرح کا موڈ /skip-permissions کے ذریعے آن کیا جا سکتا ہے۔

ایجنٹس (Agents). ڈیفالٹ طور پر build مکمل ٹول سیٹ کے ساتھ کام کرتا ہے، plan صرف پڑھتا اور تجزیہ کرتا ہے، compose تفصیلات سے لے کر تصدیق شدہ کوڈ تک پورے عمل کی نگرانی کرتا ہے؛ Tab کے ذریعے ان کے درمیان سوئچ کیا جا سکتا ہے۔

طویل تناظر (Long context). کانٹیکسٹ ونڈو کی حد کے قریب پہنچنے پر MiMo Code آخری چیک پوائنٹ، پروجیکٹ میموری اور تازہ پیغامات سے کانٹیکسٹ کو دوبارہ جوڑتا ہے؛ یہ حد limit.context سے گنتی ہے۔ /context-limit کمانڈ کے ذریعے ہر ماڈل کے لیے الگ سے پہلے ہی کمپریس کیا جا سکتا ہے۔

Xiaomi اکاؤنٹ سے منسلک کیا ہے۔ وائس ان پٹ (/voice) MiMo پلیٹ فارم کے ماڈل کے ذریعے اسپیچ کو پہچانتا ہے اور اس میں لاگ ان کے بعد دستیاب ہوتا ہے۔ کوڈ، کمانڈز اور سب ایجنٹس منسلک پرووائیڈر کے ذریعے کام کرتے ہیں — ہماری رن میں بغیر کسی لاگ ان کے یہ ممکن ہوا ہے۔

تصاویر۔ نیٹ ورک کے ماڈل ٹیکسٹ پر مبنی ہیں: /modalities میں ان کے لیے صرف ٹیکسٹ رکھیں، اور اسکرین شاٹس کے لیے ویژن سپورٹ والے ماڈل کا حامل دوسرا پرووائیڈر استعمال کریں۔

MiMo Code اور OpenCode — مختلف سیٹنگز والے رشتے دار۔ ان کی ڈائریکٹریاں اور فائلیں الگ ہیں، اس لیے ایک کی سیٹنگ دوسرے پر منتقل نہیں ہوتی:

ورژن۔ پروجیکٹ اکثر اپ ڈیٹ ہوتا ہے؛ ری پروڈیوسیبلٹی کے لیے اسے فکس رکھیں: npm install -g @mimo-ai/[email protected] یا curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15۔

نیٹ ورک کے ذریعے چلنے والی فیملیز کے لیے لیبارٹریز کے اپنے ایجنٹس بھی موجود ہیں: MiniMax Code اپنے وینڈر MiniMax M2.7 ماڈل پر کام کرتا ہے، DeepSeek اور GLM کے تخلیق کاروں Z.ai کے اپنے ایجنٹس ہیں۔ یہ سب ایک ہی کی (key) کے ساتھ ایک ہی گیٹ وے سے منسلک ہوتے ہیں۔