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

इंस्टॉलर की माँगेगा — कमांड लाइन आर्ग्युमेंट्स में यह पास नहीं होता, ताकि शेल हिस्ट्री में न बचा रहे — और चार काम करेगा:

• joingonka प्रोवाइडर को ~/.config/crush/crush.json में लिखेगा: टाइप 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 फ़ॉर्मैट में — यह सादा Bash है, जिसमें Crush की बिल्ट-इन कमांड हैं। फ़ाइल ~/.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, जटिल लॉजिक के लिए चुना जाता है, यह ध्यान में रखते हुए कि इसकी रिस्पांस सीमा 8192 है और इसका एक हिस्सा तर्क (reasoning) में चला जाता है — विवरण मॉडल समीक्षा में है। एक रन के लिए मॉडल को पूरे नाम से सेट किया जाता है: crush run -m joingonka/zai-org/GLM-5.3-Flash "…"। सभी उपलब्ध नाम crush models joingonka प्रिंट करता है।

स्टेट फ़ाइल (State file)। 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 दर के साथ बदलती रहती है, इसलिए काउंटर केवल एक संदर्भ है। सटीक उपभोग और शेष राशि कैबिनेट में 'उपयोग' और 'बिलिंग' अनुभागों में उपलब्ध है। लार्ज स्लॉट में डिफ़ॉल्ट रूप से 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 खोलेंगे। किसी और के रिपॉज़िटरी में उसके कॉन्फ़िग पढ़े बिना एजेंट न चलाएँ।