> **तुमची provider खाती स्वतः आणा.** हा स्वतंत्रपणे पात्र असलेल्या तृतीय-पक्षाच्या मोफत स्तरांचा अंदाजित एकत्रित हिशोब आहे; OmniRoute कडून मिळणारे token grant नाही. साइन अप करा, आवश्यक असल्यास credentials मिळवा आणि तुम्ही वापरू शकता अशा providers शी कनेक्ट करा; प्रत्येक provider स्वतःच्या मर्यादा, उपलब्धता आणि अटी नियंत्रित करतो.
>
> मोफत स्तर हाताने एकत्र करणे त्रासदायक आहे — डझनावधी SDKs, डझनावधी rate limits आणि प्रत्यक्षात तुमच्याकडे किती उपलब्ध आहे याची कल्पना नाही. OmniRoute **34 recurring pool keys मधील 465 free-tier entries** सूचीबद्ध करते आणि **सार्वजनिक केलेले सकारात्मक मासिक बजेट असलेल्या 17 pools तसेच प्रत्येक model साठीच्या पाच Groq caps** मधून token headline मोजते; shared pool नुसार duplicate entries काढल्या जातात. प्रादेशिक ओळख पडताळणीनंतरच उपलब्ध होणारे quotas (आज: ModelScope) स्वतंत्रपणे दाखवले जातात, प्रादेशिक ओळख पडताळणीनंतर +~6M, आणि headline मध्ये कधीही बेरीज केली जात नाही. हा परिणाम dashboard वर (`/dashboard/free-tiers`) दिसत राहतो.
> थेट `/dashboard/free-tiers` पेजचा animated सारांश. संपूर्ण कार्यपद्धती (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ही आकडेवारी दर दोन आठवड्यांनी live catalog शी पुन्हा तपासली जाते आणि **दोन्ही दिशांनी बदलते** — एखादा provider free tier बंद करतो तेव्हा संख्या कमी होते; नवीन provider उपलब्ध झाल्यावर ती वाढते. Catalog प्रत्यक्षात जे मोजते तेच आम्ही प्रकाशित करतो; rounded-up best case कधीही नाही.
⭐ OMNIROUTE मुळे पैसे वाचवण्यात आणि तुमचे काम सोपे करण्यात मदत झाली असल्यास repo ला Star द्या.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 समुदायात सामील व्हा
**👋 Maintainer ला Follow करा — नवीन providers, releases आणि tips सर्वप्रथम मिळवा:**
[](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)
**प्रश्न, provider tips, roadmap आणि support → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 गेटवे सतत वाढत आहे
## 🆓 स्थापित करा, प्रदात्याशी कनेक्ट करा, त्यानंतर एका एंडपॉइंटद्वारे रूट करा
```bash
# प्रदात्याशी कनेक्ट केल्यानंतर, Dashboard → Endpoints मधून आपली OmniRoute की कॉपी करा:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` साठी पात्र रूट आवश्यक आहे. नवीन स्थापनेमध्ये कोणतेही पात्र keyless लक्ष्य नसू शकते आणि keyless प्रदाता तृतीय-पक्ष क्लायंट नाकारू शकतो. `tos: avoid` असे चिन्हांकित केलेले प्रदाते, ज्यामध्ये Kiro समाविष्ट आहे, डीफॉल्टनुसार स्वयंचलित रूटिंगमधून वगळले जातात; खाते कनेक्ट केल्याने ही सेटिंग ओव्हरराइड होत नाही. प्रदाता निवडण्यापूर्वी [विनामूल्य टियर मार्गदर्शक](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.54** मधील अलीकडील ठळक वैशिष्ट्ये. संपूर्ण इतिहास [`CHANGELOG.md`](CHANGELOG.md) मध्ये.
- **⚖️ `quota-weighted` रूटिंग** — 20 वी combo रणनीती संपलेली खाती वगळते, त्यानंतर उर्वरित खात्यांमधून शिल्लक quota ÷ in-flight load या प्रमाणात निवड करते आणि विद्यमान संभाषणे त्याच खात्याशी जोडलेली ठेवते. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless मोड** — `omniroute serve --headless` (किंवा `OMNIROUTE_HEADLESS=1`) केवळ `/v1/*` proxy engine चालवतो; dashboard आणि dashboard-पुरती उपप्रणाली बंद राहतात. → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 मॉडेल शोध** — `/v1/models` capability, context, kind आणि text नुसार फिल्टर करते, तर `POST /v1/models/query` त्याच per-key visibility सह छोटी deterministic shortlist परत करते. → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 Per-key रूटिंग नियंत्रण** — `forcedModel` वापरून API key एका मॉडेल किंवा combo शी pin करा आणि key चे models व combos अणुकेंद्रीयरित्या जोडा किंवा काढा (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ अधिक सूक्ष्म PII नियंत्रणे** — प्रत्येक प्रकारासाठी स्वतंत्र निवड, 20 पर्यंत validated custom masking patterns आणि प्रत्येक प्रकारासाठी detection counters; masking स्वतः opt-inच राहते. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 भाषा** — dashboard, docs mirrors आणि CLI साठी; `npm run i18n:add-locale` एका command मध्ये सर्वत्र भाषा जोडते. → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — तुमच्या agent fleet कडे inbound A2A delegation, Agent Card वरील Conductor skills आणि Faro push-to-talk voice chat असलेले dashboard panel. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptive admission आणि overload protection** — heavyweight chat requests 503 देण्याऐवजी queue मध्ये जातात आणि प्रत्येक connection साठी atomic RPM rolling leases वापरले जातात. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Canonical `/v1/models` क्रमवारी** — प्रत्येक provider साठी एक सलग provider-grouped block (combos प्रथम pin केलेले), प्रत्येक catalog source मध्ये स्थिर. → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Compression hardening** — default-on inflation guard, DE / FR / JA + चिनी (wényán) साठी Caveman packs आणि Gradle व .NET साठी RTK filters. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 प्रामाणिक flat-rate खर्च** — subscription / coding-plan providers च्या cost analytics मध्ये **$0** दिसते; budget, quota आणि routing मात्र अंदाज कायम ठेवतात. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share रूटिंग** — shared account ची quota pooled keys मध्ये न्याय्यरीत्या विभागते आणि idle slices उधार देऊन संसाधनांचा कार्यक्षम वापर करते. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एका command मध्ये CLI/agent सेटअप** — 15 नोंदणीकृत `setup-*` commands; `omniroute run` 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) सुरू करते; `omniroute configure` interactive provider+model picker आणि प्रत्येक context साठी favorites सह 11 targets समर्थित करते. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Remote मोड** — scoped tokens (`connect` / `contexts` / `tokens`) वापरून remote OmniRoute नियंत्रित करा आणि VPS installs साठी `antigravity` OAuth helper वापरा. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 अधिक बुद्धिमान auto-routing** — `auto/:` combos, **Fusion** (model panel + judge), task-aware routing आणि प्रत्येक request साठी model / mode / USD-budget overrides. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Pluggable compression** — 12 composable engines आणि Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, per-step fidelity gate, GCF v3.2 आणि drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparent MITM decrypt (TPROXY)** — proxy env vars दुर्लक्षित करणाऱ्या CLIs चे capture, तसेच per-SNI CA + trust-store installer. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 सर्वत्र cost telemetry** — प्रत्येक endpoint वर `X-OmniRoute-*` cost/usage headers, cache-HIT savings header आणि per-key USD spend quotas. → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 तुमच्या नियंत्रणातील Memory** — default ने बंद, opt-in int8 vector quantization + typed decay आणि प्रत्येक request साठी `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Security** — प्रत्येक LLM route वर prompt-injection guard (red-team suite), opt-in credential-masking guardrail (दोन्ही दिशांमध्ये लीक झालेले API keys/secrets redacts करते), शेवटचा पर्याय म्हणून मोफत DuckDuckGo web search आणि dashboard साठी वैकल्पिक OIDC login gate (password login नेहमी उपलब्ध राहते). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ नवीन endpoints** — `/v1/ocr` (Mistral OCR) आणि `/v1/audio/translations` (Whisper-style) मुळे media surface अधिक पूर्ण होते. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Image / video / audio generation** — media साठी एक API: xAI Grok Imagine आणि Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind आणि ElevenLabs सारखे speech providers. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Deployment आणि ops** — reverse-proxy `basePath`, browser-language auto-detect, per-key device tracking, root-less MITM trust आणि zh-TW localization. → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 अधिक providers आणि agents** — cloud agents (Codex Cloud, Cursor, Devin, Jules), browser + OAuth login सह Grok Build (xAI), प्रथम-श्रेणीचे Ollama card, Claude Opus 5 आणि Sonnet 5, Kimi ची अधिकृत भागीदारी (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… आणि नव्याने अद्ययावत **388-provider catalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Routing transparency** — प्रत्येक response मध्ये सेवा देणारी strategy/provider/latency दर्शवणारा `X-OmniRoute-Decision` header असतो; नवीन `cache-optimized` combo strategy आणि Auto-Combo `cacheAffinity` factor repeat requests त्या cached prefix असलेल्या connection कडे परत पाठवतात; तसेच read-only `/v1/auto-combo/{channel}/candidates` endpoint `auto/*` channel चा live candidate pool उघड करते. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ स्थानिक कामगिरी आणि पायाभूत सुविधा** — एका क्लिकवर स्थानिक Redis, Cloudflare Workers / Deno Deploy रिले डिप्लॉयर, तसेच पर्यवेक्षित एम्बेडेड सेवा म्हणून Bifrost आणि Mux. → [एम्बेडेड सेवा](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 यामध्ये आणखी समाविष्ट** — प्लगइन फ्रेमवर्क + मार्केटप्लेस, Omni/Agent/GitHub स्किल्स फ्रेमवर्क, Obsidian व्हॉल्ट एकत्रीकरण (22 MCP टूल्स), OpenAI-सुसंगत Batch आणि Files API, सिमॅंटिक प्रतिसाद कॅशे, लीडरबोर्डसह गेमिफिकेशन, ACP एजंट शोध (15 अंगभूत एजंट), BigQuery मध्ये नियोजित लॉग निर्यात, `auto/chaos` समांतर मल्टी-मॉडेल फॅन-आउट, Telegram बॉट ब्रिज, अॅपमधील आवृत्ती व्यवस्थापक आणि LMArena-ELO मोफत-प्रदाता क्रमवारी. → [दस्तऐवज](docs/README.md)
## 🤖 सुसंगत CLI आणि कोडिंग एजंट्स
> एकच कॉन्फिग — `http://localhost:20128/v1` — आणि **प्रत्येक** AI IDE किंवा CLI मोफत आणि कमी किमतीच्या मॉडेल्सवर चालते.
**OmniRoute द्वारे कोणतेही समर्थित CLI एका आदेशात सुरू करा** — कोणतीही कॉन्फिग फाइल्स लिहिल्या जात नाहीत,
प्रत्येक प्रक्रियेसाठी क्रेडेन्शियल्स इंजेक्ट केल्या जातात, Qwen/Gemini साठी वेगळे, तात्पुरते home तयार होते:
```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` तुमचे गुपित shell इतिहासाबाहेर ठेवतो. → [CLI एकत्रीकरणे](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI प्रदाते — कॅटलॉगमध्ये नोंदवलेले 153 मोफत
> **388 नोंदणीकृत प्रदाते** canonical chat, media, search, local, cloud-agent आणि system संग्रहांमध्ये उपलब्ध आहेत; यांपैकी **153 प्रदात्यांकडे `hasFree: true` शोध मेटाडेटा आहे**. chat model registry मध्ये **239 प्रदाते / 3,059 स्वतंत्र provider-model जोड्या / 1,475 कच्चे model IDs** समाविष्ट आहेत; स्वतंत्र free-budget catalog मध्ये **471 प्रति-मॉडेल नोंदी**, **34 आवर्ती पूल** आणि **52 आवर्ती/keyless कायमस्वरूपी मोफत प्रदाते** आहेत. हे वेगवेगळे denominators जाणीवपूर्वक ठेवले आहेत; व्याख्या आणि pool-deduped गणना [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) आणि [Free Tiers](docs/reference/FREE_TIERS.md) मध्ये उपलब्ध आहेत.
### 🏢 प्रत्येक प्रमुख लॅब — एका endpoint द्वारे
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…आणखी 350+ — प्रत्येक आयकॉन dashboard च्या provider catalog मधून थेट उपलब्ध होतो. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 कायमस्वरूपी मोफत — $0, कार्डची गरज नाही
OpenCode Zen DeepSeek V4, Nemotron 3 टोकन मर्यादा नाही
Kilo Code ऑटो-राउटर, Tencent Hy3 कायमस्वरूपी मोफत
Requesty GPT-OSS 120B, Nemotron कायमस्वरूपी मोफत
SiliconFlow DeepSeek V3.2 / R1 मोफत स्तर
Z.AI GLM GLM-4.7 / 4.5-Flash कायमस्वरूपी मोफत
Baidu ERNIE ERNIE 4.0 कायमस्वरूपी मोफत
Qoder AI Qwen3-Max, Kimi-K2 अमर्यादित मोफत
Pollinations GPT, Llama, Claude की आवश्यक नाही
Cloudflare AI 50+ मॉडेल्स दररोज 10K न्यूरॉन्स
NVIDIA NIM GLM, MiniMax ~40 RPM मोफत
Cerebras GLM 4.7, GPT-OSS एकदाच मिळणारे $5 क्रेडिट; कार्ड आवश्यक
OpenRouter :free मॉडेल्स +$10 → अधिक RPM
📖 संपूर्ण मशीन-वाचनीय कॅटलॉग → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ जिथे OmniRoute चालते — कुठेही
> तेच ॲप, तुमचे मशीन, तुमचे नियम. जागतिक एनपीएम पासून ते स्थापित करा** तुमचा फोन** टर्मक्स मार्गे.
प्लॅटफॉर्म
स्थापित करा
हायलाइट्स
📦 npm (जागतिक)
npm -g omniroute
स्थापित करा, कोणतीही OS
⚡ Bun (जागतिक)
बन जोडा -g ओम्निरूट
समान रेजिस्ट्री टारबॉल, जलद स्थापित
🐳 Docker
डॉकर रन … diegosouzapw/omniroute
मल्टी-आर्क AMD64 + ARM64
🖥️ डेस्कटॉप
Electron)
एनपीएम रन इलेक्ट्रॉन: बिल्ड
नेटिव्ह विंडो + सिस्टम ट्रे — Windows / macOS / Linux
🎩 मेनू-बार (OmniRouteTray)
ब्रू स्थापित करा --cask zoispag/tap/omniroute-tray
पर्यवेक्षण करते & सर्व्हरचे स्वयं
अपडेट
— macOS
💪 ARM
नेटिव्ह arm64
रास्पबेरी Pi, ARM सर्व्हर, Apple Silicon
📱 Android (Termux)
pkg नोडज स्थापित करा && npx -y omniroute
तुमच्या फोनवर चालवा, 24/7
📲 PWA
"होम स्क्रीनवर जोडा"
फुलस्क्रीन, ऑफलाइन, ब्राउझर
वरून स्थापित करण्यायोग्य
🧩 OpenCode प्लगइन
@omniroute/opencode-provider
मूळ OpenCode एकत्रीकरण
🤖 VS कोड Copilot चॅट
स्थापित करा OmniCopilot विस्तार
मूळ Copilot चॅट पिकरमधील प्रत्येक OmniRoute मॉडेल — स्थिर &
### 🧩 नवीन: VS कोडच्या मूळ Copilot चॅटमध्ये OmniRoute
> कोणताही नवीन साइडबार नाही, नवीन चॅट UI नाही — प्रत्येक मॉडेल OmniRoute सर्व्ह करते ते थेट मध्ये दाखवले जाते** तुम्ही आधीच वापरत असलेलेCopilot चॅट मॉडेल पिकर** . VS कोड 1.122 पासून, प्रदाता मॉडेल GitHub साइन-इन किंवा Copilot सबस्क्रिप्शनशिवाय कार्य करतात — एजंट मोड, टूल कॉलिंग आणि व्हिजन, विनामूल्य.
स्थापित करा** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** विस्तार, तो तुमच्या OmniRoute सर्व्हरवर दर्शवा ( `localhost:20128` वर डीफॉल्ट), नंतर Copilot Chat → मॉडेल पिकर → उघडा** मॉडेल व्यवस्थापित करा...** →**OmniRoute** .
संपादकाच्या आतून: उघडा** विस्तार** पहा, शोधा** "OmniRoute"** , क्लिक करा** स्थापित करा** - दोन्ही स्टोअरवर समान प्रकारे कार्य करते. स्रोत, समस्या आणि प्रकाशन रनबुक [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) वर लाइव्ह आहे.
📖 [VS कोड Copilot चॅट मार्गदर्शक](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/) (एक राउंडिंग एररच्या आकाराचा एक रस्ट कोर) सह तयार केलेले, ते स्वतःचे स्वाक्षरी केलेले नोड 24 रनटाइम पाठवते आणि ॲप-मालकीचे OmniRoute इंस्टॉल व्यवस्थापित करते, त्यामुळे ते कधीही तुमच्या जागतिक `node`/`bun` शी लढत नाही. ते** तुमचे विद्यमान `~/.omniroute/` कॉन्फिगरेशन आणि डेटाबेस शेअर करते** — म्हणून तुम्ही आधीपासून चालवलेला तोच OmniRoute आहे, फक्त टोपी घालून. 🎩
काय करते
कसे
🟢 सर्व्हरचे पर्यवेक्षण करते
Spawns omniroute serve ,
ची डुप्लिकेट करण्याऐवजी आधीच चालू असलेल्या उदाहरणाचा अवलंब करते
स्टेज्ड इंस्टॉल, अणू स्वॅप, अयशस्वी झाल्यावर रोलबॅक — नेहमी नवीनतम रिलीज
वर
🚀 लॉगिनवर प्रारंभ करा
लॉगिनवर पर्यायी लाँच; केवळ ट्रे, डॉक चिन्ह
नाही
🩺 डॉक्टर & लॉग
एक-क्लिक निदान आणि सर्व्हर लॉग ऍक्सेस
```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%
```
कोड ब्लॉक्स, 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
मोठे ब्लॉक्स पुनर्प्राप्ती मार्कर्समागे संग्रहित करते आणि मागणीनुसार आणते
थेट Anthropic वायरवर मोजलेल्या Claude Fable 5 साठी प्रायोगिक कॉन्टेक्स्ट-अॅज-इमेज एन्कोडिंग; प्रदात्याच्या पावत्या मिळेपर्यंत GPT 5.6 ट्रान्सफॉर्मर्स फेल-क्लोज्ड राहतात. चार कॉम्प्रेशन प्रोफाइल (डीफॉल्ट आक्रमक, संतुलित, कोडिंग-सुरक्षित, पासथ्रू) (सर्वाधिक आक्रमक; स्वेच्छेने सक्षम करावे)
कोड ब्लॉक्स, URLs आणि संरचित डेटा **नेहमी बाइट-परिपूर्ण जतन** केला जातो. **वन-क्लिक प्रीसेट्स** इंजिन्स एकत्र करतात:
मोड
बचत
यासाठी सर्वोत्तम
🪶 Lite
~15%
नेहमी-सक्रिय सुरक्षित डीफॉल्ट
🪨 मानक (Caveman)
~30%
दैनंदिन कोडिंग
⚡ Aggressive
~50%
दीर्घ टूल-केंद्रित सत्रे
🔥 Ultra
~75%
कमाल बचत
🧰 RTK
60–90%
Shell/test/build/git आउटपुट
🔗 स्टॅक केलेले (RTK → Caveman)
78–95%
मिश्र प्रॉम्प्ट्स + टूल लॉग्स
**प्रत्यक्ष उदाहरण — मानक मोड:**
> **पूर्वी (69 टोकन):** _"तुमचा React घटक पुन्हा-रेंडर होण्याचे कारण बहुधा प्रत्येक रेंडर सायकलमध्ये तुम्ही नवीन ऑब्जेक्ट रेफरन्स तयार करत आहात. जेव्हा तुम्ही इनलाइन ऑब्जेक्ट प्रॉप म्हणून पास करता, तेव्हा React ची शॅलो तुलना त्याला प्रत्येक वेळी वेगळा ऑब्जेक्ट मानते, ज्यामुळे पुन्हा-रेंडर सुरू होतो. ऑब्जेक्टला मेमोआइज करण्यासाठी useMemo वापरण्याची मी शिफारस करतो."_
>
> **नंतर (19 टोकन):** _"प्रत्येक रेंडरला नवीन ऑब्जेक्ट रेफ. इनलाइन ऑब्जेक्ट प्रॉप = नवीन रेफ. = पुन्हा-रेंडर. useMemo मध्ये रॅप करा."_
>
> **तेच उत्तर. 72% कमी टोकन. अचूकतेत शून्य नुकसान.** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) मोड:**
> **आधी (42 tokens):** _"समस्या अशी आहे की प्रत्येक रेंडरिंग चक्रात ऑब्जेक्टचा नवीन संदर्भ तयार होत असल्यामुळे घटक पुन्हा रेंडर होत आहे. `useMemo` वापरण्याची मी शिफारस करेन."_
>
> **नंतर (12 tokens):** _"पुन्हा-रेंडर: प्रत्येक चक्रात नवीन संदर्भ (इनलाइन ऑब्जेक्ट पुन्हा तयार). `useMemo` वापरा."_
>
> **तेच उत्तर. ~70% कमी tokens. तांत्रिक अचूकता अबाधित.** ✅
### 🎚️ इंजिन्सच्या पलीकडे — आउटपुट शैली, अनुकूलनशील डायल आणि प्रत्येक विनंतीचे नियंत्रण
वरील 12 इंजिन्स **आत** जाणारी सामग्री संक्षिप्त करतात. आणखी तीन स्तर **कसे**, **कधी**, आणि काय बाहेर येते हे ठरवतात:
- **🪄 आउटपुट शैली** _(आउटपुट-अक्षाचे नियंत्रण)_ — निर्धारक, कॅश-सुरक्षित प्रतिसाद-रचना सूचना समाविष्ट करतात; एकत्र वापरता येतात आणि प्रत्येकाची `lite` / `full` / `ultra` तीव्रता उपलब्ध आहे. शैली जोडणे म्हणजे रजिस्ट्रीमध्ये एका ओळीची नोंद करणे:
- **त्रोटक गद्य** — अनावश्यक भर / लेख / संदिग्धता काढा; तांत्रिक आशय अचूक ठेवा.
- **कमी कोड** — "आळशी वरिष्ठ डेव्हलपर" YAGNI: सर्वांत छोटा कार्यरत बदल, न मागितलेली अतिरिक्त संरचना नाही.
- **पोनीटेल (आळशी वरिष्ठ डेव्हलपर)** — YAGNI शिडीवर चढा, मूळ कारण दुरुस्त करा, सर्वांत छोटा कार्यरत बदल करा.
- **मला ADHD आहे (कृती-प्रथम)** — पुढील कृती आधी, क्रमांकित पायऱ्या, एक ठोस पुढील पाऊल, प्रस्तावना नाही.
- **त्रोटक CJK (文言)** — शास्त्रीय-चिनी अतित्रोटक शैली (`zh` साठी लोकेल-आधारित).
- **🎯 अनुकूलनशील संदर्भ-बजेट** _(डायल)_ — एकच ऑन/ऑफ टोकन मर्यादा ठेवण्याऐवजी, मॉडेलच्या संदर्भ विंडोमध्ये बसण्यासाठी आवश्यक तेवढ्याच प्रमाणात सर्वांत स्वस्त आणि कमीतकमी माहिती गमावणारी इंजिन्स वाढवत नेतो. धोरण: `reserve-output` (डीफॉल्ट, मॉडेल-जागरूक) · `percentage` · `absolute`. मोड: `floor` (बसण्याची हमी) · `replace-autotrigger` (तुमची स्पष्ट निवड प्राधान्याने लागू) · `off` (वारसा मर्यादा).
- **🎛️ कॉम्प्रेशन कुठे ठरते** _(प्राधान्यक्रम, उच्च → निम्न)_ — प्रत्येक विनंतीचा `x-omniroute-compression` हेडर › रूटिंग-कॉम्बो ओव्हरराइड › सक्रिय नामांकित प्रोफाइल › अनुकूलनशील / ऑटो-ट्रिगर › पॅनेल डीफॉल्ट › off. लागू केलेली योजना `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.54 ने नोंदवलेल्या पॅकेज संचासाठी:
>
> ```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 key जोडा किंवा खाते-प्रक्रिया पूर्ण करा. मोफत स्तरांसाठी साइनअप, मंजुरी किंवा पेमेंट पद्धत आवश्यक असू शकते. [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) पहा; keyless उपलब्धतेची हमी नाही आणि `tos: avoid` म्हणून चिन्हांकित केलेले प्रदाते डीफॉल्टनुसार `auto` मधून वगळले जातात.
**3) तुमचे कोडिंग टूल निर्देशित करा**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) ते कार्यरत असल्याची पडताळणी करा**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
तुमचे कनेक्ट केलेले मॉडेल्स सूचीबद्ध दिसायला हवे. 🎉 एवढेच — कोडिंग सुरू करा; OmniRoute तुमच्यासाठी ऑटो-रूटिंग आणि फॉलबॅक करेल.
तुमचा क्लायंट कस्टम हेडर्स पाठवू शकत नसल्यास, OmniRoute टोकनयुक्त सुसंगतता उपनावे देखील उपलब्ध करून देते:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
ही फक्त `Authorization: Bearer ...` जोडू न शकणाऱ्या क्लायंट्ससाठी वापरा. हेडर प्रमाणीकरण ही अजूनही पसंतीची पद्धत आहे.
## 📦 इंस्टॉल करण्याच्या आणखी पद्धती — Docker, सोर्स, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` हे सर्वाधिक आवृत्तीच्या **प्रकाशित** स्थिर SemVer चे अनुसरण करते. ते git `main` चे अनुसरण करत नाही. GitOps साठी `:X.Y.Z` निश्चित करा. [Docker प्रकाशन चॅनेल](docs/guides/DOCKER_GUIDE.md#release-channels) पहा. या इमेजमध्ये **`OMNIROUTE_MEMORY_MB=1024`** निश्चित केलेले आहे. डॅशबोर्ड आणि हलक्या चॅटसाठी ते पुरेसे आहे. **कोडिंग एजंट्सना** (Claude Code, Codex, Grok, … कडून `POST /v1/responses`) यापेक्षा खूप मोठ्या V8 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-मात्र पॅकेज नाही.
8,400+ ट्रॅक केलेल्या चाचणी फाइल्समधील 60,000+ स्थिर चाचणी घोषणांसाठी चाचणी कव्हरेज धोरण
# ⭐ शीर्ष योगदानकर्ते
> OmniRoute ला उत्साही मुक्त-स्रोत समुदायाने आकार दिला आहे. या व्यक्तींनी प्रकल्पाची गुणवत्ता, स्थैर्य आणि पोहोच यांवर थेट परिणाम करणारे असाधारण योगदान दिले आहे. **धन्यवाद.**
### विलीन केलेल्या पुल विनंत्यांनुसार बाह्य योगदानकर्ते
2026-11-03 03:01:19 UTC रोजी थेट release/v3.8.53 टिप 05bc048d6c सह जनगणना घेण्यात आली. पृष्ठांकित GitHub GraphQL जनगणनेमध्ये 9,947 विलीन केलेले PRs आहेत: रिपॉझिटरी मालकाने केलेले 4,130, Dependabot ने केलेले 240, इतर bots/apps ने केलेले 6 आणि 883 स्वतंत्र योगदानकर्त्यांकडून आलेले 5,571 बाह्य PRs. “बदललेल्या ओळी” म्हणजे GitHub वरील additions + deletions असून त्यात व्युत्पन्न फाइल्स, lockfiles, catalogs, भाषांतरे आणि दस्तऐवजीकरण समाविष्ट आहे; हे churn आहे, authored LOC नाही. 53 PRs मध्ये GitHub diffs 500,000 ओळींपेक्षा अधिक असल्याचे दिसते (उदाहरणार्थ #13399 मध्ये, एका provider addition मध्ये, 2,347 बदललेल्या फाइल्स सूचीबद्ध आहेत), ज्यामुळे वरील काही एकूण संख्या वाढतात. समान क्रमांक एकत्रितपणे दिले आहेत.
### GitHub-संबंधित commits
2026-11-03 02:09:16 UTC रोजी पुन्हा तपासले: release/v3.8.53 डिफॉल्ट ब्रँचसाठी रिपॉझिटरीच्या Contributors API ने नोंदवलेले GitHub-श्रेयित कमिट्स. API ने 903 ओळखी परत केल्या (429 वापरकर्ते, 2 बॉट्स, 472 अनामिक); या तक्त्यात मेंटेनर, बॉट्स आणि अनामिक ओळखी वगळल्या आहेत आणि समान क्रमांकावरील स्पर्धक कायम ठेवले आहेत. हे वरील मर्ज केलेल्या PR क्रमवारीपेक्षा आणि खालील Git-मेटाडेटा जनगणनेपेक्षाही वेगळे आहे.
> 🙏 या योगदानकर्त्यांची वैशिष्ट्ये, दोषनिराकरणे आणि पायाभूत सुविधांमधील सुधारणा, OmniRoute ला विश्वासार्ह आणि समृद्ध वैशिष्ट्यांनी युक्त बनवणाऱ्या गोष्टींचा **मूलभूत भाग** आहेत. प्रत्येक पुल रिक्वेस्ट, प्रत्येक चाचणी प्रकरण आणि प्रत्येक i18n भाषांतर फाइल महत्त्वाची आहे. ओपन सोर्स त्यांच्यासारख्या लोकांनी घडवले जाते.
---
## 💖 प्रायोजक
स्वतःच्या खिशातून OmniRoute ला निधी देणाऱ्या सर्वांचे मनःपूर्वक आभार — प्रत्येक योगदानामुळे हा प्रकल्प विनामूल्य, स्वतंत्र आणि कार्यरत राहतो.
… आणि गोपनीय राहणे पसंत करणारे इतर समर्थक 💛सार्वजनिक GitHub Sponsors ची 2026-10-18 रोजी GitHub Sponsors GraphQL API द्वारे पुन्हा पडताळणी करण्यात आली: एकूण 14 पैकी 11 सार्वजनिक प्रायोजकत्वे (6 सक्रिय, 5 पूर्वीची). वरील सक्रिय लेबले GitHub च्या isActive स्थितीनुसार निर्धारित केली जातात; पूर्वीच्या सार्वजनिक एकदाच समर्थकांप्रती कृतज्ञता कायम आहे आणि खासगी प्रायोजक निनावी राहतात. Ko-fi, Buy Me a Coffee, Liberapay, PIX आणि क्रिप्टो देणग्या सूचीबद्ध केलेल्या नाहीत, कारण त्यांची कोणतीही सार्वजनिक प्रायोजक नोंद नाही.💖 प्रायोजक व्हा → — प्रत्येक डॉलरमुळे OmniRoute विनामूल्य आणि स्वतंत्र राहतो.
## 👥 1,000+ योगदानकर्ते
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-11-02 रोजी live release/v3.8.53 tip 1c7135e0fb (7,972 commits) वर ऑडिट केले: 1,074 सामान्यीकृत मानवी Git ओळखी — 759 commit authors म्हणून दिसतात (maintainer सहित) आणि 315 फक्त स्पष्ट Co-authored-by trailers मध्ये आहेत. या गणनेत .mailmap लागू केले जाते, ई-मेल पत्त्यांची तुलना case-insensitive पद्धतीने केली जाते, numeric आणि साधे GitHub noreply पत्ते केवळ ते समान handle दर्शवत असतील तेव्हाच एकत्र केले जातात, 29 bot/agent/service/placeholder ओळखी वगळल्या जातात आणि केवळ display names जुळतात म्हणून सामान्य ई-मेल पत्ते एकत्र केले जात नाहीत. 2026-08-24 च्या ऑडिटमध्ये 639 प्रकाशित केले होते; त्या ऑडिटच्या base ac02c5b42f वर ही पद्धत पुन्हा चालवल्यावर 619 मिळतात, त्यामुळे ही वाढ नवीन योगदानकर्त्यांमुळे आहे, अधिक सैल पद्धतीमुळे नाही.
### योगदान कसे द्यावे
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
# रिलीज तयार करा — npm publish आपोआप होते
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 तारांकने
## 🌍 StarMapper
## 🙏 आभार
OmniRoute हे अनेक दिग्गजांच्या कार्यावर उभे आहे. याची सुरुवात **[9router](https://github.com/decolua/9router)** च्या fork म्हणून आणि Go प्रकल्प **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** च्या TypeScript port म्हणून झाली — आणि त्यानंतर खालील प्रत्येक उपप्रणालीची प्रेरणा याआधीच मार्ग दाखवणाऱ्या एका मुक्त-स्रोत प्रकल्पातून मिळाली. प्रत्येक प्रकल्पाने OmniRoute च्या एका ठोस भागाला आकार दिला. हा त्या सर्वांसाठी आमचा धन्यवाद आहे. 🙏
> ⭐ GitHub च्या REST API द्वारे 3 नोव्हेंबर 2026 रोजी स्टार संख्या पडताळल्या आहेत — या प्रकल्पांना स्टार द्या. या संख्या त्या दिनांकाची अचूक snapshot आहेत आणि स्वाभाविकपणे बदलतील.
### 🧬 वंशपरंपरा आणि gateway
ज्या AI gateway च्या सार्वजनिक pricing dataset मधून आमच्या cost-tracking sync ला डेटा मिळतो आणि ज्याच्या provider-normalization model ने आमच्या routing ला दिशा दिली.
MIT source चे रूपांतर करून vendored ChatGPT Web → Codex Responses bridge मध्ये वापरले आहे; यात browser-session, response-framing, usage आणि web-search adapters समाविष्ट आहेत.
Stream recovery, no-thinking aliases, fallback web search, sliding-window limits, log redaction आणि hardened launcher flows मध्ये यातील patterns port केले आहेत.
यातील Grok model mappings, fake-TypeError Statsig generator, request आणि device defaults, तसेच NDJSON response processor यांचे OmniRoute च्या Grok Web executor मध्ये महत्त्वपूर्ण रूपांतर केले आहे.
grok2api-merged मागील प्रमुख transitive code source; यातील model, header, payload, Statsig आणि processor implementations Grok Web lineage मध्ये जतन केल्या आहेत.
Grok payload आणि device defaults, Statsig generator आणि result.response processor यांचा मूळ MIT source; हे घटक TQZHR आणि grok2api-merged मार्फत पुढे आले आहेत.
grok2api-merged ने proxy-pool layer साठी ज्या transitive source ला श्रेय दिले आहे; OmniRoute ही lineage notice जतन करते, परंतु तिच्या bounded Grok Web executor मध्ये proxy-pool port केल्याचा दावा करत नाही.
याच्या HTTP/browser upstream design चा मूळ Grok Web implementation सल्ल्यासाठी वापरला; यातील direct HTTP path GrokProxy मधून आलेला असल्याने स्वतंत्र code port केल्याचा दावा केलेला नाही.
व्हायरल "why use many token when few token do trick" प्रकल्प — त्याचे caveman-speak तत्त्वज्ञान आमच्या मानक compression mode आणि 30+ filler/condensation नियमांना सामर्थ्य देते.
उच्च-कार्यक्षमता command-output compression — याने आमच्या RTK engine, JSON filter DSL, raw-output recovery आणि एकत्रित RTK → Caveman pipeline ला प्रेरणा दिली.
PT-BR token compression — आमच्या pt-BR language pack ला सामर्थ्य देते: Brazilian-Portuguese व्याकरणासाठी अनुरूप केलेली pleonasm reduction आणि filler removal.
व्हायरल "lazy senior dev" YAGNI-coder skill — याने आमच्या less-code Output Style ला प्रेरणा दिली: Caveman च्या terse prose च्या output-axis sibling प्रमाणे, _व्युत्पन्न_ code कमी करणारे smallest-working-change steering.
Rust columnar-JSON + content-addressed retrieve + cross-message dedup — याने आमच्या headroom/ccr/session-dedup engine design आणि cache-stable "compressed form is position-independent" invariant ची पुष्टी केली.
कोडिंग-असिस्टंट ↔ LLM ट्रॅफिकच्या MITM इंटरसेप्शन/विश्लेषणामुळे सुरुवातीच्या Traffic Inspector आवश्यकतांना दिशा मिळाली. यापूर्वी तयार केलेली चार मॉड्यूल्स — SSE मर्जिंग, संभाषण सामान्यीकरण, गुपिते मास्क करणे आणि हेडर स्वच्छता — सार्वजनिक प्रोटोकॉल मानकांवर आधारित स्वतंत्र क्लीन-रूम अंमलबजावणींनी बदलली आहेत. दोन होस्ट-पासथ्रू पृष्ठभाग (passthrough.ts आणि _internal/bypass.cjs) OmniRoute-अंतर्गत स्वतंत्रपणे वर्गीकृत केलेल्या अंमलबजावणी म्हणून कायम आहेत; त्या बदलाचा भाग म्हणून त्यांचे पुनर्लेखन केलेले नाही.
प्रति-प्रक्रिया पारदर्शक प्रॉक्सी रूटिंग — याने आमच्या क्रॅश-सुरक्षित MITM टिअरडाउन, सॉकेट निष्क्रिय-टाइमआउट्स, /proc प्रक्रिया अॅट्रिब्युशन आणि TPROXY कॅप्चरला प्रेरणा दिली.
Grok Build कोटा पृष्ठभाग ओळखला; त्यानंतर OmniRoute ने लाइव्ह वायर स्वरूपाची स्वतंत्रपणे पडताळणी करून दुरुस्ती केली.
## 📄 परवाना
MIT परवाना - तपशीलांसाठी [LICENSE](LICENSE) पहा.
---
**[⬆ शीर्षस्थानी परत जा](#-omniroute)** · मुक्त-स्रोत AI समुदायासाठी ❤️ ने तयार केलेले.
Diego Souza यांनी तयार केले · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT परवाना · omniroute.online
> थेट `/dashboard/free-tiers` पेजचा animated सारांश. संपूर्ण कार्यपद्धती (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ही आकडेवारी दर दोन आठवड्यांनी live catalog शी पुन्हा तपासली जाते आणि **दोन्ही दिशांनी बदलते** — एखादा provider free tier बंद करतो तेव्हा संख्या कमी होते; नवीन provider उपलब्ध झाल्यावर ती वाढते. Catalog प्रत्यक्षात जे मोजते तेच आम्ही प्रकाशित करतो; rounded-up best case कधीही नाही.
```bash
# प्रदात्याशी कनेक्ट केल्यानंतर, Dashboard → Endpoints मधून आपली OmniRoute की कॉपी करा:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` साठी पात्र रूट आवश्यक आहे. नवीन स्थापनेमध्ये कोणतेही पात्र keyless लक्ष्य नसू शकते आणि keyless प्रदाता तृतीय-पक्ष क्लायंट नाकारू शकतो. `tos: avoid` असे चिन्हांकित केलेले प्रदाते, ज्यामध्ये Kiro समाविष्ट आहे, डीफॉल्टनुसार स्वयंचलित रूटिंगमधून वगळले जातात; खाते कनेक्ट केल्याने ही सेटिंग ओव्हरराइड होत नाही. प्रदाता निवडण्यापूर्वी [विनामूल्य टियर मार्गदर्शक](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%
```
कोड ब्लॉक्स, 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-इंजिन स्टॅक
इंजिन पाइपलाइनच्या क्रमाने चालतात; प्रत्येक इंजिन स्वतंत्रपणे सक्षम/अक्षम करता येते आणि प्रत्येक कॉम्बोसाठी कॉन्फिगर करता येते:
