MiMo Code + JoinGonka Gateway: Gonka ağ modellerinde Xiaomi ajanı

Adım 1: MiMo Code'u kurun. Projenin README dosyasındaki resmi yöntemler:

# 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

Betik, ikili dosyayı ~/.mimocode/bin dizinine kurar ve bu dizini kabuk profili üzerinden PATH'e ekler (--no-modify-path bayrağı bunu devre dışı bırakır). Derlemeyi Xiaomi deposundan indirir; indirme gerçekleşmezse npm üzerinden kurun – aynı sürümdür, bizde her iki yoldan da 0.1.15 geldi. Kontrol – mimo --version.

Adım 2: Anahtar alın. gate.joingonka.ai/register adresinden kaydolun, adresinizi doğrulayın ve „API anahtarları" bölümünde jg- önekli bir anahtar oluşturun. Tek anahtar ve tek bakiye, ağdaki tüm modeller için geçerlidir.

Adım 3: Kurulum betiğini çalıştırın.

npx @joingonka/setup --tool mimo-code

Kurulum betiği anahtarı sorar – komut satırı argümanı olarak iletilmez – ve MiMo Code'un kendi sağlayıcı sihirbazının yazdığı iki dosyanın aynısını yazar, ancak hemen tam katalog ve limitlerle:

• joingonka sağlayıcısını genel yapılandırma dosyasına ~/.config/mimocode/mimocode.jsonc ekler (ya da MiMo Code zaten oraya yazıyorsa mimocode.json veya config.json dosyasına): @ai-sdk/openai-compatible adaptörü, /v1 içeren ağ geçidi adresi ve bağlam pencereleri, yanıt üst sınırları ve araç desteğiyle ağın üç modeli;
• anahtarı MiMo Code'un kendi anahtar deposuna koyar – 600 izinli ~/.local/share/mimocode/auth.json. Yapılandırmanın kendisinde anahtar yoktur, bu yüzden dosyayı dotfile'larda güvenle saklayabilirsiniz;
• varsayılan modeli – model alanı – DeepSeek V4 Flash olarak ayarlar, ancak yalnızca model seçili değilse veya ağdan çıkarılmış bir modeli gösteriyorsa. Sizin yaptığınız seçimi, başka bir genel yapılandırmadaki dahil, geçersiz kılmaz;
• önceki dosyaların kopyalarını saklar, başka sağlayıcılara, anahtarlara ve yorumlara dokunmaz, ayrıştırılamayan bir dosyanın üzerine yazmaz – durur ve neyin düzeltilmesi gerektiğini söyler;
• sonunda ağ geçidine canlı bir istek gönderir ve anahtarın, adresin ve modelin kabul edilip edilmediğini doğrudan söyler.

Standart dışı dizinleri kurulum betiği kendisi dikkate alır: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME ve MIMOCODE_CONFIG. Başka bir varsayılan modeli --model bayrağı deepseek, glm veya minimax kısaltmalarıyla belirler; dotfile'lar ve sunucular için soru sormayan bir mod vardır:

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

MiMo Code açıksa yeniden başlatın: yeni sağlayıcı başlangıçta devreye alınır.

Kurulum aracının yaptığı her şeyi elle de yazabilirsiniz. İki dosya var ve her birinin kendi işi: yapılandırma sağlayıcıyı ve modelleri tanımlar, auth.json ise anahtarı saklar. İkisini birbirine bağlayan şey sağlayıcı kimliğidir – joingonka her iki dosyada da aynı olmalı. Yapılandırma, ~/.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"
}

Anahtar, 600 izinleriyle ~/.local/share/mimocode/auth.json:

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

Varsayılan model provider/model-id biçiminde yazılır; sağlayıcı ilk eğik çizgiden ayrılır, bu yüzden kendi eğik çizgisini içeren ağ kimlikleri olduğu gibi yazılır.

Anahtar başka nerede bulunabilir. MiMo Code README'si anahtarın doğrudan yapılandırmada yer aldığı seçeneği de gösterir – options.apiKey. Bu çalışır, ama o zaman anahtar dotfile'larla birlikte kolayca commit'lenir ve orada unutulan eski bir anahtar auth.json içindeki yenisini geçersiz kılar – bu yüzden kurulum aracı options.apiKey satırını kendi bloğundan çıkarır. Projeye özel .mimocode/mimocode.jsonc dosyasına anahtarı hele hiç koymayın.

Hangi dosya esas. MiMo Code genel config.json, mimocode.json ve mimocode.jsonc dosyalarını bu sırayla birleştirir; sonraki öncekini geçersiz kılar. Sonucu mimo debug config, sisteminizdeki yapılandırma ve anahtar yollarını ise mimo debug paths yazdırır.

Kendi sağlayıcınızı dosyalara ihtiyaç duymadan, yerleşik sihirbaz ile tanıtabilirsiniz. MiMo Code proje dizininde ilk kez çalıştırıldığında, klasöre güvenip güvenmediğinizi sorar (Yes, I trust this folder): Ajan, bu klasördeki dosyaları okuma, düzenleme ve çalıştırma yetkisi kazanır. Ardından /connect komutu Select provider listesini açar: Üst kısımda Xiaomi MiMo platformuna giriş, Codex ve Claude Code'dan içe aktarma, alt kısımda sağlayıcı dizini ve en sonda + Custom provider yer alır. Sihirbaz altı soru sorar:

Bizim çalışmamızda sihirbaz, tek bir sınırsız model ile sağlayıcı bloğunu ve yükleyicide bulunmayan iki alanı kaydetti: MiMo Code'un anahtarı arayacağı JOINGONKA_API_KEY değişken adını içeren env ve options.setCacheKey: true. Bu, ağ geçidi ile çalışır ancak yapılandırmayı tamamlamak daha iyidir: limit olmadan mimo models joingonka 1M token'lık bir pencere gösterecektir. Sihirbazdan sonra yükleyiciyi bir kez çalıştırmak en kolay yoldur — aynı bloğa limitleri içeren tam dizini ekleyecektir.

Model seçimi. Kalıcı seçim, yapılandırmadaki model alanıdır. Arayüzde model, /models komutu ile, tek seferlik bir çalışma için ise -m bayrağı ile değiştirilir. MiMo Code'un sağlayıcıda hangi modelleri gördüğünü ve hangi pencere ile çalıştığını mimo models joingonka gösterir — ajanın geçmişi sıkıştırmaya başlayacağı eşik değeri ile birlikte:

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

Ağdaki tüm modellerin fiyatı aynıdır, bu nedenle seçim davranışla ilgilidir. mimo run ile yaptığımız denemede, bir dosyayı okuyup hata bulma görevinde şu şekilde sonuç verdiler:

Neden varsayılan olarak DeepSeek V4 Flash'ın seçildiği, model incelemesinde açıklanmıştır.

Önce MiMo Code'un sağlayıcıyı ve anahtarı gördüğünden emin olun:

mimo models joingonka
mimo providers list

İlk komut, yukarıdaki örnekte olduğu gibi ağdaki üç modeli bağlam pencereleriyle birlikte listeler; ikincisi anahtar deposunun yolunu ve joingonka api satırını yazdırır. Ardından tek seferlik bir çalıştırma yapın. Proje dizinine bariz bir hata içeren bir calc.py dosyası koyun — örneğin kenarları çarpılmak yerine toplanan bir dikdörtgen alanı — ve hatayı bulmasını isteyin:

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

Çıktıda ajan ve model (> build · deepseek-ai/DeepSeek-V4-Flash-0731), araç çağrısı (→ Read calc.py) ve hatalı ifadeyi belirten somut bir yanıt görünür. --format json bayrağı çıktıyı, her adımın token sayacı olduğu bir olay akışına dönüştürür; -m joingonka/<model-id> ise çalıştırmayı başka bir modelle başlatır. Bizim çalıştırmamızda ağdaki üç modelin tümü "istek → araç çağrısı → sonuç → yanıt" döngüsünü tamamladı.

Üçüncü kontrol ağ geçidi tarafında: Panelde "Kullanım" bölümünde istek "Model bazında" dağılımında görünür, "Anahtar bazında" bloğunda ise son istek zamanı güncellenir.

Bir şeyler ters gittiyse teşhis genellikle doğrudan mesajdan okunur:

Ajan aracı, tokenları sohbetten farklı harcar: MiMo Code, her cümlenize bir sistem istemi, araç açıklamaları ve ajanın hizmet bağlamını ekler ve görev birkaç adımdan oluşur. Bizim çalışmamızda, modele yapılan her istek 22-25 bin giriş tokenı taşıdı ve "dosyayı oku ve hatayı bul" görevi iki adımda yaklaşık 45-50 bin tokene mal oldu; bunların neredeyse tamamı girişti. Bu nedenle burada token başına fiyat belirleyicidir.

JoinGonka Gateway üzerinden tokenlar girişte milyon başına $0.0069, çıkışta milyon başına $0.021 maliyetindedir; fiyat tüm ağ modelleri için aynıdır ve bu sayfaya canlı kaynaktan çekilir.

Sağ sütundaki tahminler Eylül 2026 fiyatlarına göredir. Karşılaştırma için, MiMo Code içindeki modeller için genel ödeme yöntemleri şöyledir:

Gateway modelleri için MiMo Code içindeki maliyet tahmini sıfırdır; kayıtlarında cost alanı yoktur ve --format json olaylarında "cost": 0 yazar. Gerçek tüketim ve bakiye, paneldeki "Kullanım" ve "Faturalandırma" bölümlerindedir.

İzinler. MiMo Code arayüzünde riskli eylemler için onay ister, ancak mimo run komutunda sorulacak kimse yoktur — proje dışı erişim talebini kendisi reddeder. Güvenilir tek kullanımlık ortamlar için --dangerously-skip-permissions bayrağı (veya MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1 değişkeni) mevcuttur: bu, açık bir kural tarafından yasaklanmayan her şeye izin verir — ancak yalnızca bir konteyner veya korumalı alanda. Arayüzde benzer bir mod /skip-permissions komutu ile oturum süresince etkinleştirilebilir.

Ajanlar. Varsayılan olarak build tüm araç setiyle çalışır, plan sadece okur ve analiz eder, compose süreci teknik özellikten doğrulanmış koda kadar yönetir; Tab ile aralarında geçiş yapılır.

Uzun bağlam. Pencere sınırına ulaşıldığında MiMo Code, bağlamı son kontrol noktasından, proje belleğinden ve yeni mesajlardan yeniden oluşturur; eşiği limit.context değerinden hesaplar. Daha erken sıkıştırma /context-limit komutuyla her model için ayrı ayrı yapılabilir.

Xiaomi hesabına bağlı olanlar. Sesli giriş (/voice) konuşmayı MiMo platform modeliyle tanır ve oturum açıldıktan sonra kullanılabilir. Kod, komutlar ve alt ajanlar bağlı bir sağlayıcı üzerinden çalışır — bizim testlerimizde herhangi bir oturum açma gerektirmeden.

Görseller. Ağ modelleri metin tabanlıdır: /modalities içinde onlar için sadece metne izin verin, ekran görüntüleri için ise görüntü işleyebilen bir modele sahip ikinci bir sağlayıcı tanımlayın.

MiMo Code ve OpenCode, farklı ayarlara sahip akrabalardır. Dizinleri ve dosyaları kendilerine aittir, bu nedenle birinin ayarı diğerine aktarılmaz:

Sürüm. Proje sık güncellenir; yeniden üretilebilirlik için sürümü sabitleyin: npm install -g @mimo-ai/[email protected] veya curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

Ağın hizmet verdiği aileler için laboratuvarların kendi ajanları da mevcuttur: MiniMax Code, kendi tedarikçisi MiniMax M2.7 modelinde çalışır, DeepSeek ve GLM yazarları Z.ai'nin kendi ajanları vardır. Hepsi tek bir anahtarla aynı ağ geçidine bağlanır.