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-এ joingonka প্রোভাইডার লিখবে (অথবা mimocode.json বা config.json-এ, যদি MiMo Code ইতিমধ্যেই সেখানে লিখে থাকে): অ্যাডাপ্টার @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 এই ক্রমে মার্জ করে, পরেরটি আগেরটিকে ঢেকে দেয়। ফলাফল প্রিন্ট করে 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 ১ মিলিয়ন টোকেনের একটি উইন্ডো দেখাবে। উইজার্ডের পর একবার ইন্সটলার রান করাই সহজ - এটি একই ব্লকে লিমিটসহ সম্পূর্ণ ক্যাটালগ যোগ করে দেবে।

মডেল সিলেকশন। কনফিগে পার্মানেন্ট সিলেকশনের জন্য ফিল্ড হলো 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 একটি সিস্টেম প্রম্পট, টুলের বর্ণনা এবং এজেন্টের সার্ভিস কনটেক্সট যোগ করে, এবং টাস্কটি সম্পন্ন করতে বেশ কয়েকটি ধাপের প্রয়োজন হয়। আমাদের রানে, মডেলের প্রতি রিকোয়েস্ট ২০-২৫ হাজার ইনপুট টোকেন বহন করেছে এবং "ফাইল পড়া ও ভুল খোঁজা" টাস্কটি দুই ধাপে সম্পন্ন করতে প্রায় ৪৫-৫০ হাজার টোকেন খরচ হয়েছে — যার প্রায় সবটুকুই ইনপুট। তাই এখানে প্রতি টোকেনের দাম গুরুত্বপূর্ণ।

JoinGonka Gateway-এর মাধ্যমে টোকেনের দাম ইনপুটের ক্ষেত্রে প্রতি মিলিয়নে $0.0069 এবং আউটপুটের ক্ষেত্রে প্রতি মিলিয়নে $0.021 — এই দাম নেটওয়ার্কের সব মডেলের জন্য একই এবং এই পৃষ্ঠায় লাইভ সোর্স থেকে নেওয়া হয়েছে।

ডানদিকের কলামের হিসাবগুলো ২০২৬ সালের সেপ্টেম্বরের দাম অনুযায়ী। তুলনার জন্য — 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) দিয়ে একই গেটওয়েতে কানেক্ট হয়।