# 🚀 OmniRoute — निःशुल्क AI गेटवे
**[Diego Souza](https://github.com/diegosouzapw) द्वारा निर्मित**
## 💰 तृतीय-पक्ष के मुफ़्त स्तरों पर प्रति माह ~1.62B टोकन
> **अपने प्रदाता खातों का उपयोग करें।** यह अलग-अलग पात्र तृतीय-पक्ष मुफ़्त स्तरों का अनुमानित कुल है, OmniRoute की ओर से कोई टोकन अनुदान नहीं। जहाँ आवश्यक हो, साइन अप करें, क्रेडेंशियल प्राप्त करें और उन प्रदाताओं को कनेक्ट करें जिनका आप उपयोग कर सकते हैं; प्रत्येक प्रदाता अपनी सीमाओं, उपलब्धता और शर्तों को नियंत्रित करता है।
>
> मुफ़्त स्तरों को हाथ से जोड़ना कठिन है — दर्जनों SDKs, दर्जनों दर सीमाएँ और यह जानने का कोई तरीका नहीं कि आपके पास वास्तव में कितना उपलब्ध है। OmniRoute **34 आवर्ती पूल कुंजियों में 465 मुफ़्त-स्तर प्रविष्टियों** को सूचीबद्ध करता है और टोकन का मुख्य आँकड़ा **प्रकाशित सकारात्मक मासिक बजट वाले 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 [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 गेटवे लगातार बढ़ रहा है
## 🆓 इंस्टॉल करें, किसी प्रोवाइडर से कनेक्ट करें, फिर एक एंडपॉइंट के माध्यम से रूट करें
```bash
# किसी प्रोवाइडर से कनेक्ट करने के बाद, डैशबोर्ड → एंडपॉइंट्स से अपनी 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` के लिए एक योग्य रूट आवश्यक है। नए इंस्टॉलेशन में कोई योग्य keyless लक्ष्य नहीं हो सकता, और कोई keyless प्रोवाइडर तृतीय-पक्ष क्लाइंट को अस्वीकार कर सकता है। `tos: avoid` के रूप में चिह्नित प्रोवाइडर, जिनमें Kiro भी शामिल है, डिफ़ॉल्ट रूप से स्वचालित रूटिंग से बाहर रखे जाते हैं; किसी खाते को कनेक्ट करने से यह सेटिंग ओवरराइड नहीं होती। किसी प्रोवाइडर को चुनने से पहले [Free Tiers Guide](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.54** के हालिया मुख्य आकर्षण। पूरा इतिहास [`CHANGELOG.md`](CHANGELOG.md) में।
- **⚖️ `quota-weighted` routing** — 20वीं कॉम्बो रणनीति समाप्त हो चुके खातों को छोड़ देती है, फिर शेष खातों में बचे हुए कोटा ÷ सक्रिय लोड के अनुपात में चयन करती है और मौजूदा वार्तालापों को उसी खाते से जोड़े रखती है। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless mode** — `omniroute serve --headless` (या `OMNIROUTE_HEADLESS=1`) केवल `/v1/*` प्रॉक्सी इंजन चलाता है और डैशबोर्ड तथा केवल-डैशबोर्ड सबसिस्टम बंद रखता है। → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 Model discovery** — `/v1/models` क्षमता, संदर्भ, प्रकार और टेक्स्ट के आधार पर फ़िल्टर करता है, जबकि `POST /v1/models/query` उसी प्रति-कुंजी दृश्यता के साथ एक छोटी, नियतात्मक शॉर्टलिस्ट लौटाता है। → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 Per-key routing control** — `forcedModel` के साथ किसी API कुंजी को एक मॉडल या कॉम्बो पर पिन करें, और किसी कुंजी के मॉडल तथा कॉम्बो को एटॉमिक रूप से जोड़ें या हटाएँ (`/api/keys/{id}/access`)। → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ अधिक सूक्ष्म PII नियंत्रण** — प्रति-प्रकार चयन, अधिकतम 20 सत्यापित कस्टम मास्किंग पैटर्न और प्रति-प्रकार पहचान काउंटर; मास्किंग अब भी वैकल्पिक रहती है। → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 भाषाएँ** — डैशबोर्ड, दस्तावेज़ मिरर और CLI में, जबकि `npm run i18n:add-locale` एक ही कमांड से हर जगह भाषा जोड़ता है। → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — आपके एजेंट बेड़े को इनबाउंड A2A प्रतिनिधिमंडल, Agent Card पर Conductor स्किल्स और Faro push-to-talk वॉइस चैट वाला डैशबोर्ड पैनल। → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूली प्रवेश और ओवरलोड सुरक्षा** — भारी चैट अनुरोध 503 देने के बजाय कतार में लगते हैं और प्रति कनेक्शन एटॉमिक RPM रोलिंग लीज़ का उपयोग होता है। → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ मानक `/v1/models` क्रम** — प्रत्येक प्रोवाइडर के लिए एक सतत, प्रोवाइडर-समूहित ब्लॉक (कॉम्बो पहले पिन किए गए), जो हर कैटलॉग स्रोत में स्थिर रहता है। → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ कंप्रेशन सुदृढ़ीकरण** — डिफ़ॉल्ट रूप से सक्रिय inflation guard, DE / FR / JA + चीनी (wényán) के लिए Caveman पैक, तथा Gradle और .NET के लिए RTK फ़िल्टर। → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 ईमानदार flat-rate लागत** — subscription / coding-plan प्रोवाइडर लागत विश्लेषण में **$0** दिखाते हैं; बजट, कोटा और रूटिंग का अनुमान जारी रहता है। → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share routing** — साझा खाते के कोटे को पूल की गई कुंजियों में निष्पक्ष रूप से बाँटता है और idle slices को उधार देकर संसाधनों का उपयोग सुनिश्चित करता है। → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एक-कमांड CLI/agent सेटअप** — 15 पंजीकृत `setup-*` कमांड; `omniroute run` 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) लॉन्च करता है; `omniroute configure` इंटरैक्टिव प्रोवाइडर+मॉडल पिकर और प्रति-संदर्भ पसंदीदा विकल्पों के साथ 11 लक्ष्यों का समर्थन करता है। → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Remote mode** — स्कोप किए गए टोकन (`connect` / `contexts` / `tokens`) के साथ दूरस्थ OmniRoute चलाएँ और VPS इंस्टॉलेशन के लिए `antigravity` OAuth हेल्पर का उपयोग करें। → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 अधिक स्मार्ट auto-routing** — `auto/:` कॉम्बो, **Fusion** (मॉडल पैनल + जज), कार्य-जागरूक रूटिंग, तथा प्रति-अनुरोध मॉडल / मोड / USD-बजट ओवरराइड। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ प्लगेबल कंप्रेशन** — 12 संयोज्य इंजन और Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, प्रति-चरण fidelity gate, GCF v3.2 और drag-reorder editor। → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ पारदर्शी MITM decrypt (TPROXY)** — ऐसे capture CLIs के लिए जो proxy env vars को अनदेखा करते हैं, प्रति-SNI CA और trust-store installer के साथ। → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 हर जगह लागत टेलीमेट्री** — प्रत्येक endpoint पर `X-OmniRoute-*` लागत/उपयोग हेडर, cache-HIT बचत हेडर और प्रति-कुंजी USD खर्च कोटे। → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 आपके नियंत्रण में Memory** — डिफ़ॉल्ट रूप से बंद, वैकल्पिक int8 vector quantization + typed decay, तथा प्रति-अनुरोध `x-omniroute-no-memory`। → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Security** — प्रत्येक LLM route पर prompt-injection guard (red-team suite), वैकल्पिक credential-masking guardrail (दोनों दिशाओं में लीक हुई API कुंजियों/सीक्रेट को redacts करता है), निःशुल्क DuckDuckGo अंतिम-उपाय वेब खोज और डैशबोर्ड के लिए वैकल्पिक OIDC लॉगिन गेट (पासवर्ड लॉगिन हमेशा उपलब्ध रहता है)। → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ नए endpoints** — `/v1/ocr` (Mistral OCR) और `/v1/audio/translations` (Whisper-style) मीडिया सतह को पूरा करते हैं। → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Image / video / audio generation** — मीडिया के लिए एक API: xAI Grok Imagine और Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind तथा ElevenLabs जैसे speech प्रोवाइडर। → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Deployment & ops** — reverse-proxy `basePath`, ब्राउज़र-भाषा का ऑटो-डिटेक्शन, प्रति-कुंजी डिवाइस ट्रैकिंग, root-less MITM trust और zh-TW स्थानीयकरण। → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 अधिक प्रोवाइडर और एजेंट** — cloud agents (Codex Cloud, Cursor, Devin, Jules), browser + OAuth login वाला Grok Build (xAI), first-class card वाला Ollama, Claude Opus 5 और Sonnet 5, Kimi की आधिकारिक साझेदारी (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… और नया **388-provider catalog**। → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 रूटिंग पारदर्शिता** — हर response में उसे सर्व करने वाली strategy/provider/latency का नाम देने वाला `X-OmniRoute-Decision` हेडर होता है; नई `cache-optimized` कॉम्बो रणनीति और Auto-Combo `cacheAffinity` factor दोहराए गए अनुरोधों को उस कनेक्शन पर वापस भेजते हैं जिसके पास cached prefix है; और केवल-पठन `/v1/auto-combo/{channel}/candidates` endpoint किसी `auto/*` channel के लाइव candidate pool को दिखाता है। → [Auto-Combo](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 APIs, सिमेंटिक रिस्पॉन्स कैश, लीडरबोर्ड सहित गेमिफ़िकेशन, ACP एजेंट डिस्कवरी (15 बिल्ट-इन एजेंट), BigQuery में शेड्यूल किया गया लॉग एक्सपोर्ट, `auto/chaos` पैरेलल मल्टी-मॉडल फ़ैन-आउट, Telegram बॉट ब्रिज, इन-ऐप वर्शन मैनेजर और LMArena-ELO मुफ़्त-प्रदाता रैंकिंग। → [दस्तावेज़](docs/README.md)
## 🤖 संगत CLI और कोडिंग एजेंट्स
> एक ही कॉन्फ़िग — `http://localhost:20128/v1` — और **हर** AI IDE या CLI मुफ्त और कम लागत वाले मॉडलों पर चलता है।
＋ इसके अलावा काम करता है · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · किसी भी OpenAI-संगत टूल
📖 सभी 39 टूल्स (28 CLI Code's + 11 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"
# या इंटरएक्टिव रूप से provider+model चुनें और टूल का अपना कॉन्फ़िग लिखें:
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)
## 🌐 388 AI प्रदाता — 153 कैटलॉग-चिह्नित निःशुल्क
> **388 पंजीकृत प्रदाता** canonical chat, media, search, local, cloud-agent और system collections में फैले हुए हैं, जिनमें **153 के पास `hasFree: true` discovery metadata है**। Chat model registry में **239 प्रदाता / 3,059 विशिष्ट provider-model pairs / 1,475 raw model IDs** शामिल हैं; अलग free-budget catalog में **471 per-model rows**, **34 recurring pools** और **52 recurring/keyless free-forever providers** हैं। ये जानबूझकर अलग-अलग denominators हैं; परिभाषाएँ और pool-deduped calculations [प्रदाता संदर्भ](docs/reference/PROVIDER_REFERENCE.md) और [निःशुल्क स्तर](docs/reference/FREE_TIERS.md) में उपलब्ध हैं।
### 🏢 हर प्रमुख लैब — एक ही endpoint के माध्यम से
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…और 350+ अन्य — हर आइकन dashboard के provider catalog से live रूप से resolve होता है। 📖 [प्रदाता संदर्भ](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 हमेशा निःशुल्क — $0, कार्ड की आवश्यकता नहीं
OpenCode Zen DeepSeek V4, Nemotron 3 कोई टोकन सीमा नहीं
Kilo Code ऑटो-राउटर, 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 (वैश्विक)
npm इंस्टॉल -g omniroute
एक कमांड, कोई भी OS
⚡ Bun (वैश्विक)
bun -g omniroute
जोड़ें समान रजिस्ट्री टैरबॉल, तेजी से इंस्टॉल
🐳 Docker
डॉकर रन ... diegosouzapw/omniroute
मल्टी-आर्क AMD64 + ARM64
🖥️ डेस्कटॉप (Electron)
एनपीएम रन इलेक्ट्रॉन: बिल्ड
नेटिव विंडो + सिस्टम ट्रे - Windows / macOS / Linux
🎩 मेनू-बार (OmniRouteTray)
ब्रू इंस्टॉल --cask zoispag/tap/omniroute-tray
& सर्वर को स्वचालित रूप से अपडेट करता है - macOS
💪 ARM
देशी Arm64
रास्पबेरी पाई, ARM सर्वर, Apple सिलिकॉन
📱 एंड्रॉइड (टर्मक्स)
pkg इंस्टॉल नोडज && npx -y omniroute
आपके फोन पर चलाता है, 24/7, कोई रूट नहीं
📲 PWA
"होम स्क्रीन में जोड़ें"
फुलस्क्रीन, ऑफ़लाइन, ब्राउज़र से इंस्टॉल करने योग्य
🧩 OpenCode प्लगइन
@omniroute/opencode-provider
मूल OpenCode एकीकरण
🤖 VS कोड Copilot चैट
इंस्टॉल OmniCopilot एक्सटेंशन
मूल Copilot चैट पिकर में प्रत्येक OmniRoute मॉडल - स्थिर & अंदरूनी सूत्र
### 🧩 नया: OmniRoute VS कोड के मूल Copilot चैट के अंदर
> कोई नया साइडबार नहीं, कोई नया चैट UI नहीं - प्रत्येक मॉडल OmniRoute सेवाएँ सही में दिखाई देती हैं**Copilot चैट मॉडल पिकर जिसका आप पहले से उपयोग कर रहे हैं** . VS कोड 1.122 के बाद से, प्रदाता मॉडल GitHub साइन-इन या Copilot सदस्यता के बिना काम करते हैं - एजेंट मोड, टूल कॉलिंग और विज़न, मुफ्त में।
स्थापित करें** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** एक्सटेंशन, इसे अपने OmniRoute सर्वर पर इंगित करें (डिफ़ॉल्ट रूप से `localhost:20128`), फिर Copilot चैट → मॉडल पिकर → खोलें** मॉडल प्रबंधित करें…** →**OmniRoute** .
संपादक के अंदर से: खोलें** एक्सटेंशन** देखना, खोजना** "OmniRoute"** , क्लिक करें** स्थापित करना** - दोनों दुकानों पर समान तरीके से काम करता है। स्रोत, मुद्दे और प्रकाशन रनबुक [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) पर लाइव।
📖 [VS कोड Copilot चैट गाइड](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/) (रस्ट कोर एक राउंडिंग एरर के आकार का) के साथ निर्मित, यह अपने स्वयं के हस्ताक्षरित नोड 24 रनटाइम को शिप करता है और एक ऐप-स्वामित्व वाली OmniRoute इंस्टॉल का प्रबंधन करता है, इसलिए यह कभी भी आपके वैश्विक `node`/`bun` से नहीं लड़ता है। यह** आपके मौजूदा `~/.omniroute/` कॉन्फिगरेशन और डेटाबेस को साझा करता है** - तो यह वही है OmniRoute आप पहले से ही दौड़ रहे हैं, केवल टोपी पहनकर। 🎩
यह क्या करता है
कैसे
🟢 सर्वर का पर्यवेक्षण करता है
स्पॉन्स omniroute सर्व , इसे डुप्लिकेट करने के बजाय पहले से चल रहे उदाहरण को अपनाता है
📊 एक नज़र में लाइव उपयोग
प्रदाता कोटा बार, रीसेट उलटी गिनती के साथ Claude session/weekly सीमाएं, 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` चलता है। जब दोनों एक ही टूल/कॉन्टेक्स्ट payload पर काम करते हैं, तो बचत संचयी हो जाती है:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लॉक, URL, JSON और संरचित डेटा **preservation engine द्वारा हमेशा सुरक्षित** रहते हैं।
> **जब कम टोकन से काम चल जाता है, तो इतने अधिक टोकन क्यों इस्तेमाल करें?** प्रत्येक अनुरोध OmniRoute की compression pipeline से **पारदर्शी रूप से** गुजरता है — क्लाइंट में कोई बदलाव आवश्यक नहीं। अब यह **12 संयोज्य इंजनों का एक स्टैक** है, जो क्रम से चलते हैं और प्रत्येक routing combo के अनुसार आपस में मिलाए जा सकते हैं — [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-इंजन स्टैक
इंजन pipeline क्रम में चलते हैं; प्रत्येक को अलग-अलग सक्षम किया जा सकता है और प्रति combo कॉन्फ़िगर किया जा सकता है:
#
इंजन
यह क्या करता है
1
Session-Dedup
टर्न के बीच दोहराई गई सामग्री हटाता है (content-addressed, cross-turn)
2
CCR
बड़े ब्लॉक को retrieve markers के पीछे संग्रहीत करता है, जिन्हें आवश्यकता पड़ने पर प्राप्त किया जाता है
स्मार्ट tool-result filtering, dedup और truncation (command-aware)
5
Responses Tool Output
shell/patch/search/build outputs के लिए lossless-first JSON + bounded 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 (output पर ~65–75%)
9
Aggressive
पुराने टर्न का 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
direct Anthropic wire पर मापे गए Claude Fable 5 के लिए experimental context-as-image encoding; GPT 5.6 transformers provider receipts लंबित रहने तक fail-closed रहते हैं। चार compression profiles (डिफ़ॉल्ट aggressive, balanced, coding-safe, passthrough) (सबसे aggressive; opt-in)
कोड ब्लॉक, URL और संरचित डेटा को **byte-perfect रूप से हमेशा संरक्षित** रखा जाता है। **One-click presets** इंजनों को संयोजित करते हैं:
मोड
बचत
किसके लिए सर्वोत्तम
🪶 Lite
~15%
हमेशा-सक्रिय सुरक्षित डिफ़ॉल्ट
🪨 Standard (Caveman)
~30%
दैनिक coding
⚡ Aggressive
~50%
लंबे tool-heavy sessions
🔥 Ultra
~75%
अधिकतम बचत
🧰 RTK
60–90%
Shell/test/build/git output
🔗 Stacked (RTK → Caveman)
78–95%
मिश्रित prompts + tool logs
**वास्तविक उदाहरण — Standard mode:**
> **पहले (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 में wrap करें।"_
>
> **वही उत्तर। 72% कम टोकन। सटीकता में कोई कमी नहीं।** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) mode:**
> **पहले (42 टोकन):** _"समस्या यह है कि घटक हर रेंडरिंग चक्र में ऑब्जेक्ट का नया रेफ़रेंस बनाए जाने के कारण फिर से रेंडर हो रहा है। मैं `useMemo` का उपयोग करने की सलाह दूँगा।"_
>
> **बाद में (12 टोकन):** _"री-रेंडर: हर चक्र में नया रेफ़रेंस (inline ऑब्जेक्ट फिर से बनाया गया)। `useMemo` का उपयोग करें।"_
>
> **वही उत्तर। लगभग 70% कम टोकन। तकनीकी सटीकता बरकरार।** ✅
### 🎚️ इंजन से आगे — आउटपुट शैलियाँ, अनुकूली डायल और प्रति-अनुरोध नियंत्रण
ऊपर दिए गए 12 इंजन **इनपुट** को छोटा करते हैं। तीन और परतें यह तय करती हैं कि आउटपुट **कैसे**, **कब**, और क्या होगा:
- **🪄 आउटपुट शैलियाँ** _(आउटपुट-अक्ष निर्देशन)_ — नियतात्मक, कैश-सुरक्षित, प्रतिक्रिया-आकार देने वाले निर्देश जोड़ती हैं; इन्हें संयोजित किया जा सकता है, और प्रत्येक की `lite` / `full` / `ultra` तीव्रता होती है। शैली जोड़ना रजिस्ट्री में एक-पंक्ति प्रविष्टि जोड़ने जितना आसान है:
- **संक्षिप्त गद्य** — अनावश्यक शब्द / आर्टिकल / अनिश्चितता-सूचक वाक्यांश हटाएँ; तकनीकी सार को सटीक रखें।
- **कम कोड** — "आलसी वरिष्ठ डेवलपर" YAGNI: सबसे छोटा काम करने वाला बदलाव, बिना माँगे गए अतिरिक्त ढाँचे के।
- **पोनीटेल (आलसी वरिष्ठ डेवलपर)** — 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 पैकेज lifecycle scripts को तब तक रोक सकता है, जब तक उन्हें अनुमति न दी जाए। OmniRoute का `postinstall` (`node scripts/build/postinstall.mjs`) इसकी native runtime files तैयार करने के लिए आवश्यक है। globally इंस्टॉल करते समय npm की चेतावनी में बताए गए पैकेजों को अनुमति दें। OmniRoute 3.8.54 द्वारा रिपोर्ट किए गए पैकेज सेट के लिए:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> भविष्य के global installs में इस allowlist का पुनः उपयोग करने के लिए इसे एक बार कॉन्फ़िगर करें, फिर सामान्य रूप से इंस्टॉल करें:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> निर्भरताओं की सूची releases के बीच बदल सकती है; यदि npm कोई अलग सूची रिपोर्ट करे, तो उस चेतावनी में दिए गए पैकेज नामों का उपयोग करें। किसी पैकेज को अनुमति देने से उसकी install scripts चलने की अनुमति मिलती है।
> **Gemini Web या किसी अन्य web-cookie provider का उपयोग कर रहे हैं?** npm पैकेज में
> Playwright शामिल है, लेकिन इसका Chromium binary शामिल नहीं है। पहला web-provider request करने से पहले
> [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> नोट देखें।
डैशबोर्ड `http://localhost:20128` पर · API `http://localhost:20128/v1` पर उपलब्ध है।
**2) अपने खाते का उपयोग करके किसी योग्य provider से कनेक्ट करें**
Dashboard → **Providers** → ऐसा provider चुनें जिसकी वर्तमान शर्तें और quota आपके उपयोग के अनुकूल हों → उसकी API key जोड़ें या account flow पूरा करें। Free tiers के लिए signup, approval या payment method आवश्यक हो सकता है। [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) देखें; keyless availability की गारंटी नहीं है, और `tos: avoid` से चिह्नित providers को डिफ़ॉल्ट रूप से `auto` से बाहर रखा जाता है।
**3) अपने coding tool को इंगित करें**
```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"
```
आपको अपने कनेक्ट किए गए models की सूची दिखनी चाहिए। 🎉 बस इतना ही — coding शुरू करें, OmniRoute आपके लिए auto-route और fallback करता रहेगा।
यदि आपका client custom headers नहीं भेज सकता, तो OmniRoute tokenized compatibility aliases भी उपलब्ध कराता है:
```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
```
इनका उपयोग केवल उन clients के लिए करें जो `Authorization: Bearer ...` संलग्न नहीं कर सकते। Header auth अब भी पसंदीदा मोड है।
## 📦 इंस्टॉल करने के और तरीके — 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) |
8,400+ ट्रैक की गई परीक्षण फ़ाइलों में 60,000+ स्थिर परीक्षण घोषणाओं के लिए परीक्षण कवरेज रणनीति
# ⭐ शीर्ष योगदानकर्ता
> OmniRoute को एक उत्साही ओपन-सोर्स समुदाय ने आकार दिया है। इन व्यक्तियों ने ऐसी असाधारण भूमिकाएँ निभाई हैं, जिनका परियोजना की गुणवत्ता, स्थिरता और पहुँच पर सीधा प्रभाव पड़ता है। **धन्यवाद।**
### मर्ज किए गए पुल अनुरोधों के आधार पर बाहरी योगदानकर्ता
जनगणना 2026-11-03 03:01:19 UTC को लाइव release/v3.8.53 टिप 05bc048d6c के साथ की गई। पृष्ठांकित GitHub GraphQL जनगणना में 9,947 मर्ज किए गए PR शामिल हैं: 4,130 रिपॉज़िटरी स्वामी द्वारा, 240 Dependabot द्वारा, 6 अन्य बॉट/ऐप्स द्वारा, और 883 अलग-अलग योगदानकर्ताओं के 5,571 बाहरी PR। “परिवर्तित पंक्तियाँ” GitHub में जोड़ी गई + हटाई गई पंक्तियाँ हैं और इनमें जनरेट की गई फ़ाइलें, लॉकफ़ाइलें, कैटलॉग, अनुवाद और दस्तावेज़ शामिल हैं; यह बदलावों की मात्रा है, लिखे गए LOC नहीं। 53 PR में GitHub डिफ़ के अनुसार 500,000 से अधिक पंक्तियाँ हैं (उदाहरण के लिए #13399, जिसमें एकल प्रदाता जोड़ने के लिए 2,347 परिवर्तित फ़ाइलें सूचीबद्ध हैं), जिससे ऊपर दिए गए कई कुल आँकड़े बढ़ जाते हैं। समान रैंक वाले योगदानकर्ताओं को साथ रैंक किया गया है।
### GitHub-आरोपित कमिट
अंतिम बार 2026-11-03 02:09:16 UTC पर पुनः जाँचा गया: release/v3.8.53 डिफ़ॉल्ट शाखा के लिए रिपॉज़िटरी Contributors API द्वारा रिपोर्ट किए गए GitHub से संबद्ध कमिट। API ने 903 पहचानें लौटाईं (429 उपयोगकर्ता, 2 बॉट, 472 अनाम); इस तालिका में मेंटेनर, बॉट और अनाम पहचानों को शामिल नहीं किया गया है तथा प्रतियोगिता में बराबरी बनाए रखी गई है। यह ऊपर दी गई मर्ज किए गए PR की रैंकिंग और नीचे दी गई Git-मेटाडेटा जनगणना—दोनों से अलग है।
> 🙏 इन योगदानकर्ताओं की सुविधाएँ, बग सुधार और इन्फ्रास्ट्रक्चर सुधार OmniRoute को विश्वसनीय और सुविधासंपन्न बनाने में **मुख्य भूमिका** निभाते हैं। हर पुल अनुरोध, हर परीक्षण मामला और हर 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 को निःशुल्क और स्वतंत्र बनाए रखने में मदद करता है।
## 👥 1,000+ योगदानकर्ता
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-11-02 को लाइव release/v3.8.53 टिप 1c7135e0fb (7,972 कमिट) पर ऑडिट किया गया: 1,074 सामान्यीकृत मानव Git पहचानें — 759 कमिट लेखकों के रूप में दिखाई देती हैं (मेंटेनर सहित) और 315 केवल स्पष्ट Co-authored-by ट्रेलर में हैं। जनगणना में .mailmap लागू किया जाता है, ई-मेल पतों की तुलना केस-असंवेदनशील तरीके से की जाती है, संख्यात्मक और सादे GitHub noreply पतों को केवल तभी जोड़ा जाता है जब वे एक ही हैंडल को एन्कोड करते हों, 29 बॉट/एजेंट/सेवा/प्लेसहोल्डर पहचानों को बाहर रखा जाता है, और केवल प्रदर्शन नामों के मेल खाने के कारण सामान्य ई-मेल पतों को मर्ज नहीं किया जाता। 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. **आधार = वह `release/vX.Y.Z` शाखा** रखकर Pull Request खोलें
विस्तृत दिशानिर्देशों के लिए [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)** के fork और Go प्रोजेक्ट **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** के TypeScript port के रूप में हुई थी — और उसके बाद, नीचे दिए गए प्रत्येक subsystem को पहले वहाँ पहुँच चुके किसी open-source प्रोजेक्ट से प्रेरणा मिली। इनमें से प्रत्येक ने OmniRoute के एक ठोस हिस्से को आकार दिया। यह उन सभी के प्रति हमारा धन्यवाद है। 🙏
> ⭐ star counts को GitHub के REST API से 3 नवंबर 2026 को सत्यापित किया गया है — इन प्रोजेक्ट्स को star दें। Counts एक निश्चित दिनांक का snapshot हैं और स्वाभाविक रूप से बदलते रहेंगे।
### 🧬 वंशावली और gateway
वह AI gateway जिसका public pricing dataset हमारे cost-tracking sync को feed करता है और जिसके provider-normalization model ने हमारी routing को प्रभावित किया।
MIT source को vendored ChatGPT Web → Codex Responses bridge में अनुकूलित किया गया, जिसमें browser-session, response-framing, usage और web-search adapters शामिल हैं।
इसके patterns को stream recovery, no-thinking aliases, fallback web search, sliding-window limits, log redaction और hardened launcher flows में port किया गया।
इसके Grok model mappings, fake-TypeError Statsig generator, request और device defaults, तथा NDJSON response processor को OmniRoute के Grok Web executor में महत्वपूर्ण रूप से अनुकूलित किया गया।
grok2api-merged के पीछे का प्रमुख transitive code source; इसके model, header, payload, Statsig और processor implementations को Grok Web lineage में संरक्षित रखा गया है।
Grok payload और device defaults, Statsig generator, तथा result.response processor के लिए underlying MIT source, जिसे TQZHR और grok2api-merged के माध्यम से आगे लाया गया है।
grok2api-merged द्वारा इसकी proxy-pool layer के लिए श्रेय दिया गया एक transitive source; OmniRoute इस lineage notice को संरक्षित रखता है, लेकिन अपने bounded Grok Web executor में proxy-pool port का दावा नहीं करता।
इसके HTTP/browser upstream design के लिए मूल Grok Web implementation का परामर्श लिया गया; इसका direct HTTP path GrokProxy से निकला है, इसलिए किसी स्वतंत्र code port का दावा नहीं किया गया है।
वायरल "कम टोकन का उपयोग क्यों न करें, जब थोड़े टोकन से काम चल सकता है" प्रोजेक्ट — इसका caveman-स्पीक दर्शन हमारे मानक संपीड़न मोड और 30+ filler/condensation नियमों को शक्ति देता है।
PT-BR टोकन संपीड़न — हमारे pt-BR language pack को शक्ति देता है: ब्राज़ीलियाई-पुर्तगाली व्याकरण के लिए pleonasm reduction और filler removal को अनुकूलित किया गया है।
वायरल "lazy senior dev" YAGNI-coder skill — इसने हमारी less-code Output Style को प्रेरित किया: ऐसा smallest-working-change steering जो _जनरेट किए गए_ कोड को कम करता है (Caveman की terse prose के output-axis sibling के रूप में)।
Rust columnar-JSON + content-addressed retrieve + cross-message dedup — इसने हमारे headroom/ccr/session-dedup engine design और cache-stable "compressed form is position-independent" invariant को मान्य किया।
कोडिंग-असिस्टेंट ↔ LLM ट्रैफ़िक के MITM अवरोधन/विश्लेषण से शुरुआती Traffic Inspector आवश्यकताओं की जानकारी मिली। पहले प्राप्त चार मॉड्यूल — SSE मर्जिंग, conversation normalization, secret masking और header sanitization — अब सार्वजनिक प्रोटोकॉल मानकों पर आधारित स्वतंत्र clean-room कार्यान्वयनों से प्रतिस्थापित किए जा चुके हैं। दो host-passthrough सतहें (passthrough.ts और _internal/bypass.cjs) OmniRoute की आंतरिक कार्यान्वयन बनी हुई हैं और स्वतंत्र रूप से वर्गीकृत हैं; उस प्रतिस्थापन के हिस्से के रूप में इन्हें फिर से नहीं लिखा गया।
प्रति-प्रोसेस पारदर्शी प्रॉक्सी रूटिंग — इससे हमारा crash-safe MITM teardown, socket idle-timeouts, /proc process attribution और TPROXY capture प्रेरित हुआ।
सुरक्षित-डिफ़ॉल्ट वाली लाइब्रेरी की क्यूरेटेड सूची, जो हमारे सुरक्षा विकल्पों (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink) का मार्गदर्शन करती है।
Grok Build quota surface की पहचान की; इसके बाद OmniRoute ने live wire format को स्वतंत्र रूप से सत्यापित और ठीक किया।
## 📄 लाइसेंस
MIT License - विवरण के लिए [LICENSE](LICENSE) देखें।
---
**[⬆ शीर्ष पर वापस जाएँ](#-omniroute)** · ओपन-सोर्स AI समुदाय के लिए ❤️ से निर्मित।
Diego Souza द्वारा निर्मित · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT License · omniroute.online
> लाइव `/dashboard/free-tiers` पेज का एनिमेटेड सारांश। पूरी कार्यप्रणाली (पूल डुप्लिकेट हटाना, क्रेडिट स्तर, प्रदाता की शर्तें): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> इन आँकड़ों का लाइव कैटलॉग के आधार पर हर दो सप्ताह में फिर से ऑडिट किया जाता है और ये **दोनों दिशाओं में बदलते हैं** — कोई प्रदाता मुफ़्त स्तर समाप्त करता है तो संख्या घटती है; कोई नया प्रदाता जुड़ता है तो संख्या बढ़ती है। हम वही प्रकाशित करते हैं जिसकी कैटलॉग वास्तव में गणना करती है, कभी भी ऊपर की ओर गोल किया हुआ सर्वोत्तम अनुमान नहीं।
```bash
# किसी प्रोवाइडर से कनेक्ट करने के बाद, डैशबोर्ड → एंडपॉइंट्स से अपनी 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` के लिए एक योग्य रूट आवश्यक है। नए इंस्टॉलेशन में कोई योग्य keyless लक्ष्य नहीं हो सकता, और कोई keyless प्रोवाइडर तृतीय-पक्ष क्लाइंट को अस्वीकार कर सकता है। `tos: avoid` के रूप में चिह्नित प्रोवाइडर, जिनमें Kiro भी शामिल है, डिफ़ॉल्ट रूप से स्वचालित रूटिंग से बाहर रखे जाते हैं; किसी खाते को कनेक्ट करने से यह सेटिंग ओवरराइड नहीं होती। किसी प्रोवाइडर को चुनने से पहले [Free Tiers Guide](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` चलता है। जब दोनों एक ही टूल/कॉन्टेक्स्ट payload पर काम करते हैं, तो बचत संचयी हो जाती है:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लॉक, URL, JSON और संरचित डेटा **preservation engine द्वारा हमेशा सुरक्षित** रहते हैं।
> **जब कम टोकन से काम चल जाता है, तो इतने अधिक टोकन क्यों इस्तेमाल करें?** प्रत्येक अनुरोध OmniRoute की compression pipeline से **पारदर्शी रूप से** गुजरता है — क्लाइंट में कोई बदलाव आवश्यक नहीं। अब यह **12 संयोज्य इंजनों का एक स्टैक** है, जो क्रम से चलते हैं और प्रत्येक routing combo के अनुसार आपस में मिलाए जा सकते हैं — [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-इंजन स्टैक
इंजन pipeline क्रम में चलते हैं; प्रत्येक को अलग-अलग सक्षम किया जा सकता है और प्रति combo कॉन्फ़िगर किया जा सकता है:
