## 💰 तृतीय-पक्ष मुफ़्त टियरों में प्रति माह ~1.62B टोकन
> **अपने प्रोवाइडर खाते स्वयं लाएँ।** यह अलग-अलग पात्रता वाले तृतीय-पक्ष मुफ़्त टियरों का अनुमानित कुल योग है, OmniRoute की ओर से टोकन अनुदान नहीं। साइन अप करें, जहाँ आवश्यक हो क्रेडेंशियल प्राप्त करें, और जिन प्रोवाइडरों का उपयोग कर सकते हैं उन्हें कनेक्ट करें; प्रत्येक प्रोवाइडर अपनी सीमाएँ, उपलब्धता और शर्तें नियंत्रित करता है।
>
> मुफ़्त टियरों को हाथ से जोड़ना कष्टदायक है — दर्जनों SDK, दर्जनों रेट लिमिट, और यह पता ही नहीं कि आपके पास वास्तव में कितना है। OmniRoute **34 आवर्ती पूल कुंजियों में 467 मुफ़्त-टियर एंट्रीज़** को कैटलॉग करता है और टोकन का मुख्य आंकड़ा **प्रकाशित सकारात्मक मासिक बजट वाले 17 पूल और पाँच प्रति-मॉडल Groq कैप** से निकालता है, जिसे साझा पूल के आधार पर डीडुप्लिकेट किया जाता है। जो कोटा केवल क्षेत्रीय पहचान जाँच के बाद खुलते हैं (आज: ModelScope), वे अलग दिखाए जाते हैं — क्षेत्रीय पहचान सत्यापन के पीछे +~6M — और मुख्य आंकड़े में कभी नहीं जोड़े जाते। परिणाम डैशबोर्ड (`/dashboard/free-tiers`) पर दिखाई देता रहता है।
> लाइव `/dashboard/free-tiers` पेज का एनिमेटेड सारांश। पूरी कार्यप्रणाली (पूल डीडुपे, क्रेडिट टियर, प्रोवाइडर शर्तें): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> ये आंकड़े हर दो सप्ताह में लाइव कैटलॉग के विरुद्ध दोबारा ऑडिट किए जाते हैं और **दोनों दिशाओं में बदलते हैं** — कोई प्रोवाइडर मुफ़्त टियर समाप्त करता है तो संख्या घट जाती है; नया जुड़ता है तो बढ़ जाती है। हम वही प्रकाशित करते हैं जो कैटलॉग वास्तव में गणना करता है, कभी भी ऊपर की ओर गोल किया गया सर्वोत्तम केस नहीं।
⭐ अगर OMNIROUTE ने आपका पैसा बचाने और आपका काम आसान बनाने में मदद की है, तो रेपो को स्टार करें।
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 समुदाय से जुड़ें
**👋 मेंटेनर को फ़ॉलो करें — नए प्रोवाइडर, रिलीज़ और टिप्स सबसे पहले पाएँ:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**प्रश्न, प्रोवाइडर टिप्स, रोडमैप और सहायता → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 वैश्विक](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ब्राज़ील](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [पोर्टल](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 गेटवे बढ़ता रहता है
## 🆓 इंस्टॉल करें, किसी प्रदाता को कनेक्ट करें, फिर एक एंडपॉइंट के माध्यम से रूट करें
```bash
# किसी प्रदाता को कनेक्ट करने के बाद, Dashboard → Endpoints से अपनी OmniRoute कुंजी कॉपी करें:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` के लिए एक योग्य रूट आवश्यक है। नए इंस्टॉलेशन में कोई योग्य कुंजी-रहित लक्ष्य नहीं हो सकता है, और कोई कुंजी-रहित प्रदाता तृतीय-पक्ष क्लाइंट को अस्वीकार कर सकता है। Kiro सहित `tos: avoid` के रूप में चिह्नित प्रदाताओं को डिफ़ॉल्ट रूप से स्वचालित रूटिंग से बाहर रखा जाता है; किसी खाते को कनेक्ट करने से यह सेटिंग ओवरराइड नहीं होती। प्रदाता चुनने से पहले [निःशुल्क टियर मार्गदर्शिका](docs/getting-started/FREE-TIERS-GUIDE.md) देखें।📦 **Python, Node.js, PHP और cURL** के लिए कॉपी-पेस्ट क्विकस्टार्ट स्क्रिप्ट → [`examples/quickstart/`](examples/quickstart/)
# 💥 वादा
# 🤔 OmniRoute क्यों?
## 🤝 हमारे ओपन सोर्स मित्रों द्वारा समर्थित
> **ओपन सोर्स मित्र के रूप में शामिल होना चाहते हैं?** ये वे कंपनियाँ हैं जो ओपन सोर्स का समर्थन करती हैं और OmniRoute को आगे बढ़ाने में मदद करती हैं — और हम सार्वजनिक रूप से बताते हैं कि वे हमें दिया गया हर टोकन कहाँ खर्च करती हैं। संपर्क करें: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Kimi (Moonshot AI), हमारे संस्थापक ओपन सोर्स मित्र, को इस परियोजना का समर्थन करने के लिए धन्यवाद! Kimi ओपन-वेट K2 और K3 मॉडल परिवारों के पीछे की AI लैब है — Kimi K3 1M-टोकन संदर्भ विंडो, नेटिव विजन और क्लोज्ड-मॉडल कीमतों के एक अंश पर फ्रंटियर-स्तरीय कोडिंग प्रदान करता है, और क्लाउड कोड, कोडेक्स और हर कोडिंग टूल के साथ बॉक्स से बाहर काम करता है जिसे OmniRoute सेवा प्रदान करता है।
Kimi का समर्थन क्या शक्ति देता है: Kimi के API क्रेडिट OmniRoute की AI-मान्य रिलीज़ पाइपलाइन को शक्ति देते हैं — Kimi K3 द्वारा संचालित मर्ज सत्यापन चरण जो हर पुल अनुरोध को शिप करने से पहले उसकी समीक्षा करता है — साथ ही दिन-प्रतिदिन की सुविधा विकास। फर्स्ट-क्लास Kimi समर्थन दोनों रेल पर शिप होता है: सीधा Kimi API (kimi-k3) और Kimi Code कोडिंग प्लान (OAuth और API कुंजी)। OmniRoute Kimi के समर्थन कार्यक्रम में पहला ब्राज़ीलियाई ओपन-सोर्स प्रोजेक्ट भी है। 15% अतिरिक्त क्रेडिट के साथ Kimi API कुंजी प्राप्त करें →
Cheaper Inference cheaperinference.com
Cheaper Inference, एक OmniRoute ओपन सोर्स मित्र, को इस परियोजना का समर्थन करने के लिए धन्यवाद! Cheaper Inference एक लागत-रैंक वाला गेटवे है जो 42 फ्रंटियर मॉडल — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok और MiniMax — को एक OpenAI-संगत एंडपॉइंट के पीछे फिर से बेचता है, प्रत्येक अनुरोध को सबसे सस्ते योग्य प्रदाता को रूट करता है, बिना मॉडल निर्माता की सूची मूल्य से अधिक शुल्क लिए।
OmniRoute में फर्स्ट-क्लास समर्थन: चैट पूर्णताएँ, नेटिव /v1/responses एंडपॉइंट, विजन, टूल कॉलिंग और 3 इमेज मॉडल (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> के रूप में पहुंच योग्य)। एक API कुंजी प्राप्त करें →
aff=omniroute टैग वाले लिंक पार्टनर लिंक हैं। वे आपको बिना किसी अतिरिक्त लागत के परियोजना को वित्तपोषित करते हैं। 🎟️ संबद्ध प्रचार — उन प्रदाताओं से मुफ्त साइनअप कूपन जिन्हें हम प्रायोजित नहीं करते हैं (विस्तार करने के लिए क्लिक करें)यह अनुभाग केवल रेफरल/कूपन कोड के लिए है। प्रायोजित भागीदारी ऊपर 🤝 हमारे ओपन सोर्स मित्रों द्वारा समर्थित में रहती है। OmniRoute का यहाँ सूचीबद्ध प्रदाताओं के साथ कोई प्रायोजन या भागीदारी नहीं है — ये सार्वजनिक कूपन हैं जिनका कोई भी उपयोग कर सकता है।
AgentRouter agentrouter.org
AgentRouter — संबद्ध साइनअप · साइनअप पर $100 मुफ्त क्रेडिट (मुफ्त सर्वर, उच्च विलंबता की अपेक्षा करें — परीक्षण के लिए सबसे अच्छा, उत्पादन के लिए नहीं)। OmniRoute में v3.8.50 के बाद से फर्स्ट-क्लास समर्थन: चैट पूर्णताएँ, Anthropic-संगत वायर प्रारूप और OpenAI-संगत पथ। उपलब्ध मॉडलों में claude-opus-4-8, claude-opus-5, gpt-5.6-sol और बहुत कुछ शामिल हैं। अपने $100 प्राप्त करें →
⚠️ संबद्ध लिंक — OmniRoute का इस प्रदाता के साथ कोई प्रायोजन या भागीदारी नहीं है।
क्या आप किसी अन्य प्रदाता को जानते हैं जिसके पास एक उदार मुफ्त साइनअप कूपन है जो OmniRoute उपयोगकर्ताओं को लाभ पहुंचाता है? एक समस्या खोलें और हम इसे यहाँ जोड़ देंगे।
## 🎯 कॉम्बो — प्रमुख सुविधा
> एक **कॉम्बो** मॉडल की ऐसी शृंखला है, जिनके बीच OmniRoute **स्वचालित रूप से** रूट करता है। यदि कोटा समाप्त हो जाए, कोई प्रदाता विफल हो जाए या लागत अचानक बढ़ जाए, तो कॉम्बो अगले योग्य और स्वस्थ मॉडल पर जा सकता है। 🛡️
### ⚡ शून्य-कॉन्फ़िगरेशन — बस `auto` का उपयोग करें
कोई कॉम्बो बनाने की आवश्यकता नहीं है। अपने मॉडल को `auto` (या इसके किसी प्रकार) पर सेट करें और OmniRoute आपके कनेक्ट किए गए प्रदाताओं से एक वर्चुअल कॉम्बो बनाता है, जिसका लाइव स्कोर निर्धारित किया जाता है:
मॉडल ID
यह किसके लिए अनुकूलन करता है
auto
🎯 संतुलित डिफ़ॉल्ट (LKGP — आपके अंतिम अच्छे प्रदाता से जुड़ा रहता है)
auto/coding
🧑💻 कोड जनरेशन के लिए गुणवत्ता-प्रथम भार
auto/fast
⚡ सबसे कम विलंबता पहले
auto/cheap
💰 प्रति टोकन सबसे सस्ता पहले
auto/subscription
🎟️ केवल वही सदस्यता कोटा जिसके लिए आप पहले से भुगतान करते हैं — बंद स्थिति में विफल होता है, कभी भी बिल योग्य फ़ॉलबैक नहीं करता (मार्गदर्शिका)
auto/thrifty
🪜 पहले प्लान का कोटा, फिर सबसे सस्ते सशुल्क विकल्पों की ओर एक-एक पायदान — रीसेट होने के बाद वापस प्लान पर (मार्गदर्शिका)
auto/offline
🔋 सबसे अधिक कोटा / दर-सीमा की उपलब्ध गुंजाइश पहले
auto/smart
🔭 गुणवत्ता-प्रथम + बेहतर मॉडल खोजने के लिए 10% अन्वेषण
auto/lkgp
📌 अंतिम ज्ञात अच्छे प्रदाता से स्पष्ट जुड़ाव
auto/chaos
🧪 मॉडलों के एक पैनल में समानांतर विस्तार (प्रति प्रदाता एक, डिफ़ॉल्ट रूप से 5), एक उत्तर लौटाता है; प्रति पैनल मॉडल एक अपस्ट्रीम कॉल, यह फ़ॉल्ट इंजेक्शन नहीं है
##
### 🔀 या अपना स्वयं का बनाएँ — 20 रूटिंग रणनीतियाँ
सभी **20** रणनीतियाँ — प्रत्येक कॉम्बो चरण के लिए मिलाएँ और संयोजित करें:
#
रणनीति
यह क्या करती है
1
priority
पहले लक्ष्य वाली क्रमबद्ध सूची — अगले पर जाने से पहले प्रत्येक का पूरा उपयोग करें 🥇
2
fill-first
आगे बढ़ने से पहले प्रत्येक लक्ष्य का कोटा पूरी तरह उपयोग करें
3
weighted
प्रति-लक्ष्य भार के आधार पर भारित यादृच्छिक चयन
4
round-robin
लक्ष्यों के बीच क्रम से चक्र चलाएँ
5
p2c
दो विकल्पों की शक्ति वाला यादृच्छिक लोड संतुलन
6
least-used
सबसे कम मौजूदा लोड वाला लक्ष्य चुनें
7
random
समान रूप से यादृच्छिक चयन (डुप्लिकेट हटाकर)
8
strict-random
दोहराव हटाए बिना यादृच्छिक चयन 🎲
9
cost-optimized
लाइव कैटलॉग मूल्य निर्धारण से प्रति अनुरोध $ को न्यूनतम करें 💸
10
headroom
सबसे अधिक शेष कोटा वाला लक्ष्य चुनें
11
quota-weighted
समाप्त हो चुके खातों को छोड़ें, फिर शेष कोटा ÷ प्रगतिशील लोड के अनुपात में चयन करें — मौजूदा वार्तालाप उसी पर स्थिर रहते हैं ⚖️
12
reset-window
उस लक्ष्य को प्राथमिकता दें जिसकी कोटा विंडो सबसे पहले रीसेट होती है
13
reset-aware
कोटा रीसेट समय के आधार पर रैंक करें — छोटी विंडो पहले 📊
14
context-relay
लंबे वार्तालापों के लिए लक्ष्यों के बीच संदर्भ हस्तांतरित करें 🧠
15
context-optimized
मौजूदा संदर्भ आकार के लिए सबसे उपयुक्त लक्ष्य चुनें
16
cache-optimized
प्रत्येक पुनः उपयोग योग्य प्रॉम्प्ट प्रीफ़िक्स को उसी खाते पर स्थिर रखें — प्रॉम्प्ट-कैश हिट को अधिकतम करें 🎯
17
lkgp
अंतिम-ज्ञात-अच्छा पथ — अंतिम सफल प्रदाता पर स्थिर रखता है, फिर नियमों पर फ़ॉलबैक करता है
18
auto
प्रत्येक कनेक्शन पर 16-कारक लाइव स्कोरिंग 🤖
19
fusion
मॉडलों के एक पैनल में विस्तार + एक निर्णायक एक उत्तर संश्लेषित करता है 🧬
20
pipeline
चरणों की शृंखला — प्रत्येक लक्ष्य का आउटपुट अगले लक्ष्य का इनपुट बनता है 🔗
Auto-Combo इंजन प्रत्येक उम्मीदवार को **16 कारकों** (स्वास्थ्य, कोटा, लागत, विलंबता, कार्य-अनुकूलता, गुणवत्ता, सत्र उपलब्धता…) पर स्कोर करता है — देखें [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)।
##
### 🧱 प्रत्यास्थता अंतर्निर्मित है (3 स्वतंत्र परतें)
📖 [Auto-Combo इंजन](docs/routing/AUTO-COMBO.md) · [प्रत्यास्थता मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute को क्या विशिष्ट बनाता है
📊 संपूर्ण कार्यप्रणाली और 9router, OpenRouter, CLIProxyAPI तथा LiteLLM की तुलना में प्रत्येक सुविधा का विवरण → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute का समर्थन करें
OmniRoute MIT-लाइसेंस प्राप्त है और खुले तौर पर अनुरक्षित किया जाता है। यदि यह आपका समय या पैसा बचाता है, तो इसे स्वतंत्र बनाए रखने के लिए अपनी सुविधा के अनुसार कोई भी तरीका चुनें। प्रायोजन कभी भी रूटिंग प्राथमिकता को प्रभावित नहीं करता; इससे केवल दृश्यता मिलती है, रैंकिंग नहीं।
⭐ रिपॉज़िटरी को स्टार दें
निःशुल्क — दृश्यता बढ़ाने में वास्तव में मदद करता है
**🇧🇷 PIX** — तत्काल, कोई शुल्क नहीं (ब्राज़ील)
कुंजी (रैंडम): `5d865059-bc44-483a-962d-43ceb80126eb`
कॉपी और पेस्ट करने योग्य Pix:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ क्रिप्टो — BTC · ETH · USDT-TRC20 · USDC-Solana (विस्तार के लिए क्लिक करें)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ प्रत्येक कॉइन केवल दिखाए गए नेटवर्क पर ही भेजें — गलत नेटवर्क पर भेजने से धनराशि खो सकती है।
🐛 कोई बग मिला या प्रतिक्रिया देना चाहते हैं? एक [चर्चा](https://github.com/diegosouzapw/OmniRoute/discussions) शुरू करें।
डेवलपर नोट्स: डेवलपर की सुविधा के लिए प्रोजेक्ट npm install/postinstall के दौरान एक स्थानीय .env फ़ाइल उत्पन्न कर सकता है। इस फ़ाइल को जानबूझकर .gitignore के माध्यम से अनदेखा किया जाता है (.gitignore देखें) और इसे कभी भी कमिट नहीं किया जाना चाहिए — यदि यह गलती से कमिट हो जाए, तो उजागर हुए सभी सीक्रेट्स को बदलें और फ़ाइल को इतिहास से हटा दें। स्थानीय एनवायरनमेंट फ़ाइलों और सीक्रेट्स को प्रबंधित करने के मार्गदर्शन के लिए docs/DEVELOPER-ENVIRONMENT.md देखें।
## 📡 OmniRoute Radar
मुख्य फ़्री-टियर सीमा ऊपर दिए गए दस्तावेज़ीकृत,
पूल-डीडुप्लिकेटेड कैटलॉग के अनुसार **~1.62B टोकन/माह** बनी हुई है। अस्थायी प्रदाता साइनअप क्रेडिट अलग से पहले
महीने की सीमा को **~2.22B** तक बढ़ा सकते हैं। Radar उन लोगों के लिए एक वैकल्पिक, हस्ताक्षरित कैटलॉग ओवरले है, जो OmniRoute रिलीज़ के बीच
मुफ़्त मॉडल की उपलब्धता के बारे में अधिक नवीन जानकारी चाहते हैं; सामुदायिक कैटलॉग और प्रत्येक मौजूदा मुफ़्त
सुविधा मुफ़्त बनी रहती है।
समर्थक लाइव कैटलॉग और अतिरिक्त प्रदाता अवसर प्राप्त कर सकते हैं। इसकी अलग,
परिवर्तनशील अधिकतम सीमा प्रदाता की उपलब्धता के आधार पर **अधिकतम लगभग 3B टोकन/माह** है।
यह अधिकतम सीमा कोई गारंटी नहीं है: प्रदाता किसी भी
समय कोटा, पात्रता, मॉडल या क्षेत्र बदल सकते हैं।
Radar ऑप्ट-इन और केवल-GET है। OmniRoute क्लाइंट प्रॉम्प्ट, ट्रैफ़िक, प्रदाता
कॉन्फ़िगरेशन, उपयोग टेलीमेट्री या स्थानीय घोषणा-खारिज स्थिति अपलोड नहीं करता। पात्रता और
वर्तमान कैटलॉग के बारे में **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** पर जानें।
## ✨ नया क्या है
> **v3.8.20 → v3.8.53** की हाल की प्रमुख विशेषताएँ। पूरा इतिहास [`CHANGELOG.md`](CHANGELOG.md) में उपलब्ध है।
- **⚖️ `quota-weighted` रूटिंग** — 20वीं कॉम्बो रणनीति समाप्त कोटा वाले खातों को छोड़ देती है, फिर शेष खातों में बचे हुए कोटे ÷ जारी लोड के अनुपात में चयन करती है, जबकि मौजूदा वार्तालाप अपने खातों से जुड़े रहते हैं। → [ऑटो-कॉम्बो](docs/routing/AUTO-COMBO.md)
- **🧰 हेडलेस मोड** — `omniroute serve --headless` (या `OMNIROUTE_HEADLESS=1`) केवल `/v1/*` प्रॉक्सी इंजन चलाता है, जबकि डैशबोर्ड और केवल-डैशबोर्ड सबसिस्टम बंद रहते हैं। → [हेडलेस मोड](docs/guides/HEADLESS.md)
- **🔎 मॉडल खोज** — `/v1/models` क्षमता, कॉन्टेक्स्ट, प्रकार और टेक्स्ट के अनुसार फ़िल्टर करता है, और `POST /v1/models/query` समान प्रति-कुंजी दृश्यता के साथ एक छोटी, नियतात्मक शॉर्टलिस्ट लौटाता है। → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🔑 प्रति-कुंजी रूटिंग नियंत्रण** — `forcedModel` के साथ किसी API कुंजी को एक मॉडल या कॉम्बो से जोड़ें, और किसी कुंजी के मॉडल व कॉम्बो को एटॉमिक रूप से जोड़ें या हटाएँ (`/api/keys/{id}/access`)। → [API संदर्भ](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ अधिक सूक्ष्म PII नियंत्रण** — प्रति-प्रकार चयन, अधिकतम 20 सत्यापित कस्टम मास्किंग पैटर्न और प्रति-प्रकार पहचान काउंटर; मास्किंग स्वयं ऑप्ट-इन बनी रहती है। → [गार्डरेल्स](docs/security/GUARDRAILS.md)
- **🌍 67 भाषाएँ** — डैशबोर्ड, दस्तावेज़ मिरर और CLI में उपलब्ध; `npm run i18n:add-locale` एक ही कमांड से हर जगह भाषा जोड़ता है। → [i18n मार्गदर्शिका](docs/guides/I18N.md)
- **🎛️ OmniConductor** — आपके एजेंट समूह के लिए इनबाउंड A2A डेलीगेशन, Agent Card पर Conductor कौशल और Faro पुश-टू-टॉक वॉइस चैट वाला डैशबोर्ड पैनल। → [A2A सर्वर](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूली प्रवेश और ओवरलोड सुरक्षा** — भारी चैट अनुरोध 503 लौटाने के बजाय कतार में लगते हैं, और प्रत्येक कनेक्शन के लिए एटॉमिक RPM रोलिंग लीज़ उपलब्ध हैं। → [रेज़िलिएंस मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ कैनोनिकल `/v1/models` क्रम** — प्रत्येक प्रदाता के लिए एक सतत, प्रदाता-समूहित ब्लॉक (कॉम्बो सबसे पहले), जो प्रत्येक कैटलॉग स्रोत में स्थिर रहता है। → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🗜️ कम्प्रेशन सुदृढ़ीकरण** — डिफ़ॉल्ट रूप से चालू इन्फ्लेशन गार्ड, DE / FR / JA + चीनी (wényán) के लिए Caveman पैक, और Gradle व .NET के लिए RTK फ़िल्टर। → [कम्प्रेशन](docs/compression/COMPRESSION_ENGINES.md)
- **💸 पारदर्शी फ़्लैट-रेट लागत** — सदस्यता / कोडिंग-प्लान प्रदाता लागत विश्लेषण में **$0** दिखाते हैं; बजट, कोटा और रूटिंग में अनुमान जारी रहता है। → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **⚖️ कोटा-शेयर रूटिंग** — साझा खाते का कोटा पूल की गई कुंजियों के बीच निष्पक्ष रूप से बाँटती है और कार्य-संरक्षण के लिए निष्क्रिय हिस्से दूसरों को उधार देती है। → [रेज़िलिएंस मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एक-कमांड CLI/एजेंट सेटअप** — 15 पंजीकृत `setup-*` कमांड; `omniroute run` 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) लॉन्च करता है; `omniroute configure` इंटरैक्टिव प्रदाता+मॉडल चयनकर्ता और प्रति-कॉन्टेक्स्ट पसंदीदा विकल्पों के साथ 11 लक्ष्यों का समर्थन करता है। → [CLI एकीकरण](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ रिमोट मोड** — स्कोप किए गए टोकन (`connect` / `contexts` / `tokens`) और VPS इंस्टॉलेशन के लिए एक `antigravity` OAuth सहायक के साथ रिमोट OmniRoute संचालित करें। → [रिमोट मोड](docs/guides/REMOTE-MODE.md)
- **🧭 अधिक स्मार्ट ऑटो-रूटिंग** — `auto/:` कॉम्बो, **Fusion** (मॉडल पैनल + जज), कार्य-जागरूक रूटिंग, और प्रति-अनुरोध मॉडल / मोड / USD-बजट ओवरराइड। → [ऑटो-कॉम्बो](docs/routing/AUTO-COMBO.md)
- **🗜️ प्लग करने योग्य कम्प्रेशन** — 12 संयोज्य इंजन + Compression Studios: LLMLingua-2, दो-स्तरीय Ultra, omniglyph, प्रति-चरण फ़िडेलिटी गेट, GCF v3.2 और ड्रैग-रीऑर्डर संपादक। → [कम्प्रेशन](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ पारदर्शी MITM डिक्रिप्शन (TPROXY)** — प्रति-SNI CA और ट्रस्ट-स्टोर इंस्टॉलर के साथ उन CLI को कैप्चर करें जो प्रॉक्सी एनवायरनमेंट वेरिएबल की अनदेखी करते हैं। → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 हर जगह लागत टेलीमेट्री** — प्रत्येक एंडपॉइंट पर `X-OmniRoute-*` लागत/उपयोग हेडर, कैश-HIT बचत हेडर और प्रति-कुंजी USD खर्च कोटा। → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🧠 आपके नियंत्रण वाली मेमोरी** — डिफ़ॉल्ट रूप से बंद, ऑप्ट-इन int8 वेक्टर क्वांटाइज़ेशन + टाइप्ड डिके और प्रति-अनुरोध `x-omniroute-no-memory`। → [मेमोरी](docs/frameworks/MEMORY.md)
- **🛡️ सुरक्षा** — प्रत्येक LLM रूट पर प्रॉम्प्ट-इंजेक्शन गार्ड (रेड-टीम सुइट), ऑप्ट-इन क्रेडेंशियल-मास्किंग गार्डरेल (दोनों दिशाओं में लीक हुई API कुंजियों/सीक्रेट को छिपाता है), निःशुल्क अंतिम-विकल्प DuckDuckGo वेब खोज और डैशबोर्ड के लिए वैकल्पिक OIDC लॉगिन गेट (पासवर्ड लॉगिन हमेशा उपलब्ध रहता है)। → [गार्डरेल्स](docs/security/GUARDRAILS.md)
- **🖼️ नए एंडपॉइंट** — `/v1/ocr` (Mistral OCR) और `/v1/audio/translations` (Whisper-शैली) मीडिया सुविधाओं को पूर्ण बनाते हैं। → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🎨 इमेज / वीडियो / ऑडियो जनरेशन** — मीडिया के लिए एक API: xAI Grok Imagine और Novita AI वीडियो, ComfyUI, Magnific, Adobe Firefly, Segmind तथा ElevenLabs जैसे स्पीच प्रदाता। → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🌍 डिप्लॉयमेंट और संचालन** — रिवर्स-प्रॉक्सी `basePath`, ब्राउज़र-भाषा का स्वतः पता लगाना, प्रति-कुंजी डिवाइस ट्रैकिंग, रूट-रहित MITM ट्रस्ट और zh-TW स्थानीयकरण। → [एनवायरनमेंट](docs/reference/ENVIRONMENT.md)
- **🤝 अधिक प्रदाता और एजेंट** — क्लाउड एजेंट (Codex Cloud, Cursor, Devin, Jules), ब्राउज़र + OAuth लॉगिन वाला Grok Build (xAI), प्रथम-श्रेणी Ollama कार्ड, Claude Opus 5 और Sonnet 5, Kimi की आधिकारिक साझेदारी (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… और नया रूप दिया गया **375-प्रदाता कैटलॉग**। → [प्रदाता](docs/reference/PROVIDER_REFERENCE.md)
- **📡 रूटिंग पारदर्शिता** — प्रत्येक प्रतिक्रिया में उसे सेवा देने वाली रणनीति/प्रदाता/लेटेंसी बताने वाला `X-OmniRoute-Decision` हेडर होता है; नई `cache-optimized` कॉम्बो रणनीति + ऑटो-कॉम्बो `cacheAffinity` फ़ैक्टर दोहराए गए अनुरोधों को कैश किया हुआ प्रीफ़िक्स रखने वाले कनेक्शन पर वापस भेजते हैं; और केवल-पठन `/v1/auto-combo/{channel}/candidates` एंडपॉइंट किसी `auto/*` चैनल का लाइव कैंडिडेट पूल दिखाता है। → [ऑटो-कॉम्बो](docs/routing/AUTO-COMBO.md)
- **⚡ स्थानीय प्रदर्शन और इन्फ्रा** — एक-क्लिक स्थानीय Redis, Cloudflare Workers / Deno Deploy रिले डिप्लॉयर, Bifrost और Mux सुपरवाइज़्ड एम्बेडेड सेवाओं के रूप में। → [एम्बेडेड सेवाएँ](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 इसके अलावा भी शामिल है** — प्लगइन फ्रेमवर्क + मार्केटप्लेस, Omni/Agent/GitHub स्किल्स फ्रेमवर्क, Obsidian वॉल्ट इंटीग्रेशन (22 MCP टूल्स), OpenAI-संगत Batch और Files API, सिमैंटिक रिस्पॉन्स कैश, लीडरबोर्ड के साथ गेमिफ़िकेशन, ACP एजेंट डिस्कवरी (15 बिल्ट-इन एजेंट), BigQuery में शेड्यूल्ड लॉग एक्सपोर्ट, `auto/chaos` समानांतर मल्टी-मॉडल फ़ैन-आउट, एक Telegram बॉट ब्रिज, एक इन-ऐप वर्ज़न मैनेजर और LMArena-ELO फ़्री-प्रोवाइडर रैंकिंग्स। → [दस्तावेज़](docs/README.md)
## 🤖 संगत CLIs और कोडिंग एजेंट
> एक कॉन्फ़िगरेशन — `http://localhost:20128/v1` — और **हर** AI IDE या CLI मुफ़्त और कम लागत वाले मॉडलों पर चलता है।
＋ इनके साथ भी काम करता है · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · कोई भी OpenAI-संगत टूल
📖 सभी 37 टूल (27 CLI Code + 10 CLI Agents) के लिए प्रति-टूल सेटअप → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode प्लगइन → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**OmniRoute के माध्यम से किसी भी समर्थित CLI को एक कमांड में लॉन्च करें** — कोई कॉन्फ़िगरेशन फ़ाइल नहीं लिखी जाती,
प्रत्येक प्रोसेस में क्रेडेंशियल इंजेक्ट किए जाते हैं, और Qwen/Gemini को एक अस्थायी पृथक होम मिलता है:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# या इंटरैक्टिव रूप से प्रोवाइडर+मॉडल चुनें और टूल का अपना कॉन्फ़िगरेशन लिखें:
omniroute configure codex # ये भी: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
प्रत्येक कमांड सक्रिय रिमोट कॉन्टेक्स्ट (`omniroute connect `) का पालन करता है, `--dry-run`
निष्पादन किए बिना सटीक env/args का पूर्वावलोकन दिखाता है, और `--api-key-env NAME` सीक्रेट्स को
आपकी शेल हिस्ट्री से बाहर रखता है। → [CLI इंटीग्रेशन](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 AI प्रदाता — 153 कैटलॉग-चिह्नित मुफ़्त
> **मानक चैट, मीडिया, खोज, स्थानीय, क्लाउड-एजेंट और सिस्टम संग्रहों में 375 पंजीकृत प्रदाता**, जिनमें **153 `hasFree: true` डिस्कवरी मेटाडेटा वाले** शामिल हैं। चैट मॉडल रजिस्ट्री **239 प्रदाता / 3,059 विशिष्ट प्रदाता-मॉडल जोड़े / 1,475 कच्चे मॉडल ID** को कवर करती है; अलग मुफ़्त-बजट कैटलॉग में **467 प्रति-मॉडल पंक्तियाँ**, **34 आवर्ती पूल** और **51 आवर्ती/कीलेस हमेशा-मुफ़्त प्रदाता** हैं। ये जानबूझकर अलग-अलग भाजक हैं; परिभाषाएँ और पूल-डीडुप्लिकेट गणनाएँ [प्रदाता संदर्भ](docs/reference/PROVIDER_REFERENCE.md) और [निःशुल्क स्तर](docs/reference/FREE_TIERS.md) में मौजूद हैं।
### 🏢 हर प्रमुख लैब — एक ही एंडपॉइंट के ज़रिए
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…और 350+ अधिक — हर आइकन डैशबोर्ड के प्रदाता कैटलॉग से लाइव रिज़ॉल्व होता है। 📖 [प्रदाता संदर्भ](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 हमेशा के लिए मुफ़्त — $0, कोई कार्ड नहीं
OpenCode Zen DeepSeek V4, Nemotron 3 कोई टोकन कैप नहीं
Kilo Code Auto-router, Tencent Hy3 हमेशा के लिए मुफ़्त
Requesty GPT-OSS 120B, Nemotron हमेशा के लिए मुफ़्त
SiliconFlow DeepSeek V3.2 / R1 मुफ़्त टियर
Z.AI GLM GLM-4.7 / 4.5-Flash हमेशा के लिए मुफ़्त
Baidu ERNIE ERNIE 4.0 हमेशा के लिए मुफ़्त
Qoder AI Qwen3-Max, Kimi-K2 असीमित मुफ़्त
Pollinations GPT, Llama, Claude की ज़रूरत नहीं
Cloudflare AI 50+ मॉडल 10K न्यूरॉन/दिन
NVIDIA NIM GLM, MiniMax ~40 RPM मुफ़्त
Cerebras GLM 4.7, GPT-OSS एकबारगी $5 क्रेडिट; कार्ड आवश्यक
OpenRouter :free मॉडल +$10 → अधिक RPM
📖 पूरा मशीन-पठनीय कैटलॉग → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute कहाँ चलता है — हर जगह
> वही ऐप, आपकी मशीन, आपके नियम। वैश्विक npm इंस्टॉल से लेकर Termux के ज़रिए **आपके फ़ोन** तक।
प्लेटफ़ॉर्म
इंस्टॉल
मुख्य विशेषताएँ
📦 npm (वैश्विक)
npm install -g omniroute
एक कमांड, कोई भी OS
🐳 Docker
docker run … diegosouzapw/omniroute
मल्टी-आर्क AMD64 + ARM64
🖥️ डेस्कटॉप (Electron)
npm run electron:build
नेटिव विंडो + सिस्टम ट्रे — Windows / macOS / Linux
🎩 मेन्यू-बार (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
सर्वर की निगरानी और स्वतः अपडेट करता है — macOS
💪 ARM
नेटिव arm64
Raspberry Pi, ARM सर्वर, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
आपके फ़ोन पर, 24/7, बिना root के चलता है
📲 PWA
"होम स्क्रीन पर जोड़ें"
फ़ुलस्क्रीन, ऑफ़लाइन, ब्राउज़र से इंस्टॉल करने योग्य
🧩 OpenCode प्लगइन
@omniroute/opencode-provider
नेटिव OpenCode एकीकरण
🤖 VS Code Copilot Chat
OmniCopilot एक्सटेंशन इंस्टॉल करें
नेटिव Copilot Chat चयनकर्ता में प्रत्येक OmniRoute मॉडल — स्थिर और Insiders
### 🧩 नया: VS Code के नेटिव Copilot Chat के भीतर OmniRoute
> कोई नया साइडबार नहीं, कोई नया चैट UI नहीं — OmniRoute द्वारा उपलब्ध कराया गया प्रत्येक मॉडल सीधे उस
> **Copilot Chat मॉडल चयनकर्ता में दिखाई देता है जिसका आप पहले से उपयोग करते हैं**। VS Code 1.122 से, प्रदाता मॉडल
> GitHub साइन-इन या Copilot सदस्यता के बिना काम करते हैं — एजेंट मोड, टूल कॉलिंग और विज़न,
> निःशुल्क।
**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** एक्सटेंशन इंस्टॉल करें, इसे
अपने OmniRoute सर्वर की ओर निर्देशित करें (डिफ़ॉल्ट `localhost:20128` है), फिर Copilot Chat → मॉडल चयनकर्ता
→ **मॉडल प्रबंधित करें…** → **OmniRoute** खोलें।
एडिटर के भीतर से: **एक्सटेंशन** दृश्य खोलें, **"OmniRoute"** खोजें, **इंस्टॉल करें** पर क्लिक करें
— दोनों स्टोर पर समान तरीके से काम करता है। स्रोत, समस्याएँ और प्रकाशन रनबुक
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) पर उपलब्ध हैं।
📖 [VS Code Copilot Chat मार्गदर्शिका](docs/guides/VSCODE-COPILOT.md) — सेटअप, चयनकर्ता क्या दिखाता है, टैब में डैशबोर्ड, समस्या निवारण
### 🎩 नया: OmniRouteTray — आपका गेटवे, जो मेन्यू बार में रहता है
> `omniroute serve` हमेशा चालू रहने पर सबसे अच्छा काम करता है। **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> इसे macOS के लिए एक बार सेट करके भूल जाने योग्य मेन्यू-बार ऐप में बदल देता है: यह सर्वर शुरू करता है, रीबूट के
> बाद भी उसे चालू रखता है, उसे वहीं अपडेट करता है और आपके लाइव टोकन बजट को एक क्लिक की दूरी पर रखता है — **किसी
> टर्मिनल विंडो को खुला रखने की ज़रूरत नहीं, न ही `npm install -g omniroute` की देखरेख करनी पड़ती है।**
[Tauri v2](https://v2.tauri.app/) (एक Rust कोर, जिसका आकार नगण्य है) के साथ निर्मित, यह
अपने स्वयं के हस्ताक्षरित Node 24 रनटाइम के साथ आता है और ऐप-स्वामित्व वाले OmniRoute इंस्टॉल का प्रबंधन करता है, इसलिए यह कभी भी आपके
वैश्विक `node`/`bun` से टकराता नहीं है। यह **आपके मौजूदा `~/.omniroute/` कॉन्फ़िगरेशन और डेटाबेस को साझा करता है** — इसलिए यह
वही OmniRoute है जिसे आप पहले से चलाते हैं, बस इसने एक टोपी पहन रखी है। 🎩
यह क्या करता है
कैसे
🟢 सर्वर की निगरानी करता है
omniroute serve शुरू करता है, और उसकी प्रतिलिपि बनाने के बजाय पहले से चल रहे इंस्टेंस को अपना लेता है
📊 एक नज़र में लाइव उपयोग
प्रदाता कोटा बार, रीसेट काउंटडाउन सहित Claude सत्र/साप्ताहिक सीमाएँ, 30-दिन का लागत विवरण
🔄 वहीं स्वतः अपडेट करता है
चरणबद्ध इंस्टॉल, एटॉमिक स्वैप, विफलता पर रोलबैक — हमेशा नवीनतम रिलीज़ पर
🚀 लॉगिन पर शुरू करें
लॉगिन पर वैकल्पिक लॉन्च; केवल ट्रे, कोई डॉक आइकन नहीं
🩺 डॉक्टर और लॉग
एक-क्लिक निदान और सर्वर लॉग तक पहुँच
```sh
brew install --cask zoispag/tap/omniroute-tray
```
डाउनलोड करना पसंद है? नवीनतम .dmgरिलीज़ से प्राप्त करें। स्रोत, समस्याएँ और बिल्ड
दस्तावेज़ zoispag/omniroute-tray पर उपलब्ध हैं।
💛 @zoispag द्वारा एक सामुदायिक परियोजना — यह आधिकारिक OmniRoute रिलीज़ नहीं है।
> सर्वर के अलावा, OmniRoute एक **पूर्ण कमांड-लाइन कॉकपिट** है, जिसमें **80+ कमांड** और खुले एजेंट प्रोटोकॉल हैं, ताकि कोई AI एजेंट इसे **स्वयं** संचालित कर सके।
### ⌨️ एक वास्तविक CLI (सिर्फ़ `start` नहीं)
```bash
omniroute # गेटवे + डैशबोर्ड उपलब्ध कराएँ (पोर्ट 20128)
omniroute chat # इंटरैक्टिव TUI चैट क्लाइंट (स्लैश: /model /combo /skill /memory)
omniroute setup # पहली बार चलाने के लिए निर्देशित विज़ार्ड
omniroute doctor # प्रदाताओं, पोर्ट और नेटिव निर्भरताओं का निदान करें
```
### 🛰️ रिमोट मोड — CLI यहाँ चलाएँ, OmniRoute को VPS पर
OmniRoute किसी सर्वर पर है? इसे अपने लैपटॉप से **उसी CLI** के ज़रिए संचालित करें। सीमित-दायरे वाले एक्सेस टोकन से एक बार
लॉग इन करें; उसके बाद प्रत्येक कमांड रिमोट को लक्षित करेगा।
```bash
omniroute connect 192.168.0.15 # पासवर्ड → सीमित-दायरे वाला टोकन, कॉन्टेक्स्ट के रूप में सहेजा जाता है
omniroute models # ← रिमोट सर्वर पर चलता है
omniroute configure codex # ← रिमोट मॉडल चुनता है, स्थानीय Codex प्रोफ़ाइल लिखता है
omniroute tokens create --name ci --scope read # अन्य मशीनों के लिए अधिक सीमित टोकन बनाएँ
omniroute contexts use default # ← स्थानीय सर्वर पर वापस जाएँ
```
टोकन के दायरे `read` / `write` / `admin` होते हैं; प्रोसेस शुरू करने वाले रूट केवल लूपबैक तक सीमित रहते हैं।
📖 [रिमोट मोड](docs/guides/REMOTE-MODE.md)
### 🤝 किसी एजेंट को कनेक्ट करें — और वह स्वयं OmniRoute को नियंत्रित करेगा
OmniRoute को **MCP**, **A2A**, **REST API**, **webhooks** या **रिमोट CLI** के माध्यम से उपलब्ध कराएँ — कोई भी सक्षम एजेंट (या आपका अपना कोड) पूरे गेटवे को नियंत्रित कर सकता है: रूटिंग, प्रदाता, कॉम्बो, कैश, कम्प्रेशन, मेमोरी — स्वायत्त रूप से। नीचे दिए गए HTTP एंडपॉइंट `http://localhost:20128` के अंतर्गत उपलब्ध होते हैं।
इंटरफ़ेस
एंडपॉइंट / कमांड
इसका उपयोग करें
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor या किसी भी MCP क्लाइंट से जोड़ने के लिए
अनुरोध / कोटा इवेंट को Slack, Discord, Telegram या किसी भी URL पर पुश करने के लिए
🛰️ रिमोट CLI
omniroute connect
सीमित-दायरे वाले एक्सेस टोकन से रिमोट इंस्टेंस संचालित करने के लिए
```bash
# Claude Code को MCP के माध्यम से पूरा OmniRoute टूलसेट दें:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP सर्वर](docs/frameworks/MCP-SERVER.md) · [A2A सर्वर](docs/frameworks/A2A-SERVER.md) · [एजेंट प्रोटोकॉल](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 15–95% टोकन बचाएं — स्वचालित रूप से
### 📖 यह कैसे काम करता है — पाइपलाइन, आर्किटेक्चर और बचत का गणित
डिफ़ॉल्ट स्टैक्ड कॉम्बो `RTK → Caveman` चलाता है। जब दोनों एक ही tool/context payload पर काम करते हैं, तो बचत संयुक्त हो जाती है:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लॉक, URLs, JSON और संरचित डेटा preservation engine द्वारा **हमेशा सुरक्षित** रहते हैं।
> **जब कुछ ही टोकन काम कर देते हैं, तो ढेर सारे टोकन क्यों इस्तेमाल करें?** हर request OmniRoute की compression pipeline से **पारदर्शी रूप से** गुज़रती है — क्लाइंट में कोई बदलाव नहीं। यह अब **12 composable engines का स्टैक** है जो क्रम से चलते हैं और प्रति routing combo mix & match होते हैं — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) और [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) के विचारों पर आधारित।
### 🧱 12-engine स्टैक
Engines pipeline क्रम में चलते हैं; प्रत्येक को अलग से toggle किया जा सकता है और प्रति combo कॉन्फ़िगर किया जा सकता है:
#
Engine
यह क्या करता है
1
Session-Dedup
टर्न्स के बीच दोहराई गई सामग्री को हटा देता है (content-addressed, cross-turn)
2
CCR
बड़े ब्लॉक्स को retrieve markers के पीछे आर्काइव करता है, जिन्हें माँगने पर लाया जाता है
3
Lite
Whitespace + image-URL ट्रिमिंग (कम विलंब वाला बेसलाइन)
4
RTK
स्मार्ट tool-result फ़िल्टरिंग, dedup और truncation (command-aware)
5
Responses Tool Output
shell/patch/search/build आउटपुट के लिए lossless-first JSON + सीमित diagnostic compression (Responses API)
6
Headroom
vendored GCF codec के ज़रिए JSON arrays का lossless tabular compaction (~30%)
7
Relevance
अंतिम user query के मुकाबले extractive sentence scoring
8
Caveman
नियम-आधारित prose compression (आउटपुट पर ~65–75%)
9
Aggressive
पुराने turns का summarization + progressive aging
10
LLMLingua-2
MobileBERT ONNX के ज़रिए ML semantic pruning — code-safe, async
11
Ultra
वैकल्पिक small-model (SLM) tier के साथ heuristic token pruning
12
OmniGlyph
प्रयोगात्मक context-as-image encoding, जो सीधे Anthropic wire पर मापे गए Claude Fable 5 के लिए है; provider receipts मिलने तक GPT 5.6 transformers fail-closed रहते हैं। चार compression profiles (aggressive डिफ़ॉल्ट, balanced, coding-safe, passthrough) (सबसे आक्रामक; opt-in)
कोड ब्लॉक, URLs और संरचित डेटा **हमेशा** byte-perfect सुरक्षित रहते हैं। **One-click presets** engines को जोड़ते हैं:
मोड
बचत
किसके लिए सर्वोत्तम
🪶 Lite
~15%
हमेशा चालू रहने वाला सुरक्षित डिफ़ॉल्ट
🪨 Standard (Caveman)
~30%
रोज़ाना की कोडिंग
⚡ Aggressive
~50%
tool-भारी लंबे sessions
🔥 Ultra
~75%
अधिकतम बचत
🧰 RTK
60–90%
Shell/test/build/git आउटपुट
🔗 Stacked (RTK → Caveman)
78–95%
मिश्रित prompts + tool logs
**असली उदाहरण — Standard मोड:**
> **पहले (69 tokens):** _"आपका React component दोबारा render होने का कारण संभवतः यह है कि आप हर render cycle में एक नया object reference बना रहे हैं। जब आप एक inline object को prop के रूप में पास करते हैं, तो React का shallow comparison इसे हर बार एक अलग object मानता है, जिससे re-render शुरू हो जाता है। मेरा सुझाव है कि object को memoize करने के लिए useMemo का उपयोग करें।"_
>
> **बाद में (19 tokens):** _"हर render पर नया object ref। Inline object prop = नया ref = re-render। useMemo में लपेटें।"_
>
> **वही जवाब। 72% कम tokens। शून्य accuracy loss।** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) मोड:**
> **पहले (42 टोकन):** _"समस्या यह है कि कंपोनेंट फिर से रेंडर हो रहा है क्योंकि हर रेंडर चक्र में एक नया ऑब्जेक्ट संदर्भ बनाया जा रहा है। मैं `useMemo` इस्तेमाल करने की सलाह दूँगा।"_
>
> **बाद में (12 टोकन):** _"फिर से रेंडर: हर चक्र में नया संदर्भ (इनलाइन ऑब्जेक्ट फिर से बनाया गया)। `useMemo` इस्तेमाल करें।"_
>
> **वही उत्तर। ~70% कम टोकन। तकनीकी सटीकता बरकरार।** ✅
### 🎚️ इंजनों से आगे — आउटपुट स्टाइल, अनुकूली डायल और प्रति-अनुरोध नियंत्रण
ऊपर दिए गए 12 इंजन यह छोटा करते हैं कि **अंदर क्या जाता है**। तीन और परतें यह तय करती हैं कि **कैसे**, **कब**, और **बाहर क्या आता है**:
- **🪄 आउटपुट स्टाइल** _(आउटपुट-अक्ष स्टीयरिंग)_ — नियतात्मक, कैश-सुरक्षित प्रतिक्रिया-आकार देने वाले निर्देश इंजेक्ट करें; संयोजनीय, प्रत्येक `lite` / `full` / `ultra` तीव्रता पर। स्टाइल जोड़ना एक पंक्ति की रजिस्ट्री प्रविष्टि है:
- **संक्षिप्त गद्य** — भरती / आर्टिकल / हेजिंग हटाएँ; तकनीकी सार बिल्कुल वैसा ही रखें।
- **कम कोड** — "आलसी सीनियर डेव" YAGNI: सबसे छोटा काम करने वाला बदलाव, बिना माँगे गए स्कैफोल्डिंग के।
- **Ponytail (आलसी सीनियर डेव)** — YAGNI सीढ़ी चढ़ें, मूल कारण ठीक करें, सबसे छोटा काम करने वाला diff।
- **मुझे ADHD है (क्रिया-प्रथम)** — अगली क्रिया पहले, चरण संख्या में, एक ठोस अगला कदम, कोई प्रस्तावना नहीं।
- **संक्षिप्त CJK (文言)** — शास्त्रीय-चीनी अति-संक्षिप्त शैली (`zh` तक लोकेल-सीमित)।
- **🎯 अनुकूली संदर्भ-बजट** _(डायल)_ — एक चालू/बंद टोकन थ्रेशोल्ड के बजाय, केवल उतना ही आगे बढ़ाएँ जितना **मॉडल की संदर्भ विंडो में फ़िट होने** के लिए ज़रूरी हो, सबसे सस्ते, सबसे कम-हानि वाले इंजनों को। नीति: `reserve-output` (डिफ़ॉल्ट, मॉडल-जागरूक) · `percentage` · `absolute`। मोड: `floor` (फिट की गारंटी) · `replace-autotrigger` (आपकी स्पष्ट पसंद जीतती है) · `off` (लेगेसी थ्रेशोल्ड)।
- **🎛️ संपीड़न कहाँ तय होता है** _(प्राथमिकता, उच्च → निम्न)_ — प्रति-अनुरोध `x-omniroute-compression` हेडर › राउटिंग-कॉम्बो ओवरराइड › सक्रिय नामित प्रोफ़ाइल › अनुकूली / ऑटो-ट्रिगर › पैनल डिफ़ॉल्ट › बंद। लागू योजना प्रतिक्रिया हेडर `X-OmniRoute-Compression: ; source=` में वापस दिखती है।
टोकन थ्रेशोल्ड से ऑटो-ट्रिगर करें, अनुकूली डायल चालू करें, नामित प्रोफ़ाइल पिन करें, प्रति अनुरोध एक-बार का सेट करें, या प्रति राउटिंग कॉम्बो पाइपलाइन असाइन करें — जो भी वर्कलोड में फ़िट हो। एक वैकल्पिक ऑफ़लाइन **eval harness** (`npm run eval:compression`) किसी बदलाव को प्रोमोट करने से पहले एक पिन किए गए कॉर्पस पर फ़िडेलिटी बनाम बचत को स्कोर करता है।
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ त्वरित शुरुआत
**1) इंस्टॉल करें और चलाएँ**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` या peer-dep चेतावनियाँ देख रहे हैं? [ये हानिरहित हैं](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 या बाद का उपयोग कर रहे हैं?** npm पैकेज लाइफ़साइकल स्क्रिप्ट्स को ब्लॉक कर सकता है जब तक उन्हें अनुमति न दी जाए। OmniRoute का `postinstall` (`node scripts/build/postinstall.mjs`) इसकी नेटिव रनटाइम फ़ाइलें तैयार करने के लिए आवश्यक है। ग्लोबली इंस्टॉल करते समय npm की चेतावनी में नामित पैकेजों को अनुमति दें। OmniRoute 3.8.53 द्वारा रिपोर्ट किए गए पैकेज सेट के लिए:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> भविष्य के ग्लोबल इंस्टॉल के लिए इस allowlist का पुन उपयोग करने के लिए, इसे एक बार कॉन्फ़िगर करें, फिर सामान्य रूप से इंस्टॉल करें:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> डिपेंडेंसी सूची रिलीज़ के बीच बदल सकती है; अगर npm कोई अलग सूची रिपोर्ट करता है, तो उस चेतावनी में दिए पैकेज नामों का उपयोग करें। पैकेज को अनुमति देने से उसकी इंस्टॉल स्क्रिप्ट चल सकती हैं।
> **Gemini Web या किसी अन्य वेब-कुकी प्रोवाइडर का उपयोग कर रहे हैं?** npm पैकेज में
> Playwright शामिल है लेकिन उसका Chromium बाइनरी नहीं। पहला वेब-प्रोवाइडर अनुरोध करने से पहले
> [Playwright Chromium सेटअप](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> नोट देखें।
डैशबोर्ड `http://localhost:20128` पर · API `http://localhost:20128/v1` पर।
**2) अपने स्वयं के खाते का उपयोग करके एक योग्य प्रोवाइडर कनेक्ट करें**
डैशबोर्ड → **Providers** → ऐसा प्रोवाइडर चुनें जिसकी वर्तमान शर्तें और कोटा आपके उपयोग-केस में फ़िट हों → उसकी API key जोड़ें या उसका account flow पूरा करें। मुफ़्त टियर के लिए साइनअप, अनुमोदन, या भुगतान विधि की आवश्यकता हो सकती है। [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) देखें; keyless उपलब्धता की गारंटी नहीं है, और `tos: avoid` चिह्नित प्रोवाइडर डिफ़ॉल्ट रूप से `auto` से बाहर रखे जाते हैं।
**3) अपने कोडिंग टूल को कॉन्फ़िगर करें**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) जाँचें कि यह काम कर रहा है**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
आपको अपने कनेक्टेड मॉडल सूचीबद्ध दिखने चाहिए। 🎉 बस इतना ही — कोडिंग शुरू करें, और OmniRoute आपके लिए ऑटो-रूट और फ़ॉलबैक करेगा।
यदि आपका क्लाइंट कस्टम हेडर नहीं भेज सकता, तो OmniRoute टोकनयुक्त संगतता उपनाम भी उजागर करता है:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
इनका उपयोग केवल उन क्लाइंट के लिए करें जो `Authorization: Bearer ...` संलग्न नहीं कर सकते। हेडर प्रमाणीकरण पसंदीदा मोड बना रहता है।
## 📦 इंस्टॉल करने के और तरीके — Docker, सोर्स, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` उच्चतम **प्रकाशित** स्थिर SemVer का अनुसरण करता है। यह git `main` को ट्रैक नहीं करता। GitOps के लिए `:X.Y.Z` पिन करें। [Docker रिलीज़ चैनल](docs/guides/DOCKER_GUIDE.md#release-channels) देखें। इमेज में **`OMNIROUTE_MEMORY_MB=1024`** पिन किया गया है। यह डैशबोर्ड और हल्की चैट के लिए पर्याप्त है। **कोडिंग एजेंटों** (Claude Code, Codex, Grok, … से `POST /v1/responses`) को कहीं बड़े V8 हीप की आवश्यकता होती है, अन्यथा दो ओवरलैप करते लंबे कॉन्टेक्स्ट के अंतर्गत लगभग 12 GiB पर प्रक्रिया में `FATAL ERROR` होता है। कंटेनर का आकार हीप से अधिक रखें (नेटिव बफ़र V8 के बाहर रहते हैं):
| वर्कलोड | हीप (`-e OMNIROUTE_MEMORY_MB`) | कंटेनर (`--memory`) |
| ------------------------------- | ------------------------------ | ------------------- |
| डैशबोर्ड / हल्की चैट | `1024` (इमेज डिफ़ॉल्ट) | ≥2 g |
| एक कोडिंग एजेंट | `8192` | ≥10 g |
| दो समवर्ती लंबे `/v1/responses` | `10240`–`12288` | ≥12–16 g |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
पूरी तालिका: [Docker गाइड — रनटाइम RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents)।
> **प्री-रिलीज़ Docker चैनल:** `diegosouzapw/omniroute:next` और
> `diegosouzapw/omniroute:next-web` वर्तमान डिफ़ॉल्ट `release/v*`
> ब्रांच का अनुसरण करते हैं। ये परिवर्तनीय टैग केवल अप्रकाशित सुधारों के परीक्षण के लिए हैं और
> **प्रोडक्शन के लिए समर्थित नहीं हैं**। देखें
> [Docker रिलीज़ चैनल](docs/guides/DOCKER_GUIDE.md#release-channels)।
**🥟 Bun**
मानक `bun install` और ग्लोबल इंस्टॉलेशन (`bun install -g omniroute`) Bun रनटाइम डिटेक्शन के माध्यम से समर्थित हैं:
- **बिल्ट-इन `bun:sqlite`**: Bun के अंतर्गत चलते समय OmniRoute, Bun के बिल्ट-इन `bun:sqlite` ड्राइवर का उपयोग करता है और Node.js पर `better-sqlite3` या `sql.js` पर फ़ॉलबैक करता है।
- **डेव में स्वचालित Webpack बंडलर चयन**: डेवलपमेंट (`bun run dev`) स्वचालित रूप से Bun का पता लगाता है और नेटिव V8 बाइंडिंग असंगतियों को रोकने के लिए Turbopack को अक्षम करके Webpack का उपयोग करता है। प्रोडक्शन बिल्ड (`bun run build`), Node की तरह ही `OMNIROUTE_USE_TURBOPACK` का सटीक रूप से अनुसरण करते हैं: डिफ़ॉल्ट रूप से Turbopack, जबकि Webpack से बिल्ड करने के लिए `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` इसे `--build-arg` के रूप में उपलब्ध कराता है)।
- **समर्पित Bun Dockerfile**: नेटिव Bun प्रोडक्शन डिप्लॉयमेंट के लिए मल्टी-स्टेज `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`)।
```bash
# Bun के साथ इंस्टॉल करें और चलाएँ
bun install
bun run dev
```
**🛠️ सोर्स से**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flakes का उपयोग करके
nix develop
npm run dev
# या devbox का उपयोग करके
devbox run npm run dev
```
📖 [Docker गाइड](docs/guides/DOCKER_GUIDE.md) — Compose प्रोफ़ाइल, Caddy HTTPS, Cloudflare टनल।
**🦭 Podman**
```bash
# 1. बाइंड-माउंटेड डेटा डायरेक्टरी तैयार करें
mkdir -p data
# 2. केवल Linux + स्थानीय रूटलेस Podman (रिमोट Podman Machine क्लाइंट पर कभी नहीं):
podman unshare chown 1000:1000 ./data
# 3. रनटाइम संकेत सेट करें, स्थानीय Compose इमेज बिल्ड करें और शुरू करें
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS या Windows पर, Podman रिमोट Podman Machine का उपयोग करता है: `podman unshare` को छोड़ दें और
[टोपोलॉजी-विशिष्ट डेटा डायरेक्टरी मार्गदर्शन](contrib/podman/README.md#data-directory-permissions-by-topology) का पालन करें।
📖 [Podman गाइड](contrib/podman/README.md) — Compose बिल्ड, Podman Machine, और
Linux/systemd Quadlet सेटअप।
**⚡ अधिक तेज़ / हल्का इंस्टॉल (नेटिव बिल्ड छोड़ें)**
नेटिव SQLite इंजन (`better-sqlite3`) एक **वैकल्पिक** डिपेंडेंसी है, इसलिए ग्लोबल
इंस्टॉल कभी भी सोर्स से कंपाइल करने के कारण अवरुद्ध नहीं होता: आपके प्लेटफ़ॉर्म/Node से मेल खाने पर यह प्रीबिल्ट बाइनरी का उपयोग करता है
और अन्यथा पारदर्शी रूप से प्योर-JS इंजन पर फ़ॉलबैक करता है
(Node 22+ पर `node:sqlite`, अन्यथा बंडल किया गया `sql.js` WASM) — किसी बिल्ड टूल की आवश्यकता नहीं है।
इंस्टॉल के बाद के नेटिव वार्म-अप को पूरी तरह छोड़ने के लिए (CI, हेडलेस या धीमी मशीनें):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 भी इसे छोड़ देता है
```
सबसे तेज़ इंस्टॉल के लिए **pnpm** को प्राथमिकता दें (कंटेंट-एड्रेस्ड स्टोर + हार्ड लिंक — ऊपर देखें)।
डैशबोर्ड-रहित, हेडलेस रनटाइम के लिए Docker `base` प्रोफ़ाइल (ऊपर) या
[Termux गाइड](docs/guides/TERMUX_GUIDE.md) का उपयोग करें। CLI और वेब डैशबोर्ड को एक ही प्रक्रिया द्वारा
एक पोर्ट पर सर्व किया जाता है, इसलिए वर्तमान में कोई अलग केवल-CLI पैकेज नहीं है।
🎬 #1 — Instagram nick_saraev — 3,042,474 बार देखा गया
🎬 #2 — Instagram nnapier7 — 1,454,535 बार देखा गया
🎬 #3 — YouTube Amidia AI & Tech — 794,974 बार देखा गया
🎬 #4 — Instagram theopenstack — 692,419 बार देखा गया
🎬 #5 — TikTok migue.baena — 685,788 बार देखा गया
**पूर्ण रैंकिंग (डुप्लिकेट हटाए गए कैनोनिकल URL, `v > 0`, सर्वाधिक पहुँच):**
| #1 | #2 | #3 | #4 | #5 |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** |
| #6 | #7 | #8 | #9 | #10 |
| ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** |
2026-10-18 के कैनोनिकल मेट्रिक्स: **1.976 अद्वितीय वीडियो** · **20.220.289 ज्ञात व्यू** (`v > 0`) · **प्रति नेटवर्क 1.210 चैनल/प्रोफ़ाइल**। अपरिष्कृत पैनल में 1.976 पंक्तियाँ हैं (YouTube 1.352 = 740 लंबे वीडियो + 612 Shorts · TikTok 334 · Instagram 290); कैनोनिकल URL के आधार पर सामान्यीकरण के बाद कोई डुप्लिकेट शेष नहीं रहा, जो प्रत्येक वीडियो के लिए सबसे अधिक व्यू संख्या बनाए रखता है। YouTube डेटा संग्रह 2026-10-13 से रुका हुआ है (14 से 18/10 तक API कोटा समाप्त था) और TikTok/Instagram का संग्रह 2026-09-02 से रुका हुआ है (डेटा संग्रह क्रेडिट उपलब्ध नहीं हैं); 76 वीडियो के लिए अभी भी व्यू संख्या उपलब्ध नहीं है।
> 🎬 **OmniRoute के बारे में वीडियो बनाया है?** लिंक के साथ एक [इश्यू](https://github.com/diegosouzapw/OmniRoute/issues/new) या [चर्चा](https://github.com/diegosouzapw/OmniRoute/discussions) खोलें — हम उसे यहाँ प्रदर्शित करेंगे।
# 📧 समुदाय और सहायता
> सब कुछ एक ही स्थान पर — मेंटेनर को फ़ॉलो करें, समुदाय के साथ चैट करें, या कोई इश्यू खोलें।
| चैनल | कहाँ / कैसे |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| 💼 **LinkedIn** — मेंटेनर को फ़ॉलो करें | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) |
| 🐙 **GitHub** — रिलीज़ और सुझावों के लिए फ़ॉलो करें | [@diegosouzapw](https://github.com/diegosouzapw) |
| 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) |
| ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) |
| 🟢 **WhatsApp — 🌍 वैश्विक** | [समूह में शामिल हों](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) |
| 🟢 **WhatsApp — 🇧🇷 ब्राज़ील** | [समूह में शामिल हों](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) |
| 🌍 **वेबसाइट** | [omniroute.online](https://omniroute.online) |
| 🌍 **🌍StHub OmniRoute समुदाय (निःशुल्क)** | [StHub पोर्टल](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) |
| 📦 **स्रोत कोड** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) |
| 🐛 **बग की रिपोर्ट करें** | [एक इश्यू खोलें](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` का आउटपुट संलग्न करें |
| 🤝 **योगदान दें** | [CONTRIBUTING.md](CONTRIBUTING.md) · [ब्रांचिंग और रिलीज़ मॉडल](docs/ops/BRANCHING_MODEL.md) · कोई `good first issue` चुनें |
| 💚 **प्रोजेक्ट का समर्थन करें** | [समर्थन करने के तरीके ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |
7,800+ ट्रैक किए गए टेस्ट फ़ाइलों में 56,000+ स्टैटिक टेस्ट घोषणाओं के लिए टेस्ट कवरेज रणनीति
# ⭐ शीर्ष योगदानकर्ता
> OmniRoute को एक भावुक ओपन-सोर्स समुदाय ने आकार दिया है। इन व्यक्तियों ने असाधारण योगदान दिए हैं जो सीधे परियोजना की गुणवत्ता, स्थिरता और पहुँच को प्रभावित करते हैं। **धन्यवाद।**
### मर्ज किए गए पुल रिक्वेस्ट के अनुसार बाहरी योगदानकर्ता
गणना 2026-10-18 15:09:09 UTC पर लाइव release/v3.8.52 टिप 656f01cb43 के साथ की गई। पेजिनेटेड GitHub GraphQL गणना में 9,191 मर्ज किए गए PR हैं: 3,834 रिपॉज़िटरी स्वामी द्वारा, 229 Dependabot द्वारा, 6 अन्य बॉट्स/ऐप्स द्वारा, और 835 अलग-अलग योगदानकर्ताओं से 5,122 बाहरी PR। “परिवर्तित पंक्तियाँ” GitHub additions + deletions है और इसमें जनरेट की गई फ़ाइलें, lockfiles, कैटलॉग, अनुवाद और दस्तावेज़ शामिल हैं; यह churn है, लेखक-लिखित LOC नहीं। 49 PR GitHub डिफ़ में 500,000 से अधिक पंक्तियाँ रिपोर्ट करते हैं (उदाहरण के लिए #13399, एकल प्रोवाइडर जोड़, 2,347 बदली गई फ़ाइलें सूचीबद्ध करता है), जो ऊपर कई कुल योगों को बढ़ा देता है। बराबर वाले एक साथ रैंक किए गए हैं।
### GitHub-श्रेयित कमिट्स
2026-10-18 14:44:45 UTC पर पुनः जाँचा गया: ये GitHub-श्रेयित कमिट हैं जो रिपॉज़िटरी के Contributors API द्वारा release/v3.8.52 डिफ़ॉल्ट ब्रांच के लिए रिपोर्ट किए गए हैं। API ने 849 पहचानें लौटाईं (429 उपयोगकर्ता, 2 बॉट, 418 अनाम); यह तालिका मेंटेनर, बॉट और अनाम पहचानों को शामिल नहीं करती तथा प्रतियोगिता में बराबरी को बनाए रखती है। यह ऊपर दी गई merged-PR रैंकिंग और नीचे दी गई Git-मेटाडेटा गणना — दोनों से अलग है।
> 🙏 इन योगदानकर्ताओं की सुविधाएँ, बग फ़िक्स और इन्फ्रास्ट्रक्चर सुधार **एक मुख्य हिस्सा** हैं, जो OmniRoute को भरोसेमंद और सुविधाओं से समृद्ध बनाते हैं। हर pull request, हर टेस्ट केस और हर i18n अनुवाद फ़ाइल मायने रखती है। ओपन सोर्स उन्हीं जैसे लोगों द्वारा बनाया जाता है।
---
## 💖 प्रायोजक
उन लोगों का दिल से धन्यवाद, जो अपनी जेब से OmniRoute को वित्तीय सहयोग देते हैं — प्रत्येक योगदान इस परियोजना को निःशुल्क, स्वतंत्र और निरंतर आगे बढ़ते रहने में मदद करता है।
… और वे अन्य लोग, जो अपनी पहचान गोपनीय रखना पसंद करते हैं 💛सार्वजनिक GitHub Sponsors को 2026-10-18 को GitHub Sponsors GraphQL API के माध्यम से पुनः सत्यापित किया गया: कुल 14 में से 11 सार्वजनिक प्रायोजन (6 सक्रिय, 5 पूर्व)। GitHub की isActive स्थिति ऊपर दिए गए सक्रिय लेबल निर्धारित करती है; पूर्व सार्वजनिक एकमुश्त समर्थकों के प्रति आभार बना रहता है और निजी प्रायोजक गुमनाम रहते हैं। Ko-fi, Buy Me a Coffee, Liberapay, PIX और क्रिप्टो दान सूचीबद्ध नहीं हैं, क्योंकि उनके लिए कोई सार्वजनिक प्रायोजक रिकॉर्ड उपलब्ध नहीं है।💖 प्रायोजक बनें → — प्रत्येक डॉलर OmniRoute को निःशुल्क और स्वतंत्र बनाए रखने में मदद करता है।
## 👥 900+ योगदानकर्ता
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-10-18 को लाइव release/v3.8.52 के नवीनतम कमिट ad160ab2d1 (6,826 कमिट) पर ऑडिट किया गया: 993 सामान्यीकृत मानवीय Git पहचानें — 707 कमिट लेखक के रूप में दिखाई देती हैं (अनुरक्षक सहित) और 286 केवल स्पष्ट Co-authored-by ट्रेलर में दिखाई देती हैं। इस गणना में .mailmap लागू किया गया है, ई-मेल पतों की तुलना अक्षरों के केस की परवाह किए बिना की गई है, संख्यात्मक और सामान्य GitHub noreply पतों को केवल तभी जोड़ा गया है जब वे समान हैंडल को कूटबद्ध करते हैं, 26 बॉट/एजेंट/सेवा/प्लेसहोल्डर पहचानों को बाहर रखा गया है, और केवल प्रदर्शन नाम समान होने के कारण सामान्य ई-मेल पतों को मर्ज नहीं किया गया है। 2026-08-24 के ऑडिट में 639 प्रकाशित किए गए थे; उसी ऑडिट के आधार ac02c5b42f पर इस विधि को दोबारा चलाने से 619 मिलते हैं, इसलिए यह वृद्धि नए योगदानकर्ताओं के कारण है, न कि किसी कम सख्त विधि के कारण।
### योगदान कैसे करें
1. रिपॉज़िटरी को फ़ोर्क करें
2. **सक्रिय** `release/vX.Y.Z` के नवीनतम कमिट से ब्रांच बनाएँ (`main` से नहीं) — [ब्रांचिंग और रिलीज़ मॉडल](docs/ops/BRANCHING_MODEL.md) देखें
3. अपनी फ़ीचर ब्रांच बनाएँ (`git checkout -b feat/amazing-feature`)
4. अपने बदलाव कमिट करें (`git commit -m 'feat: add amazing feature'`)
5. ब्रांच पर पुश करें (`git push origin feat/amazing-feature`)
6. **base = वही `release/vX.Y.Z` ब्रांच** रखते हुए एक पुल रिक्वेस्ट खोलें
विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md](CONTRIBUTING.md) देखें।
### नया संस्करण रिलीज़ करना
```bash
# एक रिलीज़ बनाएँ — npm publish स्वचालित रूप से होता है
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 स्टार
## 🌍 StarMapper
## 🙏 आभार
OmniRoute दिग्गजों के कंधों पर खड़ा है। इसकी शुरुआत **[9router](https://github.com/decolua/9router)** के एक फ़ॉर्क और Go प्रोजेक्ट **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** के TypeScript पोर्ट के रूप में हुई थी — और उसके बाद, नीचे दिए गए प्रत्येक सबसिस्टम को किसी ऐसे ओपन-सोर्स प्रोजेक्ट से प्रेरणा मिली जिसने यह काम पहले किया था। उनमें से प्रत्येक ने OmniRoute के एक ठोस हिस्से को आकार दिया। यह उन सभी के प्रति हमारा धन्यवाद है। 🙏
> ⭐ स्टार की संख्याएँ 18 अक्टूबर, 2026 को GitHub के REST API से सत्यापित की गई थीं — जाकर इन प्रोजेक्ट्स को एक स्टार दें। ये संख्याएँ किसी विशिष्ट तिथि पर लिया गया सटीक स्नैपशॉट हैं और स्वाभाविक रूप से बदलेंगी।
### 🧬 वंशावली और गेटवे
वह AI गेटवे जिसका सार्वजनिक मूल्य-निर्धारण डेटासेट हमारे लागत-ट्रैकिंग सिंक को डेटा प्रदान करता है और जिसके प्रोवाइडर-नॉर्मलाइज़ेशन मॉडल ने हमारी रूटिंग को दिशा दी।
वेंडर किए गए ChatGPT Web → Codex Responses ब्रिज में अनुकूलित MIT स्रोत, जिसमें ब्राउज़र-सेशन, रिस्पॉन्स-फ़्रेमिंग, उपयोग और वेब-सर्च अडैप्टर शामिल हैं।
इसके Grok मॉडल मैपिंग, नकली-TypeError Statsig जनरेटर, अनुरोध और डिवाइस डिफ़ॉल्ट तथा NDJSON रिस्पॉन्स प्रोसेसर को OmniRoute के Grok Web एक्ज़ीक्यूटर में महत्वपूर्ण रूप से अनुकूलित किया गया।
grok2api-merged द्वारा अपनी प्रॉक्सी-पूल परत के लिए श्रेय दिया गया एक ट्रांज़िटिव स्रोत; OmniRoute उस वंशावली सूचना को संरक्षित रखता है, लेकिन अपने सीमित Grok Web एक्ज़ीक्यूटर में प्रॉक्सी-पूल पोर्ट का दावा नहीं करता।
मूल Grok Web कार्यान्वयन ने इसके HTTP/ब्राउज़र अपस्ट्रीम डिज़ाइन का संदर्भ लिया; इसका प्रत्यक्ष HTTP पथ GrokProxy से व्युत्पन्न है, इसलिए किसी स्वतंत्र कोड पोर्ट का दावा नहीं किया जाता।
वायरल "जब कम टोकन से काम हो, तो अधिक टोकन क्यों इस्तेमाल करें" प्रोजेक्ट — इसका आदिमानव-जैसी भाषा का दर्शन हमारे मानक संपीड़न मोड और 30+ अनावश्यक-शब्द हटाने/संघनन नियमों को शक्ति देता है।
PT-BR टोकन संपीड़न — हमारे pt-BR भाषा पैक को शक्ति देता है: ब्राज़ीली-पुर्तगाली व्याकरण के लिए अनुकूलित पुनरुक्ति न्यूनीकरण और अनावश्यक शब्दों को हटाना।
वायरल "आलसी वरिष्ठ डेवलपर" YAGNI-कोडर कौशल — इसने हमारी less-code आउटपुट शैली को प्रेरित किया: सबसे छोटे कार्यशील परिवर्तन की दिशा, जो _जनरेट किए गए_ कोड को घटाती है (Caveman के संक्षिप्त गद्य का आउटपुट-अक्ष सहोदर)।
Rust स्तंभाकार-JSON + सामग्री-संबोधित पुनर्प्राप्ति + संदेशों के बीच डीडुप — इसने हमारे headroom/ccr/session-dedup इंजन डिज़ाइन और कैश-स्थिर "संपीड़ित रूप स्थिति-स्वतंत्र है" अपरिवर्तनीयता को सत्यापित किया।
TypeScript Compiler API टूलकिट — इसने हमारे पार्सर-आधारित टिप्पणी निष्कासन को प्रेरित किया, जो स्ट्रिंग, टेम्पलेट और रेगेक्स लिटरल को सुरक्षित रखता है।
कोडिंग-असिस्टेंट ↔ LLM ट्रैफ़िक के MITM इंटरसेप्शन/विश्लेषण ने शुरुआती Traffic Inspector आवश्यकताओं को दिशा दी। पहले व्युत्पन्न किए गए चार मॉड्यूल — SSE मर्जिंग, वार्तालाप सामान्यीकरण, गोपनीय डेटा मास्किंग और हेडर सैनिटाइज़ेशन — को सार्वजनिक प्रोटोकॉल मानकों पर आधारित स्वतंत्र क्लीन-रूम कार्यान्वयनों से बदल दिया गया है। दो होस्ट-पासथ्रू सतहें (passthrough.ts और _internal/bypass.cjs) स्वतंत्र रूप से वर्गीकृत OmniRoute-आंतरिक कार्यान्वयन बनी हुई हैं; उस प्रतिस्थापन के हिस्से के रूप में उन्हें दोबारा नहीं लिखा गया था।
डिफ़ॉल्ट रूप से सुरक्षित लाइब्रेरी की एक चयनित सूची, जो हमारे सुरक्षा विकल्पों का मार्गदर्शन करती है (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)।
इसने Grok Build कोटा सतह की पहचान की; इसके बाद OmniRoute ने स्वतंत्र रूप से लाइव वायर फ़ॉर्मैट को सत्यापित और ठीक किया।
## 📄 लाइसेंस
MIT लाइसेंस - विवरण के लिए [LICENSE](LICENSE) देखें।
---
**[⬆ शीर्ष पर वापस जाएँ](#-omniroute)** · ओपन-सोर्स AI समुदाय के लिए ❤️ से बनाया गया।
OmniRoute v3.8.53 · Node ≥22.22.2 · MIT लाइसेंस · omniroute.online
> लाइव `/dashboard/free-tiers` पेज का एनिमेटेड सारांश। पूरी कार्यप्रणाली (पूल डीडुपे, क्रेडिट टियर, प्रोवाइडर शर्तें): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> ये आंकड़े हर दो सप्ताह में लाइव कैटलॉग के विरुद्ध दोबारा ऑडिट किए जाते हैं और **दोनों दिशाओं में बदलते हैं** — कोई प्रोवाइडर मुफ़्त टियर समाप्त करता है तो संख्या घट जाती है; नया जुड़ता है तो बढ़ जाती है। हम वही प्रकाशित करते हैं जो कैटलॉग वास्तव में गणना करता है, कभी भी ऊपर की ओर गोल किया गया सर्वोत्तम केस नहीं।
```bash
# किसी प्रदाता को कनेक्ट करने के बाद, Dashboard → Endpoints से अपनी OmniRoute कुंजी कॉपी करें:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` के लिए एक योग्य रूट आवश्यक है। नए इंस्टॉलेशन में कोई योग्य कुंजी-रहित लक्ष्य नहीं हो सकता है, और कोई कुंजी-रहित प्रदाता तृतीय-पक्ष क्लाइंट को अस्वीकार कर सकता है। Kiro सहित `tos: avoid` के रूप में चिह्नित प्रदाताओं को डिफ़ॉल्ट रूप से स्वचालित रूटिंग से बाहर रखा जाता है; किसी खाते को कनेक्ट करने से यह सेटिंग ओवरराइड नहीं होती। प्रदाता चुनने से पहले [निःशुल्क टियर मार्गदर्शिका](docs/getting-started/FREE-TIERS-GUIDE.md) देखें।
📦 **Python, Node.js, PHP और cURL** के लिए कॉपी-पेस्ट क्विकस्टार्ट स्क्रिप्ट → [`examples/quickstart/`](examples/quickstart/)
> एक **कॉम्बो** मॉडल की ऐसी शृंखला है, जिनके बीच OmniRoute **स्वचालित रूप से** रूट करता है। यदि कोटा समाप्त हो जाए, कोई प्रदाता विफल हो जाए या लागत अचानक बढ़ जाए, तो कॉम्बो अगले योग्य और स्वस्थ मॉडल पर जा सकता है। 🛡️
### ⚡ शून्य-कॉन्फ़िगरेशन — बस `auto` का उपयोग करें
कोई कॉम्बो बनाने की आवश्यकता नहीं है। अपने मॉडल को `auto` (या इसके किसी प्रकार) पर सेट करें और OmniRoute आपके कनेक्ट किए गए प्रदाताओं से एक वर्चुअल कॉम्बो बनाता है, जिसका लाइव स्कोर निर्धारित किया जाता है:
📖 [Auto-Combo इंजन](docs/routing/AUTO-COMBO.md) · [प्रत्यास्थता मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
📊 संपूर्ण कार्यप्रणाली और 9router, OpenRouter, CLIProxyAPI तथा LiteLLM की तुलना में प्रत्येक सुविधा का विवरण → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
कुंजी (रैंडम): `5d865059-bc44-483a-962d-43ceb80126eb`
कॉपी और पेस्ट करने योग्य Pix:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [प्राधिकरण](docs/architecture/AUTHZ_GUIDE.md) · [सुरक्षा उपाय](docs/security/GUARDRAILS.md) · [अनुपालन](docs/security/COMPLIANCE.md)
डिफ़ॉल्ट स्टैक्ड कॉम्बो `RTK → Caveman` चलाता है। जब दोनों एक ही tool/context payload पर काम करते हैं, तो बचत संयुक्त हो जाती है:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लॉक, URLs, JSON और संरचित डेटा preservation engine द्वारा **हमेशा सुरक्षित** रहते हैं।
> **जब कुछ ही टोकन काम कर देते हैं, तो ढेर सारे टोकन क्यों इस्तेमाल करें?** हर request OmniRoute की compression pipeline से **पारदर्शी रूप से** गुज़रती है — क्लाइंट में कोई बदलाव नहीं। यह अब **12 composable engines का स्टैक** है जो क्रम से चलते हैं और प्रति routing combo mix & match होते हैं — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) और [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) के विचारों पर आधारित।
### 🧱 12-engine स्टैक
Engines pipeline क्रम में चलते हैं; प्रत्येक को अलग से toggle किया जा सकता है और प्रति combo कॉन्फ़िगर किया जा सकता है:
