> **आफ्नै प्रदायक खाताहरू ल्याउनुहोस्।** यो OmniRoute बाट टोकन अनुदान होइन, अलग-अलग योग्य तेस्रो-पक्ष निःशुल्क तहहरूमा अनुमानित समग्र योगफल हो। साइन अप गर्नुहोस्, आवश्यक ठाउँमा प्रमाणहरू प्राप्त गर्नुहोस्, र तपाईंले प्रयोग गर्न सक्ने प्रदायकहरू जडान गर्नुहोस्; प्रत्येक प्रदायकले आफ्नो सीमा, उपलब्धता र सर्तहरू नियन्त्रण गर्छ।
>
> निःशुल्क तहहरू हातले थुपार्नु दुःखदायी छ — दर्जनौं SDK हरू, दर्जनौं rate limit हरू, र तपाईंसँग वास्तवमा कति छ भन्ने कुनै थाहा हुँदैन। OmniRoute ले **34 दोहोरिने pool कुञ्जीहरूमा 467 निःशुल्क-तह प्रविष्टिहरू** सूचीबद्ध गर्छ र **प्रकाशित सकारात्मक मासिक बजेट भएका 17 pool हरू प्लस पाँच प्रति-मोडेल Groq caps** बाट टोकन हेडलाइन गणना गर्छ, साझा pool अनुसार डिडुप्लिकेट गरिएको। क्षेत्रीय परिचय जाँचपछि मात्र खुल्ने कोटाहरू (आज: ModelScope) अलग देखाइन्छन्, क्षेत्रीय परिचय प्रमाणीकरण पछाडि +~6M, र कहिल्यै हेडलाइनमा समेटिँदैनन्। नतिजा ड्यासबोर्डमा (`/dashboard/free-tiers`) निरन्तर देखिरहन्छ।
> प्रत्यक्ष `/dashboard/free-tiers` पृष्ठको एनिमेटेड सारांश। पूर्ण पद्धति (pool dedupe, क्रेडिट तहहरू, प्रदायक सर्तहरू): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> यी तथ्याङ्कहरू प्रत्यक्ष सूचीविरुद्ध हरेक दुई हप्तामा पुनः-अडिट गरिन्छन् र **दुवैतिर सर्छन्** — कुनै प्रदायकले निःशुल्क तह समाप्त गर्यो भने संख्या घट्छ; नयाँ आयो भने बढ्छ। हामी सूचीले वास्तवमा गणना गरेको कुरा नै प्रकाशित गर्छौं, कहिल्यै माथि पुर्याइएको सर्वोत्तम-अनुमान होइन।
⭐ यदि OMNIROUTE ले तपाईंलाई पैसा बचत गर्न र काम सजिलो बनाउन मद्दत गर्यो भने repo लाई star दिनुहोस्।
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 समुदायमा सामेल हुनुहोस्
**👋 मर्मतकर्तालाई फलो गर्नुहोस् — नयाँ प्रदायकहरू, रिलिजहरू र सुझावहरू सबैभन्दा पहिले पाउनुहोस्:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**प्रश्नहरू, प्रदायक सुझावहरू, रोडम्याप र सहयोग → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ग्लोबल](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ब्राजिल](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [पोर्टल](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 गेटवे लगातार बढिरहेको छ
## 🆓 इन्स्टल गर्नुहोस्, प्रोभाइडर जडान गर्नुहोस्, अनि एउटै एन्डपोइन्टमार्फत राउट गर्नुहोस्
```bash
# प्रोभाइडर जडान गरेपछि, Dashboard → Endpoints बाट आफ्नो OmniRoute कुञ्जी कपी गर्नुहोस्:
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` लाई योग्य रुट चाहिन्छ। नयाँ इन्स्टलेसनमा कुनै पनि योग्य कुञ्जीविहीन लक्ष्य नहुन सक्छ, र कुञ्जीविहीन प्रोभाइडरले तेस्रो-पक्ष क्लायन्टलाई अस्वीकार गर्न सक्छ। Kiro सहित `tos: avoid` भनेर चिन्ह लगाइएका प्रोभाइडरहरू पूर्वनिर्धारित रूपमा स्वचालित राउटिङबाट बाहिर राखिन्छन्; खाता जडान गर्दा पनि त्यो सेटिङ ओभरराइड हुँदैन। प्रोभाइडर छनोट गर्नुअघि [निःशुल्क तहहरूको गाइड](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्।📦 **Python, Node.js, PHP, र cURL** का लागि कपी-पेस्ट क्विकस्टार्ट स्क्रिप्टहरू → [`examples/quickstart/`](examples/quickstart/)
# 💥 प्रतिज्ञा
# 🤔 किन OmniRoute?
## 🤝 हाम्रा खुला स्रोतका साथीहरूद्वारा समर्थित
> **खुला स्रोत साथीको रूपमा सामेल हुन चाहनुहुन्छ?** यी ती कम्पनीहरू हुन् जसले खुला स्रोतलाई समर्थन गर्छन् र OmniRoute लाई चलायमान राख्न मद्दत गर्छन् — र हामी सार्वजनिक रूपमा उनीहरूले हामीलाई दिएको प्रत्येक टोकन कहाँ जान्छ भनी बताउँछौं। सम्पर्क गर्नुहोस्: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
यस परियोजनालाई समर्थन गरेकोमा हाम्रा संस्थापक खुला स्रोत साथी Kimi (Moonshot AI) लाई धन्यवाद! Kimi खुला-वजन K2 र K3 मोडेल परिवारहरू पछाडिको AI प्रयोगशाला हो — Kimi K3 ले 1M-टोकन सन्दर्भ विन्डो, नेटिभ भिजन र फ्रन्टियर-स्तरको कोडिङ बन्द-मोडेल मूल्यको एक अंशमा प्रदान गर्दछ, र Claude Code, Codex र OmniRoute ले सेवा गर्ने हरेक कोडिङ उपकरणसँग बक्स बाहिर काम गर्दछ।
Kimi को समर्थनले के शक्ति दिन्छ: Kimi को API क्रेडिटहरूले OmniRoute को AI-प्रमाणित रिलीज पाइपलाइनलाई शक्ति दिन्छ — प्रत्येक पुल अनुरोधलाई शिप गर्नु अघि समीक्षा गर्ने Kimi K3 द्वारा संचालित मर्ज प्रमाणीकरण चरण — साथै दैनिक सुविधा विकास। पहिलो-कक्षा Kimi समर्थन दुवै रेलहरूमा पठाइन्छ: प्रत्यक्ष Kimi API (kimi-k3) र Kimi Code कोडिङ योजना (OAuth र API कुञ्जी)। OmniRoute Kimi को समर्थन कार्यक्रममा पहिलो ब्राजिलियन खुला-स्रोत परियोजना पनि हो। 15% अतिरिक्त क्रेडिटको साथ Kimi API कुञ्जी प्राप्त गर्नुहोस् →
Cheaper Inference cheaperinference.com
यस परियोजनालाई समर्थन गरेकोमा OmniRoute खुला स्रोत साथी Cheaper Inference लाई धन्यवाद! Cheaper Inference एक लागत-रैंक गरिएको गेटवे हो जसले 42 फ्रन्टियर मोडेलहरू — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok र MiniMax — एक OpenAI-अनुकूल एन्डपोइन्ट पछाडि पुनर्विक्रय गर्दछ, प्रत्येक अनुरोधलाई सबैभन्दा सस्तो योग्य प्रदायकमा रुट गर्दै मोडेल निर्माताको सूची मूल्य भन्दा माथि कहिल्यै शुल्क नलिई।
OmniRoute मा पहिलो-कक्षा समर्थन: च्याट पूरा, नेटिभ /v1/responses एन्डपोइन्ट, भिजन, उपकरण कलिङ र 3 छवि मोडेलहरू (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> को रूपमा पहुँचयोग्य)। API कुञ्जी प्राप्त गर्नुहोस् →
लिङ्कहरू ट्याग गरिएका aff=omniroute साझेदार लिङ्कहरू हुन्। तिनीहरूले तपाईंलाई कुनै अतिरिक्त लागत बिना परियोजनालाई कोष दिन्छन्। 🎟️ सम्बद्ध प्रचार — हामीले प्रायोजन नगर्ने प्रदायकहरूबाट निःशुल्क साइनअप कुपनहरू (विस्तार गर्न क्लिक गर्नुहोस्)यो खण्ड रेफरल/कुपन कोडहरूको लागि मात्र हो। प्रायोजित साझेदारीहरू माथिको 🤝 हाम्रा खुला स्रोतका साथीहरूद्वारा समर्थित मा छन्। OmniRoute को यहाँ सूचीबद्ध प्रदायकहरूसँग कुनै प्रायोजन वा साझेदारी छैन — यी सार्वजनिक कुपनहरू हुन् जुन कसैले पनि प्रयोग गर्न सक्छ।
AgentRouter agentrouter.org
AgentRouter — सम्बद्ध साइनअप · साइनअपमा $100 निःशुल्क क्रेडिट (निःशुल्क सर्भर, उच्च विलम्बताको अपेक्षा गर्नुहोस् — परीक्षणको लागि उत्तम, उत्पादनको लागि होइन)। OmniRoute मा v3.8.50 देखि पहिलो-कक्षा समर्थन: च्याट पूरा, Anthropic-अनुकूल तार ढाँचा र OpenAI-अनुकूल मार्ग। उपलब्ध मोडेलहरूमा claude-opus-4-8, claude-opus-5, gpt-5.6-sol र थप समावेश छन्। आफ्नो $100 प्राप्त गर्नुहोस् →
⚠️ सम्बद्ध लिङ्क — OmniRoute को यस प्रदायकसँग कुनै प्रायोजन वा साझेदारी छैन।
OmniRoute प्रयोगकर्ताहरूलाई फाइदा पुग्ने उदार निःशुल्क साइनअप कुपन भएको अर्को प्रदायक थाहा छ? एउटा मुद्दा खोल्नुहोस् र हामी यसलाई यहाँ थप्नेछौं।
## 🎯 कम्बोहरू — प्रमुख विशेषता
> **कम्बो** भनेको OmniRoute ले **स्वचालित रूपमा** राउट गर्ने मोडेलहरूको शृङ्खला हो। कोटा सकिएमा, प्रदायक असफल भएमा वा लागत आकस्मिक रूपमा बढेमा, कम्बो अर्को योग्य र स्वस्थ मोडेलमा जान सक्छ। 🛡️
### ⚡ शून्य-कन्फिगरेसन — केवल `auto` प्रयोग गर्नुहोस्
कम्बो सिर्जना गर्नुपर्दैन। आफ्नो मोडेललाई `auto` (वा यसको कुनै भेरियन्ट) मा सेट गर्नुहोस् र OmniRoute ले तपाईंका जडान गरिएका प्रदायकहरूबाट प्रत्यक्ष रूपमा स्कोर गरिएको भर्चुअल कम्बो बनाउँछ:
मोडेल ID
यसले केका लागि अनुकूलन गर्छ
auto
🎯 सन्तुलित पूर्वनिर्धारित (LKGP — तपाईंको पछिल्लो राम्रो प्रदायकमै कायम रहन्छ)
auto/coding
🧑💻 कोड उत्पादनका लागि गुणस्तर-प्रथम भारहरू
auto/fast
⚡ सबैभन्दा कम विलम्बता पहिले
auto/cheap
💰 प्रति टोकन सबैभन्दा सस्तो पहिले
auto/subscription
🎟️ तपाईंले पहिले नै भुक्तानी गरिरहनुभएको सदस्यता कोटा मात्र — बन्द अवस्थामै असफल हुन्छ, कहिल्यै बिल लाग्ने फलब्याक प्रयोग गर्दैन (मार्गदर्शिका)
auto/thrifty
🪜 पहिले योजनाको कोटा, त्यसपछि एक-एक तह गर्दै सबैभन्दा सस्ता सशुल्क विकल्पहरूमा — योजना रिसेट भएपछि पुनः योजनामै फर्कन्छ (मार्गदर्शिका)
auto/offline
🔋 सबैभन्दा धेरै कोटा / दर-सीमा हेडरुम पहिले
auto/smart
🔭 अझ राम्रा मोडेलहरू पत्ता लगाउन गुणस्तर-प्रथम + १०% अन्वेषण
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.53** का हालिया मुख्य आकर्षणहरू। पूरा इतिहास [`CHANGELOG.md`](CHANGELOG.md) मा हेर्नुहोस्।
- **⚖️ `quota-weighted` रूटिङ** — २०औँ कम्बो रणनीतिले सकिइसकेका खाताहरू छोड्छ, त्यसपछि बाँकी कोटा ÷ इन-फ्लाइट लोडको अनुपातमा बाँकीहरूमध्येबाट छान्छ, चलिरहेका कुराकानीहरूलाई पिन गरिएकै राख्दै। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 हेडलेस मोड** — `omniroute serve --headless` (वा `OMNIROUTE_HEADLESS=1`) ले केवल `/v1/*` प्रोक्सी इन्जिन चलाउँछ, ड्यासबोर्ड र ड्यासबोर्ड-मात्र सबसिस्टमहरू बन्द रहन्छन्। → [हेडलेस मोड](docs/guides/HEADLESS.md)
- **🔎 मोडेल खोजी** — `/v1/models` ले क्षमता, सन्दर्भ, प्रकार र पाठअनुसार फिल्टर गर्छ, र `POST /v1/models/query` ले उही प्रति-कुञ्जी दृश्यतासहित छोटो निर्णायक सूची फर्काउँछ। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🔑 प्रति-कुञ्जी रूटिङ नियन्त्रण** — `forcedModel` सँग एउटा API कुञ्जीलाई एउटै मोडेल वा कम्बोमा पिन गर्नुहोस्, र कुञ्जीका मोडेल तथा कम्बोहरू एटोमिक रूपमा थप्नुहोस् वा हटाउनुहोस् (`/api/keys/{id}/access`)। → [API सन्दर्भ](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ सूक्ष्म PII नियन्त्रणहरू** — प्रकार-अनुसार छनोट, २० सम्म मान्य कस्टम मास्किङ ढाँचाहरू र प्रकार-अनुसार पत्ता लगाउने काउन्टरहरू; मास्किङ आफैँ opt-in नै रहन्छ। → [गार्डरेलहरू](docs/security/GUARDRAILS.md)
- **🌍 ६७ भाषाहरू** — ड्यासबोर्ड, डक्स मिररहरू र CLI, जसमा `npm run i18n:add-locale` ले एउटै कमान्डमा सबैतिर भाषा थप्छ। → [i18n गाइड](docs/guides/I18N.md)
- **🎛️ OmniConductor** — तपाईंको एजेन्ट फ्लिटतिर इनबाउन्ड A2A डेलिगेसन, Agent Card मा Conductor स्किलहरू, र Faro पुश-टु-टक भ्वाइस च्याटसहितको ड्यासबोर्ड प्यानल। → [A2A सर्भर](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूलनशील भर्ना र ओभरलोड सुरक्षा** — हेभीवेट च्याट अनुरोधहरू 503 फर्काउनुको सट्टा कतारमा बस्छन्, प्रति कनेक्सन एटोमिक RPM रोलिङ लिजहरूसहित। → [रिजिलियन्स गाइड](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ क्यानोनिकल `/v1/models` क्रम** — प्रति प्रोभाइडर एउटा निरन्तर प्रोभाइडर-समूहित ब्लक (कम्बोहरू पहिले पिन गरिएका), हरेक क्याटालग स्रोतमा स्थिर। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🗜️ कम्प्रेसन कठोरकरण** — डिफल्ट-अन इन्फ्लेसन गार्ड, DE / FR / JA + चाइनिज (wényán) का लागि Caveman प्याकहरू, Gradle र .NET का लागि RTK फिल्टरहरू। → [कम्प्रेसन](docs/compression/COMPRESSION_ENGINES.md)
- **💸 इमानदार फ्ल्याट-रेट लागत** — सब्सक्रिप्सन / कोडिङ-प्लान प्रोभाइडरहरू लागत एनालिटिक्समा **$0** देखिन्छन्; बजेट, कोटा र रूटिङले अनुमान गर्न जारी राख्छन्। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **⚖️ कोटा-शेयर रूटिङ** — साझा खाताको कोटालाई पुल गरिएका कुञ्जीहरूमा निष्पक्ष रूपमा बाँड्नुहोस्, work-conserving भएकाले निष्क्रिय स्लाइसहरू अरूलाई दिइन्छ। → [रिजिलियन्स गाइड](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एक-कमान्ड CLI/एजेन्ट सेटअप** — १५ दर्ता गरिएका `setup-*` कमान्डहरू; `omniroute run` ले ७ CLIहरू लन्च गर्छ (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` ले अन्तरक्रियात्मक प्रोभाइडर+मोडेल छनोटकर्ता र प्रति-सन्दर्भ मनपर्नेहरूसहित ११ लक्ष्यहरू समर्थन गर्छ। → [CLI इन्टिग्रेसनहरू](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ रिमोट मोड** — स्कोप गरिएका टोकनहरू (`connect` / `contexts` / `tokens`) सँग रिमोट OmniRoute चलाउनुहोस् + VPS इन्स्टलहरूका लागि `antigravity` OAuth हेल्पर। → [रिमोट मोड](docs/guides/REMOTE-MODE.md)
- **🧭 स्मार्ट अटो-रूटिङ** — `auto/:` कम्बोहरू, **Fusion** (मोडेल प्यानल + जज), कार्य-सचेत रूटिङ, प्रति-अनुरोध मोडेल / मोड / USD-बजेट ओभरराइडहरू। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ प्लग गर्न मिल्ने कम्प्रेसन** — १२ कम्पोज गर्न मिल्ने इन्जिनहरू + Compression Studios: LLMLingua-2, दुई-तहको Ultra, omniglyph, प्रति-चरण फिडेलिटी गेट, GCF v3.2, ड्र्याग-रिअर्डर सम्पादक। → [कम्प्रेसन](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ पारदर्शी MITM डिक्रिप्ट (TPROXY)** — प्रोक्सी env भेरिएबलहरू बेवास्ता गर्ने CLIहरू क्याप्चर गर्नुहोस्, प्रति-SNI CA + ट्रस्ट-स्टोर इन्स्टलरसहित। → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 जहाँततै लागत टेलीमेट्री** — हरेक एन्डपोइन्टमा `X-OmniRoute-*` लागत/प्रयोग हेडरहरू, cache-HIT बचत हेडर, प्रति-कुञ्जी USD खर्च कोटाहरू। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🧠 तपाईंको नियन्त्रणमा रहेको मेमोरी** — डिफल्ट रूपमा बन्द, opt-in int8 भेक्टर क्वान्टाइजेसन + टाइप गरिएको डिके, प्रति-अनुरोध `x-omniroute-no-memory`। → [मेमोरी](docs/frameworks/MEMORY.md)
- **🛡️ सुरक्षा** — हरेक LLM रूटमा प्रम्प्ट-इन्जेक्सन गार्ड (रेड-टिम सुइट), opt-in क्रेडेन्सियल-मास्किङ गार्डरेल (दुवै दिशामा चुहिएका API कुञ्जी/गोप्यहरू मेटाउँछ), निःशुल्क DuckDuckGo अन्तिम-उपाय वेब खोज, र ड्यासबोर्डका लागि वैकल्पिक OIDC लगइन गेट (पासवर्ड लगइन सधैँ उपलब्ध नै रहन्छ)। → [गार्डरेलहरू](docs/security/GUARDRAILS.md)
- **🖼️ नयाँ एन्डपोइन्टहरू** — `/v1/ocr` (Mistral OCR) र `/v1/audio/translations` (Whisper-शैली) ले मिडिया सतहलाई पूर्ण बनाउँछन्। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🎨 इमेज / भिडियो / अडियो जेनेरेसन** — मिडियाका लागि एउटै API: xAI Grok Imagine र Novita AI भिडियो, ComfyUI, Magnific, Adobe Firefly, Segmind, र ElevenLabs जस्ता स्पिच प्रोभाइडरहरू। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🌍 डिप्लयमेन्ट र अप्स** — रिभर्स-प्रोक्सी `basePath`, ब्राउजर-भाषा स्वतः-पत्ता लगाउने, प्रति-कुञ्जी डिभाइस ट्र्याकिङ, root-less MITM ट्रस्ट, zh-TW स्थानीयकरण। → [वातावरण](docs/reference/ENVIRONMENT.md)
- **🤝 थप प्रोभाइडर र एजेन्टहरू** — क्लाउड एजेन्टहरू (Codex Cloud, Cursor, Devin, Jules), ब्राउजर + OAuth लगइनसहित Grok Build (xAI), Ollama फर्स्ट-क्लास कार्ड, Claude Opus 5 र Sonnet 5, Kimi आधिकारिक साझेदारी (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… र नवीकरण गरिएको **375-प्रोभाइडर क्याटालग**। → [प्रोभाइडरहरू](docs/reference/PROVIDER_REFERENCE.md)
- **📡 रूटिङ पारदर्शिता** — हरेक प्रतिक्रियामा सेवा दिने रणनीति/प्रोभाइडर/लेटेन्सीको नाम बताउने `X-OmniRoute-Decision` हेडर हुन्छ, नयाँ `cache-optimized` कम्बो रणनीति + Auto-Combo `cacheAffinity` फ्याक्टरले दोहोरिने अनुरोधहरूलाई क्यास गरिएको प्रिफिक्स राखेको कनेक्सनतिर फर्काउँछ, र रिड-ओनली `/v1/auto-combo/{channel}/candidates` एन्डपोइन्टले `auto/*` च्यानलको लाइभ उम्मेदवार पुल देखाउँछ। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ स्थानीय कार्यसम्पादन र पूर्वाधार** — एक-क्लिक स्थानीय Redis, Cloudflare Workers / Deno Deploy रिले डिप्लोयरहरू, सुपरभाइज्ड इम्बेडेड सेवाहरूका रूपमा Bifrost र Mux। → [इम्बेडेड सेवाहरू](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 बक्सभित्र अरू के छ** — प्लगइन फ्रेमवर्क + मार्केटप्लेस, Omni/Agent/GitHub स्किल फ्रेमवर्कहरू, Obsidian भल्ट एकीकरण (22 MCP उपकरणहरू), OpenAI-संगत Batch र Files API हरू, सिमान्टिक प्रतिक्रिया क्यास, लिडरबोर्डसहित गेमिफिकेसन, ACP एजेन्ट खोजी (15 बिल्ट-इन एजेन्टहरू), BigQuery मा निर्धारित लग निर्यात, `auto/chaos` समानान्तर बहु-मोडेल फ्यान-आउट, Telegram बोट ब्रिज, इन-एप संस्करण व्यवस्थापक र LMArena-ELO निःशुल्क-प्रदायक श्रेणीकरण। → [डक्स](docs/README.md)
## 🤖 अनुकूल CLI हरू र कोडिङ एजेन्टहरू
> एउटै कन्फिग — `http://localhost:20128/v1` — र **हरेक** AI IDE वा CLI निःशुल्क तथा कम लागतका मोडेलहरूमा चल्छ।
**एउटै आदेशबाट OmniRoute मार्फत कुनै पनि समर्थित CLI सुरु गर्नुहोस्** — कुनै कन्फिगरेसन फाइल लेखिँदैन,
प्रत्येक प्रक्रियामा क्रेडेन्सियलहरू इन्जेक्ट गरिन्छन्, र Qwen/Gemini ले अस्थायी पृथक होम पाउँछन्:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# वा अन्तरक्रियात्मक रूपमा प्रदायक+मोडेल छान्नुहोस् र उपकरणकै कन्फिगरेसन लेख्नुहोस्:
omniroute configure codex # यी पनि: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
प्रत्येक आदेशले सक्रिय रिमोट कन्टेक्स्ट (`omniroute connect `) पालना गर्छ, `--dry-run` ले
कार्यान्वयन नगरी ठ्याक्कै प्रयोग हुने env/args को पूर्वावलोकन देखाउँछ, र `--api-key-env NAME` ले गोप्य जानकारीलाई
तपाईंको शेल इतिहासबाट बाहिर राख्छ। → [CLI एकीकरणहरू](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 AI प्रोभाइडरहरू — 153 क्याटलग-चिन्ह लगाइएका निःशुल्क
> **375 दर्ता गरिएका प्रोभाइडरहरू** canonical chat, media, search, local, cloud-agent र system कलेक्सनहरूमा, जसमध्ये **153 ले `hasFree: true` डिस्कभरी मेटाडाटा बोकेका छन्**। च्याट मोडेल रेजिस्ट्रीले **239 प्रोभाइडरहरू / 3,059 फरक प्रोभाइडर-मोडेल जोडाहरू / 1,475 कच्चा मोडेल ID हरू** समेट्छ; छुट्टै निःशुल्क-बजेट क्याटलगमा **467 प्रति-मोडेल पङ्क्तिहरू**, **34 दोहोरिने पुलहरू** र **51 दोहोरिने/कीलेस सधैं-निःशुल्क प्रोभाइडरहरू** छन्। यी डिजाइनअनुसार नै फरक हरहरू हुन्; परिभाषाहरू र पुल-डिड्युप गरिएका गणनाहरू [प्रोभाइडर सन्दर्भ](docs/reference/PROVIDER_REFERENCE.md) र [निःशुल्क तहहरू](docs/reference/FREE_TIERS.md) मा छन्।
### 🏢 हरेक प्रमुख प्रयोगशाला — एउटै एन्डपोइन्टमार्फत
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…र 350+ थप — हरेक आइकन ड्यासबोर्डको प्रोभाइडर क्याटलगबाट लाइभ रिजोल्भ हुन्छ। 📖 [प्रोभाइडर सन्दर्भ](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 सधैं निःशुल्क — $0, कुनै कार्ड चाहिँदैन
OpenCode Zen DeepSeek V4, Nemotron 3 टोकन सीमा छैन
Kilo Code Auto-router, 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)
### 🧩 नयाँ: VS Code को नेटिभ Copilot Chat भित्र OmniRoute
> कुनै नयाँ साइडबार छैन, कुनै नयाँ च्याट UI छैन — OmniRoute ले उपलब्ध गराउने प्रत्येक मोडेल
> **तपाईंले पहिल्यै प्रयोग गर्ने Copilot Chat मोडेल पिकरमै** देखिन्छ। VS Code 1.122 देखि, प्रोभाइडर मोडेलहरू
> GitHub साइन-इन वा Copilot सदस्यताबिना नै काम गर्छन् — एजेन्ट मोड, टुल कलिङ र भिजन,
> निःशुल्क।
**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** एक्सटेन्सन इन्स्टल गर्नुहोस्, यसलाई
तपाईंको OmniRoute सर्भरतर्फ लक्षित गर्नुहोस् (पूर्वनिर्धारित रूपमा `localhost:20128`), त्यसपछि Copilot Chat → मोडेल पिकर
→ **मोडेलहरू व्यवस्थापन गर्नुहोस्…** → **OmniRoute** खोल्नुहोस्।
एडिटरभित्रबाट: **Extensions** भ्यु खोल्नुहोस्, **"OmniRoute"** खोज्नुहोस्, **Install** मा क्लिक गर्नुहोस्
— दुवै स्टोरमा उही तरिकाले काम गर्छ। स्रोत, इस्युहरू र प्रकाशन रनबुक
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) मा उपलब्ध छन्।
📖 [VS Code Copilot Chat मार्गदर्शिका](docs/guides/VSCODE-COPILOT.md) — सेटअप, पिकरले के देखाउँछ, ट्याबभित्रको ड्यासबोर्ड, समस्या समाधान
### 🎩 नयाँ: OmniRouteTray — मेनु बारमै रहने तपाईंको गेटवे
> `omniroute serve` सधैँ चालु हुँदा सबैभन्दा राम्रोसँग काम गर्छ। **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> ले यसलाई macOS का लागि एकपटक सेट गरेर बिर्सन मिल्ने मेनु-बार एपमा रूपान्तरण गर्छ: यसले सर्भर सुरु गर्छ, रिबुटपछि पनि
> चालु राख्छ, त्यहीँ अपडेट गर्छ, र तपाईंको लाइभ टोकन बजेटलाई एक क्लिकको दूरीमा राख्छ — **कुनै
> टर्मिनल विन्डो खुला छोड्नु पर्दैन, `npm install -g omniroute` को रेखदेख गर्नु पर्दैन।**
[Tauri v2](https://v2.tauri.app/) प्रयोग गरेर निर्मित (राउन्डिङ त्रुटिजत्तिकै सानो Rust कोर), यसले
आफ्नै हस्ताक्षरित Node 24 रनटाइम समावेश गर्छ र एपको स्वामित्वमा रहेको OmniRoute इन्स्टल व्यवस्थापन गर्छ, त्यसैले यसले तपाईंको
ग्लोबल `node`/`bun` सँग कहिल्यै द्वन्द्व गर्दैन। यसले **तपाईंको विद्यमान `~/.omniroute/` कन्फिग र डेटाबेस साझा गर्छ** — त्यसैले यो
तपाईंले पहिल्यै चलाइरहनुभएको उही OmniRoute हो, केवल टोपी लगाएको। 🎩
यसले के गर्छ
कसरी
🟢 सर्भरको सुपरिवेक्षण गर्छ
omniroute serve सुरु गर्छ, प्रतिलिपि बनाउनुको सट्टा पहिल्यै चलिरहेको इन्स्ट्यान्स अपनाउँछ
📊 एकै नजरमा लाइभ प्रयोग
प्रोभाइडर कोटा बारहरू, रिसेट काउन्टडाउनसहित Claude का सेसन/साप्ताहिक सीमाहरू, 30-दिने लागत विवरण
```sh
brew install --cask zoispag/tap/omniroute-tray
```
डाउनलोड गर्न रुचाउनुहुन्छ? नवीनतम .dmgरिलिजहरूबाट प्राप्त गर्नुहोस्। स्रोत, समस्याहरू र बिल्डसम्बन्धी
कागजातहरू zoispag/omniroute-tray मा उपलब्ध छन्।
💛 @zoispag द्वारा निर्मित सामुदायिक परियोजना — यो आधिकारिक OmniRoute रिलिज होइन।
> सर्भरभन्दा पर, OmniRoute **80+ कमान्डहरू** भएको **पूर्ण कमान्ड-लाइन ककपिट** हो, साथै यसमा खुला एजेन्ट प्रोटोकलहरू छन् जसले गर्दा AI एजेन्टले यसलाई **आफैं** सञ्चालन गर्न सक्छ।
### ⌨️ वास्तविक CLI (`start` मात्र होइन)
```bash
omniroute # गेटवे + ड्यासबोर्ड सञ्चालन गर्नुहोस् (पोर्ट 20128)
omniroute chat # अन्तरक्रियात्मक TUI च्याट क्लाइन्ट (स्ल्यास: /model /combo /skill /memory)
omniroute setup # निर्देशित पहिलो-पटकको विजार्ड
omniroute doctor # प्रदायकहरू, पोर्टहरू र नेटिभ निर्भरताहरूको निदान गर्नुहोस्
```
### 🛰️ रिमोट मोड — CLI यहाँ चलाउनुहोस्, OmniRoute VPS मा
OmniRoute सर्भरमा छ? **उही CLI** प्रयोग गरेर आफ्नो ल्यापटपबाट यसलाई सञ्चालन गर्नुहोस्। सीमित दायराको पहुँच टोकनमार्फत एकपटक लगइन गर्नुहोस्;
त्यसपछि प्रत्येक कमान्ड रिमोटतर्फ लक्षित हुन्छ।
```bash
omniroute connect 192.168.0.15 # पासवर्ड → सीमित दायराको टोकन, कन्टेक्स्टका रूपमा सुरक्षित
omniroute models # ← रिमोट सर्भरविरुद्ध चल्छ
omniroute configure codex # ← रिमोट मोडेल छान्छ, स्थानीय Codex प्रोफाइल लेख्छ
omniroute tokens create --name ci --scope read # अन्य मेसिनहरूका लागि अझ साँघुरो दायराका टोकनहरू सिर्जना गर्छ
omniroute contexts use default # ← स्थानीय सर्भरमा फर्किन्छ
```
टोकनहरू `read` / `write` / `admin` दायरामा सीमित हुन्छन्; प्रक्रिया सुरु गर्ने रुटहरू लुपब्याकमा मात्र सीमित रहन्छन्।
📖 [रिमोट मोड](docs/guides/REMOTE-MODE.md)
### 🤝 एजेन्ट जडान गर्नुहोस् — र त्यसले OmniRoute लाई आफैं नियन्त्रण गर्छ
OmniRoute लाई **MCP**, **A2A**, **REST API**, **वेबहुकहरू** वा **रिमोट CLI** मार्फत उपलब्ध गराउनुहोस् — कुनै पनि सक्षम एजेन्टले (वा तपाईंको आफ्नै कोडले) सम्पूर्ण गेटवेको नियन्त्रण पाउँछ: राउटिङ, प्रदायकहरू, कम्बोहरू, क्यास, कम्प्रेसन, मेमोरी — स्वायत्त रूपमा। तलका HTTP इन्डपोइन्टहरू `http://localhost:20128` अन्तर्गत उपलब्ध गराइन्छन्।
इन्टरफेस
इन्डपोइन्ट / कमान्ड
यसका लागि प्रयोग गर्नुहोस्
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor वा कुनै पनि MCP क्लाइन्टमा जडान गर्नुहोस्
अनुरोध / कोटा इभेन्टहरू Slack, Discord, Telegram वा कुनै पनि URL मा पठाउनुहोस्
🛰️ रिमोट CLI
omniroute connect
सीमित दायराका पहुँच टोकनहरूमार्फत रिमोट इन्स्ट्यान्स सञ्चालन गर्नुहोस्
```bash
# Claude Code लाई MCP मार्फत पूर्ण OmniRoute उपकरणसेट दिनुहोस्:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP सर्भर](docs/frameworks/MCP-SERVER.md) · [A2A सर्भर](docs/frameworks/A2A-SERVER.md) · [एजेन्ट प्रोटोकलहरू](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 15–95% टोकन बचत गर्नुहोस् — स्वचालित रूपमा
### 📖 यसले कसरी काम गर्छ — पाइपलाइन, आर्किटेक्चर र बचतको गणित
पूर्वनिर्धारित स्ट्याक गरिएको कम्बो `RTK → Caveman` चल्छ। जब दुवैले एउटै टुल/कन्टेक्स्ट पेलोडमा काम गर्छन्, बचतहरू चक्रवृद्धि हुन्छन्:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लकहरू, URL हरू, JSON र संरचित डेटा संरक्षण इन्जिनद्वारा **सधैँ सुरक्षित** हुन्छन्।
> **थोरै टोकनले नै काम चल्छ भने धेरै टोकन किन प्रयोग गर्ने?** प्रत्येक अनुरोध OmniRoute को कम्प्रेसन पाइपलाइन भएर **पारदर्शी रूपमा** जान्छ — क्लायन्टमा कुनै परिवर्तन चाहिँदैन। यो अब क्रमानुसार चल्ने र राउटिङ कम्बोअनुसार मिक्स-एन्ड-म्याच गर्न मिल्ने **12 कम्पोजेबल इन्जिनहरूको स्ट्याक** हो — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), र [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) का विचारहरूमा आधारित।
### 🧱 12-इन्जिन स्ट्याक
इन्जिनहरू पाइपलाइन क्रममा चल्छन्; प्रत्येक स्वतन्त्र रूपमा टगल गर्न मिल्ने र कम्बोअनुसार कन्फिगर गर्न मिल्ने हुन्छ:
प्रत्यक्ष Anthropic वायरमा नापिएको Claude Fable 5 का लागि प्रयोगात्मक कन्टेक्स्ट-लाई-तस्बिर इन्कोडिङ; GPT 5.6 ट्रान्सफर्मरहरू प्रोभाइडर रसिद नआउञ्जेल fail-closed नै रहन्छन्। चार कम्प्रेसन प्रोफाइलहरू (aggressive default, balanced, coding-safe, passthrough) (सबैभन्दा आक्रामक; opt-in)
कोड ब्लकहरू, URL हरू र संरचित डेटा **सधैँ** बाइट-पर्फेक्ट **संरक्षित** हुन्छन्। **एक-क्लिक प्रिसेटहरू** ले इन्जिनहरू संयोजन गर्छन्:
मोड
बचत
किनका लागि उपयुक्त
🪶 Lite
~15%
सधैँ-चालू सुरक्षित पूर्वनिर्धारित
🪨 Standard (Caveman)
~30%
दैनिक कोडिङ
⚡ Aggressive
~50%
लामा टुल-भारित सत्रहरू
🔥 Ultra
~75%
अधिकतम बचत
🧰 RTK
60–90%
Shell/test/build/git आउटपुट
🔗 Stacked (RTK → Caveman)
78–95%
मिश्रित प्रम्प्टहरू + टुल लगहरू
**वास्तविक उदाहरण — Standard मोड:**
> **पहिले (69 टोकन):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_
>
> **पछि (19 टोकन):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_
>
> **उही उत्तर। 72% कम टोकन। शून्य शुद्धता क्षति।** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) मोड:**
> **पहिले (42 टोकन):** _"समस्या के हो भने कम्पोनेन्ट पुनः रेन्डर भइरहेको छ किनकि प्रत्येक रेन्डर चक्रमा नयाँ अब्जेक्ट रेफरेन्स सिर्जना भइरहेको छ। म useMemo प्रयोग गर्ने सिफारिस गर्छु।"_
>
> **पछि (12 टोकन):** _"पुनः रेन्डर: प्रत्येक चक्रमा नयाँ ref (inline अब्जेक्ट पुनः सिर्जित)। `useMemo` प्रयोग गर्नुहोस्।"_
>
> **उही उत्तर। ~70% कम टोकन। प्राविधिक शुद्धता अक्षत।** ✅
### 🎚️ इन्जिनहरूभन्दा बाहिर — आउटपुट शैलीहरू, अनुकूलन डायल र प्रति-अनुरोध नियन्त्रण
माथिका 12 इन्जिनहरूले **भित्र** जाने कुरा सानो बनाउँछन्। थप तीन तहले **कसरी**, **कहिले**, र **बाहिर** के आउँछ भन्ने कुरा आकार दिन्छन्:
- **🪄 आउटपुट शैलीहरू** _(आउटपुट-अक्ष स्टीयरिङ)_ — निर्धारक, cache-सुरक्षित प्रतिक्रिया-आकार दिने निर्देशनहरू इन्जेक्ट गर्छन्; संयोजन गर्न मिल्ने, प्रत्येक `lite` / `full` / `ultra` तीव्रतामा। शैली थप्नु भनेको एक-लाइन registry प्रविष्टि मात्र हो:
- **Terse prose** — भरुवा शब्द / article / hedging हटाउँछ; प्राविधिक सारलाई यथावत राख्छ।
- **Less code** — "अल्छी senior dev" YAGNI: सबैभन्दा सानो काम गर्ने परिवर्तन, नमागिएको scaffolding छैन।
- **Ponytail (अल्छी senior dev)** — YAGNI भर्याङ चढ्ने, मूल कारण सच्याउने, सबैभन्दा सानो काम गर्ने diff।
- **I have ADHD (action-first)** — अर्को कार्य अगाडि आउँछ, चरणहरू क्रमांकित, एउटा ठोस अर्को चरण, कुनै प्रस्तावना छैन।
- **Terse CJK (文言)** — शास्त्रीय-चिनियाँ अत्यन्त संक्षिप्त शैली (`zh` मा locale-gated)।
- **🎯 अनुकूलन context-budget** _(डायल)_ — एउटै on/off टोकन threshold को सट्टा, **मोडेलको context window मा फिट गर्न** आवश्यक परेसम्म मात्र सबैभन्दा सस्ता, सबैभन्दा lossless इन्जिनहरू क्रमशः बढाउँछ। नीति: `reserve-output` (पूर्वनिर्धारित, मोडेल-सचेत) · `percentage` · `absolute`। मोड: `floor` (फिट ग्यारेन्टी) · `replace-autotrigger` (तपाईंको स्पष्ट छनोटले जित्छ) · `off` (पुरानो threshold)।
- **🎛️ कम्प्रेसन कहाँ निर्णय हुन्छ** _(प्राथमिकता, उच्च → न्यून)_ — प्रति-अनुरोध `x-omniroute-compression` header › routing-combo override › सक्रिय नामित profile › adaptive / auto-trigger › panel पूर्वनिर्धारित › off। लागू गरिएको योजना `X-OmniRoute-Compression: ; source=` प्रतिक्रिया header मा फर्केर आउँछ।
टोकन threshold द्वारा auto-trigger गर्नुहोस्, adaptive डायल खोल्नुहोस्, नामित profile पिन गर्नुहोस्, प्रति-अनुरोध एक-पटक सेट गर्नुहोस्, वा प्रत्येक routing combo मा pipeline तोक्नुहोस् — workload लाई जुन फिट हुन्छ। अप्ट-इन अफलाइन **eval harness** (`npm run eval:compression`) ले परिवर्तन promote गर्नुअघि pinned corpus मा fidelity बनाम बचतको स्कोर गर्छ।
📖 [`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 ले अनुमति नदिइएसम्म package lifecycle स्क्रिप्टहरू ब्लक गर्न सक्छ। OmniRoute को `postinstall` (`node scripts/build/postinstall.mjs`) यसको native runtime फाइलहरू तयार गर्न आवश्यक छ। ग्लोबल रूपमा इन्स्टल गर्दा npm को चेतावनीमा नाम दिइएका प्याकेजहरूलाई अनुमति दिनुहोस्। OmniRoute 3.8.53 ले रिपोर्ट गरेको प्याकेज सेटका लागि:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> भविष्यका ग्लोबल इन्स्टलहरूका लागि यो allowlist पुनः प्रयोग गर्न, एक पटक कन्फिगर गर्नुहोस्, अनि सामान्य रूपमा इन्स्टल गर्नुहोस्:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> dependency सूची रिलिजहरू बीच फेरिन सक्छ; यदि npm ले फरक सूची रिपोर्ट गर्छ भने, त्यही चेतावनीका प्याकेज नामहरू प्रयोग गर्नुहोस्। प्याकेजलाई अनुमति दिनाले यसका इन्स्टल स्क्रिप्टहरू चल्न दिन्छ।
> **Gemini Web वा अन्य web-cookie provider प्रयोग गर्दै हुनुहुन्छ?** npm प्याकेजमा
> Playwright समावेश छ तर यसको Chromium binary छैन। पहिलो web-provider अनुरोध गर्नुअघि
> [Playwright Chromium सेटअप](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> नोट हेर्नुहोस्।
ड्यासबोर्ड `http://localhost:20128` मा · API `http://localhost:20128/v1` मा।
**2) आफ्नै खाता प्रयोग गरेर योग्य provider जडान गर्नुहोस्**
ड्यासबोर्ड → **Providers** → तपाईंको प्रयोग-केससँग हालका सर्तहरू र quota फिट हुने provider छान्नुहोस् → यसको API key थप्नुहोस् वा यसको खाता प्रवाह पूरा गर्नुहोस्। निःशुल्क tier हरूमा साइनअप, स्वीकृति, वा भुक्तानी विधि आवश्यक पर्न सक्छ। [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्; keyless उपलब्धता ग्यारेन्टी छैन, र `tos: avoid` भनेर चिन्ह लगाइएका provider हरू पूर्वनिर्धारित रूपमा `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 ले तपाईंका लागि auto-route र fallback गर्छ।
यदि तपाईंको client ले कस्टम header पठाउन सक्दैन भने, OmniRoute ले tokenized compatibility alias हरू पनि दिन्छ:
```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 ...` संलग्न गर्न नसक्ने client हरूका लागि मात्र प्रयोग गर्नुहोस्। Header auth नै मन पराइएको मोड रहन्छ।
## 📦 थप स्थापना विधिहरू — Docker, स्रोत, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` ले उच्चतम **प्रकाशित** स्थिर SemVer पछ्याउँछ। यसले git `main` लाई पछ्याउँदैन। GitOps का लागि `:X.Y.Z` निश्चित गर्नुहोस्। [Docker रिलिज च्यानलहरू](docs/guides/DOCKER_GUIDE.md#release-channels) हेर्नुहोस्। इमेजले **`OMNIROUTE_MEMORY_MB=1024`** निश्चित गर्छ। यो ड्यासबोर्ड र हल्का च्याटका लागि पर्याप्त छ। **कोडिङ एजेन्टहरू** (Claude Code, Codex, Grok, … बाट `POST /v1/responses`) लाई धेरै ठूलो V8 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-मात्र प्याकेज छैन।
7,800+ ट्र्याक गरिएका परीक्षण फाइलहरूमा रहेका 56,000+ स्थिर परीक्षण घोषणाहरूका लागि परीक्षण कभरेज रणनीति
# ⭐ शीर्ष योगदानकर्ताहरू
> OmniRoute लाई उत्साही ओपन-सोर्स समुदायले आकार दिएको छ। यी व्यक्तिहरूले परियोजनाको गुणस्तर, स्थिरता र पहुँचमा प्रत्यक्ष असर पार्ने असाधारण योगदान दिएका छन्। **धन्यवाद।**
### मर्ज गरिएका पुल अनुरोधहरू अनुसार बाह्य योगदानकर्ताहरू
जनगणना 2026-10-18 15:09:09 UTC मा लाइभ release/v3.8.52 टिप 656f01cb43 साथ लिइएको। पेजिनेटेड GitHub GraphQL जनगणनामा 9,191 मर्ज गरिएका PR हरू छन्: 3,834 रिपोजिटरी मालिकद्वारा, 229 Dependabot द्वारा, 6 अन्य बोटहरू/एपहरूद्वारा, र 835 फरक योगदानकर्ताहरूबाट 5,122 बाह्य PR हरू। “परिवर्तित लाइनहरू” भनेको GitHub थपिएका + हटाइएका लाइनहरू हुन् र यसमा उत्पन्न फाइलहरू, लकफाइलहरू, क्याटालगहरू, अनुवादहरू र कागजातहरू समावेश छन्; यो चर्न हो, लेखिएको LOC होइन। 49 PR हरूमा 500,000 लाइनभन्दा माथिको GitHub डिफ रिपोर्ट गरिएको छ (उदाहरणका लागि #13399, एकल प्रदायक थप, मा 2,347 परिवर्तित फाइलहरू सूचीबद्ध छन्), जसले माथिका धेरै जम्माहरू बढाएको छ। बराबर भएकाहरूलाई सँगै श्रेणीबद्ध गरिएको छ।
### GitHub-आरोपित कमिटहरू
2026-10-18 14:44:45 UTC मा पुनः जाँच गरिएको: release/v3.8.52 पूर्वनिर्धारित शाखाका लागि रिपोजिटरी Contributors API ले रिपोर्ट गरेका GitHub-आरोपित कमिटहरू। API ले 849 परिचयहरू फर्कायो (429 प्रयोगकर्ताहरू, 2 बटहरू, 418 अज्ञात); यस तालिकामा मर्मतकर्ता, बटहरू र अज्ञात परिचयहरू बाहेकका रहेका छन् र प्रतिस्पर्धामा बराबरी (tie) भएकाहरूलाई कायम राखिएको छ। यो माथिको merged-PR र्याङ्किङ र तलको Git-metadata गणना दुवैबाट फरक छ।
> 🙏 यी योगदानकर्ताहरूका सुविधाहरू, बग सुधारहरू र पूर्वाधार सुधारहरू 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 लाई निःशुल्क र स्वतन्त्र राख्छ।
## 👥 900+ योगदानकर्ताहरू
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-10-18 मा प्रत्यक्ष release/v3.8.52 टिप ad160ab2d1 (6,826 कमिटहरू) मा लेखापरीक्षण गरिएको: 993 सामान्यीकृत मानव Git पहिचानहरू — 707 जना कमिट लेखकका रूपमा देखा पर्छन् (मर्मतकर्तासहित) र 286 जना स्पष्ट Co-authored-by ट्रेलरहरूमा मात्र देखा पर्छन्। यो गणनाले .mailmap लागू गर्छ, इ-मेल ठेगानाहरूलाई अक्षरको केसको भिन्नता नहेरी तुलना गर्छ, सङ्ख्यात्मक र सामान्य GitHub noreply ठेगानाहरूले एउटै ह्यान्डल सङ्केत गर्दा मात्र तिनलाई जोड्छ, 26 बोट/एजेन्ट/सेवा/प्लेसहोल्डर पहिचानहरूलाई हटाउँछ, र तिनका प्रदर्शन नामहरू मिलेकै कारणले मात्र सामान्य इ-मेल ठेगानाहरूलाई मर्ज गर्दैन। 2026-08-24 को लेखापरीक्षणले 639 प्रकाशित गरेको थियो; यस विधिलाई उक्त लेखापरीक्षणको आधार ac02c5b42f मा पुनः चलाउँदा 619 प्राप्त हुन्छ, त्यसैले वृद्धि खुकुलो विधिका कारण नभई नयाँ योगदानकर्ताहरूका कारण भएको हो।
### कसरी योगदान गर्ने
1. रिपोजिटरी फोर्क गर्नुहोस्
2. **सक्रिय** `release/vX.Y.Z` टिपबाट ब्रान्च बनाउनुहोस् (`main` बाट होइन) — [ब्रान्चिङ र रिलिज मोडेल](docs/ops/BRANCHING_MODEL.md) हेर्नुहोस्
3. आफ्नो फिचर ब्रान्च सिर्जना गर्नुहोस् (`git checkout -b feat/amazing-feature`)
4. आफ्ना परिवर्तनहरू कमिट गर्नुहोस् (`git commit -m 'feat: add amazing feature'`)
5. ब्रान्चमा पुश गर्नुहोस् (`git push origin feat/amazing-feature`)
6. **base = उक्त `release/vX.Y.Z` ब्रान्च** राखेर Pull Request खोल्नुहोस्
विस्तृत दिशानिर्देशहरूका लागि [CONTRIBUTING.md](CONTRIBUTING.md) हेर्नुहोस्।
### नयाँ संस्करण रिलिज गर्ने
```bash
# रिलिज सिर्जना गर्नुहोस् — npm publish स्वतः हुन्छ
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 ताराहरू
## 🌍 StarMapper
## 🙏 आभार
OmniRoute दिग्गजहरूको योगदानमा आधारित छ। यसको सुरुवात **[9router](https://github.com/decolua/9router)** को फोर्क र Go परियोजना **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** को TypeScript पोर्टका रूपमा भएको थियो — र त्यसपछि, तलका प्रत्येक उपप्रणाली यस क्षेत्रमा पहिले नै मार्ग प्रशस्त गरिसकेको कुनै खुला-स्रोत परियोजनाबाट प्रेरित भए। ती प्रत्येकले OmniRoute को कुनै ठोस अंशलाई आकार दिए। यो ती सबैप्रति हाम्रो धन्यवाद हो। 🙏
> ⭐ ताराहरूको सङ्ख्या अक्टोबर 18, 2026 मा GitHub को REST API बाट प्रमाणित गरिएको हो — यी परियोजनाहरूलाई एउटा तारा दिनुहोस्। यी सङ्ख्याहरू निश्चित मितिमा लिइएको यथार्थ स्न्यापसट हुन् र समयसँगै स्वाभाविक रूपमा परिवर्तन हुनेछन्।
### 🧬 वंशावली र गेटवे
त्यो AI गेटवे, जसको सार्वजनिक मूल्य निर्धारण डेटासेटले हाम्रो लागत-ट्र्याकिङ सिङ्कलाई डेटा दिन्छ र जसको प्रदायक-सामान्यीकरण मोडेलले हाम्रो राउटिङको स्वरूप निर्धारण गर्न सहयोग गर्यो।
स्ट्रिम पुनर्प्राप्ति, no-thinking उपनामहरू, फलब्याक वेब खोज, स्लाइडिङ-विन्डो सीमाहरू, लग सम्पादन र थप सुरक्षित बनाइएका लन्चर प्रवाहहरूमा पोर्ट गरिएका ढाँचाहरू।
यसका Grok मोडेल म्यापिङहरू, नक्कली-TypeError Statsig जेनेरेटर, अनुरोध र उपकरणका पूर्वनिर्धारित मानहरू तथा NDJSON प्रतिक्रिया प्रोसेसरलाई OmniRoute को Grok Web एक्जिक्युटरमा उल्लेखनीय रूपमा अनुकूलित गरिएको थियो।
grok2api-merged पछाडिको प्रमुख ट्रान्जिटिभ कोड स्रोत; यसका मोडेल, हेडर, पेलोड, Statsig र प्रोसेसर कार्यान्वयनहरू Grok Web वंशावलीमा सुरक्षित राखिएका छन्।
Grok पेलोड र उपकरणका पूर्वनिर्धारित मानहरू, Statsig जेनेरेटर तथा TQZHR र grok2api-merged मार्फत ल्याइएको result.response प्रोसेसरको अन्तर्निहित MIT स्रोत।
आफ्नो प्रोक्सी-पुल तहका लागि grok2api-merged ले श्रेय दिएको एउटा ट्रान्जिटिभ स्रोत; OmniRoute ले उक्त वंशावली सूचना कायम राख्छ, तर आफ्नो सीमित Grok Web एक्जिक्युटरमा प्रोक्सी-पुल पोर्ट गरेको दाबी गर्दैन।
मूल Grok Web कार्यान्वयनले यसको HTTP/ब्राउजर अपस्ट्रिम डिजाइनलाई सन्दर्भका रूपमा प्रयोग गर्यो; यसको प्रत्यक्ष HTTP मार्ग GrokProxy बाट व्युत्पन्न भएकाले कुनै स्वतन्त्र कोड पोर्टको दाबी गरिएको छैन।
चर्चित "थोरै टोकनले काम हुन्छ भने धेरै टोकन किन प्रयोग गर्ने" परियोजना — यसको गुफामानव-जस्तो बोल्ने दर्शनले हाम्रो मानक सङ्कुचन मोड र 30+ अनावश्यक शब्द हटाउने/संक्षेपण नियमहरूलाई शक्ति दिन्छ।
चर्चित "अल्छी वरिष्ठ डेभलपर" YAGNI-कोडर सीप — यसले हाम्रो कम-कोड आउटपुट शैलीलाई प्रेरित गर्यो: सबैभन्दा सानो कार्यशील परिवर्तनतर्फ निर्देशित गर्ने शैली, जसले _उत्पन्न_ कोड घटाउँछ (Caveman को संक्षिप्त गद्यको आउटपुट-अक्षीय सहोदर)।
Rust स्तम्भीय-JSON + सामग्री-ठेगानायुक्त पुनःप्राप्ति + सन्देशहरूबीचको डिडुप — यसले हाम्रो headroom/ccr/session-dedup इन्जिन डिजाइन र क्यास-स्थिर "सङ्कुचित रूप स्थानबाट स्वतन्त्र हुन्छ" भन्ने अपरिवर्तनीयतालाई मान्यता दियो।
TypeScript Compiler API टुलकिट — यसले स्ट्रिङ, टेम्प्लेट र regex लिटरलहरू सुरक्षित राख्ने हाम्रो पार्सर-आधारित टिप्पणी हटाउने प्रक्रियालाई प्रेरित गर्यो।
कोडिङ सहायक ↔ LLM ट्राफिकको MITM अवरोधन/विश्लेषणले प्रारम्भिक Traffic Inspector आवश्यकताहरू निर्धारण गर्न मद्दत गर्यो। पहिले व्युत्पन्न गरिएका चार मोड्युलहरू — SSE मर्जिङ, वार्तालाप सामान्यीकरण, गोप्य विवरण मास्किङ र हेडर सरसफाइ — लाई सार्वजनिक प्रोटोकल मानकहरूमा आधारित स्वतन्त्र क्लिन-रूम कार्यान्वयनहरूले प्रतिस्थापन गरेका छन्। दुई होस्ट-पासथ्रु सतहहरू (passthrough.ts र _internal/bypass.cjs) स्वतन्त्र रूपमा वर्गीकृत OmniRoute-आन्तरिक कार्यान्वयनकै रूपमा कायम छन्; उक्त प्रतिस्थापनको भागका रूपमा तिनलाई पुनर्लेखन गरिएको थिएन।
प्रति-प्रक्रिया पारदर्शी प्रोक्सी राउटिङ — यसले हाम्रो क्र्यास-सुरक्षित MITM टियरडाउन, सकेट निष्क्रियता टाइमआउट, /proc प्रक्रिया एट्रिब्युसन र TPROXY क्याप्चरलाई प्रेरित गर्यो।
हाम्रा सुरक्षा विकल्पहरूलाई मार्गदर्शन गर्ने पूर्वनिर्धारित रूपमै सुरक्षित लाइब्रेरीहरूको क्युरेट गरिएको सूची (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)।
Grok Build कोटा सतह पहिचान गर्यो; त्यसपछि OmniRoute ले स्वतन्त्र रूपमा लाइभ वायर ढाँचा प्रमाणीकरण र सुधार गर्यो।
## 📄 इजाजतपत्र
MIT इजाजतपत्र - विवरणका लागि [LICENSE](LICENSE) हेर्नुहोस्।
---
**[⬆ माथि फर्कनुहोस्](#-omniroute)** · खुला-स्रोत AI समुदायका लागि ❤️ सहित निर्मित।
OmniRoute v3.8.53 · Node ≥22.22.2 · MIT इजाजतपत्र · omniroute.online
> प्रत्यक्ष `/dashboard/free-tiers` पृष्ठको एनिमेटेड सारांश। पूर्ण पद्धति (pool dedupe, क्रेडिट तहहरू, प्रदायक सर्तहरू): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> यी तथ्याङ्कहरू प्रत्यक्ष सूचीविरुद्ध हरेक दुई हप्तामा पुनः-अडिट गरिन्छन् र **दुवैतिर सर्छन्** — कुनै प्रदायकले निःशुल्क तह समाप्त गर्यो भने संख्या घट्छ; नयाँ आयो भने बढ्छ। हामी सूचीले वास्तवमा गणना गरेको कुरा नै प्रकाशित गर्छौं, कहिल्यै माथि पुर्याइएको सर्वोत्तम-अनुमान होइन।
```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` लाई योग्य रुट चाहिन्छ। नयाँ इन्स्टलेसनमा कुनै पनि योग्य कुञ्जीविहीन लक्ष्य नहुन सक्छ, र कुञ्जीविहीन प्रोभाइडरले तेस्रो-पक्ष क्लायन्टलाई अस्वीकार गर्न सक्छ। Kiro सहित `tos: avoid` भनेर चिन्ह लगाइएका प्रोभाइडरहरू पूर्वनिर्धारित रूपमा स्वचालित राउटिङबाट बाहिर राखिन्छन्; खाता जडान गर्दा पनि त्यो सेटिङ ओभरराइड हुँदैन। प्रोभाइडर छनोट गर्नुअघि [निःशुल्क तहहरूको गाइड](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्।
📦 **Python, Node.js, PHP, र cURL** का लागि कपी-पेस्ट क्विकस्टार्ट स्क्रिप्टहरू → [`examples/quickstart/`](examples/quickstart/)
> **कम्बो** भनेको OmniRoute ले **स्वचालित रूपमा** राउट गर्ने मोडेलहरूको शृङ्खला हो। कोटा सकिएमा, प्रदायक असफल भएमा वा लागत आकस्मिक रूपमा बढेमा, कम्बो अर्को योग्य र स्वस्थ मोडेलमा जान सक्छ। 🛡️
### ⚡ शून्य-कन्फिगरेसन — केवल `auto` प्रयोग गर्नुहोस्
कम्बो सिर्जना गर्नुपर्दैन। आफ्नो मोडेललाई `auto` (वा यसको कुनै भेरियन्ट) मा सेट गर्नुहोस् र OmniRoute ले तपाईंका जडान गरिएका प्रदायकहरूबाट प्रत्यक्ष रूपमा स्कोर गरिएको भर्चुअल कम्बो बनाउँछ:
📖 [Auto-Combo इन्जिन](docs/routing/AUTO-COMBO.md) · [लचिलोपन मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
📊 पूर्ण कार्यविधि & 9router, OpenRouter, CLIProxyAPI & LiteLLM सँग प्रत्येक सुविधाको विस्तृत तुलना → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
कुञ्जी (यादृच्छिक): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix प्रतिलिपि गरेर टाँस्नुहोस्:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [प्राधिकरण](docs/architecture/AUTHZ_GUIDE.md) · [सुरक्षा सीमाहरू](docs/security/GUARDRAILS.md) · [अनुपालन](docs/security/COMPLIANCE.md)
पूर्वनिर्धारित स्ट्याक गरिएको कम्बो `RTK → Caveman` चल्छ। जब दुवैले एउटै टुल/कन्टेक्स्ट पेलोडमा काम गर्छन्, बचतहरू चक्रवृद्धि हुन्छन्:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लकहरू, URL हरू, JSON र संरचित डेटा संरक्षण इन्जिनद्वारा **सधैँ सुरक्षित** हुन्छन्।
> **थोरै टोकनले नै काम चल्छ भने धेरै टोकन किन प्रयोग गर्ने?** प्रत्येक अनुरोध OmniRoute को कम्प्रेसन पाइपलाइन भएर **पारदर्शी रूपमा** जान्छ — क्लायन्टमा कुनै परिवर्तन चाहिँदैन। यो अब क्रमानुसार चल्ने र राउटिङ कम्बोअनुसार मिक्स-एन्ड-म्याच गर्न मिल्ने **12 कम्पोजेबल इन्जिनहरूको स्ट्याक** हो — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), र [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) का विचारहरूमा आधारित।
### 🧱 12-इन्जिन स्ट्याक
इन्जिनहरू पाइपलाइन क्रममा चल्छन्; प्रत्येक स्वतन्त्र रूपमा टगल गर्न मिल्ने र कम्बोअनुसार कन्फिगर गर्न मिल्ने हुन्छ:
