MiMo Code + JoinGonka Gateway: Xiaomi agent sa mga Gonka network models

Hakbang 1: i-install ang MiMo Code. Mga opisyal na paraan mula sa README ng proyekto:

# 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

Inilalagay ng script ang binary sa ~/.mimocode/bin at idinadagdag ang direktoryong ito sa PATH sa pamamagitan ng shell profile (ang --no-modify-path flag ay nagpapatay nito). Dinodownload nito ang build mula sa repository ng Xiaomi; kung hindi mag-download, mag-install sa pamamagitan ng npm — pareho silang release, sa amin ay dumating ang 0.1.15 sa dalawang paraan. Para i-verify — mimo --version.

Hakbang 2: kumuha ng key. Magrehistro sa gate.joingonka.ai/register, i-verify ang address at gumawa ng key na may jg- prefix sa seksyong «Mga API key». Isang key at isang balanse ang gumagana para sa lahat ng modelo ng network.

Hakbang 3: patakbuhin ang installer.

npx @joingonka/setup --tool mimo-code

Tatanungin ng installer ang key — hindi ito ipinapasa sa command-line arguments — at isusulat ang parehong dalawang file na ginagawa ng wizard ng sarili nitong provider sa loob ng MiMo Code, ngunit agad na may buong catalog at limits:

• ire-register ang provider na joingonka sa global config na ~/.config/mimocode/mimocode.jsonc (o sa mimocode.json o config.json, kung doon na nagsusulat ang MiMo Code): adapter na @ai-sdk/openai-compatible, address ng gateway na may /v1 at tatlong modelo ng network na may context windows, response ceilings at tool support;
• ilalagay ang key sa sariling key storage ng MiMo Code — ~/.local/share/mimocode/auth.json na may 600 permissions. Wala ang key sa config mismo, kaya maaari itong itago nang matiwasay sa mga dotfile;
• itakda ang default na modelo — ang model field — sa DeepSeek V4 Flash, pero kung wala pang napili o ang napili ay tumutukoy sa modelong wala na sa network. Hindi nito pinapalitan ang pinili mo, kahit na nasa ibang global config pa ito;
• magse-save ng kopya ng dating mga file, hindi gagalawin ang mga provider, key at comment ng iba, at ang file na hindi mabasa ay hindi i-overwrite — titigil at sasabihin kung ano ang ayusin;
• sa huli, magpapadala ng live na request sa gateway at direktang sasabihin kung tinanggap ang key, address at modelo.

Ang mga hindi karaniwang direktoryo ay awtomatikong isinasaalang-alang ng installer: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME at MIMOCODE_CONFIG. Ang ibang default na modelo ay itinatakda ng --model flag na may shorthand na deepseek, glm o minimax; para sa mga dotfile at server, may mode na walang tanong:

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

Kung tumatakbo ang MiMo Code, i-restart ito: ang bagong provider ay kinukuha sa pagsisimula.

Lahat ng ginagawa ng installer ay maaari mong isulat nang manu-mano. Dalawa lang ang file, at may sariling trabaho ang bawat isa: inilalarawan ng config ang provider at ang mga modelo, hinahawakan ng auth.json ang key. Pinag-uugnay sila ng provider identifier — kailangang magkatugma ang joingonka sa dalawang file. Ang config, ~/.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"
}

Ang key, ~/.local/share/mimocode/auth.json na may pahintulot na 600:

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

Ang default na modelo ay isinusulat bilang provider/model-id; hinihiwalay ang provider sa unang slash, kaya ang mga identifier ng network na may sariling slash ay isinusulat nang buo.

Saan pa maaaring naroon ang key. Ipinapakita rin ng README ng MiMo Code ang variant na may key nang direkta sa config — options.apiKey. Gumagana ito, ngunit madaling ma-commit ang key kasama ng mga dotfile, at ang lumang key na naiwan doon ay sasapaw sa bago mula sa auth.json — kaya inaalis ng installer ang options.apiKey sa block nito. Sa project na .mimocode/mimocode.jsonc, lalo nang huwag maglagay ng key.

Aling file ang pangunahin. Pinagsasama ng MiMo Code ang mga global na config.json, mimocode.json at mimocode.jsonc sa ganitong pagkakasunod-sunod, sinasapawan ng susunod ang nauna. Ang resulta ay ipinapakita ng mimo debug config, at ang mga path sa config at mga key sa iyong system — ng mimo debug paths.

Maaari kang magdagdag ng sariling provider kahit walang mga file — gamit ang built-in wizard. Sa unang pagtakbo sa directory ng proyekto, tinatanong ng MiMo Code kung pinagkakatiwalaan mo ang folder (Yes, I trust this folder): ang agent ay magkakaroon ng karapatang magbasa, mag-edit, at magpatakbo ng mga file sa loob nito. Pagkatapos, ang command na /connect ay magbubukas ng listahan ng Select provider: sa itaas ay ang login para sa Xiaomi MiMo platform, Codex at import mula sa Claude Code, sa ibaba ang catalog ng mga provider, at sa dulo — ang + Custom provider. Ang wizard ay nagtatanong ng anim na bagay:

Sa aming run, isinulat ng wizard ang provider block na may isang model na walang limitasyon at dalawang field na wala sa installer: env na may variable name na JOINGONKA_API_KEY, kung saan hahanapin din ng MiMo Code ang key, at options.setCacheKey: true. Gumagana ito sa gateway, ngunit dapat kumpletuhin ang configuration: kung walang limit, ang mimo models joingonka ay magpapakita ng window na 1M tokens. Pinakamadali na pagkatapos ng wizard, patakbuhin ang installer nang isang beses — idaragdag nito ang buong catalog na may mga limitasyon sa parehong block.

Pagpili ng model. Ang permanenteng pagpili ay sa pamamagitan ng field na model sa config. Sa interface, binabago ang model gamit ang command na /models, at para sa isang beses na run — gamit ang flag na -m. Kung anong mga model ang nakikita ng MiMo Code sa provider at kung anong window ang gamit nito, ipinapakita ng mimo models joingonka — kasama ang threshold kung saan magsisimulang i-compress ng agent ang history:

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

Pare-pareho ang presyo ng lahat ng model sa network, kaya ang pagpili ay tungkol sa behavior. Ganito sila nag-perform sa aming mimo run sa isang gawain — basahin ang file at hanapin ang error:

Bakit DeepSeek V4 Flash ang default, ipinaliwanag sa model review.

Una, tiyakin munang nakikita ng MiMo Code ang provider at ang key:

mimo models joingonka
mimo providers list

Inililista ng unang command ang tatlong modelo ng network kasama ang mga window, tulad ng nasa halimbawa sa itaas; ipinapakita naman ng pangalawa ang path papunta sa key storage at ang linyang joingonka api. Pagkatapos — isang beses na pagpapatakbo. Maglagay ng file na calc.py sa project directory na may malinaw na bug — halimbawa, ang area ng rectangle kung saan pinagsasama ang mga gilid sa halip na i-multiply — at ipahanap ito:

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

Lalabas sa output ang agent at modelo (> build · deepseek-ai/DeepSeek-V4-Flash-0731), ang tool call (→ Read calc.py), at ang tapat na sagot — kasama ang tinutukoy na maling expression. Ginagawang event stream ng flag na --format json ang output, kung saan may token counter ang bawat hakbang, at ang -m joingonka/<model-id> ay nagpapatakbo gamit ang ibang modelo. Sa aming pagpapatakbo, naidaan ng lahat ng tatlong modelo ng network ang cycle na «request → tool call → resulta → sagot».

Ang ikatlong check — mula sa panig ng gateway: sa dashboard, sa seksyong «Usage», lalabas ang request sa breakdown na «By model», at sa bloke na «By key» ay mag-a-update ang oras ng huling request.

Kung may nagkamali, karaniwang mababasa nang diretso mula sa mensahe ang diagnosis:

Ang agent tool ay gumagastos ng tokens nang iba kaysa sa chat: sa bawat pahayag mo, nagdadagdag ang MiMo Code ng system prompt, description ng mga tool, at agent context, at ang task ay tumatagal ng ilang steps. Sa aming run, ang bawat request sa modelo ay nagdadala ng 22-25 libong input tokens, at ang task na "basahin ang file at hanapin ang error" mula sa dalawang steps ay nagkakahalaga ng humigit-kumulang 45-50 libong tokens — halos lahat nito ay input. Kaya ang presyo bawat token dito ay mahalaga.

Sa pamamagitan ng JoinGonka Gateway, ang mga token ay nagkakahalaga ng $0.0069 bawat milyon sa input at $0.021 bawat milyon sa output — ang presyo ay pareho para sa lahat ng modelo ng network at kinuha sa page na ito mula sa isang live source.

Ang mga estimate sa kanang column ay ayon sa presyo noong Setyembre 2026. Bilang paghahambing — paano ka magbabayad para sa mga modelo sa MiMo Code:

Ang sariling estimate ng cost sa MiMo Code para sa gateway models ay zero — walang field na cost sa kanilang records, at sa --format json events ay nakalagay ang "cost": 0. Ang tunay na konsumo at natitirang balanse ay nasa cabinet, sa mga seksyong "Usage" at "Billing".

Mga Pahintulot (Permissions). Sa interface, nagtatanong ang MiMo Code ng kumpirmasyon para sa mga delikadong aksyon, pero sa mimo run ay wala nang mapagtatanungan — kusa nitong tinatanggihan ang pag-access sa labas ng proyekto. Para sa mga pinagkakatiwalaang one-time environments, may flag na --dangerously-skip-permissions (o variable na MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1): pinapayagan nito ang lahat ng hindi ipinagbabawal ng isang explicit na rule — sa loob lamang ng container o sandbox. Sa interface, may katulad na mode para sa tagal ng session gamit ang /skip-permissions.

Mga Agent. Bilang default, gumagana ang build na may kumpletong hanay ng mga tool, ang plan ay nagbabasa at nagsusuri lamang, at ang compose ay nagpapatakbo ng proseso mula sa specification hanggang sa nasuring code; ginagamit ang Tab para lumipat sa kanila.

Mahabang Konteksto (Long Context). Kapag nasa limitasyon na ng window, muling binubuo ng MiMo Code ang konteksto mula sa huling checkpoint, memorya ng proyekto, at mga bagong mensahe; ibinabatay nito ang threshold sa limit.context. Maaaring mag-compress nang mas maaga gamit ang command na /context-limit, nang hiwalay para sa bawat modelo.

Ano ang nakatali sa Xiaomi account. Ang voice input (/voice) ay kumikilala ng pananalita gamit ang modelo ng platform na MiMo at available pagkatapos mag-log in dito. Ang code, mga command, at mga sub-agent ay gumagana sa pamamagitan ng nakakonektang provider — sa aming run, nang walang anumang login.

Mga Larawan. Ang mga modelo ng network ay text-based: sa /modalities, iwanan lang sila ng text, at para sa mga screenshot, mag-set up ng pangalawang provider na may modelong marunong tumingin (vision).

Ang MiMo Code at OpenCode ay magkamag-anak na may magkaibang settings. May kanya-kanya silang mga directory at file, kaya ang setting ng isa ay hindi naipapasa sa isa pa:

Bersyon. Madalas mag-update ang proyekto; para sa reproducibility, i-fix ito: npm install -g @mimo-ai/[email protected] o curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Mayroon ding mga agent mula sa mismong mga laboratoryo para sa mga pamilyang pinagsisilbihan ng network: ang MiniMax Code ay gumagana sa modelo ng vendor nitong MiniMax M2.7, may kanya-kanya ring agent ang DeepSeek at Z.ai, ang mga awtor ng GLM. Lahat sila ay kumokonekta sa iisang gateway gamit ang iisang susi.