# 🚀 OmniRoute — निःशुल्क AI गेटवे
**[Diego Souza](https://github.com/diegosouzapw) द्वारा निर्मित**
## 💰 तेस्रो-पक्षका निःशुल्क तहहरूमा प्रति महिना ~1.62B टोकनहरू
> **आफ्ना प्रदायक खाताहरू आफैँ ल्याउनुहोस्।** यो छुट्टाछुट्टै योग्य तेस्रो-पक्षका निःशुल्क तहहरूको अनुमानित समग्र योग हो, OmniRoute बाट प्रदान गरिएको टोकन अनुदान होइन। आवश्यक परे साइन अप गर्नुहोस्, प्रमाणहरू प्राप्त गर्नुहोस्, र आफूले प्रयोग गर्न सक्ने प्रदायकहरू जडान गर्नुहोस्; प्रत्येक प्रदायकले आफ्ना सीमाहरू, उपलब्धता र सर्तहरू नियन्त्रण गर्छ।
>
> निःशुल्क तहहरूलाई हातैले जोड्नु झन्झटिलो हुन्छ — दर्जनौँ SDK, दर्जनौँ दर सीमाहरू, र वास्तवमा तपाईंसँग कति छ भन्ने कुनै जानकारी हुँदैन। OmniRoute ले **34 दोहोरिने पूल कुञ्जीहरूमा 465 निःशुल्क-तह प्रविष्टिहरू सूचीबद्ध** गर्छ र साझा पूलअनुसार डुप्लिकेट हटाएर **प्रकाशित सकारात्मक मासिक बजेट भएका 17 पूलहरू तथा प्रति-मोडेल Groq का पाँच सीमाहरू** बाट टोकनको मुख्य आँकडा गणना गर्छ। क्षेत्रीय पहिचान जाँचपछि मात्र खुल्ने कोटाहरू (आज: ModelScope) छुट्टै देखाइन्छन्, क्षेत्रीय पहिचान प्रमाणीकरणअन्तर्गत +~6M थपिन्छन्, र मुख्य आँकडामा कहिल्यै जोडिँदैनन्। परिणाम ड्यासबोर्डमा (`/dashboard/free-tiers`) देखिरहन्छ।
> प्रत्यक्ष `/dashboard/free-tiers` पृष्ठको एनिमेटेड सारांश। पूर्ण कार्यविधि (पूल डुप्लिकेट हटाउने प्रक्रिया, क्रेडिट तहहरू, प्रदायकका सर्तहरू): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> यी आँकडाहरू प्रत्यक्ष क्याटलगसँग हरेक दुई हप्तामा पुनः परीक्षण गरिन्छन् र **दुवै दिशामा परिवर्तन हुन्छन्** — कुनै प्रदायकले निःशुल्क तह बन्द गरेमा संख्या घट्छ; नयाँ प्रदायक थपिएमा बढ्छ। हामी क्याटलगले वास्तवमा गणना गरेको कुरा मात्र प्रकाशित गर्छौँ, माथितिर गोल गरिएको उत्तम सम्भावित अवस्था कहिल्यै होइन।
⭐ OMNIROUTE ले तपाईंलाई पैसा बचत गर्न र आफ्नो काम सजिलो बनाउन मद्दत गरेको छ भने रिपोलाई स्टार दिनुहोस्।
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 समुदायमा सामेल हुनुहोस्
**👋 मर्मतकर्तालाई फलो गर्नुहोस् — नयाँ प्रदायक, रिलिज र सुझावहरू सबैभन्दा पहिले पाउनुहोस्:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**प्रश्न, प्रदायकसम्बन्धी सुझाव, रोडम्याप र सहयोग → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ग्लोबल](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)**
## 📈 गेटवे निरन्तर विस्तार हुँदैछ
## 🆓 स्थापना गर्नुहोस्, प्रदायक जडान गर्नुहोस्, त्यसपछि एउटा endpoint मार्फत रुट गर्नुहोस्
```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` का लागि योग्य route आवश्यक हुन्छ। नयाँ स्थापनामा कुनै पनि योग्य keyless target नहुन सक्छ, र keyless provider ले तेस्रो-पक्षका client अस्वीकार गर्न सक्छ। `tos: avoid` चिन्ह लगाइएका प्रदायकहरू, Kiro सहित, पूर्वनिर्धारित रूपमा स्वचालित रुटिङबाट हटाइन्छन्; खाता जडान गर्दा त्यो सेटिङ अधिलेखन हुँदैन। प्रदायक छनोट गर्नुअघि [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्।📦 **Python, Node.js, PHP, र cURL** का लागि प्रतिलिपि गरेर चलाउन मिल्ने quickstart scripts → [`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
🔭 अझ राम्रा मोडेलहरू पत्ता लगाउन गुणस्तर-प्रथम + १०% अन्वेषण
auto/lkgp
📌 स्पष्ट रूपमा पछिल्लो-ज्ञात-राम्रो-प्रदायकमै कायम रहने व्यवहार
auto/chaos
🧪 मोडेलहरूको प्यानलमा समानान्तर फ्यान-आउट (प्रति प्रदायक एउटा, पूर्वनिर्धारित रूपमा ५), एउटा उत्तर फर्काउँछ; प्रति प्यानल मोडेल एउटा अपस्ट्रिम कल, त्रुटि इन्जेक्सन होइन
##
### 🔀 वा आफ्नै बनाउनुहोस् — २० राउटिङ रणनीतिहरू
सबै **२०** रणनीतिहरू — प्रत्येक कम्बो चरणमा मिलाउनुहोस् र संयोजन गर्नुहोस्:
#
रणनीति
यसले के गर्छ
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
हरेक जडानमा १६-कारक प्रत्यक्ष स्कोरिङ 🤖
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औँ कम्बो रणनीतिले सकिएका खाताहरू हटाउँछ, त्यसपछि बाँकी खातामध्ये बाँकी कोटा ÷ चलिरहेको लोडको अनुपातमा चयन गर्छ र विद्यमान कुराकानीहरूलाई सोही खातामा कायम राख्छ। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless मोड** — `omniroute serve --headless` (वा `OMNIROUTE_HEADLESS=1`) ले `/v1/*` प्रोक्सी इन्जिन मात्र चलाउँछ; ड्यासबोर्ड र ड्यासबोर्ड-केवल उपप्रणालीहरू बन्द हुन्छन्। → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 मोडेल खोज** — `/v1/models` ले क्षमता, सन्दर्भ, प्रकार र पाठअनुसार फिल्टर गर्छ, र `POST /v1/models/query` ले प्रत्येक कुञ्जेको समान दृश्यतासहित छोटो, निर्धार्य सर्टलिस्ट फर्काउँछ। → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 प्रत्येक कुञ्जेका लागि राउटिङ नियन्त्रण** — `forcedModel` प्रयोग गरेर API कुञ्जेलाई एउटा मोडेल वा कम्बोमा पिन गर्नुहोस्, र कुञ्जेका मोडेल तथा कम्बोहरूलाई एटोमिक रूपमा थप्नुहोस् वा हटाउनुहोस् (`/api/keys/{id}/access`)। → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ अझ सूक्ष्म PII नियन्त्रणहरू** — प्रकारअनुसार चयन, प्रमाणीकरण गरिएका 20 वटासम्म कस्टम मास्किङ ढाँचाहरू र प्रकारअनुसार पहिचान काउन्टरहरू; मास्किङ आफैँ भने opt-in नै रहन्छ। → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 भाषाहरू** — ड्यासबोर्ड, कागजातका मिररहरू र CLI मा; `npm run i18n:add-locale` ले एउटै आदेशमा सबै ठाउँमा भाषा थप्छ। → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — तपाईंको एजेन्ट फ्लीटमा इनबाउन्ड A2A delegation, Agent Card मा Conductor skills, र Faro push-to-talk voice chat सहितको ड्यासबोर्ड प्यानल। → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूलनशील admission र overload सुरक्षा** — भारी chat अनुरोधहरू 503 फर्काउनुको सट्टा पङ्क्तिबद्ध हुन्छन्, र प्रत्येक connection का लागि atomic RPM rolling leases प्रयोग गरिन्छ। → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Canonical `/v1/models` क्रम** — प्रत्येक provider का लागि एउटै निरन्तर provider-grouped block (कम्बोहरू पहिले पिन गरिएका), सबै catalog स्रोतहरूमा स्थिर। → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Compression hardening** — पूर्वनिर्धारित रूपमा सक्रिय 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 राउटिङ** — साझा खाताको कोटा pooled keys बीच निष्पक्ष रूपमा बाँड्छ, र निष्क्रिय slices उधारो दिएर स्रोतको पूर्ण उपयोग गर्छ। → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एक-आदेश CLI/agent setup** — 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)
- **🕵️ पारदर्शी MITM decrypt (TPROXY)** — proxy environment variables बेवास्ता गर्ने CLIs का लागि capture, साथै प्रत्येक 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, र प्रत्येक key का लागि USD spend quotas। → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 तपाईंको नियन्त्रणमा Memory** — पूर्वनिर्धारित रूपमा बन्द, opt-in int8 vector quantization र typed decay, प्रत्येक request का लागि `x-omniroute-no-memory`। → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ सुरक्षा** — प्रत्येक LLM route मा prompt-injection guard (red-team suite), opt-in credential-masking guardrail (दुवै दिशामा चुहिएका API keys/secrets लाई redacts गर्ने), निःशुल्क DuckDuckGo last-resort web search, र ड्यासबोर्डका लागि वैकल्पिक 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, प्रत्येक 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), first-class card सहित Ollama, Claude Opus 5 र Sonnet 5, Kimi official partnership (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… र पुनः तयार गरिएको **388-provider catalog**। → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 राउटिङ पारदर्शिता** — प्रत्येक response ले त्यसलाई सेवा दिने strategy/provider/latency को नामसहित `X-OmniRoute-Decision` 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-compatible Batch र Files APIs, सिमान्टिक प्रतिक्रिया क्यास, लिडरबोर्डसहितको गेमिफिकेसन, ACP एजेन्ट डिस्कभरी (15 निर्मित एजेन्टहरू), BigQuery मा निर्धारित लग निर्यात, `auto/chaos` समानान्तर बहु-मोडेल फ्यान-आउट, Telegram बट ब्रिज, इन-एप संस्करण व्यवस्थापक र LMArena-ELO निःशुल्क-प्रदायक र्याङ्किङहरू। → [दस्तावेज](docs/README.md)
## 🤖 उपयुक्त CLI हरू र कोडिङ एजेन्टहरू
> एउटै कन्फिग — `http://localhost:20128/v1` — र **हरेक** AI IDE वा CLI निःशुल्क र कम लागतका मोडेलहरूमा चल्छ।
＋ यसले यीहरूसँग पनि काम गर्छ · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · कुनै पनि OpenAI-संगत उपकरण
📖 सबै ३९ उपकरणहरूको लागि प्रति-उपकरण सेटअप (२८ CLI कोड + ११ CLI एजेन्टहरू) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode प्लगइन → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**OmniRoute मार्फत कुनै पनि समर्थित CLI एकै आदेशमा सुरु गर्नुहोस्** — कुनै कन्फिग फाइलहरू लेख्न आवश्यक छैन,
प्रत्येक प्रक्रियामा प्रमाणिकरणहरू इन्जेक्ट गरिन्छ, Qwen/Gemini ले छुट्टै अस्थायी होम पाउँछन्:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# वा प्रदायक+मोडेल अन्तरक्रियात्मक रूपमा छान्नुहोस् र उपकरणको आफ्नै कन्फिग लेख्नुहोस्:
omniroute configure codex # साथै: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
हरेक आदेशले सक्रिय रिमोट सन्दर्भ (`omniroute connect `) पालना गर्छ, `--dry-run`
ले कार्यान्वयन नगरीकन ठ्याक्कै env/args पूर्वावलोकन गर्छ, र `--api-key-env NAME` ले
तपाईंको shell इतिहासबाट गोप्य कुराहरू बाहिर राख्छ। → [CLI एकीकरणहरू](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI प्रदायक — क्याटलगमा चिह्नित 153 निःशुल्क
> **388 दर्ता गरिएका प्रदायकहरू** आधिकारिक chat, media, search, local, cloud-agent र system सङ्ग्रहहरूमा समेटिएका छन्, जसमा **`hasFree: true` डिस्कभरी मेटाडेटा भएका 153 प्रदायकहरू** पनि छन्। chat model registry मा **239 प्रदायक / 3,059 विशिष्ट provider-model जोडी / 1,475 कच्चा model ID** समेटिएका छन्; छुट्टै free-budget catalog मा **471 प्रति-मोडेल पङ्क्तिहरू**, **34 पुनरावर्ती पूलहरू** र **52 पुनरावर्ती/कुञ्जीविहीन सधैँ-निःशुल्क प्रदायकहरू** छन्। यी फरक denominator हरू डिजाइनकै अंश हुन्; परिभाषा र 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 ५०+ मोडेलहरू प्रतिदिन १०K न्युरोनहरू
NVIDIA NIM GLM, MiniMax निःशुल्क ~४० 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 -g omniroute
एक आदेश स्थापना गर्नुहोस्, कुनै पनि OS
⚡ Bun (ग्लोबल)
बन जोड्नुहोस् -g omniroute
समान रजिस्ट्री टारबल, छिटो स्थापना
🐳 Docker
डकर रन ... diegosouzapw/omniroute
बहु-आर्क AMD64 + ARM64
🖥️ डेस्कटप (Electron)
npm रन इलेक्ट्रोन
निर्माण
नेटिभ विन्डो +
ट्रे — Windows / macOS / Linux
🎩 Menu-bar (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
सुपरिवेक्षण गर्दछ & सर्भरलाई स्वत
अपडेट
— macOS
💪 ARM
देशी arm64
Raspberry Pi, ARM सर्भरहरू, Apple Silicon
📱 एन्ड्रोइड (Termux)
pkg स्थापना nodejs && npx -y omniroute
तपाईंको फोनमा चलाउँछ , 24/7 no
📲 PWA
"गृह स्क्रिनमा थप्नुहोस्"
फुलस्क्रिन, अफलाइन, ब्राउजर
बाट स्थापना गर्न सकिने
🧩 OpenCode प्लगइन
@omniroute/opencode-provider
मूल OpenCode एकीकरण
🤖 VS कोड Copilot च्याट
स्थापना गर्नुहोस् OmniCopilot विस्तार
नेटिभ Copilot च्याट पिकरमा प्रत्येक OmniRoute मोडेल — स्थिर &
### 🧩 नयाँ: OmniRoute भित्र VS कोडको नेटिभ Copilot च्याट
> कुनै नयाँ साइडबार छैन, कुनै नयाँ च्याट UI छैन — प्रत्येक मोडेल OmniRoute ले सेवा गर्दछ।**Copilot च्याट मोडेल पिकर तपाईंले पहिले नै प्रयोग गरिरहनुभएको छ** । VS कोड 1.122 देखि, प्रदायक मोडेलहरू GitHub साइन-इन वा Copilot सदस्यता बिना काम गर्छन् — एजेन्ट मोड, उपकरण कलिङ र भिजन, नि:शुल्क।
स्थापना गर्नुहोस्** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** विस्तार, यसलाई आफ्नो OmniRoute सर्भरमा पोइन्ट गर्नुहोस् ( `localhost:20128` मा पूर्वनिर्धारित), त्यसपछि Copilot 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 को सुपरिवेक्षण गर्दछ, यसलाई
नक्कल गर्नुको सट्टा पहिले नै चलिरहेको उदाहरणलाई अपनाउछ।
📊 Claude
session/weekly
🔄 स्थानमा स्वत: अपडेटहरू
चरणबद्ध स्थापना, परमाणु स्वैप, असफलतामा रोलब्याक — सधैं नयाँ रिलीजमा
🚀 लगइन सुरु गर्नुहोस्
लगइनमा वैकल्पिक सुरुवात; ट्रे-मात्र, कुनै डक आइकन
🩺 डाक्टर & लगहरू
एक-क्लिक निदान र सर्भर लग पहुँच
```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**, **वेबहुकहरू** वा **रिमोट 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)
## 🗜️ १५–९५% टोकन बचत — स्वचालित रूपमा
### 📖 यसले कसरी काम गर्छ — पाइपलाइन, आर्किटेक्चर र बचतको गणित
पूर्वनिर्धारित स्ट्याक गरिएको संयोजन `RTK → Caveman` चलाउँछ। दुवैले एउटै tool/context payload मा काम गर्दा बचतहरू संयोजित हुन्छन्:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लकहरू, URL हरू, JSON र संरचित डाटा preservation engine द्वारा **सधैं सुरक्षित** हुन्छन्।
> **थोरै टोकनले काम चल्ने हुँदा धेरै टोकन किन प्रयोग गर्ने?** प्रत्येक अनुरोध OmniRoute को कम्प्रेसन पाइपलाइन हुँदै **पारदर्शी रूपमा** जान्छ — क्लाइन्टमा कुनै परिवर्तन आवश्यक पर्दैन। अहिले यो क्रमशः चल्ने र प्रत्येक routing combo अनुसार मिश्रण तथा मिलान गर्न सकिने **१२ वटा संयोजनयोग्य इन्जिनहरूको स्ट्याक** हो — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), र [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) का विचारहरूमा आधारित।
### 🧱 १२-इन्जिन स्ट्याक
इन्जिनहरू पाइपलाइनको क्रममा चल्छन्; प्रत्येकलाई छुट्टाछुट्टै सक्रिय वा निष्क्रिय गर्न र प्रत्येक combo अनुसार कन्फिगर गर्न सकिन्छ:
अन्तिम user query विरुद्ध extractive sentence scoring
8
Caveman
Rule-based prose compression (output मा ~65–75%)
9
Aggressive
पुराना turn हरूको summarization + progressive aging
10
LLMLingua-2
MobileBERT ONNX मार्फत ML semantic pruning — code-safe, async
11
Ultra
वैकल्पिक small-model (SLM) tier सहित heuristic token pruning
12
OmniGlyph
direct Anthropic wire मा मापन गरिएको Claude Fable 5 का लागि experimental context-as-image encoding; provider receipts बाँकी रहेसम्म GPT 5.6 transformers fail-closed रहन्छन्। चारवटा compression profile (aggressive default, balanced, coding-safe, passthrough) (सबैभन्दा aggressive; opt-in)
कोड ब्लकहरू, URL हरू र संरचित डाटा **सधैं byte-perfect रूपमा सुरक्षित** रहन्छन्। **One-click presets** ले इन्जिनहरूलाई संयोजन गर्छन्:
मोड
बचत
यसका लागि उपयुक्त
🪶 Lite
~15%
सधैं सक्रिय सुरक्षित पूर्वनिर्धारित
🪨 Standard (Caveman)
~30%
दैनिक coding
⚡ Aggressive
~50%
लामो tool-heavy session हरू
🔥 Ultra
~75%
अधिकतम बचत
🧰 RTK
60–90%
Shell/test/build/git output
🔗 Stacked (RTK → Caveman)
78–95%
मिश्रित prompt हरू + tool log हरू
**वास्तविक उदाहरण — Standard मोड:**
> **अघि (६९ टोकन):** _"तपाईंको React component पुनः render हुनुको सम्भावित कारण प्रत्येक render cycle मा नयाँ object reference सिर्जना हुनु हो। जब तपाईं inline object लाई prop का रूपमा पठाउनुहुन्छ, React को shallow comparison ले यसलाई हरेक पटक फरक object का रूपमा देख्छ, जसले re-render गराउँछ। object लाई memoize गर्न useMemo प्रयोग गर्न म सुझाव दिन्छु।"_
>
> **पछि (१९ टोकन):** _"प्रत्येक render मा नयाँ object ref। Inline object prop = नयाँ ref = re-render। useMemo मा wrap गर्नुहोस्।"_
>
> **उही उत्तर। ७२% कम टोकन। शुद्धतामा कुनै कमी छैन।** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) मोड:**
> **पहिले (42 tokens):** _"समस्या के हो भने प्रत्येक रेंडरिङ चक्रमा वस्तुको नयाँ सन्दर्भ सिर्जना भइरहेकाले कम्पोनेन्ट पुनः-रेंडर भइरहेको छ। म `useMemo` प्रयोग गर्न सिफारिस गर्छु।"_
>
> **पछि (12 tokens):** _"पुनः-रेंडर: प्रत्येक चक्रमा नयाँ ref (inline वस्तु पुनःसिर्जना)। `useMemo` प्रयोग गर्नुहोस्।"_
>
> **उही उत्तर। ~70% कम tokens। प्राविधिक शुद्धता अक्षुण्ण।** ✅
### 🎚️ इन्जिनहरूभन्दा पर — आउटपुट शैलीहरू, अनुकूलनशील डायल र प्रति-अनुरोध नियन्त्रण
माथिका 12 इन्जिनहरूले **भित्र जाने** सामग्रीलाई छोट्याउँछन्। थप तीन तहहरूले **कसरी**, **कहिले**, र बाहिर **के** आउँछ भन्ने निर्धारण गर्छन्:
- **🪄 आउटपुट शैलीहरू** _(output-axis steering)_ — निश्चित, क्यास-सुरक्षित प्रतिक्रिया-आकार दिने निर्देशनहरू थप्छन्; संयोजन गर्न सकिने, प्रत्येक `lite` / `full` / `ultra` तीव्रतामा। शैली थप्नु भनेको रजिस्ट्रीमा एक लाइन थप्नु मात्र हो:
- **संक्षिप्त गद्य** — अनावश्यक भराइ / articles / अनिश्चितता हटाउनुहोस्; प्राविधिक विषयवस्तु ठ्याक्कै राख्नुहोस्।
- **कम कोड** — "lazy senior dev" YAGNI: काम गर्ने सबैभन्दा सानो परिवर्तन, अनुरोध नगरिएको scaffolding नराख्ने।
- **Ponytail (lazy senior dev)** — YAGNI को तह चढ्दै, मूल कारण समाधान गर्दै, काम गर्ने सबैभन्दा सानो diff।
- **मलाई ADHD छ (action-first)** — अर्को कार्य अगाडि, चरणहरू क्रमाङ्कित, एउटा ठोस अर्को चरण, कुनै preamble होइन।
- **संक्षिप्त CJK (文言)** — शास्त्रीय-चिनियाँ अति-संक्षिप्त शैली (`zh` locale मा मात्र)।
- **🎯 अनुकूलनशील context-budget** _(डायल)_ — एउटै on/off token threshold को सट्टा, मोडलको context window मा **अटाउन** आवश्यक परेसम्म मात्र सबैभन्दा सस्तो र न्यूनतम-सूचना-हानि हुने इन्जिनहरू क्रमशः सक्रिय गर्छ। नीति: `reserve-output` (default, model-aware) · `percentage` · `absolute`। मोड: `floor` (अट्ने सुनिश्चित) · `replace-autotrigger` (तपाईंको स्पष्ट छनोट प्रभावी) · `off` (legacy threshold)।
- **🎛️ कम्प्रेसन कहाँ तय हुन्छ** _(precedence, high → low)_ — प्रति-अनुरोध `x-omniroute-compression` header › routing-combo override › सक्रिय named profile › adaptive / auto-trigger › panel default › off। लागू गरिएको plan `X-OmniRoute-Compression: ; source=` response header मा फिर्ता देखाइन्छ।
Token threshold द्वारा auto-trigger गर्नुहोस्, adaptive dial सक्रिय गर्नुहोस्, named profile pin गर्नुहोस्, प्रति-अनुरोध one-off सेट गर्नुहोस्, वा प्रत्येक routing combo का लागि pipeline तोक्नुहोस् — workload अनुसार जे उपयुक्त हुन्छ। Opt-in offline **eval harness** (`npm run eval:compression`) ले परिवर्तन promote गर्नुअघि pinned corpus मा fidelity र savings को स्कोर निकाल्छ।
📖 [`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 warnings देखियो? [ती हानिरहित छन्](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)।
> **npm 11 वा पछिल्लो संस्करण प्रयोग गर्दै हुनुहुन्छ?** अनुमति नदिइएसम्म npm ले package lifecycle scripts रोक्न सक्छ। OmniRoute को `postinstall` (`node scripts/build/postinstall.mjs`) यसको native runtime files तयार गर्न आवश्यक हुन्छ। globally स्थापना गर्दा npm को warning मा उल्लेख गरिएका packages लाई अनुमति दिनुहोस्। OmniRoute 3.8.54 द्वारा रिपोर्ट गरिएको package set का लागि:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> भविष्यका global installs का लागि यही allowlist पुनः प्रयोग गर्न, यसलाई एकपटक configure गर्नुहोस्, त्यसपछि सामान्य रूपमा install गर्नुहोस्:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Releases बीच dependency list परिवर्तन हुन सक्छ; npm ले फरक list रिपोर्ट गरेमा त्यस warning मा भएका package names प्रयोग गर्नुहोस्। कुनै package लाई अनुमति दिँदा त्यसका install scripts चल्न पाउँछन्।
> **Gemini Web वा अर्को web-cookie provider प्रयोग गर्दै हुनुहुन्छ?** npm package मा
> Playwright समावेश छ, तर यसको Chromium binary छैन। पहिलो web-provider request गर्नुअघि
> [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> note हेर्नुहोस्।
Dashboard `http://localhost:20128` मा · API `http://localhost:20128/v1` मा।
**2) आफ्नै account प्रयोग गरेर योग्य provider जोड्नुहोस्**
Dashboard → **Providers** → हालका terms र quota तपाईंको use case का लागि उपयुक्त भएको provider छान्नुहोस् → यसको API key थप्नुहोस् वा account flow पूरा गर्नुहोस्। Free tiers का लागि signup, approval, वा payment method आवश्यक हुन सक्छ। [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्; keyless availability सुनिश्चित हुँदैन, र `tos: avoid` चिह्नित providers लाई default रूपमा `auto` बाट हटाइन्छ।
**3) आफ्नो coding tool निर्देशित गर्नुहोस्**
```txt
Base URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints बाट प्रतिलिपि गर्नुहोस्]
Model: auto (योग्य connections बीच routing गर्छ — वा provider/model छान्नुहोस्)
```
**4) यसले काम गरिरहेको छ भनी जाँच्नुहोस्**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
तपाईंले जोडिएका models को सूची देख्नुहुनेछ। 🎉 यति नै — coding सुरु गर्नुहोस्, OmniRoute ले तपाईंका लागि स्वतः route र fallback गर्छ।
तपाईंको client ले custom headers पठाउन नसकेमा, OmniRoute ले tokenized compatibility aliases पनि उपलब्ध गराउँछ:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
यी `Authorization: Bearer ...` attach गर्न नसक्ने clients का लागि मात्र प्रयोग गर्नुहोस्। Header auth अझै पनि प्राथमिक mode हो।
## 📦 थप स्थापना विधिहरू — 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 बन्डलर चयन**: विकास (`bun run dev`) ले Bun स्वतः पहिचान गर्छ र नेटिभ V8 बाइन्डिङ असङ्गतिहरू रोक्न Turbopack लाई निष्क्रिय पारेर Webpack प्रयोग गर्छ। उत्पादन बिल्डहरू (`bun run build`) ले Node मा जस्तै ठ्याक्कै `OMNIROUTE_USE_TURBOPACK` पछ्याउँछन्: पूर्वनिर्धारित रूपमा Turbopack, Webpack मार्फत बिल्ड गर्न `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` ले यसलाई `--build-arg` का रूपमा उपलब्ध गराउँछ)।
- **समर्पित Bun Dockerfile**: नेटिभ Bun उत्पादन डिप्लोयमेन्टहरूका लागि बहु-चरणीय `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`)।
```bash
# Bun मार्फत स्थापना गरी चलाउनुहोस्
bun install
bun run dev
```
**🛠️ स्रोतबाट**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flakes प्रयोग गर्दै
nix develop
npm run dev
# वा devbox प्रयोग गर्दै
devbox run npm run dev
```
📖 [Docker गाइड](docs/guides/DOCKER_GUIDE.md) — Compose प्रोफाइलहरू, Caddy HTTPS, Cloudflare टनेलहरू।
**🦭 Podman**
```bash
# 1. बाइन्ड-माउन्ट गरिएको डेटा डाइरेक्टरी तयार गर्नुहोस्
mkdir -p data
# 2. Linux + स्थानीय 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 एक उत्साही खुला-स्रोत समुदायले आकार दिएको परियोजना हो। यी व्यक्तिहरूले परियोजनाको गुणस्तर, स्थिरता र पहुँचमा प्रत्यक्ष प्रभाव पार्ने असाधारण योगदानहरू गरेका छन्। **धन्यवाद।**
### मर्ज गरिएका पुल अनुरोधअनुसार बाह्य योगदानकर्ताहरू
२०२६-११-०३ ०३:०१:१९ UTC मा लाइभ release/v3.8.53 टिप 05bc048d6c प्रयोग गरेर जनगणना गरिएको हो। पृष्ठांकित GitHub GraphQL जनगणनामा ९,९४७ वटा मर्ज गरिएका PR हरू छन्: रिपोजिटरी मालिकद्वारा ४,१३०, Dependabot द्वारा २४०, अन्य बट/एपहरूद्वारा ६, र ८८३ जना फरक योगदानकर्ताहरूबाट ५,५७१ वटा बाह्य PR हरू। “परिवर्तित लाइनहरू” GitHub का थपिएका + हटाइएका लाइनहरू हुन् र यसमा जेनेरेट गरिएका फाइलहरू, लकफाइलहरू, क्याटलगहरू, अनुवादहरू र दस्तावेजहरू समावेश छन्; यो churn हो, लेखिएका LOC होइन। ५३ वटा PR हरूले GitHub diffs मा ५००,००० भन्दा बढी लाइनहरू देखाउँछन् (उदाहरणका लागि #13399, एकल provider addition, जसमा २,३४७ वटा परिवर्तित फाइलहरू सूचीबद्ध छन्), जसले माथिका केही कुलहरूलाई बढाउँछ। बराबरी भएका स्थानहरू सँगै क्रमबद्ध गरिएका छन्।
### GitHub-मा श्रेय दिइएका कमिटहरू
2026-11-03 02:09:16 UTC मा पुनः जाँच गरिएको: पूर्वनिर्धारित शाखा release/v3.8.53 का लागि repository Contributors API ले रिपोर्ट गरेका GitHub-श्रेय प्राप्त कमिटहरू। API ले 903 पहिचानहरू (429 प्रयोगकर्ता, 2 बोट, 472 अज्ञात) फिर्ता गर्यो; यस तालिकाले मर्मतकर्ता, बोटहरू र अज्ञात पहिचानहरूलाई समावेश गर्दैन र समान स्थानमा रहेका योगदानकर्ताहरूलाई कायम राख्छ। यो माथिको मर्ज गरिएका PR को क्रममा र तलको Git-मेटाडेटा गणनाबाट अलग छ।
> 🙏 यी योगदानकर्ताहरूका सुविधाहरू, बग समाधानहरू र पूर्वाधार सुधारहरू OmniRoute लाई विश्वसनीय र सुविधासम्पन्न बनाउने कुराको **मुख्य हिस्सा** हुन्। हरेक pull request, हरेक परीक्षण केस र हरेक i18n अनुवाद फाइल महत्त्वपूर्ण हुन्छ। खुला स्रोत उनीहरूजस्ता मानिसहरूले निर्माण गर्छन्।
---
## 💖 प्रायोजकहरू
आफ्नै खल्तीबाट OmniRoute लाई आर्थिक सहयोग गर्ने व्यक्तिहरूप्रति हार्दिक धन्यवाद — प्रत्येक योगदानले परियोजनालाई निःशुल्क, स्वतन्त्र र निरन्तर अगाडि बढाइराख्छ।
… र गोप्य रहन रुचाउने अन्य व्यक्तिहरू 💛सार्वजनिक GitHub Sponsors लाई GitHub Sponsors GraphQL API मार्फत 2026-10-18 मा पुनः प्रमाणित गरिएको थियो: कुल 14 मध्ये 11 सार्वजनिक प्रायोजनहरू (6 सक्रिय, 5 विगतका)। GitHub को isActive स्थितिले माथिका सक्रिय लेबलहरू निर्धारण गर्छ; विगतका सार्वजनिक एकपटकका समर्थकहरूलाई धन्यवाद दिइरहिएको छ, र निजी प्रायोजकहरू गुमनाम रहन्छन्। Ko-fi, Buy Me a Coffee, Liberapay, PIX र क्रिप्टो दानहरू सूचीबद्ध गरिएका छैनन् किनकि तिनको कुनै सार्वजनिक प्रायोजक अभिलेख छैन।💖 प्रायोजक बन्नुहोस् → — प्रत्येक डलरले OmniRoute लाई निःशुल्क र स्वतन्त्र राख्छ।
## 👥 १,०००+ योगदानकर्ताहरू
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
२०२६-११-०२ मा live release/v3.8.53 tip 1c7135e0fb (७,९७२ commits) मा अडिट गरिएको: १,०७४ सामान्यीकृत मानव Git पहिचानहरू — ७५९ commit authors का रूपमा (maintainer सहित) देखिन्छन् र ३१५ केवल स्पष्ट Co-authored-by trailers मा छन्। यस गणनाले .mailmap लागू गर्छ, e-mail addresses लाई case-insensitively तुलना गर्छ, एउटै handle सङ्केत गर्ने अवस्थामा मात्र numeric र plain GitHub noreply addresses लाई जोड्छ, २९ bot/agent/service/placeholder identities लाई हटाउँछ, र display names मिलेकै आधारमा सामान्य e-mail addresses लाई merge गर्दैन। २०२६-०८-२४ को audit ले ६३९ प्रकाशित गरेको थियो; त्यस audit को base ac02c5b42f मा यही विधि पुनः चलाउँदा ६१९ प्राप्त हुन्छ, त्यसैले वृद्धि नयाँ contributors का कारण हो, खुकुलो विधिका कारण होइन।
### योगदान कसरी गर्ने
1. Repository fork गर्नुहोस्
2. **active** `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)** को fork र Go परियोजना **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** को TypeScript port का रूपमा भयो — र त्यसपछि तलका प्रत्येक subsystem पहिले नै त्यो क्षेत्रमा अगाडि बढिसकेको open-source परियोजनाबाट प्रेरित भयो। प्रत्येकले OmniRoute को एउटा ठोस अंशलाई आकार दियो। यो ती सबैप्रतिको हाम्रो धन्यवाद हो। 🙏
> ⭐ star गणनाहरू GitHub को REST API बाट November 3, 2026 मा प्रमाणित गरिएका हुन् — यी परियोजनाहरूलाई star दिनुहोस्। गणनाहरू तोकिएको मितिको यथार्थ snapshot हुन् र स्वाभाविक रूपमा परिवर्तन भइरहन्छन्।
### 🧬 वंशपरम्परा र gateway
हाम्रो cost-tracking sync लाई यसको सार्वजनिक pricing dataset ले data feed गर्छ र यसको provider-normalization model ले हाम्रो routing लाई जानकारी दिएको छ।
MIT source लाई vendored ChatGPT Web → Codex Responses bridge मा अनुकूलित गरिएको छ, जसमा browser-session, response-framing, usage र web-search adapters समावेश छन्।
यसका patterns लाई stream recovery, no-thinking aliases, fallback web search, sliding-window limits, log redaction र hardened launcher flows मा port गरिएको छ।
यसका Grok model mappings, fake-TypeError Statsig generator, request र device defaults, तथा NDJSON response processor लाई OmniRoute को Grok Web executor मा महत्वपूर्ण रूपमा अनुकूलित गरिएको छ।
grok2api-merged पछाडिको प्रमुख transitive code source; यसका model, header, payload, Statsig र processor implementations Grok Web lineage मा सुरक्षित राखिएका छन्।
Grok payload र device defaults, Statsig generator, तथा TQZHR र grok2api-merged मार्फत अगाडि ल्याइएको result.response processor का लागि अन्तर्निहित MIT source।
यसको proxy-pool layer का लागि grok2api-merged द्वारा श्रेय दिइएको transitive source; OmniRoute ले उक्त lineage notice सुरक्षित राख्छ, तर यसको सीमित Grok Web executor मा proxy-pool port गरेको दाबी गर्दैन।
यसको HTTP/browser upstream design का लागि मूल Grok Web implementation लाई सन्दर्भ गरिएको थियो; यसको direct HTTP path GrokProxy बाट आएको हुनाले कुनै स्वतन्त्र code port को दाबी गरिएको छैन।
भाइरल "थोरै टोकनले काम चल्छ भने धेरै टोकन किन प्रयोग गर्ने" प्रोजेक्ट — यसको caveman-स्पिक दर्शनले हाम्रो मानक सङ्कुचन मोड र ३०+ filler/condensation नियमहरूलाई शक्ति दिन्छ।
उच्च-प्रदर्शन command-output सङ्कुचन — यसले हाम्रो RTK engine, JSON filter DSL, raw-output recovery र stacked RTK → Caveman pipeline लाई प्रेरित गर्यो।
PT-BR token compression — यसले हाम्रो pt-BR language pack लाई शक्ति दिन्छ: Brazilian-Portuguese grammar का लागि अनावश्यक पुनरुक्ति घटाउने र filler हटाउने कार्यमा परिष्कृत।
भाइरल "अल्छी वरिष्ठ dev" YAGNI-coder skill — यसले हाम्रो less-code Output Style लाई प्रेरित गर्यो: Caveman को संक्षिप्त prose को output-axis sibling का रूपमा _उत्पन्न_ code घटाउने, सबैभन्दा सानो काम गर्ने परिवर्तनतर्फको steering।
Rust columnar-JSON + content-addressed retrieve + cross-message dedup — यसले हाम्रो headroom/ccr/session-dedup engine design र cache-stable "compressed form is position-independent" invariant लाई प्रमाणित गर्यो।
coding-assistant ↔ LLM ट्राफिकको MITM अवरोधन/विश्लेषणले प्रारम्भिक Traffic Inspector आवश्यकताहरूलाई मार्गदर्शन गर्यो। पहिले व्युत्पन्न गरिएका चार मोड्युलहरू — SSE merging, conversation normalization, secret masking र header sanitization — सार्वजनिक प्रोटोकल मापदण्डहरूमा आधारित स्वतन्त्र clean-room implementation हरूद्वारा प्रतिस्थापित गरिएका छन्। दुईवटा host-passthrough सतहहरू (passthrough.ts र _internal/bypass.cjs) OmniRoute-आन्तरिक implementation का रूपमा स्वतन्त्र रूपमा वर्गीकृत गरिएका छन्; उक्त प्रतिस्थापनको भागका रूपमा तिनलाई पुनर्लेखन गरिएको थिएन।
प्रति-प्रक्रिया पारदर्शी प्रोक्सी राउटिङ — यसले हाम्रो crash-safe MITM teardown, socket idle-timeouts, /proc process attribution र TPROXY capture लाई प्रेरित गर्यो।
secure-by-default libraries को curated list, जसले हाम्रा सुरक्षा छनोटहरू (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink) लाई मार्गदर्शन गर्छ।
Grok Build quota surface पहिचान गर्यो; त्यसपछि OmniRoute ले live wire format स्वतन्त्र रूपमा verify र correct गर्यो।
## 📄 इजाजतपत्र
MIT License - विवरणका लागि [LICENSE](LICENSE) हेर्नुहोस्।
---
**[⬆ माथि फर्कनुहोस्](#-omniroute)** · खुला-स्रोत AI समुदायका लागि ❤️ सहित निर्माण गरिएको।
Diego Souza द्वारा सिर्जना गरिएको · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT License · omniroute.online
> प्रत्यक्ष `/dashboard/free-tiers` पृष्ठको एनिमेटेड सारांश। पूर्ण कार्यविधि (पूल डुप्लिकेट हटाउने प्रक्रिया, क्रेडिट तहहरू, प्रदायकका सर्तहरू): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> यी आँकडाहरू प्रत्यक्ष क्याटलगसँग हरेक दुई हप्तामा पुनः परीक्षण गरिन्छन् र **दुवै दिशामा परिवर्तन हुन्छन्** — कुनै प्रदायकले निःशुल्क तह बन्द गरेमा संख्या घट्छ; नयाँ प्रदायक थपिएमा बढ्छ। हामी क्याटलगले वास्तवमा गणना गरेको कुरा मात्र प्रकाशित गर्छौँ, माथितिर गोल गरिएको उत्तम सम्भावित अवस्था कहिल्यै होइन।
```bash
# प्रदायक जडान गरेपछि, 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` का लागि योग्य route आवश्यक हुन्छ। नयाँ स्थापनामा कुनै पनि योग्य keyless target नहुन सक्छ, र keyless provider ले तेस्रो-पक्षका client अस्वीकार गर्न सक्छ। `tos: avoid` चिन्ह लगाइएका प्रदायकहरू, Kiro सहित, पूर्वनिर्धारित रूपमा स्वचालित रुटिङबाट हटाइन्छन्; खाता जडान गर्दा त्यो सेटिङ अधिलेखन हुँदैन। प्रदायक छनोट गर्नुअघि [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्।
📦 **Python, Node.js, PHP, र cURL** का लागि प्रतिलिपि गरेर चलाउन मिल्ने quickstart scripts → [`examples/quickstart/`](examples/quickstart/)
> **कम्बो** भनेको OmniRoute ले **स्वचालित रूपमा** राउट गर्ने मोडेलहरूको शृङ्खला हो। कोटा सकिएमा, प्रदायक असफल भएमा वा लागत आकस्मिक रूपमा बढेमा, कम्बो अर्को योग्य र स्वस्थ मोडेलमा जान सक्छ। 🛡️
### ⚡ शून्य-कन्फिगरेसन — केवल `auto` प्रयोग गर्नुहोस्
कम्बो सिर्जना गर्नुपर्दैन। आफ्नो मोडेललाई `auto` (वा यसको कुनै भेरियन्ट) मा सेट गर्नुहोस् र OmniRoute ले तपाईंका जडान गरिएका प्रदायकहरूबाट प्रत्यक्ष रूपमा स्कोर गरिएको भर्चुअल कम्बो बनाउँछ:
📖 [Auto-Combo इन्जिन](docs/routing/AUTO-COMBO.md) · [लचिलोपन मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
📊 9router, OpenRouter, CLIProxyAPI र LiteLLM सँगको पूर्ण विधिशास्त्र तथा प्रत्येक सुविधाको विस्तृत विवरण → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
कुञ्जी (यादृच्छिक): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix प्रतिलिपि गरेर टाँस्नुहोस्:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [प्राधिकरण](docs/architecture/AUTHZ_GUIDE.md) · [सुरक्षा सीमाहरू](docs/security/GUARDRAILS.md) · [अनुपालन](docs/security/COMPLIANCE.md)
पूर्वनिर्धारित स्ट्याक गरिएको संयोजन `RTK → Caveman` चलाउँछ। दुवैले एउटै tool/context payload मा काम गर्दा बचतहरू संयोजित हुन्छन्:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लकहरू, URL हरू, JSON र संरचित डाटा preservation engine द्वारा **सधैं सुरक्षित** हुन्छन्।
> **थोरै टोकनले काम चल्ने हुँदा धेरै टोकन किन प्रयोग गर्ने?** प्रत्येक अनुरोध OmniRoute को कम्प्रेसन पाइपलाइन हुँदै **पारदर्शी रूपमा** जान्छ — क्लाइन्टमा कुनै परिवर्तन आवश्यक पर्दैन। अहिले यो क्रमशः चल्ने र प्रत्येक routing combo अनुसार मिश्रण तथा मिलान गर्न सकिने **१२ वटा संयोजनयोग्य इन्जिनहरूको स्ट्याक** हो — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), र [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) का विचारहरूमा आधारित।
### 🧱 १२-इन्जिन स्ट्याक
इन्जिनहरू पाइपलाइनको क्रममा चल्छन्; प्रत्येकलाई छुट्टाछुट्टै सक्रिय वा निष्क्रिय गर्न र प्रत्येक combo अनुसार कन्फिगर गर्न सकिन्छ:
