omp (Oh My Pi) + JoinGonka Gateway: मॉडल भूमिकाओं वाला एजेंट

चरण 1: omp इंस्टॉल करें। प्रोजेक्ट README के आधिकारिक तरीक़े:

# macOS and Linux
curl -fsSL https://omp.sh/install | sh

# Homebrew
brew install can1357/tap/omp

# via Bun (requires Bun 1.3.14 or newer)
bun install -g @oh-my-pi/pi-coding-agent

# Windows (PowerShell)
irm https://omp.sh/install.ps1 | iex

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

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

npx @joingonka/setup --tool omp

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

• ~/.omp/agent/models.yml में joingonka प्रोवाइडर लिखेगा: गेटवे का पता, openai-completions प्रोटोकॉल, की लिटरल के तौर पर और नेटवर्क की तीन मॉडलें असली कॉन्टेक्स्ट विंडो और रिस्पॉन्स लिमिट के साथ; फ़ाइल को 600 की परमिशन मिलेगी;
• डिफ़ॉल्ट मॉडल सेट करेगा — ~/.omp/agent/config.yml में modelRoles.default — DeepSeek V4 Flash पर, लेकिन सिर्फ़ तब जब रोल खाली हो या नेटवर्क से हट चुकी मॉडल की तरफ़ इशारा करता हो: किसी और की चोइस को वो ओवरराइड नहीं करता, बल्कि स्विच करने का तरीक़ा बताता है;
• लिखने से पहले पुरानी फ़ाइल का बैकअप लेगा, और बाक़ी प्रोवाइडर, रोल और कमेंट जैसे थे वैसे ही रहने देगा;
• आख़िर में गेटवे पर एक लाइव रिक्वेस्ट भेजेगा और सीधे बताएगा कि की, पता और मॉडल स्वीकार हुए या नहीं।

दूसरी डिफ़ॉल्ट मॉडल --model फ़्लैग से तय होती है, शॉर्टकट deepseek, glm या minimax — जो मॉडल साफ़ तौर पर बताई जाए वो हमेशा लिखी जाती है। डॉटफ़ाइल और सर्वर के लिए बिना सवाल वाला मोड है, इसमें की एनवायरनमेंट वेरिएबल से ली जाती है:

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

कॉन्फ़िग की ग़ैर-मानक जगह इंस्टॉलर खुद संभालता है: नामित प्रोफ़ाइल (OMP_PROFILE) और शिफ़्ट किया गया एजेंट डायरेक्टरी (PI_CODING_AGENT_DIR)। पुरानी models.json को वो models.yml में वैसे ही ले जाता है जैसे खुद omp करता — पुराने प्रोवाइडर ग़ायब नहीं होंगे। और अगर साथ में पुरानी settings.json हो बिना config.yml के, तो इंस्टॉलर config.yml नहीं बनाएगा ताकि omp अपना सेटिंग्स माइग्रेशन न चूके: वो एक बार omp चलाकर कमांड दोहराने को कहेगा।

इंस्टॉलर जो कुछ भी करता है, वह सब हाथ से लिखा जा सकता है। फ़ाइलें दो हैं और हर एक का अपना काम है: models.yml प्रोवाइडरों और मॉडलों का ब्यौरा देती है, config.yml सेटिंग्स रखती है — जिसमें यह भी शामिल है कि कौन-सा मॉडल किस भूमिका पर है।

# ~/.omp/agent/models.yml
providers:
  joingonka:
    baseUrl: https://gate.joingonka.ai/v1
    api: openai-completions
    apiKey: jg-your-key
    models:
      - id: deepseek-ai/DeepSeek-V4-Flash-0731
        name: DeepSeek V4 Flash (Gonka)
        input: [text]
        contextWindow: 380000
        maxTokens: 32768
        reasoning: true
      - id: zai-org/GLM-5.3-Flash
        name: GLM-5.3 Flash (Gonka)
        input: [text]
        contextWindow: 390000
        maxTokens: 8192
        reasoning: true
      - id: MiniMaxAI/MiniMax-M2.7
        name: MiniMax M2.7 (Gonka)
        input: [text]
        contextWindow: 200000
        maxTokens: 8192

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

कुंजी को सीधे लिखना सबसे बिना झंझट वाला विकल्प है: omp किसी भी एनवायरनमेंट से शुरू हो जाता है, और फ़ाइल को chmod 600 ~/.omp/agent/models.yml कमांड से बंद कर देना काफ़ी है। कुंजी फ़ाइल से बाहर रखनी हो — तो apiKey में वेरिएबल का नाम लिखें, जैसे JOINGONKA_API_KEY, और उसे उसी शेल में एक्सपोर्ट करें जहाँ से omp चलाते हैं: कुंजी हल करने का यही क्रम प्रोजेक्ट के डॉक्युमेंटेशन में बताया गया है।

वैकल्पिक फ़ील्ड cost (प्रति मिलियन टोकन कीमत) सिर्फ़ omp के इंटरफ़ेस में सेशन की लागत का अंदाज़ा लगाने के लिए चाहिए। इंस्टॉलर वहाँ इंस्टॉल के समय का गेटवे का लाइव रेट भर देता है; हाथ के कॉन्फ़िग में यह फ़ील्ड छोड़ी जा सकती है — इस अंदाज़े का आपके बिल से कोई लेना-देना नहीं, असली खर्च कैबिनेट में दिखता है।

मॉडल सेलेक्टर provider/model-id के रूप में लिखा जाता है। प्रोवाइडर का नाम पहले स्लैश पर अलग होता है, इसलिए अपना स्लैश रखने वाले नेटवर्क आईडी जैसे हैं वैसे ही लिखे जाते हैं: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731। config.yml बदलने के बजाय भूमिका इंटरफ़ेस से भी सौंपी जा सकती है — सेशन के अंदर /model कमांड से या omp setup विज़ार्ड में।

omp में हर चीज़ के लिए एक ही मॉडल नहीं चुना जाता, बल्कि भूमिकाओं के आधार पर चयन किया जाता है — यही कॉन्फ़िगरेशन का मुख्य आधार है। संवाद के लिए अंतर्निहित भूमिकाएँ: default, smol, slow, plan, commit, task, tiny, memory, advisor और vision। सभी को असाइन करना आवश्यक नहीं है: अनिर्दिष्ट smol और slow पहले default भूमिका के मॉडल का उपयोग करते हैं, task भूमिका के बिना उप-एजेंट वर्तमान सत्र के मॉडल पर काम करते हैं, और commit तथा tiny, smol का पालन करते हैं। default की एक पंक्ति वाली कॉन्फ़िगरेशन पूरी तरह से काम करती है।

नेटवर्क के मॉडलों के बीच भूमिकाओं को विभाजित करना बचत के लिए नहीं है — DeepSeek V4 Flash, GLM-5.3 Flash और MiniMax M2.7 की कीमत समान है — बल्कि व्यवहार और क्षमता के लिए है: तर्क करने वाला मॉडल बेहतर योजना बनाता है, लंबे उत्तर वाला मॉडल बेहतर लिखता है, और पृष्ठभूमि के छोटे कार्यों को मुख्य कार्य के साथ एक ही कतार में रखने की आवश्यकता नहीं है।

# ~/.omp/agent/config.yml
modelRoles:
  default: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
  slow: joingonka/zai-org/GLM-5.3-Flash
  plan: joingonka/zai-org/GLM-5.3-Flash
  tiny: joingonka/MiniMaxAI/MiniMax-M2.7

retry:
  fallbackChains:
    default:
      - joingonka/zai-org/GLM-5.3-Flash

retry.fallbackChains ब्लॉक — पीक ऑवर के लिए बीमा: जब मुख्य मॉडल लगातार 429 उत्तर देता है, तो omp शेष चाल को चेन की अगली प्रविष्टि को स्थानांतरित कर देता है, और रुकने के बाद वापस मुख्य पर आ जाता है। चेन की कुंजी एक भूमिका, एक विशिष्ट मॉडल या पूरा प्रदाता (joingonka/*) हो सकती है।

एक रन के लिए भूमिका को फ्लैग द्वारा बदला जा सकता है: omp --model slow, slow भूमिका के मॉडल पर सत्र शुरू करता है, और --smol, --slow तथा --plan मॉडल को ही बदल देते हैं। सत्र के भीतर Ctrl+P भूमिका मॉडल को स्क्रॉल करता है, और /model चयन खोलता है; Roles टैब में भूमिकाएँ और उनके बैकअप असाइन किए जा सकते हैं।

भूमिका मान में विचार का स्तर जोड़ा जा सकता है — :low, :medium, :high। यह omp सिंटैक्स है, और कोई विशिष्ट मॉडल इस स्तर को कैसे समझता है, यह स्वयं मॉडल पर निर्भर करता है: उदाहरण के लिए, GLM-5.3 Flash में यह एक बाइनरी स्विच है — विवरण मॉडल समीक्षा में हैं। एक और उपयोगी विवरण: भूमिकाओं को एक रिपॉजिटरी के लिए <repo>/.omp/config.yml फ़ाइल द्वारा उसी modelRoles ब्लॉक के साथ ओवरराइड किया जा सकता है। प्रदाता और कुंजियाँ होम डायरेक्टरी में रहती हैं, इसलिए कुंजी रिपॉजिटरी में नहीं जाएगी।

पहले यह पक्का करें कि omp को प्रोवाइडर दिख रहा है:

omp models joingonka

जवाब में तीन पंक्तियों की एक टेबल आती है, जिसमें models.yml से कॉन्टेक्स्ट विंडो और मैक्स-आउट लिमिट हैं, हज़ार तक राउंड किए गए (आउटपुट छोटा किया गया है: omp में thinking और images कॉलम भी हैं):

joingonka (3)
model                                context  max-out
deepseek-ai/DeepSeek-V4-Flash-0731      380K      33K
MiniMaxAI/MiniMax-M2.7                  200K     8.2K
zai-org/GLM-5.3-Flash                   390K     8.2K

इसके बाद — बिना इंटरफ़ेस के एक बार का रन। किसी खाली डायरेक्टरी में साफ़ बग वाली फ़ाइल रखें और उसे ढूँढने के लिए कहें:

omp -p "Read calc.py and tell me in one sentence whether it has a bug."

एजेंट को ख़ुद रीड टूल कॉल करना चाहिए और सार-भरा जवाब देना चाहिए — उस एक्सप्रेशन के साथ जहाँ बग है। 21 सितंबर 2026 के हमारे रन में यह पूरा चक्र — रिक्वेस्ट, टूल कॉल, नतीजा, जवाब — DeepSeek V4 Flash और GLM-5.3 Flash ने साफ़-सुथरे पास किया; MiniMax M2.7 की बात नीचे टेबल की आख़िरी पंक्ति में।

तीसरी जाँच — गेटवे की तरफ़ से: डैशबोर्ड में "उपयोग" सेक्शन में रिक्वेस्ट "मॉडल के अनुसार" ब्रेकडाउन में दिखेगी, और "कीज़ के अनुसार" ब्लॉक में आख़िरी रिक्वेस्ट का समय अपडेट हो जाएगा। अगर वहाँ खाली है, तो omp किसी और प्रोवाइडर से बात कर रहा है: देखें कि रोल्स पर क्या सेट है, कमांड से omp config get modelRoles।

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

एजेंट टूल चैट की तुलना में अलग तरह से टोकन खर्च करता है: आपके हर वाक्य में omp एक सिस्टम प्रॉम्प्ट और टूल विवरण जोड़ता है, और टास्क को पूरा करने में आमतौर पर कई चरण लगते हैं। हमारे रन में, केवल एक रीड टूल चालू होने पर भी हर चरण में लगभग 3,500 इनपुट टोकन खर्च हुए; पूर्ण सेट के साथ यह और भी अधिक होगा। इसलिए, टोकन की कीमत यहाँ मायने रखती है।

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

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

omp स्टेटस बार सेशन की लागत का अनुमान दिखाता है। यह models.yml से cost फ़ील्ड के आधार पर गिना जाता है: इंस्टॉलर वहां इंस्टॉलेशन के समय गेटवे की कीमत लिखता है, और नेटवर्क में डॉलर की कीमत GNK दर के साथ बदलती रहती है, इसलिए यह अनुमान एक संकेत है। सटीक खपत और बैलेंस डैशबोर्ड में, "उपयोग" और "बिलिंग" अनुभागों में उपलब्ध हैं। डिफ़ॉल्ट रूप से DeepSeek V4 Flash को क्यों चुना गया, इसे मॉडल समीक्षा में विस्तार से समझाया गया है।

अनुमोदन मोड। डिफ़ॉल्ट रूप से omp yolo मोड में चलता है: पढ़ने, लिखने और कमांड चलाने को खुद ही मंज़ूरी देता है। अपने प्रोजेक्ट पर यह सुविधाजनक है, पर किसी और के कोड पर — मोड सख़्त करने या कंटेनर में चले जाने की वजह:

omp config set tools.approvalMode write

write मोड में एजेंट सिर्फ़ कमांड चलाने की इजाज़त माँगता है, always-ask में — लिखने की भी। एक बार के लिए यही काम --approval-mode फ़्लैग करता है। यह omp की ख़ुद की प्रॉपर्टी है, मॉडल प्रोवाइडर पर निर्भर नहीं करती।

Pi और omp — अलग कॉन्फ़िग वाले रिश्तेदार। एक टूल की सेटिंग दूसरे को नहीं मिलती: डायरेक्टरी, फ़ॉर्मैट और फ़ील्ड के नाम दोनों के अपने हैं।

कई एनवायरनमेंट। नामित प्रोफ़ाइल (omp --profile work या OMP_PROFILE वेरिएबल) सारी सेटिंग ~/.omp/profiles/<name>/agent में ले जाती है — ऑफ़िस और निजी कीज़ अलग रखने के लिए सुविधाजनक। मौजूदा एजेंट डायरेक्टरी omp config path दिखाता है।

अगर एजेंट एडिटर में चाहिए। omp, Zed के अंदर ACP प्रोटोकॉल पर काम कर सकता है — यह वही एजेंट है, वही सेटिंग के साथ, प्रोवाइडर और रोल दोबारा लिखने की ज़रूरत नहीं।