> **तुमची स्वतःची प्रदाता खाती वापरा.** हा स्वतंत्रपणे पात्र असलेल्या तृतीय-पक्ष विनामूल्य स्तरांचा अंदाजित एकत्रित आकडा आहे, OmniRoute कडून मिळणारे टोकन अनुदान नाही. नोंदणी करा, आवश्यक असल्यास क्रेडेन्शियल्स मिळवा आणि तुम्ही वापरू शकत असलेले प्रदाते कनेक्ट करा; प्रत्येक प्रदाता स्वतःच्या मर्यादा, उपलब्धता आणि अटी नियंत्रित करतो.
>
> विनामूल्य स्तर स्वतः एकत्र करणे त्रासदायक आहे — डझनभर SDKs, डझनभर दरमर्यादा आणि तुमच्याकडे प्रत्यक्षात किती उपलब्ध आहे याची काहीच कल्पना नसते. OmniRoute **35 आवर्ती पूल कीजमधील 489 विनामूल्य-स्तर नोंदींची** सूची तयार करते आणि सामायिक पूलनुसार डुप्लिकेट नोंदी काढून, **प्रकाशित सकारात्मक मासिक बजेट असलेले 17 पूल आणि प्रत्येक मॉडेलसाठी असलेल्या पाच Groq मर्यादांमधून** मुख्य टोकन आकडा मोजते. ज्या कोटा केवळ प्रादेशिक ओळख पडताळणीनंतर उपलब्ध होतात (सध्या: ModelScope), ते स्वतंत्रपणे दाखवले जातात—प्रादेशिक ओळख पडताळणीमागे +~6M—आणि मुख्य आकड्यात कधीही जोडले जात नाहीत. हा परिणाम डॅशबोर्डवर (`/dashboard/free-tiers`) कायम दृश्यमान असतो.
> थेट `/dashboard/free-tiers` पृष्ठाचा अॅनिमेटेड सारांश. संपूर्ण कार्यपद्धती (पूल डुप्लिकेट काढणे, क्रेडिट स्तर, प्रदात्यांच्या अटी): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> या आकड्यांचे थेट सूचीशी पडताळून दर दोन आठवड्यांनी पुन्हा लेखापरीक्षण केले जाते आणि ते **दोन्ही दिशांनी बदलतात** — एखादा प्रदाता विनामूल्य स्तर बंद केल्यास आकडा कमी होतो; नवीन स्तर आल्यास तो वाढतो. आम्ही सूचीने प्रत्यक्षात मोजलेला आकडाच प्रकाशित करतो, वरच्या दिशेने पूर्णांक केलेली सर्वोत्तम संभाव्य स्थिती कधीही नाही.
⭐ OMNIROUTE ने तुमचे पैसे वाचवण्यास आणि तुमचे काम सोपे करण्यास मदत केली असल्यास रेपोला स्टार द्या.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 समुदायात सामील व्हा
**👋 देखभालकर्त्याला फॉलो करा — नवीन प्रदाते, प्रकाशने आणि टिपा सर्वप्रथम मिळवा:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**प्रश्न, प्रदात्यांविषयी टिपा, रोडमॅप आणि सहाय्य → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 जागतिक](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ब्राझील](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [पोर्टल](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 गेटवे सतत वाढत आहे
## 🆓 इंस्टॉल करा, प्रदाता कनेक्ट करा आणि नंतर एका एंडपॉइंटद्वारे रूट करा
```bash
# प्रदाता कनेक्ट केल्यानंतर, Dashboard → Endpoints मधून तुमची OmniRoute 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 प्रदाता तृतीय-पक्ष क्लायंट नाकारू शकतो. OpenCode Free आणि 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/offline
🔋 सर्वप्रथम सर्वाधिक कोटा / दर-मर्यादा राखीव क्षमता
auto/smart
🔭 गुणवत्तेला प्राधान्य + अधिक चांगली मॉडेल्स शोधण्यासाठी 10% अन्वेषण
auto/lkgp
📌 शेवटच्या ज्ञात चांगल्या प्रदात्याशी स्पष्टपणे कायम राहणे
auto/chaos
🧪 मॉडेल्सच्या पॅनेलकडे समांतर फॅन-आउट (प्रति प्रदाता एक, डीफॉल्टनुसार 5), एक उत्तर परत करते; प्रति पॅनेल मॉडेल एक अपस्ट्रीम कॉल, हे फॉल्ट इंजेक्शन नाही
##
### 🔀 किंवा स्वतःचा तयार करा — 19 राउटिंग धोरणे
सर्व **19** धोरणे — प्रत्येक कॉम्बो टप्प्यावर मिसळा आणि जुळवा:
#
धोरण
ते काय करते
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
reset-window
ज्याची कोटा विंडो सर्वात लवकर रीसेट होते त्या लक्ष्याला प्राधान्य द्या
12
reset-aware
कोटा रीसेट वेळेनुसार क्रमवारी लावा — लहान विंडोज प्रथम 📊
13
context-relay
दीर्घ संभाषणांसाठी लक्ष्यांदरम्यान संदर्भ हस्तांतरित करा 🧠
14
context-optimized
सध्याच्या संदर्भ आकारासाठी सर्वात योग्य लक्ष्य निवडा
15
cache-optimized
प्रत्येक पुनर्वापरयोग्य प्रॉम्प्ट उपसर्ग त्याच खात्याशी पिन करा — प्रॉम्प्ट-कॅश हिट्स जास्तीत जास्त करा 🎯
16
lkgp
शेवटचा-ज्ञात-चांगला मार्ग — शेवटच्या यशस्वी प्रदात्याशी पिन करते, त्यानंतर नियमांकडे फॉलबॅक करते
17
auto
प्रत्येक कनेक्शनवर 16-घटकांचे थेट गुणांकन 🤖
18
fusion
मॉडेल्सच्या पॅनेलकडे फॅन-आउट + एक परीक्षक एकत्रितपणे एक उत्तर तयार करतो 🧬
19
pipeline
टप्पे साखळीबद्ध करा — प्रत्येक लक्ष्याचे आउटपुट पुढील लक्ष्याचे इनपुट बनते 🔗
Auto-Combo इंजिन प्रत्येक उमेदवाराचे **16 घटकांवर** (आरोग्य, कोटा, खर्च, विलंब, कार्याशी सुसंगतता, गुणवत्ता, सत्र उपलब्धता…) गुणांकन करते — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) पाहा.
##
### 🧱 लवचिकता अंगभूत आहे (3 स्वतंत्र स्तर)
📖 [ऑटो-कॉम्बो इंजिन](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.50** मधील अलीकडील ठळक वैशिष्ट्ये. संपूर्ण इतिहास [`CHANGELOG.md`](CHANGELOG.md) मध्ये उपलब्ध आहे.
- **🎛️ OmniConductor** — तुमच्या एजंट समूहाकडे येणारे A2A प्रतिनिधीकरण, Agent Card वरील Conductor कौशल्ये आणि Faro पुश-टू-टॉक व्हॉइस चॅटसह डॅशबोर्ड पॅनेल. → [A2A सर्व्हर](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूल प्रवेश आणि ओव्हरलोड संरक्षण** — संसाधन-प्रधान चॅट विनंत्या 503 त्रुटी देण्याऐवजी रांगेत जातात आणि प्रत्येक कनेक्शनसाठी अणुस्तरीय RPM रोलिंग लीझ वापरल्या जातात. → [लवचिकता मार्गदर्शक](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ प्रमाणित `/v1/models` क्रमवारी** — प्रत्येक प्रदात्यासाठी प्रदात्यानुसार गटबद्ध केलेला एक सलग ब्लॉक (कॉम्बो प्रथम पिन केलेले), जो प्रत्येक कॅटलॉग स्रोतामध्ये स्थिर राहतो. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🗜️ अधिक मजबूत कॉम्प्रेशन** — डीफॉल्टने सुरू असलेला इन्फ्लेशन गार्ड, DE / FR / JA + चिनी (wényán) साठी Caveman पॅक आणि Gradle व .NET साठी RTK फिल्टर. → [कॉम्प्रेशन](docs/compression/COMPRESSION_ENGINES.md)
- **💸 पारदर्शक फ्लॅट-रेट खर्च** — खर्च विश्लेषणामध्ये सदस्यता / कोडिंग-प्लॅन प्रदात्यांचा खर्च **$0** म्हणून दाखवला जातो; बजेट, कोटा आणि रूटिंगमध्ये अंदाज लावणे सुरू राहते. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share रूटिंग** — पूल केलेल्या कींमध्ये सामायिक खात्याचा कोटा न्याय्यपणे विभागला जातो आणि निष्क्रिय वाटे इतरांना वापरता येत असल्याने कार्यक्षमता टिकून राहते. → [लवचिकता मार्गदर्शक](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एका कमांडमध्ये CLI/एजंट सेटअप** — 13 नोंदणीकृत `setup-*` कमांड; `omniroute run` द्वारे 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) सुरू होतात; `omniroute configure` परस्परसंवादी प्रदाता+मॉडेल निवडक आणि प्रत्येक संदर्भासाठी आवडींसह 10 लक्ष्यांना समर्थन देते. → [CLI एकत्रीकरणे](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ रिमोट मोड** — मर्यादित कार्यक्षेत्राचे टोकन (`connect` / `contexts` / `tokens`) आणि VPS स्थापनेसाठी `antigravity` OAuth सहाय्यक वापरून रिमोट OmniRoute नियंत्रित करा. → [रिमोट मोड](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)** — प्रत्येक SNI साठी CA आणि ट्रस्ट-स्टोअर इंस्टॉलरसह प्रॉक्सी पर्यावरण चलांकडे दुर्लक्ष करणारे CLI कॅप्चर करा. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 सर्वत्र खर्च टेलिमेट्री** — प्रत्येक एंडपॉइंटवर `X-OmniRoute-*` खर्च/वापर हेडर, cache-HIT बचत हेडर आणि प्रत्येक कीसाठी USD खर्च कोटा. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🧠 तुमच्या नियंत्रणातील मेमरी** — डीफॉल्टने बंद, स्वेच्छेने सुरू करता येणारे int8 व्हेक्टर क्वांटायझेशन + प्रकारबद्ध क्षय आणि प्रत्येक विनंतीसाठी `x-omniroute-no-memory`. → [मेमरी](docs/frameworks/MEMORY.md)
- **🛡️ सुरक्षा** — प्रत्येक LLM मार्गावर प्रॉम्प्ट-इंजेक्शन गार्ड (रेड-टीम संच), स्वेच्छेने सुरू करता येणारा क्रेडेन्शियल-मास्किंग गार्डरेल (दोन्ही दिशांनी लीक झालेल्या API की/गुपिते संपादित करतो), शेवटचा पर्याय म्हणून मोफत DuckDuckGo वेब शोध आणि डॅशबोर्डसाठी पर्यायी OIDC लॉगिन गेट (पासवर्ड लॉगिन नेहमीच उपलब्ध राहते). → [गार्डरेल्स](docs/security/GUARDRAILS.md)
- **🖼️ नवीन एंडपॉइंट** — `/v1/ocr` (Mistral OCR) आणि `/v1/audio/translations` (Whisper-शैलीतील) मीडिया पृष्ठभाग पूर्ण करतात. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🎨 प्रतिमा / व्हिडिओ / ऑडिओ निर्मिती** — मीडियासाठी एक API: xAI Grok Imagine आणि Novita AI व्हिडिओ, ComfyUI, Magnific, Adobe Firefly, Segmind तसेच ElevenLabs सारखे ध्वनी प्रदाते. → [API संदर्भ](docs/reference/API_REFERENCE.md)
- **🌍 उपयोजन आणि संचालन** — रिव्हर्स-प्रॉक्सी `basePath`, ब्राउझर भाषेचा स्वयंचलित शोध, प्रत्येक कीसाठी डिव्हाइस ट्रॅकिंग, रूट-विरहित MITM ट्रस्ट आणि zh-TW स्थानिकीकरण. → [पर्यावरण](docs/reference/ENVIRONMENT.md)
- **🤝 अधिक प्रदाते आणि एजंट** — क्लाउड एजंट (Codex Cloud, Cursor, Devin, Jules), ब्राउझर + OAuth लॉगिनसह Grok Build (xAI), प्रथम-श्रेणी Ollama कार्ड, Claude Opus 5 आणि Sonnet 5, Kimi ची अधिकृत भागीदारी (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… तसेच अद्ययावत **352-प्रदाता कॅटलॉग**. → [प्रदाते](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 मोफत आणि कमी किमतीच्या मॉडेल्सवर चालते.
**कोणतेही समर्थित CLI OmniRoute द्वारे एका कमांडने सुरू करा** — कोणत्याही कॉन्फिगरेशन फाइल्स लिहिल्या जात नाहीत,
प्रत्येक प्रक्रियेसाठी क्रेडेन्शियल्स अंतःक्षेपित केली जातात आणि 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
```
प्रत्येक कमांड सक्रिय रिमोट संदर्भाचे (`omniroute connect `) पालन करते, `--dry-run`
प्रत्यक्ष कार्यान्वयन न करता अचूक env/args चे पूर्वावलोकन दाखवते आणि `--api-key-env NAME` गुपिते
तुमच्या शेल इतिहासाबाहेर ठेवते. → [CLI एकत्रीकरणे](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 AI प्रदाते — 154 कॅटलॉगमध्ये विनामूल्य म्हणून चिन्हांकित
> **372 नोंदणीकृत प्रदाते** — प्रमाणित चॅट, मीडिया, शोध, स्थानिक, क्लाउड-एजंट आणि सिस्टम संग्रहांमध्ये; यांपैकी **154 प्रदात्यांकडे `hasFree: true` शोध मेटाडेटा आहे**. चॅट मॉडेल रजिस्ट्रीमध्ये **237 प्रदाते / 3,009 स्वतंत्र प्रदाता-मॉडेल जोड्या / 1,443 मूळ मॉडेल IDs** समाविष्ट आहेत; स्वतंत्र विनामूल्य-बजेट कॅटलॉगमध्ये **प्रति-मॉडेल 491 नोंदी**, **35 आवर्ती पूल** आणि **54 आवर्ती/की-विरहित कायमस्वरूपी विनामूल्य प्रदाते** आहेत. रचनेनुसार यांचे भाजक वेगवेगळे आहेत; व्याख्या आणि पूल-डिडुप्लिकेट केलेली गणना [प्रदाता संदर्भ](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
…आणि आणखी 330+ — प्रत्येक आयकॉन डॅशबोर्डच्या प्रदाता कॅटलॉगमधून थेट उपलब्ध होतो. 📖 [प्रदाता संदर्भ](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 list # ← रिमोट सर्व्हरवर चालते
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` चालवतो. दोन्ही जेव्हा एकाच टूल/कॉन्टेक्स्ट पेलोडवर काम करतात, तेव्हा बचत चक्रवाढ पद्धतीने वाढते:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लॉक्स, URLs, JSON आणि संरचित डेटा यांचे प्रिझर्वेशन इंजिनद्वारे **नेहमी संरक्षण केले जाते**.
> **कमी टोकन्समध्ये काम होत असेल, तर अधिक टोकन्स का वापरायचे?** प्रत्येक विनंती 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
मोठे ब्लॉक्स पुनर्प्राप्ती मार्कर्सच्या मागे संग्रहित करते आणि मागणीनुसार आणते
3
Lite
व्हाइटस्पेस + इमेज-URL ट्रिमिंग (कमी विलंब असलेली आधाररेषा)
4
RTK
टूलच्या परिणामांचे बुद्धिमान फिल्टरिंग, डिडुप्लिकेशन आणि ट्रंकेशन (कमांडची जाणीव ठेवून)
5
Responses Tool Output
शेल/पॅच/शोध/बिल्ड आउटपुटसाठी प्रथम लॉसलेस JSON + मर्यादित डायग्नोस्टिक कॉम्प्रेशन (Responses API)
6
Headroom
व्हेंडर केलेल्या GCF कोडेकद्वारे JSON अॅरेचे लॉसलेस सारणीबद्ध कॉम्पॅक्शन (~30%)
7
Relevance
शेवटच्या वापरकर्ता क्वेरीच्या तुलनेत वाक्यांना एक्स्ट्रॅक्टिव्ह गुणांकन देते
8
Caveman
नियम-आधारित गद्य कॉम्प्रेशन (आउटपुटवर ~65–75%)
9
Aggressive
जुन्या संवाद फेऱ्यांचे सारांशीकरण + क्रमिक एजिंग
10
LLMLingua-2
MobileBERT ONNX द्वारे ML सिमॅंटिक प्रूनिंग — कोड-सुरक्षित, असिंक्रोनस
थेट Anthropic कनेक्शनवर मोजलेल्या Claude Fable 5 साठी प्रायोगिक कॉन्टेक्स्ट-अॅज-इमेज एन्कोडिंग; प्रदात्याकडून पावत्या मिळेपर्यंत GPT 5.6 ट्रान्सफॉर्मर्स फेल-क्लोज्ड राहतात. चार कॉम्प्रेशन प्रोफाइल्स (डीफॉल्ट आक्रमक, संतुलित, कोडिंग-सुरक्षित, पासथ्रू) (सर्वाधिक आक्रमक; निवडून सक्षम करावे लागते)
कोड ब्लॉक्स, URLs आणि संरचित डेटा बाइट-परफेक्ट स्वरूपात **नेहमी जतन केले जातात**. **वन-क्लिक प्रीसेट्स** इंजिनांना एकत्रित करतात:
मोड
बचत
यासाठी सर्वोत्तम
🪶 Lite
~15%
नेहमी सुरू ठेवता येणारा सुरक्षित डीफॉल्ट
🪨 Standard (Caveman)
~30%
दैनंदिन कोडिंग
⚡ Aggressive
~50%
टूल्सचा मोठ्या प्रमाणावर वापर करणारी दीर्घ सत्रे
🔥 Ultra
~75%
कमाल बचत
🧰 RTK
60–90%
शेल/चाचणी/बिल्ड/git आउटपुट
🔗 Stacked (RTK → Caveman)
78–95%
मिश्र प्रॉम्प्ट्स + टूल लॉग्स
**वास्तविक उदाहरण — Standard मोड:**
> **आधी (69 टोकन्स):** _"तुमचा React कॉम्पोनंट पुन्हा रेंडर होण्याचे संभाव्य कारण म्हणजे तुम्ही प्रत्येक रेंडर सायकलमध्ये नवीन ऑब्जेक्ट रेफरन्स तयार करत आहात. तुम्ही इनलाइन ऑब्जेक्ट prop म्हणून पास करता तेव्हा, React च्या शॅलो कम्पॅरिझनला तो प्रत्येक वेळी वेगळा ऑब्जेक्ट दिसतो, ज्यामुळे पुन्हा रेंडर होते. ऑब्जेक्ट मेमोइझ करण्यासाठी useMemo वापरण्याची मी शिफारस करेन."_
>
> **नंतर (19 टोकन्स):** _"प्रत्येक रेंडरमध्ये नवीन ऑब्जेक्ट रेफरन्स. इनलाइन ऑब्जेक्ट prop = नवीन रेफरन्स = पुन्हा रेंडर. 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` हेडर › राउटिंग-कॉम्बो ओव्हरराइड › सक्रिय नामांकित प्रोफाइल › अनुकूलनीय / स्वयं-ट्रिगर › पॅनेल डीफॉल्ट › बंद. लागू केलेली योजना प्रतिसादाच्या `X-OmniRoute-Compression: ; source=` हेडरमध्ये परत दिसते.
टोकन मर्यादेनुसार स्वयं-ट्रिगर करा, अनुकूलनीय डायल चालू करा, नामांकित प्रोफाइल निश्चित करा, प्रत्येक विनंतीसाठी एकदाच लागू होणारे सेटिंग ठेवा किंवा प्रत्येक राउटिंग कॉम्बोसाठी पाइपलाइन नियुक्त करा — कार्यभाराला जे योग्य असेल ते निवडा. बदल लागू करण्यापूर्वी, ऑप्ट-इन ऑफलाइन **मूल्यांकन साधन** (`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.51 ने नोंदवलेल्या पॅकेज संचासाठी:
>
> ```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` येथे डॅशबोर्ड · `http://localhost:20128/v1` येथे API.
**2) स्वतःचे खाते वापरून पात्र प्रदात्याशी कनेक्ट करा**
डॅशबोर्ड → **प्रदाते** → ज्याच्या सध्याच्या अटी आणि कोटा तुमच्या वापरासाठी योग्य आहेत असा प्रदाता निवडा → त्याची API की जोडा किंवा त्याची खाते प्रक्रिया पूर्ण करा. विनामूल्य स्तरांसाठी नोंदणी, मंजुरी किंवा पेमेंट पद्धत आवश्यक असू शकते. [विनामूल्य स्तर मार्गदर्शक](docs/getting-started/FREE-TIERS-GUIDE.md) पहा; कीशिवाय उपलब्धता हमीशीर नाही आणि `tos: avoid` म्हणून चिन्हांकित प्रदाते डीफॉल्टनुसार `auto` मधून वगळले जातात.
**3) तुमचे कोडिंग साधन निर्देशित करा**
```txt
मूळ URL: http://localhost:20128/v1
API की: [डॅशबोर्ड → एंडपॉइंट्समधून कॉपी करा]
मॉडेल: auto (पात्र कनेक्शन्समध्ये राउट करते — किंवा प्रदाता/मॉडेल निवडा)
```
**4) ते कार्यरत असल्याची पडताळणी करा**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
तुमच्या कनेक्ट केलेल्या मॉडेल्सची यादी दिसली पाहिजे. 🎉 इतकेच — कोडिंग सुरू करा; OmniRoute तुमच्यासाठी स्वयं-राउटिंग आणि फॉलबॅक हाताळते.
तुमचा क्लायंट सानुकूल हेडर्स पाठवू शकत नसल्यास, OmniRoute टोकनयुक्त सुसंगतता उपनावेही उपलब्ध करून देते:
```txt
OpenAI कॅटलॉग: http://localhost:20128/vscode/YOUR_KEY/
OpenAI मॉडेल्स: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI चॅट: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI प्रतिसाद: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama चॅट: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama टॅग्स: 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-मात्र पॅकेज नाही.
# ⭐ सर्वोच्च योगदानकर्ते
> OmniRoute ला एका उत्साही मुक्त-स्रोत समुदायाकडून आकार दिला जातो. या व्यक्तींनी प्रकल्पाची गुणवत्ता, स्थिरता आणि पोहोच यांवर थेट परिणाम करणारे अपवादात्मक योगदान दिले आहे. **धन्यवाद.**
### विलीन केलेल्या पुल रिक्वेस्ट्सनुसार बाह्य योगदानकर्ते
2026-08-24 05:26:03 UTC पर्यंतच्या विलीनीकरणांसह, सक्रिय release/v3.8.50 च्या अग्रस्थानी असलेल्या dafb4ae808 येथे ही माहिती स्थिर केली आहे. पृष्ठांकित GitHub GraphQL गणनेमध्ये 5,911 विलीन केलेले PRs आहेत: त्यांपैकी 2,707 रिपॉझिटरी मालकाचे, 179 Dependabot चे आणि 535 वेगवेगळ्या योगदानकर्त्यांकडून आलेले 3,025 बाह्य PRs आहेत. “बदललेल्या ओळी” म्हणजे GitHub वरील जोडलेल्या + हटवलेल्या ओळी असून त्यात व्युत्पन्न केलेल्या फाइल्स, लॉकफाइल्स, कॅटलॉग्स, भाषांतरे आणि दस्तऐवजीकरण यांचा समावेश आहे; हे बदलांचे प्रमाण आहे, लेखकाने लिहिलेल्या LOC चे मोजमाप नाही. सीमारेषेवरील समान क्रमांक कायम ठेवले आहेत.
### GitHub-द्वारे श्रेय दिलेले कमिट्स
Bob.Hou 🏅 GitHub-शी संबंधित 51 कमिट्स · संयुक्त क्रमांक #10
Xiangzhe 🏅 GitHub-शी संबंधित 51 कमिट्स · संयुक्त क्रमांक #10
2026-08-24 06:14:31 UTC रोजी पुन्हा तपासले: release/v3.8.50 डीफॉल्ट शाखेसाठी रिपॉझिटरीच्या Contributors API द्वारे नोंदवलेले GitHub-शी संबंधित कमिट्स. API ने 525 ओळखी परत केल्या (415 वापरकर्ते, 2 बॉट्स, 108 अनामिक); या तक्त्यात देखभालकर्ता, बॉट्स आणि अनामिक ओळखी वगळल्या आहेत आणि क्रमवारीतील बरोबरी कायम ठेवली आहे. हा तक्ता वरील विलीन केलेल्या PR क्रमवारीपेक्षा आणि खालील 639-व्यक्तींच्या Git-मेटाडेटा जनगणनेपेक्षा वेगळा आहे.
> 🙏 या योगदानकर्त्यांची वैशिष्ट्ये, दोष निराकरणे आणि पायाभूत सुविधांमधील सुधारणा हा OmniRoute विश्वसनीय आणि वैशिष्ट्यसमृद्ध बनवणारा **मूलभूत भाग** आहे. प्रत्येक pull request, प्रत्येक चाचणी प्रकरण आणि प्रत्येक i18n भाषांतर फाइल महत्त्वाची आहे. त्यांच्यासारख्या लोकांमुळे मुक्त स्रोत उभा राहतो.
---
## 💖 प्रायोजक
स्वतःच्या खिशातून OmniRoute ला आर्थिक सहाय्य करणाऱ्या सर्वांचे मनःपूर्वक आभार — प्रत्येक योगदानामुळे हा प्रकल्प विनामूल्य, स्वतंत्र आणि प्रगतिशील राहतो.
… आणि खासगी राहणे पसंत करणारे इतरही 💛सार्वजनिक GitHub Sponsors ची 2026-08-24 रोजी पुन्हा पडताळणी करण्यात आली. वरील सक्रिय लेबले GitHub च्या activeOnly स्थितीनुसार निर्धारित केली जातात; यापूर्वी जाहीर केलेल्या सार्वजनिक एकवेळच्या समर्थकांप्रती कृतज्ञता कायम आहे आणि खासगी प्रायोजकांची नावे गोपनीय ठेवली जातात.💖 प्रायोजक बना → — प्रत्येक डॉलरमुळे OmniRoute विनामूल्य आणि स्वतंत्र राहतो.
## 👥 600+ योगदानकर्ते
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-08-24 रोजी स्थिर केलेल्या मूळ ac02c5b42f वर परीक्षण केले आणि प्रत्यक्ष release/v3.8.50 च्या अंतिम टोकावरील dafb4ae808 वर पुन्हा तपासले: 639 सामान्यीकृत मानवी Git ओळखी — 407 या commit लेखक म्हणून दिसतात (देखभालकर्त्यासह) आणि 232 केवळ स्पष्ट Co-authored-by ट्रेलर्समध्ये दिसतात. ही गणना GitHub noreply हँडल्सचे सामान्यीकरण करते, 26 bot/agent/service/placeholder ओळखी वगळते आणि केवळ त्यांची प्रदर्शित नावे जुळतात म्हणून सामान्य ईमेल पत्ते एकत्रित करत नाही.
### योगदान कसे द्यावे
1. रेपॉझिटरी fork करा
2. **सक्रिय** `release/vX.Y.Z` tip वरून branch तयार करा (`main` वरून नाही) — [Branching & Release Model](docs/ops/BRANCHING_MODEL.md) पहा
3. तुमची feature branch तयार करा (`git checkout -b feat/amazing-feature`)
4. तुमचे बदल commit करा (`git commit -m 'feat: add amazing feature'`)
5. branch वर push करा (`git push origin feat/amazing-feature`)
6. **base = ती `release/vX.Y.Z` branch** ठेवून Pull Request उघडा
तपशीलवार मार्गदर्शक तत्त्वांसाठी [CONTRIBUTING.md](CONTRIBUTING.md) पहा.
### नवीन आवृत्ती प्रकाशित करणे
```bash
# release तयार करा — 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 च्या एका ठोस भागाला आकार दिला. त्या सर्वांसाठी ही आमची कृतज्ञता आहे. 🙏
> ⭐ तारांकनांची संख्या 24 ऑगस्ट 2026 रोजी GitHub च्या REST API द्वारे सत्यापित केली आहे — या प्रकल्पांना तारांकन द्या. ही संख्या त्या विशिष्ट तारखेची अचूक नोंद आहे आणि कालांतराने ती स्वाभाविकपणे बदलेल.
### 🧬 वंशपरंपरा आणि गेटवे
AI गेटवे, ज्याचा सार्वजनिक किंमत डेटासेट आमच्या खर्च-मागोवा समक्रमणाला डेटा पुरवतो आणि ज्याच्या प्रदाता-सामान्यीकरण मॉडेलने आमच्या रूटिंगची रचना घडवली.
ब्राउझर-सत्र, प्रतिसाद-फ्रेमिंग, वापर आणि वेब-शोध अॅडॅप्टर्ससह, विक्रेता-स्रोतामध्ये समाविष्ट केलेल्या ChatGPT Web → Codex Responses ब्रिजमध्ये रूपांतरित केलेला MIT स्रोत.
स्ट्रीम पुनर्प्राप्ती, विचार-विनाचे उपनाम, पर्यायी वेब शोध, स्लाइडिंग-विंडो मर्यादा, लॉगमधील संवेदनशील माहिती लपवणे आणि अधिक सुरक्षित लाँचर प्रवाहांमध्ये पोर्ट केलेले नमुने.
त्याची Grok मॉडेल मॅपिंग्ज, बनावट-TypeError Statsig जनरेटर, विनंती व डिव्हाइस डीफॉल्ट्स आणि NDJSON प्रतिसाद प्रोसेसर यांचे OmniRoute च्या Grok Web एक्झिक्युटरमध्ये लक्षणीय रूपांतर केले आहे.
त्याच्या प्रॉक्सी-पूल स्तरासाठी grok2api-merged ने श्रेय दिलेला अप्रत्यक्ष स्रोत; OmniRoute त्या वंशपरंपरेची सूचना जतन करतो, परंतु त्याच्या मर्यादित Grok Web एक्झिक्युटरमध्ये प्रॉक्सी-पूल पोर्ट केल्याचा दावा करत नाही.
मूळ Grok Web अंमलबजावणीने त्याच्या HTTP/ब्राउझर अपस्ट्रीम रचनेचा संदर्भ घेतला; त्याचा थेट HTTP मार्ग GrokProxy वरून व्युत्पन्न झाला असल्यामुळे स्वतंत्र कोड पोर्टचा दावा केलेला नाही.
व्हायरल "थोड्या टोकननी काम होत असेल तर अनेक टोकन का वापरायचे" प्रकल्प — त्याचे आदिमानव-शैलीतील तत्त्वज्ञान आमच्या मानक संक्षेपण मोडला आणि 30+ अनावश्यक शब्द काढण्याच्या/संघननाच्या नियमांना सामर्थ्य देते.
व्हायरल "आळशी वरिष्ठ विकसक" YAGNI-कोडर कौशल्य — याने आमची less-code आउटपुट शैली प्रेरित केली: सर्वांत छोटा कार्यरत बदल करण्याचे मार्गदर्शन, जे _निर्माण केलेला_ कोड कमी करते (Caveman च्या मोजक्या गद्याचा आउटपुट-अक्षावरील समकक्ष).
Rust स्तंभीय-JSON + आशय-पत्तित पुनर्प्राप्ती + संदेशांमधील पुनरावृत्ती काढणे — याने आमचे headroom/ccr/session-dedup इंजिन डिझाइन आणि कॅशे-स्थिर "संक्षिप्त स्वरूप स्थानापासून स्वतंत्र असते" हे अपरिवर्तनीय तत्त्व प्रमाणित केले.
कोडिंग-असिस्टंट ↔ LLM ट्रॅफिकचे MITM इंटरसेप्शन/विश्लेषण यामुळे Traffic Inspector च्या सुरुवातीच्या आवश्यकतांना दिशा मिळाली. यापूर्वी त्यावरून तयार केलेले चार मॉड्यूल — SSE विलीनीकरण, संभाषण सामान्यीकरण, गुपितांचे मास्किंग आणि हेडर सॅनिटायझेशन — सार्वजनिक प्रोटोकॉल मानकांवर आधारित स्वतंत्र क्लीन-रूम अंमलबजावणींनी बदलण्यात आले आहेत. दोन होस्ट-पासथ्रू पृष्ठभाग (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 प्रदाता तृतीय-पक्ष क्लायंट नाकारू शकतो. OpenCode Free आणि Kiro यांसह `tos: avoid` म्हणून चिन्हांकित केलेले प्रदाते डीफॉल्टनुसार स्वयंचलित रूटिंगमधून वगळले जातात; खाते कनेक्ट केल्याने ते सेटिंग अधिलिखित होत नाही. प्रदाता निवडण्यापूर्वी [मोफत स्तर मार्गदर्शक](docs/getting-started/FREE-TIERS-GUIDE.md) पाहा.
📦 **Python, Node.js, PHP आणि cURL** साठी कॉपी-पेस्ट करता येणाऱ्या क्विकस्टार्ट स्क्रिप्ट्स → [`examples/quickstart/`](examples/quickstart/)
> **कॉम्बो** म्हणजे मॉडेल्सची अशी साखळी, जिच्यामधून OmniRoute **स्वयंचलितपणे** राउट करते. कोटा संपल्यास, प्रदाता अयशस्वी झाल्यास किंवा खर्च अचानक वाढल्यास, कॉम्बो पुढील पात्र आणि सुस्थितीतील मॉडेलकडे जाऊ शकतो. 🛡️
### ⚡ शून्य-कॉन्फिगरेशन — फक्त `auto` वापरा
कोणताही कॉम्बो तयार करण्याची गरज नाही. तुमचे मॉडेल `auto` (किंवा त्याचा एखादा प्रकार) वर सेट करा आणि OmniRoute तुमच्या कनेक्ट केलेल्या प्रदात्यांमधून एक आभासी कॉम्बो तयार करते, ज्याचे थेट गुणांकन केले जाते:
📖 [ऑटो-कॉम्बो इंजिन](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%
```
कोड ब्लॉक्स, URLs, 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 इंजिनांचा स्टॅक
इंजिने पाइपलाइनच्या क्रमाने चालतात; प्रत्येक इंजिन स्वतंत्रपणे सुरू किंवा बंद करता येते आणि प्रत्येक कॉम्बोसाठी कॉन्फिगर करता येते:
