## 💰 ~1.62B टोकन्स / महिना तृतीय-पक्ष फ्री टियर्समध्ये
> **तुमच्या स्वतःच्या प्रोव्हायडर अकाउंट्स वापरा.** हा वेगवेगळ्या पात्र तृतीय-पक्ष फ्री टियर्सचा अंदाजित एकूण आहे, OmniRoute कडून मिळालेला टोकन ग्रँट नाही. साइन अप करा, आवश्यक असल्यास क्रेडेन्शियल्स मिळवा आणि तुम्ही वापरू शकता ते प्रोव्हायडर्स जोडा; प्रत्येक प्रोव्हायडर त्याच्या मर्यादा, उपलब्धता आणि अटी स्वतः नियंत्रित करतो.
>
> फ्री टियर्स हाताने स्टॅक करणे त्रासदायक आहे — डझनभर SDKs, डझनभर रेट लिमिट्स आणि तुमच्याकडे प्रत्यक्षात किती आहे याची कल्पनाही नाही. OmniRoute **34 रिकरिंग पूल कीजमधील 467 फ्री-टियर एंट्रीज**ची यादी ठेवतो आणि **प्रकाशित सकारात्मक मासिक बजेट असलेल्या 17 पूल्स तसेच पाच प्रति-मॉडेल Groq कॅप्स**वरून टोकन हेडलाइन मोजतो, शेअर्ड पूलनुसार डुप्लिकेट वगळून. प्रादेशिक ओळख पडताळणीनंतरच उघडणारे कोटे (आज: ModelScope) वेगळे दाखवले जातात, प्रादेशिक ओळख पडताळणीमागे +~6M, आणि ते कधीही हेडलाइनमध्ये धरले जात नाहीत. निकाल डॅशबोर्डवर (`/dashboard/free-tiers`) सतत दिसत असतो.
> थेट `/dashboard/free-tiers` पेजचा अॅनिमेटेड सारांश. संपूर्ण पद्धतशास्त्र (पूल डिड्युप, क्रेडिट टियर्स, प्रोव्हायडर अटी): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ही आकडेवारी दर दोन आठवड्यांनी थेट कॅटलॉगशी पुन्हा तपासली जाते आणि ती **दोन्ही बाजूंनी बदलते** — एखादा प्रोव्हायडर फ्री टियर बंद करतो तेव्हा आकडा घटतो; नवीन प्रोव्हायडर येतो तेव्हा तो वाढतो. कॅटलॉग प्रत्यक्षात जे मोजतो तेच आम्ही प्रकाशित करतो, वर राऊंड केलेले सर्वोत्तम प्रकरण कधीही नाही.
⭐ OMNIROUTE ने तुमचे पैसे वाचवण्यात आणि तुमचे काम सोपे करण्यात मदत केली असल्यास, रेपोला Star द्या.
[](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) / [🇧🇷 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
# प्रोव्हायडर कनेक्ट केल्यानंतर, Dashboard → Endpoints मधून तुमची OmniRoute key कॉपी करा:
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 प्रोव्हायडर तृतीय-पक्ष क्लायंट्स नाकारू शकतो. 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-टोकन संदर्भ विंडो, मूळ दृष्टी आणि बंद-मॉडेल किमतीच्या काही अंशात सीमा-स्तरीय कोडिंग प्रदान करते आणि Claude Code, Codex आणि 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
या प्रकल्पाला पाठिंबा दिल्याबद्दल OmniRoute मुक्त स्रोत मित्र, Cheaper Inference चे आभार! 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** पर्यंत वाढवू शकते. OmniRoute च्या आवृत्त्यांदरम्यान मोफत मॉडेल्सच्या उपलब्धतेबद्दल अधिक अद्ययावत माहिती हवी असलेल्या लोकांसाठी Radar हा एक पर्यायी, स्वाक्षरीकृत कॅटलॉग ओव्हरले आहे; समुदाय कॅटलॉग आणि सध्या अस्तित्वात असलेली प्रत्येक मोफत सुविधा विनामूल्यच राहते.
समर्थकांना लाइव्ह कॅटलॉग आणि प्रदात्यांच्या अतिरिक्त संधी मिळू शकतात. प्रदात्यांच्या उपलब्धतेनुसार, त्याची स्वतंत्र आणि बदलणारी कमाल मर्यादा **जास्तीत जास्त अंदाजे 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वी कॉम्बो रणनीती थकलेली खाती वगळते, नंतर उरलेल्या कोटा ÷ प्रगतीपथावरील (in-flight) लोडच्या प्रमाणात उर्वरितांमधून निवड करते, विद्यमान संभाषणे पिन केलेली ठेवते. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 हेडलेस मोड** — `omniroute serve --headless` (किंवा `OMNIROUTE_HEADLESS=1`) फक्त `/v1/*` प्रॉक्सी इंजिन चालवते, डॅशबोर्ड आणि केवळ-डॅशबोर्ड उपप्रणाली बंद ठेवून. → [हेडलेस मोड](docs/guides/HEADLESS.md)
- **🔎 मॉडेल शोध** — `/v1/models` क्षमता, कॉन्टेक्स्ट, प्रकार आणि मजकुरानुसार फिल्टर करते, आणि `POST /v1/models/query` त्याच प्रति-की दृश्यतेसह एक छोटी नियतात्मक (deterministic) शॉर्टलिस्ट परत करते. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🔑 प्रति-की राउटिंग नियंत्रण** — `forcedModel` वापरून API की एका मॉडेल किंवा कॉम्बोला पिन करा, आणि कीची मॉडेल्स व कॉम्बो अणुक्रियेने (atomically) जोडा किंवा काढा (`/api/keys/{id}/access`). → [API संदर्भ](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ अधिक सूक्ष्म PII नियंत्रणे** — प्रति-प्रकार निवड, 20 पर्यंत प्रमाणित कस्टम मास्किंग नमुने आणि प्रति-प्रकार शोध काउंटर; मास्किंग स्वतः opt-inच राहते. → [गार्डरेला](docs/security/GUARDRAILS.md)
- **🌍 67 भाषा** — डॅशबोर्ड, डॉक्स मिरर आणि CLI, जिथे `npm run i18n:add-locale` एका आज्ञेने सर्वत्र भाषा जोडते. → [i18n मार्गदर्शक](docs/guides/I18N.md)
- **🎛️ OmniConductor** — तुमच्या एजंट फ्लीटकडे इनबाउंड A2A डेलिगेशन, Agent Card वर Conductor कौशल्ये, आणि Faro push-to-talk व्हॉइस चॅटसह डॅशबोर्ड पॅनेल. → [A2A सर्व्हर](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूल प्रवेश व ओव्हरलोड संरक्षण** — जड चॅट विनंत्या 503 टाकण्याऐवजी रांगेत उभ्या राहतात, प्रति कनेक्शन अणुक्रिय (atomic) 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)
- **⚖️ Quota-Share राउटिंग** — शेअर केलेल्या खात्याचा कोटा पूल केलेल्या कीजमध्ये न्याय्यपणे वाटा; काम-संरक्षणकारी (work-conserving) असल्याने निष्क्रिय हिस्से कर्जाने दिले जातात. → [रेझिलियन्स मार्गदर्शक](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`) रिमोट OmniRoute चालवा + VPS इन्स्टॉलसाठी `antigravity` OAuth हेल्पर. → [रिमोट मोड](docs/guides/REMOTE-MODE.md)
- **🧭 हुशार ऑटो-राउटिंग** — `auto/:` कॉम्बो, **Fusion** (मॉडेल पॅनेल + निर्णायक), टास्क-जागरूक राउटिंग, प्रति-विनंती मॉडेल / मोड / USD-बजेट ओव्हरराइड. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ प्लग करण्यायोग्य कॉम्प्रेशन** — 12 कंपोज करण्यायोग्य इंजिन + Compression Studios: LLMLingua-2, दुहेरी-स्तरीय Ultra, omniglyph, प्रति-पायरी फिडेलिटी गेट, GCF v3.2, ड्रॅग-रीऑर्डर एडिटर. → [कॉम्प्रेशन](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ पारदर्शक MITM डिक्रिप्ट (TPROXY)** — प्रॉक्सी एन्व्ह व्हेरिएबल्स दुर्लक्ष करणारे CLI कॅप्चर करा, प्रति-SNI CA + ट्रस्ट-स्टोअर इन्स्टॉलरसह. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 सर्वत्र खर्च टेलीमेट्री** — प्रत्येक एंडपॉइंटवर `X-OmniRoute-*` खर्च/वापर हेडर्स, cache-HIT बचत हेडर, प्रति-की USD खर्च कोटा. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🧠 तुमच्या नियंत्रणातील मेमरी** — डीफॉल्टनुसार बंद, opt-in int8 व्हेक्टर क्वांटायझेशन + टाइप्ड डिके, प्रति-विनंती `x-omniroute-no-memory`. → [मेमरी](docs/frameworks/MEMORY.md)
- **🛡️ सुरक्षा** — प्रत्येक LLM मार्गावर प्रॉम्प्ट-इंजेक्शन गार्ड (रेड-टीम सूट), opt-in क्रेडेन्शियल-मास्किंग गार्डरेल (दोन्ही दिशांनी गल्लीत झालेले 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` कॉम्बो रणनीती + Auto-Combo `cacheAffinity` घटक पुनरावृत्त विनंत्या कॅश केलेला प्रीफिक्स धरलेल्या कनेक्शनकडे परत पाठवतात, आणि रीड-ओन्ली `/v1/auto-combo/{channel}/candidates` एंडपॉइंट `auto/*` चॅनेलचा थेट उमेदवार पूल उघड करतो. → [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 API, सिमॅंटिक रिस्पॉन्स कॅशे, लीडरबोर्डसह गेमिफिकेशन, ACP एजंट डिस्कव्हरी (15 अंगभूत एजंट), BigQuery कडे शेड्यूल्ड लॉग एक्सपोर्ट, `auto/chaos` समांतर मल्टी-मॉडेल फॅन-आउट, Telegram बॉट ब्रिज, इन-अॅप व्हर्जन मॅनेजर आणि LMArena-ELO फ्री-प्रोव्हायडर रँकिंग. → [दस्तऐवज](docs/README.md)
## 🤖 सुसंगत CLIs आणि कोडिंग एजंट्स
> एक कॉन्फिग — `http://localhost:20128/v1` — आणि **प्रत्येक** AI IDE किंवा CLI मोफत आणि कमी किमतीच्या मॉडेल्सवर चालते.
**एका कमांडद्वारे 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 नोंदणीकृत प्रदाते** canonical चॅट, मीडिया, शोध, स्थानिक, क्लाउड-एजंट आणि सिस्टम संग्रहांमध्ये, यामध्ये **`hasFree: true` शोध मेटाडेटा सहित 153** समाविष्ट आहेत. चॅट मॉडेल रजिस्ट्रीमध्ये **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 ऑटो-राउटर, 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
### 🧩 नवीन: 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** उघडा.
एडिटरमधून: **Extensions** दृश्य उघडा, **"OmniRoute"** शोधा, **इंस्टॉल करा** क्लिक करा
— दोन्ही स्टोअरवर ते एकाच प्रकारे कार्य करते. स्रोत, समस्या आणि प्रकाशनाची कार्यपद्धती
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) येथे उपलब्ध आहेत.
📖 [VS Code Copilot Chat मार्गदर्शक](docs/guides/VSCODE-COPILOT.md) — सेटअप, निवडक काय दाखवतो, टॅबमधील डॅशबोर्ड, समस्या निवारण
> `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** किंवा **remote CLI** द्वारे उपलब्ध करा — कोणत्याही सक्षम एजंटला (किंवा तुमच्या स्वतःच्या कोडला) संपूर्ण गेटवेच्या किल्ल्या मिळतात: राउटिंग, प्रोव्हायडर्स, कॉम्बोज, कॅशे, कॉम्प्रेशन, मेमरी — सर्व काही स्वायत्तपणे. खालील HTTP एंडपॉइंट्स `http://localhost:20128` अंतर्गत उपलब्ध केले जातात.
इंटरफेस
एंडपॉइंट / कमांड
यासाठी वापरा
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor किंवा कोणत्याही MCP क्लायंटमध्ये जोडा
रिक्वेस्ट / कोटा इव्हेंट्स Slack, Discord, Telegram किंवा कोणत्याही URL कडे पुश करा
🛰️ Remote CLI
omniroute connect
स्कोप केलेल्या अॅक्सेस टोकन्सद्वारे रिमोट इन्स्टन्स चालवा
```bash
# MCP द्वारे Claude Code ला संपूर्ण 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` चालवते. जेव्हा दोन्ही एकाच टूल/कॉन्टेक्स्ट पेलोडवर कार्य करतात, तेव्हा बचत चक्रवाढीने वाढते:
```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 आणि स्ट्रक्चर्ड डेटा प्रिझर्व्हेशन इंजिनद्वारे **नेहमी संरक्षित** असतो.
> **कमी टोकनमध्ये काम होत असताना जास्त टोकन का वापरायचे?** प्रत्येक विनंती OmniRoute च्या कॉम्प्रेशन पाइपलाइनमधून **पारदर्शकपणे** जाते — क्लायंटमध्ये कोणतेही बदल नाहीत. ही आता क्रमाने चालणाऱ्या आणि प्रत्येक रूटिंग कॉम्बोनुसार मिक्स अँड मॅच होणाऱ्या **12 कम्पोझेबल इंजिनची स्टॅक** आहे — [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-इंजिन स्टॅक
इंजिन पाइपलाइन क्रमाने चालतात; प्रत्येक इंजिन स्वतंत्रपणे टॉगल करण्यायोग्य आणि प्रत्येक कॉम्बोनुसार कॉन्फिगर करण्यायोग्य आहे:
#
इंजिन
ते काय करते
1
Session-Dedup
टर्न्समध्ये पुनरावृत्त झालेला कंटेंट काढून टाकते (कंटेंट-अॅड्रेस्ड, क्रॉस-टर्न)
2
CCR
मोठे ब्लॉक retrieve मार्कर्समागे संग्रहित करते, मागणीनुसार आणले जातात
थेट Anthropic वायरवर मोजमाप केलेल्या Claude Fable 5 साठी प्रायोगिक कॉन्टेक्स्ट-अॅज-इमेज एन्कोडिंग; प्रोव्हायडर पावत्या येईपर्यंत GPT 5.6 ट्रान्सफॉर्मर्स फेल-क्लोज्ड राहतात. चार कॉम्प्रेशन प्रोफाइल्स (aggressive default, balanced, coding-safe, passthrough) (सर्वात आक्रमक; ऑप्ट-इन)
कोड ब्लॉक, URL आणि स्ट्रक्चर्ड डेटा **नेहमी** बाइट-परफेक्ट **जतन केला** जातो. **वन-क्लिक प्रीसेट्स** ही इंजिन एकत्र करतात:
मोड
बचत
योग्य वापर
🪶 Lite
~15%
नेहमी-चालू सुरक्षित डीफॉल्ट
🪨 Standard (Caveman)
~30%
रोजचे कोडिंग
⚡ Aggressive
~50%
लांब, टूल-भारित सेशन्स
🔥 Ultra
~75%
कमाल बचत
🧰 RTK
60–90%
Shell/test/build/git आउटपुट
🔗 Stacked (RTK → Caveman)
78–95%
मिश्र प्रॉम्प्ट्स + टूल लॉग्स
**प्रत्यक्ष उदाहरण — Standard मोड:**
> **आधी (69 टोकन):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_
>
> **नंतर (19 टोकन):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_
>
> **तेच उत्तर. 72% कमी टोकन. अचूकतेची शून्य हानी.** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) मोड:**
> **आधी (42 टोकन्स):** _"समस्या अशी आहे की प्रत्येक रेंडर सायकलमध्ये नवीन ऑब्जेक्ट रेफरन्स तयार होत असल्यामुळे कॉम्पोनन्ट री-रेंडर होत आहे. मी useMemo वापरण्याची शिफारस करेन."_
>
> **नंतर (12 टोकन्स):** _"री-रेंडर: प्रत्येक सायकलला नवीन ref (इनलाइन ऑब्जेक्ट पुन्हा तयार होतो). `useMemo` वापरा."_
>
> **तेच उत्तर. ~70% कमी टोकन्स. तांत्रिक अचूकता कायम.** ✅
### 🎚️ इंजिन्जच्या पलीकडे — आउटपुट स्टाइल्स, अॅडाप्टिव्ह डायल आणि प्रति-विनंती नियंत्रण
वरील 12 इंजिन्ज **आत** जाणारे कमी करतात. आणखी तीन स्तर **कसे**, **केव्हा** आणि **बाहेर** काय येते हे ठरवतात:
- **🪄 आउटपुट स्टाइल्स** _(आउटपुट-अक्ष स्टीयरिंग)_ — नियतात्मक, कॅश-सेफ प्रतिसाद-आकारण सूचना इंजेक्ट करतात; एकत्र वापरता येतात, प्रत्येकी `lite` / `full` / `ultra` तीव्रतेने. स्टाइल जोडणे म्हणजे एक-ओळीची रजिस्ट्री एन्ट्री:
- **संक्षिप्त गद्य** — भरमशब्द / आर्टिकल्स / टाळाटाळीची भाषा काढून टाका; तांत्रिक सार अचूक ठेवा.
- **कमी कोड** — "आळशी सीनियर डेव्ह" YAGNI: सर्वात लहान कार्यशील बदल, न मागितलेले स्कॅफोल्डिंग नाही.
- **Ponytail (आळशी सीनियर डेव्ह)** — YAGNI शिडी चढा, मुळातील कारण दुरुस्त करा, सर्वात लहान कार्यशील diff.
- **मला ADHD आहे (कृती-प्रथम)** — पुढील कृती अगोदर येते, पायऱ्या क्रमांकित, एक ठोस पुढील पायरी, प्रस्तावना नाही.
- **संक्षिप्त CJK (文言)** — शास्त्रीय-चिनी अति-संक्षिप्त शैली (`zh` साठी लोकेल-गेटेड).
- **🎯 अॅडाप्टिव्ह कॉन्टेक्स्ट-बजेट** _(डायल)_ — एकाच चालू/बंद टोकन थ्रेशोल्डऐवजी, **मॉडेलच्या कॉन्टेक्स्ट विंडोमध्ये बसण्यासाठी** आवश्यक तितक्याच सर्वात स्वस्त, सर्वात हानी-रहित इंजिन्ज वाढवा. पॉलिसी: `reserve-output` (डीफॉल्ट, मॉडेल-अवेअर) · `percentage` · `absolute`. मोड: `floor` (बसण्याची हमी) · `replace-autotrigger` (तुमची स्पष्ट निवड जिंकते) · `off` (लीगसी थ्रेशोल्ड).
- **🎛️ कॉम्प्रेशन कुठे ठरते** _(प्राधान्यक्रम, उच्च → कमी)_ — प्रति-विनंती `x-omniroute-compression` हेडर › रूटिंग-कॉम्बो ओव्हरराइड › सक्रिय नामांकित प्रोफाइल › अॅडाप्टिव्ह / ऑटो-ट्रिगर › पॅनेल डीफॉल्ट › off. लागू केलेले प्लॅन `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
> ```
>
> भविष्यातील ग्लोबल इंस्टॉल्ससाठी ही अलाऊलिस्ट पुन्हा वापरायची असल्यास, ती एकदाच कॉन्फिगर करा आणि मग नेहमीप्रमाणे इंस्टॉल करा:
>
> ```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 की जोडा किंवा खाते-फ्लो पूर्ण करा. फ्री टियर्ससाठी साइनअप, मान्यता किंवा पेमेंट पद्धत लागू शकते. [फ्री टियर्स मार्गदर्शक](docs/getting-started/FREE-TIERS-GUIDE.md) पहा; की-विरहित उपलब्धतेची हमी नाही, आणि `tos: avoid` असे चिन्हांकित प्रोव्हायडर डीफॉल्टनुसार `auto` मधून वगळलेले असतात.
**3) तुमचे कोडिंग टूल इकडे पॉइंट करा**
```txt
Base URL: http://localhost:20128/v1
API Key: [डॅशबोर्ड → Endpoints मधून कॉपी करा]
Model: auto (पात्र कनेक्शन्समध्ये रूट करते — किंवा प्रोव्हायडर/मॉडेल निवडा)
```
**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 heap ची आवश्यकता असते; अन्यथा दोन दीर्घ संदर्भ एकाच वेळी चालू असताना सुमारे 12 GiB वर प्रक्रियेत `FATAL ERROR` येतो. कंटेनरचा आकार heap पेक्षा मोठा ठेवा (नेटिव्ह बफर्स V8 च्या बाहेर असतात):
| कार्यभार | Heap (`-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 रनटाइम शोधाद्वारे मानक `bun install` आणि जागतिक इंस्टॉलेशन (`bun install -g omniroute`) समर्थित आहेत:
- **अंगभूत `bun:sqlite`**: Bun अंतर्गत चालत असताना OmniRoute, Bun चा अंगभूत `bun:sqlite` ड्रायव्हर वापरतो आणि Node.js वर `better-sqlite3` किंवा `sql.js` चा पर्याय म्हणून वापर करतो.
- **डेव्हलपमेंटमध्ये स्वयंचलित Webpack बंडलर निवड**: नेटिव्ह V8 बाइंडिंग विसंगती टाळण्यासाठी डेव्हलपमेंट (`bun run dev`) आपोआप Bun शोधते आणि Webpack च्या बाजूने Turbopack अक्षम करते. प्रॉडक्शन बिल्ड (`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. bind-mounted डेटा डिरेक्टरी तयार करा
mkdir -p data
# 2. केवळ Linux + स्थानिक rootless 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-मात्र पॅकेज नाही.
7,800+ ट्रॅक केलेल्या चाचणी फाइल्समधील 56,000+ स्थिर चाचणी घोषणांसाठी चाचणी कव्हरेज धोरण
# ⭐ शीर्ष योगदानकर्ते
> OmniRoute एका उत्साही ओपन-सोर्स समुदायामुळे घडला आहे. या व्यक्तींनी प्रकल्पाच्या गुणवत्ता, स्थिरता आणि पोहोचवर थेट परिणाम करणारे अपवादात्मक योगदान दिले आहे. **धन्यवाद.**
### मर्ज केलेल्या PR नुसार बाह्य योगदानकर्ते
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 आणि यात जनरेट केलेल्या फाइल्स, लॉकफाइल्स, कॅटलॉग्ज, भाषांतरे आणि दस्तऐवजीकरण यांचा समावेश आहे; हा फेरफार (churn) आहे, लेखकाने लिहिलेला LOC नाही. 49 PR मध्ये GitHub diffs 500,000 ओळींपेक्षा जास्त आहेत (उदाहरणार्थ #13399 — एकच प्रोव्हायडर जोडणी — 2,347 बदललेल्या फाइल्स दर्शवते), ज्यामुळे वरील अनेक एकूण आकडे फुगलेले दिसतात. समान स्थान असलेले एकत्र क्रमवारीत लावले आहेत.
### GitHub-ने श्रेय दिलेले कमिट्स
2026-10-18 14:44:45 UTC रोजी पुन्हा तपासणी केली: release/v3.8.52 डीफॉल्ट ब्रांचसाठी रिपॉझिटरी Contributors API ने नोंदवलेले GitHub-श्रेयित कमिट. 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` ब्रँच** ठेवून 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)** च्या फोर्कच्या आणि Go प्रकल्प **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** च्या TypeScript पोर्टच्या रूपात झाली — आणि त्यानंतर, खालील प्रत्येक उपप्रणालीला आधीच ते साध्य केलेल्या एका मुक्त-स्रोत प्रकल्पातून प्रेरणा मिळाली. यांपैकी प्रत्येकाने OmniRoute च्या एका ठोस भागाला आकार दिला. त्या सर्वांचे आभार मानण्याचा हा आमचा प्रयत्न आहे. 🙏
> ⭐ स्टारची संख्या 18 ऑक्टोबर 2026 रोजी GitHub च्या REST API वरून सत्यापित केली — या प्रकल्पांना नक्की स्टार द्या. ही संख्या विशिष्ट तारखेचा अचूक स्नॅपशॉट आहे आणि कालांतराने स्वाभाविकपणे बदलेल.
### 🧬 वंशपरंपरा आणि गेटवे
हा असा AI गेटवे आहे, ज्याचा सार्वजनिक किंमत डेटासेट आमच्या खर्च-ट्रॅकिंग समक्रमणाला डेटा पुरवतो आणि ज्याच्या प्रदाता-सामान्यीकरण मॉडेलने आमच्या रूटिंगला दिशा दिली.
स्ट्रीम पुनर्प्राप्ती, विचार-विरहित उपनावे, फॉलबॅक वेब शोध, सरकत्या-विंडो मर्यादा, लॉगमधील संवेदनशील माहिती लपवणे आणि अधिक सुरक्षित लाँचर प्रवाहांमध्ये पोर्ट केलेले नमुने.
त्याची Grok मॉडेल मॅपिंग्ज, बनावट-TypeError Statsig जनरेटर, विनंती व उपकरणाची डीफॉल्ट मूल्ये आणि NDJSON प्रतिसाद प्रोसेसर यांचे OmniRoute च्या Grok Web एक्झिक्युटरमध्ये लक्षणीय रूपांतर करण्यात आले.
TQZHR आणि grok2api-merged मार्फत पुढे आलेल्या Grok पेलोड व उपकरणाच्या डीफॉल्ट मूल्यांचा, Statsig जनरेटरचा आणि result.response प्रोसेसरचा मूलभूत MIT स्रोत.
grok2api-merged ने त्याच्या प्रॉक्सी-पूल स्तरासाठी श्रेय दिलेला अप्रत्यक्ष स्रोत; OmniRoute ही वंशपरंपरेची नोंद जतन करते, परंतु त्याच्या मर्यादित Grok Web एक्झिक्युटरमध्ये प्रॉक्सी-पूल पोर्ट केल्याचा दावा करत नाही.
मूळ Grok Web अंमलबजावणीने त्याच्या HTTP/ब्राउझर अपस्ट्रीम डिझाइनचा संदर्भ घेतला; त्याचा थेट HTTP मार्ग GrokProxy मधून व्युत्पन्न झाला असल्याने, स्वतंत्र कोड पोर्टचा दावा केला जात नाही.
व्हायरल झालेला "अनेक टोकन का वापरायचे, जेव्हा काही टोकनने काम होते" प्रकल्प — त्याचे गुहामानव-सदृश भाषेचे तत्त्वज्ञान आमच्या मानक कॉम्प्रेशन मोडला आणि 30+ अनावश्यक मजकूर काढण्याच्या/संक्षेपणाच्या नियमांना आधार देते.
उच्च-कार्यक्षमता कमांड-आउटपुट कॉम्प्रेशन — याने आमचे RTK इंजिन, JSON फिल्टर DSL, रॉ-आउटपुट पुनर्प्राप्ती आणि स्तरित RTK → Caveman पाइपलाइन यांना प्रेरणा दिली.
PT-BR टोकन कॉम्प्रेशन — आमच्या pt-BR भाषा पॅकला आधार देते: ब्राझिलियन-पोर्तुगीज व्याकरणासाठी अनुकूल केलेले पुनरुक्ती-संक्षेपण आणि अनावश्यक मजकूर काढणे.
व्हायरल झालेली "आळशी वरिष्ठ डेव्हलपर" YAGNI-कोडर कौशल्यपद्धती — याने आमच्या less-code आउटपुट शैलीला प्रेरणा दिली: सर्वांत लहान कार्यक्षम बदलाकडे मार्गदर्शन, ज्यामुळे _व्युत्पन्न केलेला_ कोड कमी होतो (Caveman च्या संक्षिप्त गद्याचा आउटपुट-अक्षावरील समकक्ष).
Rust स्तंभीय-JSON + सामग्री-पत्तायुक्त पुनर्प्राप्ती + संदेश-पार डीडुप — याने आमच्या headroom/ccr/session-dedup इंजिन रचनेला आणि कॅशे-स्थिर "संक्षिप्त स्वरूप स्थानापासून स्वतंत्र असते" या अपरिवर्तनीय तत्त्वाला पुष्टी दिली.
कोडिंग-असिस्टंट ↔ LLM ट्रॅफिकच्या MITM इंटरसेप्शन/विश्लेषणाने Traffic Inspector च्या सुरुवातीच्या आवश्यकतांना दिशा दिली. पूर्वी त्यावरून तयार केलेले चार मॉड्यूल — SSE विलीनीकरण, संभाषण सामान्यीकरण, गुपितांचे मास्किंग आणि हेडर निर्जंतुकीकरण — सार्वजनिक प्रोटोकॉल मानकांवर आधारित स्वतंत्र clean-room अंमलबजावण्यांनी बदलण्यात आले आहेत. दोन होस्ट-पासथ्रू पृष्ठभाग (passthrough.ts आणि _internal/bypass.cjs) स्वतंत्रपणे वर्गीकृत केलेल्या OmniRoute-अंतर्गत अंमलबजावण्या म्हणून कायम आहेत; त्या बदलाचा भाग म्हणून ते पुन्हा लिहिले गेले नाहीत.
डीफॉल्टनुसार सुरक्षित असलेल्या लायब्ररींची काळजीपूर्वक निवडलेली सूची, जी आमच्या सुरक्षा-संबंधित निवडींना मार्गदर्शन करते (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
> थेट `/dashboard/free-tiers` पेजचा अॅनिमेटेड सारांश. संपूर्ण पद्धतशास्त्र (पूल डिड्युप, क्रेडिट टियर्स, प्रोव्हायडर अटी): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ही आकडेवारी दर दोन आठवड्यांनी थेट कॅटलॉगशी पुन्हा तपासली जाते आणि ती **दोन्ही बाजूंनी बदलते** — एखादा प्रोव्हायडर फ्री टियर बंद करतो तेव्हा आकडा घटतो; नवीन प्रोव्हायडर येतो तेव्हा तो वाढतो. कॅटलॉग प्रत्यक्षात जे मोजतो तेच आम्ही प्रकाशित करतो, वर राऊंड केलेले सर्वोत्तम प्रकरण कधीही नाही.
```bash
# प्रोव्हायडर कनेक्ट केल्यानंतर, Dashboard → Endpoints मधून तुमची OmniRoute key कॉपी करा:
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 प्रोव्हायडर तृतीय-पक्ष क्लायंट्स नाकारू शकतो. 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` चालवते. जेव्हा दोन्ही एकाच टूल/कॉन्टेक्स्ट पेलोडवर कार्य करतात, तेव्हा बचत चक्रवाढीने वाढते:
```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 आणि स्ट्रक्चर्ड डेटा प्रिझर्व्हेशन इंजिनद्वारे **नेहमी संरक्षित** असतो.
> **कमी टोकनमध्ये काम होत असताना जास्त टोकन का वापरायचे?** प्रत्येक विनंती OmniRoute च्या कॉम्प्रेशन पाइपलाइनमधून **पारदर्शकपणे** जाते — क्लायंटमध्ये कोणतेही बदल नाहीत. ही आता क्रमाने चालणाऱ्या आणि प्रत्येक रूटिंग कॉम्बोनुसार मिक्स अँड मॅच होणाऱ्या **12 कम्पोझेबल इंजिनची स्टॅक** आहे — [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-इंजिन स्टॅक
इंजिन पाइपलाइन क्रमाने चालतात; प्रत्येक इंजिन स्वतंत्रपणे टॉगल करण्यायोग्य आणि प्रत्येक कॉम्बोनुसार कॉन्फिगर करण्यायोग्य आहे:
