Goose + JoinGonka Gateway: अपना प्रोवाइडर और keyring में की

चरण 1: Goose इंस्टॉल करें। CLI के लिए प्रोजेक्ट के डॉक्स में बताए आधिकारिक तरीके:

# macOS and Linux: the script puts the binary in ~/.local/bin
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

# macOS, Homebrew
brew install block-goose-cli

CONFIGURE=false वेरिएबल goose configure विज़ार्ड को बंद कर देता है, जिसे स्क्रिप्ट वरना इंस्टॉल के तुरंत बाद चला देती है: प्रोवाइडर इंस्टॉलर सेट करेगा। अगर ~/.local/bin कैटलॉग PATH में नहीं है, तो स्क्रिप्ट यह खुद बता देगी। Windows के लिए उसी रिपॉज़िटरी में download_cli.ps1 स्क्रिप्ट है, और डेस्कटॉप ऐप डॉक्स पेज से डाउनलोड होता है; यह और CLI एक ही सेटिंग्स पढ़ते हैं, इसलिए नीचे दी हर बात दोनों पर लागू होती है। जाँच — goose --version।

चरण 2: कुंजी लें। gate.joingonka.ai/register पर रजिस्टर करें, ईमेल वेरिफ़ाई करें और «API कुंजियाँ» सेक्शन में jg- प्रीफ़िक्स वाली कुंजी बनाएँ। एक कुंजी और एक बैलेंस नेटवर्क के सभी मॉडलों पर काम करता है।

चरण 3: इंस्टॉलर चलाएँ।

npx @joingonka/setup --tool goose

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

• गेटवे के पते और नेटवर्क के तीन मॉडलों के असली कॉन्टेक्स्ट विंडो के साथ provider फ़ाइल custom_providers/custom_joingonka.json बनाएगा, 600 परमिशन के साथ। custom_joingonka और CUSTOM_JOINGONKA_API_KEY नाम वही हैं जो Goose खुद «JoinGonka» नाम से निकालता है, इसलिए विज़ार्ड की कुंजी सही जगह पहुँचेगी;
• JoinGonka को डिफ़ॉल्ट प्रोवाइडर बनाएगा, DeepSeek V4 Flash मॉडल के साथ — लेकिन सिर्फ़ तब जब प्रोवाइडर अभी चुना न गया हो या हमारा चुना हो और उसका मॉडल खाली या नेटवर्क से गायब हो। किसी और की पसंद वह नहीं छूता, बल्कि आज़माने के लिए कमांड छापता है: goose session --provider custom_joingonka --model …;
• कुंजी secrets.yaml में डालेगा, सिर्फ़ अगर Goose का सीक्रेट स्टोर निश्चित रूप से फ़ाइल-आधारित हो; वरना साफ़ कहेगा कि एक कदम बाकी है — विवरण कुंजी वाले सेक्शन में;
• बदली गई फ़ाइलों का बैकअप बनाएगा और अंत में गेटवे पर एक लाइव अनुरोध भेजेगा, ताकि कुंजी, पता और मॉडल तुरंत जाँच लिए जाएँ।

सेटिंग्स कैटलॉग इंस्टॉलर वैसे ही ढूँढता है जैसे Goose खुद: Linux और macOS पर ~/.config/goose, Windows पर %APPDATA%\Block\goose\config, और GOOSE_PATH_ROOT सेट होने पर <root>/config। दूसरा मॉडल --model फ़्लैग से चुनें, deepseek, glm या minimax शॉर्टकट के साथ; साफ़ तौर पर बताया गया मॉडल हमेशा लिखा जाता है। बिना सवाल वाला मोड कुंजी एनवायरनमेंट वेरिएबल से लेता है:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool goose --model glm --non-interactive

इंस्टॉलर जो कुछ भी करता है, उसे हाथ से लिखा जा सकता है। प्रोवाइडर एक अलग JSON-फ़ाइल है ~/.config/goose/custom_providers/custom_joingonka.json; फ़ाइल का नाम name फ़ील्ड से मेल खाना चाहिए:

{
  "name": "custom_joingonka",
  "engine": "openai",
  "display_name": "JoinGonka",
  "description": "JoinGonka Gateway — Gonka AI inference (OpenAI-compatible)",
  "api_key_env": "CUSTOM_JOINGONKA_API_KEY",
  "base_url": "https://gate.joingonka.ai/v1/chat/completions",
  "models": [
    { "name": "deepseek-ai/DeepSeek-V4-Flash-0731", "context_limit": 380000 },
    { "name": "zai-org/GLM-5.3-Flash", "context_limit": 390000 },
    { "name": "MiniMaxAI/MiniMax-M2.7", "context_limit": 200000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Goose मॉडल प्रविष्टि के लिए कोई अलग उत्तर सीमा प्रदान नहीं करता है। ऐसे मॉडल के लिए, यह अनुरोध में कोई सीमा नहीं भेजता है — हमने इसे इसके अनुरोध लॉग के माध्यम से जांचा है — और स्ट्रीमिंग मोड में, गेटवे स्वयं उत्तर को मॉडल की सीमा तक सीमित कर देता है: DeepSeek V4 Flash के लिए 32,768 टोकन, GLM-5.3 Flash और MiniMax M2.7 के लिए 8192 टोकन। इसके लिए ग्लोबल वेरिएबल GOOSE_MAX_TOKENS सेट करने की आवश्यकता नहीं है: यह सभी प्रोवाइडर्स के लिए एक ही है।

Goose प्रोवाइडर फ़ाइल को सख्त JSON-पार्सिंग के साथ पढ़ता है: यदि कोई टिप्पणी या लटकता हुआ अल्पविराम (trailing comma) है, तो प्रोवाइडर सूची से गायब हो जाएगा। आप इसे विज़ार्ड (goose configure → Custom Providers) के माध्यम से भी बना सकते हैं, लेकिन विज़ार्ड संदर्भ विंडो (context window) के बारे में नहीं पूछता है — इसे आपको मैन्युअल रूप से जोड़ना होगा।

डिफ़ॉल्ट प्रोवाइडर और मॉडल ~/.config/goose/config.yaml में रहते हैं। Goose इन्हें इस तरह लिखता है:

active_provider: custom_joingonka
providers:
  custom_joingonka:
    enabled: true
    model: deepseek-ai/DeepSeek-V4-Flash-0731
    configured: true

पुराना लेआउट — फ़ाइल के रूट में फ्लैट कीज़ GOOSE_PROVIDER और GOOSE_MODEL — भी काम करता है: Goose इसे पढ़ता है और पहली बार सेटिंग्स सहेजते समय इसे नए में बदल देता है, जैसा कि हमारे साथ goose configure के बाद हुआ था। इंस्टॉलर खाली फ़ाइल पर फ्लैट कीज़ लिखता है — इन्हें कोई भी वर्शन समझ सकता है। समान नाम वाले एनवायरनमेंट वेरिएबल्स फ़ाइल से अधिक महत्वपूर्ण हैं: यदि वे शेल में सेट हैं, तो config.yaml का चयन काम नहीं करेगा, और इंस्टॉलर इसके बारे में चेतावनी देगा।

Goose की प्रोवाइडर फ़ाइल में सिर्फ़ सीक्रेट का नाम है — CUSTOM_JOINGONKA_API_KEY। वैल्यू वह इस क्रम में ढूँढता है: इस नाम के एनवायरनमेंट वेरिएबल में, फिर सिस्टम सीक्रेट स्टोर में (keyring, macOS पर — Keychain), फिर कॉन्फ़िग के पास secrets.yaml फ़ाइल में। सीक्रेट उस फ़ाइल में तब जाते हैं जब Goose का स्टोर फ़ाइल-आधारित हो, और वहाँ वे खुले टेक्स्ट में, 600 परमिशन के साथ पड़े रहते हैं। और config.yaml में Goose कुंजियाँ बिल्कुल नहीं ढूँढता (डॉक्युमेंटेशन)।

स्टोर फ़ाइल-आधारित तब बनता है जब keyring बंद हो — किसी भी वैल्यू वाला GOOSE_DISABLE_KEYRING वेरिएबल या config.yaml में GOOSE_DISABLE_KEYRING: true पंक्ति — या अनुपलब्ध हो: ग्राफ़िकल सेशन के बिना सर्वर, कंटेनर, CI। दूसरे मामले में Goose लॉग में लिखता है «Keyring unavailable. Using file storage for secrets.» और खुद फ़ाइल पर चला जाता है — ठीक यही हमने कंटेनर में देखा। इंस्टॉलर keyring में लिख नहीं सकता, और आपकी ओर से उसे बंद भी नहीं करेगा: Goose वे सीक्रेट देखना बंद कर देता जो वहाँ पहले से पड़े हैं। इससे ये परिदृश्य बनते हैं:

बचा हुआ कदम। goose configure चलाएँ और विज़ार्ड के सवालों का जवाब दें — हमारे रन में वे ऐसे दिखे:

• What would you like to configure? → Configure Providers;
• Which model provider should we use? → JoinGonka (हमारे यहाँ यह पहले था);
• Would you like to set CUSTOM_JOINGONKA_API_KEY? (optional) → Yes, फिर Enter value for CUSTOM_JOINGONKA_API_KEY पर कुंजी पेस्ट करें — अक्षरों की जगह चौकोर बॉक्स दिखेंगे। कुंजी तुरंत सेव हो जाती है;
• Would you like to configure advanced settings? → No;
• Select a model — सूची Goose गेटवे से लेता है: MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731, zai-org/GLM-5.3-Flash। कर्सर पहली पंक्ति पर है — इंस्टॉलर का चुना मॉडल रखने के लिए तीरों से DeepSeek V4 Flash चुनें। टेस्ट रिक्वेस्ट के बाद विज़ार्ड «Configuration saved successfully» पंक्ति के साथ ख़त्म होगा।

Goose Desktop में रास्ता यह है: Settings → Models → Configure providers → JoinGonka → कुंजी → Submit। कुंजी हाथ से पेस्ट नहीं करनी — उसे एक वेरिएबल में रखें और उसी शेल से विज़ार्ड चलाएँ: Goose लिखेगा «CUSTOM_JOINGONKA_API_KEY is set via environment variable» और वैल्यू सेव करने का विकल्प देगा:

read -s CUSTOM_JOINGONKA_API_KEY && export CUSTOM_JOINGONKA_API_KEY
goose configure

और एक बार चलाने के लिए कुंजी बिना सेव किए भी दी जा सकती है: CUSTOM_JOINGONKA_API_KEY=jg-your-key goose session, PowerShell में — $env:CUSTOM_JOINGONKA_API_KEY = "jg-your-key"; goose session। एनवायरनमेंट वेरिएबल सेव की गई वैल्यू से ज़्यादा प्राथमिकता रखता है, पर शेल बंद होने तक ही ज़िंदा रहता है।

सबसे पहले देखें कि Goose वास्तव में कौन-सी सेटिंग्स देख रहा है:

goose info -v

«goose Configuration» ब्लॉक में GOOSE_PROVIDER: custom_joingonka और मॉडल आईडी वाली GOOSE_MODEL लाइनें होनी चाहिए। इसके बाद — बिना इंटरैक्टिव सेशन के एक बार का रन: किसी खाली डायरेक्टरी में स्पष्ट बग वाली फ़ाइल रखें और उसे ढूँढने के लिए कहें।

goose run --no-session -t "Read calc.py and tell me in one sentence whether it has a bug."

--no-session फ़्लैग रन को इतिहास में सेव नहीं करता। हेडर में ● new session · custom_joingonka deepseek-ai/DeepSeek-V4-Flash-0731 जैसी लाइन दिखेगी, फिर टूल कॉल — cat calc.py कमांड के साथ ▸ shell — और मिले बग के साथ जवाब। एक बार के लिए दूसरा मॉडल --model से सेट होता है: zai-org/GLM-5.3-Flash या MiniMaxAI/MiniMax-M2.7। 23 सितंबर 2026 के हमारे रन में «अनुरोध → टूल → परिणाम → जवाब» का चक्र नेटवर्क के तीनों मॉडल्स ने पूरा किया। CLI Goose मॉडल्स की सोच डिफ़ॉल्ट रूप से छिपाता है — अगर आउटपुट टर्मिनल में जा रहा है तो GOOSE_CLI_SHOW_THINKING=1 वेरिएबल से उसे दिखाया जा सकता है। गेटवे की तरफ़ से अनुरोध कैबिनेट में दिखता है: «उपयोग» सेक्शन, «मॉडल के अनुसार» और «कीज़ के अनुसार» ब्रेकडाउन।

अगर कुछ गड़बड़ हुई हो, तो निदान आमतौर पर सीधे मैसेज से पढ़ा जा सकता है:

एजेंट चैट की तुलना में अलग तरह से टोकन खर्च करता है। मानक कॉन्फ़िगरेशन में भी, Goose मॉडल को अठारह अंतर्निहित टूल के विवरण भेजता है, और हमारे रन में, आपके प्रश्न से पहले ही प्रत्येक चाल में लगभग 4.6 हजार इनपुट टोकन शामिल थे। «फ़ाइल पढ़ें और त्रुटि खोजें» कार्य में दो-तीन चालें और 10-15 हजार टोकन लगे, लगभग सब कुछ इनपुट था; एक और छोटा अनुरोध Goose खुद करता है, सत्र का नाम सोचने के लिए। अनावश्यक एक्सटेंशन goose configure → Toggle Extensions में बंद किए जा सकते हैं — यह इनपुट को कम करने का सबसे आसान तरीका है।

JoinGonka Gateway के माध्यम से टोकन की कीमत इनपुट पर प्रति मिलियन $0.0069 और आउटपुट पर प्रति मिलियन $0.021 है — कीमत सभी नेटवर्क मॉडल के लिए समान है और इस पृष्ठ पर लाइव स्रोत से ली जाती है।

दाएं कॉलम में अनुमान सितंबर 2026 की कीमतों के अनुसार हैं। तुलना के लिए — Goose में मॉडल के लिए भुगतान करने के तरीके:

सटीक खपत और शेष राशि कैबिनेट में, «उपयोग» और «बिलिंग» अनुभागों में है। डिफ़ॉल्ट रूप से DeepSeek V4 Flash क्यों सेट है — नेटवर्क में सबसे बड़ी उत्तर सीमा के साथ — इसे मॉडल समीक्षा में विस्तार से समझाया गया है।

पुष्टि मोड। डिफ़ॉल्ट रूप से Goose auto मोड में चलता है — पूरी तरह स्वायत्त: ख़ुद फ़ाइलें एडिट और डिलीट करता है, कमांड चलाता है और एक्सटेंशन इस्तेमाल करता है, कुछ भी पूछे बिना। अपने प्रोजेक्ट पर यह सुविधाजनक है, पर किसी और के कोड पर मोड सख़्त करना बेहतर है:

# inside a session
/mode smart_approve

# permanently, as a line in config.yaml
GOOSE_MODE: smart_approve

यह Goose की ही ख़ूबी है, मॉडल प्रोवाइडर पर निर्भर नहीं।

मॉडल बदलना। सेशन के अंदर — आइडेंटिफायर के साथ /model कमांड, जैसे /model zai-org/GLM-5.3-Flash; एक बार के रन के लिए — goose run और goose session पर --model फ़्लैग; हमेशा के लिए — goose configure या config.yaml में model लाइन। प्रोवाइडर इस दौरान वही रहता है। सोचने वाला GLM-5.3 Flash उलझी लॉजिक के लिए अच्छा है, पर इसके जवाब की सीमा 8192 टोकन है, और उसका एक हिस्सा सोच में चला जाता है — जानकारी मॉडल समीक्षा में।

बिना निगरानी के रन। goose run स्क्रिप्ट और CI के लिए ठीक है: -q फ़्लैग आउटपुट में सिर्फ़ मॉडल का जवाब छोड़ता है, --output-format json नतीजा पार्स करने लायक देता है। --max-turns (इंसान की भागीदारी के बिना एजेंट कितने चरण करता है) और --max-tool-repetitions (एक ही आर्ग्युमेंट के साथ एक टूल लगातार कितनी बार बुलाया जा सकता है) जैसे लिमिटर लूप में फँसने से बचाते हैं।

प्राइवेसी। Goose में एनोनिमस इस्तेमाल आँकड़े डिफ़ॉल्ट रूप से बंद हैं (GOOSE_TELEMETRY_ENABLED)। गेटवे प्रॉम्प्ट और जवाबों की सामग्री सेव नहीं करता — आँकड़ों में सिर्फ़ खर्च के एग्रीगेट रहते हैं।