## 💰 तेस्रो-पक्षका निःशुल्क टियरहरूबाट प्रति महिना ~1.62B टोकन
> **आफ्नै प्रदायक खाताहरू ल्याउनुहोस्।** यो छुट्टाछुट्टै रूपमा योग्य तेस्रो-पक्षका निःशुल्क टियरहरूको अनुमानित कुल हो, OmniRoute बाट प्रदान गरिएको टोकन अनुदान होइन। साइन अप गर्नुहोस्, आवश्यक ठाउँमा प्रमाणपत्रहरू प्राप्त गर्नुहोस्, र आफूले प्रयोग गर्न सक्ने प्रदायकहरू जडान गर्नुहोस्; प्रत्येक प्रदायकले आफ्ना सीमा, उपलब्धता र सर्तहरू नियन्त्रण गर्छ।
>
> निःशुल्क टियरहरू हातैले एकत्रित गर्नु झन्झटिलो हुन्छ — दर्जनौँ SDK, दर्जनौँ दर सीमा, र तपाईंसँग वास्तवमा कति उपलब्ध छ भन्ने कुनै जानकारी हुँदैन। OmniRoute ले **35 पुनरावर्ती पूल कुञ्जीहरूमा 489 निःशुल्क-टियर प्रविष्टिहरू** सूचीकृत गर्छ र साझा पूलअनुसार दोहोरिएका प्रविष्टिहरू हटाउँदै, **प्रकाशित सकारात्मक मासिक बजेट भएका 17 पूलहरू र प्रति-मोडेल पाँच Groq सीमाहरूबाट** मुख्य टोकन सङ्ख्या गणना गर्छ। क्षेत्रीय पहिचान जाँचपछि मात्र खुल्ने कोटाहरू (हाल: ModelScope) अलग्गै देखाइन्छन्—क्षेत्रीय पहिचान प्रमाणीकरणपछि +~6M—र तिनलाई मुख्य सङ्ख्यामा कहिल्यै जोडिँदैन। परिणाम ड्यासबोर्डमा (`/dashboard/free-tiers`) देखिइरहन्छ।
> प्रत्यक्ष `/dashboard/free-tiers` पृष्ठको एनिमेटेड सारांश। पूर्ण कार्यविधि (पूलका दोहोरिएका प्रविष्टि हटाउने प्रक्रिया, क्रेडिट टियरहरू, प्रदायकका सर्तहरू): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> यी आँकडाहरू प्रत्यक्ष सूचीसँग तुलना गरी प्रत्येक दुई हप्तामा पुनः लेखापरीक्षण गरिन्छन् र **दुवै दिशामा परिवर्तन हुन्छन्** — कुनै प्रदायकले निःशुल्क टियर बन्द गरे सङ्ख्या घट्छ; नयाँ टियर थपिए सङ्ख्या बढ्छ। हामी सूचीले वास्तवमै गणना गरेको आँकडा प्रकाशित गर्छौँ, माथितिर पूर्णाङ्कित गरिएको उत्कृष्ट सम्भावित अवस्था कहिल्यै होइन।
⭐ OMNIROUTE ले तपाईंलाई पैसा बचत गर्न र काम सजिलो बनाउन मद्दत गरेको छ भने रिपोजिटरीमा स्टार दिनुहोस्।
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 समुदायमा सामेल हुनुहोस्
**👋 मर्मतकर्तालाई फलो गर्नुहोस् — नयाँ प्रदायक, रिलिज र सुझावहरू सबैभन्दा पहिले पाउनुहोस्:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**प्रश्न, प्रदायकसम्बन्धी सुझाव, रोडम्याप र सहायता → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ग्लोबल](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ब्राजिल](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [पोर्टल](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 गेटवे निरन्तर विस्तार हुँदैछ
## 🆓 स्थापना गर्नुहोस्, प्रदायक जडान गर्नुहोस्, त्यसपछि एउटै एन्डपोइन्टमार्फत रुट गर्नुहोस्
```bash
# प्रदायक जडान गरेपछि, Dashboard → Endpoints बाट आफ्नो OmniRoute कुञ्जी प्रतिलिपि गर्नुहोस्:
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":"नमस्कार!"}]}'
```
`auto` लाई योग्य रुट आवश्यक पर्छ। नयाँ स्थापनामा कुनै पनि योग्य कुञ्जीरहित लक्ष्य नहुन सक्छ, र कुञ्जीरहित प्रदायकले तेस्रो-पक्ष क्लाइन्टहरू अस्वीकार गर्न सक्छ। OpenCode Free र Kiro सहित `tos: avoid` चिन्ह लगाइएका प्रदायकहरू पूर्वनिर्धारित रूपमा स्वचालित राउटिङबाट बहिष्कृत हुन्छन्; खाता जडान गर्दा उक्त सेटिङ ओभरराइड हुँदैन। प्रदायक छनोट गर्नुअघि [निःशुल्क टियर मार्गदर्शिका](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्।📦 **Python, Node.js, PHP, र cURL** का लागि प्रतिलिपि गरेर टाँस्न मिल्ने द्रुत-सुरुवात स्क्रिप्टहरू → [`examples/quickstart/`](examples/quickstart/)
# 💥 प्रतिबद्धता
# 🤔 OmniRoute किन?
## 🤝 हाम्रा खुला स्रोतका साथीहरूद्वारा समर्थित
> **खुला स्रोत साथीको रूपमा सामेल हुन चाहनुहुन्छ?** यी ती कम्पनीहरू हुन् जसले खुला स्रोतलाई समर्थन गर्छन् र OmniRoute लाई चलायमान राख्न मद्दत गर्छन् — र हामी सार्वजनिक रूपमा उनीहरूले हामीलाई दिएको प्रत्येक टोकन कहाँ जान्छ भनी बताउँछौं। सम्पर्क गर्नुहोस्: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
यस परियोजनालाई समर्थन गरेकोमा हाम्रा संस्थापक खुला स्रोत साथी Kimi (Moonshot AI) लाई धन्यवाद! Kimi खुला-वजन K2 र K3 मोडेल परिवारहरू पछाडिको AI प्रयोगशाला हो — Kimi K3 ले 1M-टोकन सन्दर्भ विन्डो, नेटिभ भिजन र फ्रन्टियर-स्तरको कोडिङ बन्द-मोडेल मूल्यको एक अंशमा प्रदान गर्दछ, र Claude Code, Codex र OmniRoute ले सेवा गर्ने हरेक कोडिङ उपकरणसँग बक्स बाहिर काम गर्दछ।
Kimi को समर्थनले के शक्ति दिन्छ: Kimi को API क्रेडिटहरूले OmniRoute को AI-प्रमाणित रिलीज पाइपलाइनलाई शक्ति दिन्छ — प्रत्येक पुल अनुरोधलाई शिप गर्नु अघि समीक्षा गर्ने Kimi K3 द्वारा संचालित मर्ज प्रमाणीकरण चरण — साथै दैनिक सुविधा विकास। पहिलो-कक्षा Kimi समर्थन दुवै रेलहरूमा पठाइन्छ: प्रत्यक्ष Kimi API (kimi-k3) र Kimi Code कोडिङ योजना (OAuth र API कुञ्जी)। OmniRoute Kimi को समर्थन कार्यक्रममा पहिलो ब्राजिलियन खुला-स्रोत परियोजना पनि हो। 15% अतिरिक्त क्रेडिटको साथ Kimi API कुञ्जी प्राप्त गर्नुहोस् →
Cheaper Inference cheaperinference.com
यस परियोजनालाई समर्थन गरेकोमा OmniRoute खुला स्रोत साथी Cheaper Inference लाई धन्यवाद! Cheaper Inference एक लागत-रैंक गरिएको गेटवे हो जसले 42 फ्रन्टियर मोडेलहरू — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok र MiniMax — एक OpenAI-अनुकूल एन्डपोइन्ट पछाडि पुनर्विक्रय गर्दछ, प्रत्येक अनुरोधलाई सबैभन्दा सस्तो योग्य प्रदायकमा रुट गर्दै मोडेल निर्माताको सूची मूल्य भन्दा माथि कहिल्यै शुल्क नलिई।
OmniRoute मा पहिलो-कक्षा समर्थन: च्याट पूरा, नेटिभ /v1/responses एन्डपोइन्ट, भिजन, उपकरण कलिङ र 3 छवि मोडेलहरू (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> को रूपमा पहुँचयोग्य)। API कुञ्जी प्राप्त गर्नुहोस् →
लिङ्कहरू ट्याग गरिएका aff=omniroute साझेदार लिङ्कहरू हुन्। तिनीहरूले तपाईंलाई कुनै अतिरिक्त लागत बिना परियोजनालाई कोष दिन्छन्। 🎟️ सम्बद्ध प्रचार — हामीले प्रायोजन नगर्ने प्रदायकहरूबाट निःशुल्क साइनअप कुपनहरू (विस्तार गर्न क्लिक गर्नुहोस्)यो खण्ड रेफरल/कुपन कोडहरूको लागि मात्र हो। प्रायोजित साझेदारीहरू माथिको 🤝 हाम्रा खुला स्रोतका साथीहरूद्वारा समर्थित मा छन्। OmniRoute को यहाँ सूचीबद्ध प्रदायकहरूसँग कुनै प्रायोजन वा साझेदारी छैन — यी सार्वजनिक कुपनहरू हुन् जुन कसैले पनि प्रयोग गर्न सक्छ।
AgentRouter agentrouter.org
AgentRouter — सम्बद्ध साइनअप · साइनअपमा $100 निःशुल्क क्रेडिट (निःशुल्क सर्भर, उच्च विलम्बताको अपेक्षा गर्नुहोस् — परीक्षणको लागि उत्तम, उत्पादनको लागि होइन)। OmniRoute मा v3.8.50 देखि पहिलो-कक्षा समर्थन: च्याट पूरा, Anthropic-अनुकूल तार ढाँचा र OpenAI-अनुकूल मार्ग। उपलब्ध मोडेलहरूमा claude-opus-4-8, claude-opus-5, gpt-5.6-sol र थप समावेश छन्। आफ्नो $100 प्राप्त गर्नुहोस् →
⚠️ सम्बद्ध लिङ्क — OmniRoute को यस प्रदायकसँग कुनै प्रायोजन वा साझेदारी छैन।
OmniRoute प्रयोगकर्ताहरूलाई फाइदा पुग्ने उदार निःशुल्क साइनअप कुपन भएको अर्को प्रदायक थाहा छ? एउटा मुद्दा खोल्नुहोस् र हामी यसलाई यहाँ थप्नेछौं।
## 🎯 कम्बोहरू — प्रमुख विशेषता
> **कम्बो** भनेको मोडेलहरूको एउटा शृङ्खला हो, जसमार्फत OmniRoute ले **स्वचालित रूपमा** राउट गर्छ। कोटा सकिएमा, प्रदायक असफल भएमा वा लागत बढेमा, कम्बो अर्को योग्य र स्वस्थ मोडेलमा जान सक्छ। 🛡️
### ⚡ शून्य-कन्फिगरेसन — केवल `auto` प्रयोग गर्नुहोस्
कम्बो सिर्जना गर्नुपर्दैन। आफ्नो मोडेललाई `auto` (वा यसको कुनै भेरियन्ट) मा सेट गर्नुहोस् र OmniRoute ले तपाईंका जडान गरिएका प्रदायकहरूबाट प्रत्यक्ष रूपमा स्कोर गरिएको भर्चुअल कम्बो बनाउँछ:
मोडेल ID
यसले केका लागि अनुकूलन गर्छ
auto
🎯 सन्तुलित पूर्वनिर्धारित विकल्प (LKGP — तपाईंको पछिल्लो राम्रो प्रदायकमै कायम रहन्छ)
auto/coding
🧑💻 कोड निर्माणका लागि गुणस्तरलाई प्राथमिकता दिने भारहरू
auto/fast
⚡ सबैभन्दा कम विलम्बतालाई पहिलो प्राथमिकता
auto/cheap
💰 प्रति टोकन सबैभन्दा सस्तोलाई पहिलो प्राथमिकता
auto/offline
🔋 सबैभन्दा धेरै कोटा / दर-सीमा अतिरिक्त क्षमता भएकालाई पहिलो प्राथमिकता
auto/smart
🔭 गुणस्तरलाई पहिलो प्राथमिकता + अझ राम्रा मोडेलहरू पत्ता लगाउन 10% अन्वेषण
auto/lkgp
📌 अन्तिम-ज्ञात-राम्रो-प्रदायकमै स्पष्ट रूपमा कायम रहने
auto/chaos
🧪 मोडेलहरूको प्यानलमा समानान्तर फ्यान-आउट (प्रति प्रदायक एउटा, पूर्वनिर्धारित रूपमा 5), एउटा उत्तर फर्काउँछ; प्रति प्यानल मोडेल एउटा अपस्ट्रिम कल, त्रुटि इन्जेक्सन होइन
##
### 🔀 वा आफ्नै बनाउनुहोस् — 19 राउटिङ रणनीतिहरू
सबै **19** रणनीतिहरू — प्रत्येक कम्बो चरणमा मिसाउनुहोस् र मिलाउनुहोस्:
#
रणनीति
यसले के गर्छ
1
priority
पहिलो लक्ष्यलाई प्राथमिकता दिने क्रमबद्ध सूची — अर्कोमा जानुअघि प्रत्येकलाई समाप्त गर्नुहोस् 🥇
2
fill-first
अर्कोमा जानुअघि प्रत्येक लक्ष्यको कोटा पूर्ण रूपमा भर्नुहोस्
3
weighted
प्रत्येक लक्ष्यको भारअनुसार भारित अनियमित छनोट
4
round-robin
लक्ष्यहरूलाई क्रमअनुसार चक्रीय रूपमा प्रयोग गर्नुहोस्
5
p2c
दुई-विकल्पको-शक्ति अनियमित लोड सन्तुलन
6
least-used
हालको लोड सबैभन्दा कम भएको लक्ष्य छान्नुहोस्
7
random
समान वितरणसहितको अनियमित छनोट (दोहोरोपन हटाइएको)
8
strict-random
दोहोरिएका छनोटहरू नहटाई अनियमित छनोट 🎲
9
cost-optimized
प्रत्यक्ष क्याटलग मूल्य निर्धारणबाट प्रति अनुरोध $ न्यूनतम गर्नुहोस् 💸
10
headroom
सबैभन्दा धेरै बाँकी कोटा भएको लक्ष्य छान्नुहोस्
11
reset-window
जसको कोटा विन्डो सबैभन्दा चाँडो रिसेट हुन्छ, त्यस लक्ष्यलाई प्राथमिकता दिनुहोस्
12
reset-aware
कोटा रिसेट समयअनुसार क्रमबद्ध गर्नुहोस् — छोटा विन्डोहरू पहिले 📊
13
context-relay
लामा कुराकानीहरूका लागि लक्ष्यहरूबीच सन्दर्भ हस्तान्तरण गर्नुहोस् 🧠
14
context-optimized
हालको सन्दर्भ आकारका लागि सबैभन्दा उपयुक्त विकल्प छान्नुहोस्
15
cache-optimized
पुनः प्रयोग गर्न मिल्ने प्रत्येक प्रम्प्ट प्रिफिक्सलाई एउटै खातामा पिन गर्नुहोस् — प्रम्प्ट-क्यास हिटहरू अधिकतम बनाउनुहोस् 🎯
16
lkgp
अन्तिम-ज्ञात-राम्रो पथ — पछिल्लो सफल प्रदायकमा पिन गर्छ, त्यसपछि नियमहरूमा फलब्याक गर्छ
17
auto
प्रत्येक जडानमा 16-कारक प्रत्यक्ष स्कोरिङ 🤖
18
fusion
मोडेलहरूको प्यानलमा फ्यान-आउट + एउटा निर्णायकले एउटै उत्तर संश्लेषण गर्छ 🧬
19
pipeline
चरणहरू शृङ्खलाबद्ध गर्नुहोस् — प्रत्येक लक्ष्यको आउटपुट अर्कोमा प्रवाह हुन्छ 🔗
Auto-Combo इन्जिनले प्रत्येक उम्मेदवारलाई **16 कारकहरू** (स्वास्थ्य, कोटा, लागत, विलम्बता, कार्य अनुकूलता, गुणस्तर, सत्र उपलब्धता…) का आधारमा स्कोर गर्छ — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) हेर्नुहोस्।
##
### 🧱 लचिलोपन अन्तर्निर्मित छ (3 स्वतन्त्र तहहरू)
📖 [स्वचालित कम्बो इन्जिन](docs/routing/AUTO-COMBO.md) · [रेजिलियन्स मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute लाई विशिष्ट बनाउने पक्षहरू
📊 9router, OpenRouter, CLIProxyAPI र LiteLLM सँगको पूर्ण कार्यविधि तथा प्रत्येक सुविधाको विस्तृत तुलना → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute लाई समर्थन गर्नुहोस्
OmniRoute MIT इजाजतपत्रप्राप्त छ र खुला रूपमा मर्मत गरिन्छ। यदि यसले तपाईंको समय वा पैसा बचाउँछ भने, यसलाई स्वतन्त्र राख्न मद्दत गर्ने तरिकाहरू यहाँ छन् — आफूलाई उपयुक्त हुने विकल्प छान्नुहोस्। प्रायोजनले राउटिङ प्राथमिकतालाई कहिल्यै असर गर्दैन; यसले दृश्यता दिन्छ, श्रेणी होइन।
**🇧🇷 PIX** — तत्काल, कुनै शुल्क छैन (ब्राजिल)
कुञ्जी (यादृच्छिक): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix प्रतिलिपि गरेर टाँस्नुहोस्:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ क्रिप्टो — BTC · ETH · USDT-TRC20 · USDC-Solana (विस्तार गर्न क्लिक गर्नुहोस्)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ प्रत्येक सिक्का देखाइएको नेटवर्कमा मात्र पठाउनुहोस् — गलत नेटवर्कमा पठाउँदा रकम गुम्न सक्छ।
🐛 बग फेला पार्नुभयो वा प्रतिक्रिया छ? एउटा [छलफल](https://github.com/diegosouzapw/OmniRoute/discussions) खोल्नुहोस्।
विकासकर्ता टिप्पणीहरू: विकासकर्ताको सुविधाका लागि परियोजनाले npm install/postinstall का क्रममा स्थानीय .env फाइल सिर्जना गर्न सक्छ। यो फाइललाई जानाजानी .gitignore मार्फत बेवास्ता गरिएको छ (.gitignore हेर्नुहोस्) र यसलाई कहिल्यै कमिट गर्नु हुँदैन — यदि भूलवश कमिट भयो भने, खुलासा भएका सबै गोप्य मानहरू परिवर्तन गर्नुहोस् र इतिहासबाट फाइल हटाउनुहोस्। स्थानीय वातावरण फाइलहरू र गोप्य मानहरू व्यवस्थापन गर्ने मार्गदर्शनका लागि docs/DEVELOPER-ENVIRONMENT.md हेर्नुहोस्।
## 📡 OmniRoute Radar
माथि दस्तावेजीकृत, पूलमा दोहोरिएका प्रविष्टि हटाइएको क्याटलगबाट प्राप्त हुने मुख्य निःशुल्क-स्तरको परिमाण **~1.62B टोकन/महिना** नै रहन्छ।
प्रदायकको अस्थायी साइनअप क्रेडिटले पहिलो महिनाको परिमाणलाई छुट्टै रूपमा
**~2.22B** सम्म बढाउन सक्छ। OmniRoute का रिलीजहरूबीच निःशुल्क मोडेलहरूको उपलब्धताबारे अझ नवीन जानकारी चाहनेहरूका लागि Radar एउटा वैकल्पिक, हस्ताक्षरित क्याटलग ओभरले हो; सामुदायिक क्याटलग र हाल उपलब्ध प्रत्येक निःशुल्क
सुविधा निःशुल्क नै रहन्छन्।
समर्थकहरूले लाइभ क्याटलग र प्रदायकका थप अवसरहरू प्राप्त गर्न सक्छन्। यसको छुट्टै,
परिवर्तनशील अधिकतम सीमा प्रदायकको उपलब्धताअनुसार **बढीमा लगभग 3B टोकन/महिना** हो।
त्यो सीमा सुनिश्चित गरिएको होइन: प्रदायकहरूले कुनै पनि
समयमा कोटा, योग्यता, मोडेल वा क्षेत्र परिवर्तन गर्न सक्छन्।
Radar वैकल्पिक रूपमा सक्रिय गर्न सकिन्छ र GET-मात्र हो। OmniRoute क्लाइन्टले प्रम्प्ट, ट्राफिक, प्रदायक
कन्फिगरेसन, प्रयोगसम्बन्धी टेलिमेट्री वा घोषणाहरू नदेखाउने स्थानीय अवस्थासम्बन्धी डेटा अपलोड गर्दैन। योग्यता र
हालको क्याटलगबारे **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** मा जान्नुहोस्।
## ✨ नयाँ के छ
> **v3.8.20 → v3.8.50** का हालैका मुख्य विशेषताहरू। पूर्ण इतिहास [`CHANGELOG.md`](CHANGELOG.md) मा छ।
- **🎛️ OmniConductor** — तपाईंको एजेन्ट समूहमा आगमन A2A प्रत्यायोजन, Agent Card मा Conductor सीपहरू, र Faro पुश-टु-टक भ्वाइस च्याटसहितको ड्यासबोर्ड प्यानल। → [A2A सर्भर](docs/frameworks/A2A-SERVER.md)
- **🛂 अनुकूलनीय प्रवेश तथा ओभरलोड सुरक्षा** — भारी च्याट अनुरोधहरूले 503 त्रुटि दिनुको सट्टा पङ्क्तिमा प्रतीक्षा गर्छन्, र प्रत्येक जडानका लागि परमाणविक RPM रोलिङ लिजहरू उपलब्ध छन्। → [दृढता मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ मानक `/v1/models` क्रमबद्धता** — प्रत्येक प्रदायकका लागि प्रदायकअनुसार समूहबद्ध एउटा निरन्तर ब्लक (कम्बोहरू सुरुमा स्थिर), जुन हरेक क्याटलग स्रोतमा स्थिर रहन्छ। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🗜️ कम्प्रेसन सुदृढीकरण** — पूर्वनिर्धारित रूपमा सक्रिय इन्फ्लेसन गार्ड, DE / FR / JA + चिनियाँ (wényán) का लागि Caveman प्याकहरू, र Gradle तथा .NET का लागि RTK फिल्टरहरू। → [कम्प्रेसन](docs/compression/COMPRESSION_ENGINES.md)
- **💸 पारदर्शी फ्ल्याट-रेट लागत** — सदस्यता / कोडिङ-प्लान प्रदायकहरूको लागत विश्लेषणमा **$0** देखिन्छ; बजेट, कोटा र राउटिङले अनुमान गर्न जारी राख्छन्। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **⚖️ कोटा-साझेदारी राउटिङ** — साझा खाताको कोटा पूल गरिएका कुञ्जीहरूबीच निष्पक्ष रूपमा बाँड्छ र कार्य-संरक्षणकारी भएकाले निष्क्रिय अंशहरू अरूलाई उपलब्ध गराउँछ। → [दृढता मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 एक-कमान्ड CLI/एजेन्ट सेटअप** — 13 दर्ता गरिएका `setup-*` कमान्डहरू; `omniroute run` ले 7 CLI हरू (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) सुरु गर्छ; `omniroute configure` ले अन्तरक्रियात्मक प्रदायक+मोडेल चयनकर्ता र प्रत्येक कन्टेक्स्टका मनपर्ने विकल्पहरूसहित 10 लक्ष्यहरू समर्थन गर्छ। → [CLI एकीकरणहरू](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ रिमोट मोड** — स्कोप गरिएका टोकनहरू (`connect` / `contexts` / `tokens`) र VPS स्थापनाहरूका लागि `antigravity` OAuth सहायकमार्फत रिमोट OmniRoute सञ्चालन गर्नुहोस्। → [रिमोट मोड](docs/guides/REMOTE-MODE.md)
- **🧭 अझ स्मार्ट स्वचालित राउटिङ** — `auto/:` कम्बोहरू, **Fusion** (मोडेल प्यानल + निर्णायक), कार्य-सचेत राउटिङ, र प्रत्येक अनुरोधका लागि मोडेल / मोड / USD-बजेट ओभरराइडहरू। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ प्लग गर्न मिल्ने कम्प्रेसन** — 12 संयोजनयोग्य इन्जिनहरू + Compression Studios: LLMLingua-2, दुई-तहको Ultra, omniglyph, प्रत्येक चरणको फिडेलिटी गेट, GCF v3.2, र ड्र्याग-रिअर्डर सम्पादक। → [कम्प्रेसन](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ पारदर्शी MITM डिक्रिप्सन (TPROXY)** — प्रत्येक SNI का लागि CA र ट्रस्ट-स्टोर इन्स्टलरसहित प्रोक्सी वातावरण चरहरू बेवास्ता गर्ने CLI हरू क्याप्चर गर्नुहोस्। → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 सर्वत्र लागत टेलिमेट्री** — प्रत्येक एन्डपोइन्टमा `X-OmniRoute-*` लागत/प्रयोग हेडरहरू, cache-HIT बचत हेडर, र प्रत्येक कुञ्जीका लागि USD खर्च कोटाहरू। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🧠 तपाईंको नियन्त्रणमा रहने मेमोरी** — पूर्वनिर्धारित रूपमा निष्क्रिय, अप्ट-इन int8 भेक्टर क्वान्टाइजेसन + प्रकारयुक्त डिके, र प्रत्येक अनुरोधका लागि `x-omniroute-no-memory`। → [मेमोरी](docs/frameworks/MEMORY.md)
- **🛡️ सुरक्षा** — हरेक LLM रुटमा प्रम्प्ट-इन्जेक्सन गार्ड (रेड-टिम सुइट), अप्ट-इन क्रेडेन्सियल-मास्किङ गार्डरेल (दुवै दिशामा चुहिएका API कुञ्जीहरू/गोप्य जानकारी हटाउँछ), अन्तिम विकल्पका रूपमा निःशुल्क DuckDuckGo वेब खोज, र ड्यासबोर्डका लागि वैकल्पिक OIDC लगइन गेट (पासवर्ड लगइन सधैँ उपलब्ध रहन्छ)। → [गार्डरेलहरू](docs/security/GUARDRAILS.md)
- **🖼️ नयाँ एन्डपोइन्टहरू** — `/v1/ocr` (Mistral OCR) र `/v1/audio/translations` (Whisper-शैली) ले मिडिया सुविधाहरूलाई पूर्णता दिन्छन्। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🎨 तस्बिर / भिडियो / अडियो उत्पादन** — मिडियाका लागि एउटै API: xAI Grok Imagine र Novita AI भिडियो, ComfyUI, Magnific, Adobe Firefly, Segmind, तथा ElevenLabs जस्ता स्पिच प्रदायकहरू। → [API सन्दर्भ](docs/reference/API_REFERENCE.md)
- **🌍 डिप्लोयमेन्ट तथा सञ्चालन** — रिभर्स-प्रोक्सी `basePath`, ब्राउजरको भाषा स्वतः पहिचान, प्रत्येक कुञ्जीका लागि उपकरण ट्र्याकिङ, रुटविहीन MITM ट्रस्ट, र zh-TW स्थानीयकरण। → [वातावरण](docs/reference/ENVIRONMENT.md)
- **🤝 थप प्रदायक तथा एजेन्टहरू** — क्लाउड एजेन्टहरू (Codex Cloud, Cursor, Devin, Jules), ब्राउजर + OAuth लगइनसहित Grok Build (xAI), Ollama को प्रथम-श्रेणी कार्ड, Claude Opus 5 र Sonnet 5, Kimi को आधिकारिक साझेदारी (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… र अद्यावधिक गरिएको **352-प्रदायक क्याटलग**। → [प्रदायकहरू](docs/reference/PROVIDER_REFERENCE.md)
- **📡 राउटिङ पारदर्शिता** — हरेक प्रतिक्रियामा सेवा दिने रणनीति/प्रदायक/विलम्बको नामसहित `X-OmniRoute-Decision` हेडर हुन्छ, नयाँ `cache-optimized` कम्बो रणनीति + Auto-Combo `cacheAffinity` कारकले दोहोरिएका अनुरोधहरूलाई क्यास गरिएको प्रिफिक्स राख्ने जडानतर्फ फर्काउँछ, र पढ्न-मात्र मिल्ने `/v1/auto-combo/{channel}/candidates` एन्डपोइन्टले `auto/*` च्यानलको प्रत्यक्ष उम्मेदवार पूल देखाउँछ। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ स्थानीय कार्यसम्पादन तथा पूर्वाधार** — एक-क्लिक स्थानीय Redis, Cloudflare Workers / Deno Deploy रिले डिप्लोयरहरू, तथा पर्यवेक्षित एम्बेडेड सेवाका रूपमा Bifrost र Mux। → [एम्बेडेड सेवाहरू](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 साथै समावेश** — प्लगइन फ्रेमवर्क + मार्केटप्लेस, Omni/Agent/GitHub सीप फ्रेमवर्कहरू, Obsidian vault एकीकरण (22 MCP उपकरणहरू), OpenAI-सङ्गत Batch र Files API हरू, अर्थगत प्रतिक्रिया क्यास, लिडरबोर्डसहित गेमिफिकेसन, ACP एजेन्ट खोज (15 अन्तर्निर्मित एजेन्टहरू), BigQuery मा निर्धारित लग निर्यात, `auto/chaos` समानान्तर बहु-मोडेल फ्यान-आउट, Telegram बट ब्रिज, एपभित्रको संस्करण व्यवस्थापक, र LMArena-ELO निःशुल्क-प्रदायक वरीयताहरू। → [कागजातहरू](docs/README.md)
## 🤖 अनुकूल CLIs र कोडिङ एजेन्टहरू
> एउटै कन्फिग — `http://localhost:20128/v1` — र **हरेक** AI IDE वा CLI निःशुल्क र कम लागतका मोडेलहरूमा चल्छ।
＋ यीमा पनि काम गर्छ · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI-सँग अनुकूल कुनै पनि उपकरण
📖 सबै 36 उपकरणहरूका लागि प्रति-उपकरण सेटअप (26 CLI Code का + 10 CLI Agents) → [`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
```
प्रत्येक आदेशले सक्रिय रिमोट सन्दर्भ (`omniroute connect `) पालना गर्छ, `--dry-run`
ले कार्यान्वयन नगरी सटीक env/args को पूर्वावलोकन देखाउँछ, र `--api-key-env NAME` ले गोप्य विवरणहरूलाई
तपाईंको शेल इतिहासबाट बाहिर राख्छ। → [CLI एकीकरणहरू](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 AI प्रदायक — 154 क्याटलगमा निःशुल्कका रूपमा चिन्हित
> च्याट, मिडिया, खोज, स्थानीय, क्लाउड-एजेन्ट र प्रणालीका आधिकारिक सङ्ग्रहहरूमा **372 दर्ता गरिएका प्रदायकहरू** छन्, जसमध्ये **154 सँग `hasFree: true` खोज मेटाडेटा छ**। च्याट मोडेल रजिस्ट्रीले **237 प्रदायक / 3,009 भिन्न प्रदायक-मोडेल जोडी / 1,443 कच्चा मोडेल ID** समेट्छ; छुट्टै निःशुल्क-बजेट क्याटलगमा **491 प्रति-मोडेल पङ्क्ति**, **35 आवर्ती पूल** र **54 आवर्ती/कुञ्जीरहित सधैँ-निःशुल्क प्रदायक** छन्। डिजाइनअनुसार यिनका भाजकहरू फरक छन्; परिभाषाहरू र पूलका दोहोराइ हटाइएका गणनाहरू [प्रदायक सन्दर्भ](docs/reference/PROVIDER_REFERENCE.md) र [निःशुल्क तहहरू](docs/reference/FREE_TIERS.md) मा उपलब्ध छन्।
### 🏢 प्रत्येक प्रमुख प्रयोगशाला — एउटै एन्डपोइन्टमार्फत
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…र थप 330+ — प्रत्येक आइकन ड्यासबोर्डको प्रदायक क्याटलगबाट प्रत्यक्ष रूपमा समाधान हुन्छ। 📖 [प्रदायक सन्दर्भ](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 सधैँ निःशुल्क — $0, कार्ड आवश्यक छैन
OpenCode Zen DeepSeek V4, Nemotron 3 टोकन सीमा छैन
Kilo Code स्वचालित राउटर, Tencent Hy3 सधैँ निःशुल्क
Requesty GPT-OSS 120B, Nemotron सधैँ निःशुल्क
SiliconFlow DeepSeek V3.2 / R1 निःशुल्क तह
Z.AI GLM GLM-4.7 / 4.5-Flash सधैँ निःशुल्क
Baidu ERNIE ERNIE 4.0 सधैँ निःशुल्क
Qoder AI Qwen3-Max, Kimi-K2 असीमित रूपमा निःशुल्क
Pollinations GPT, Llama, Claude कुञ्जी आवश्यक छैन
Cloudflare AI ५०+ मोडेलहरू प्रति दिन १० हजार न्युरोन
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 list # ← रिमोट सर्भरविरुद्ध चल्छ
omniroute configure codex # ← रिमोट मोडेल छान्छ, स्थानीय Codex प्रोफाइल लेख्छ
omniroute tokens create --name ci --scope read # अन्य मेसिनहरूका लागि अझ सीमित टोकनहरू जारी गर्नुहोस्
omniroute contexts use default # ← स्थानीय सर्भरमा फिर्ता जानुहोस्
```
टोकनहरू `read` / `write` / `admin` मा स्कोप गरिएका हुन्छन्; प्रक्रिया सुरु गर्ने रुटहरू लुपब्याकमा मात्र सीमित रहन्छन्।
📖 [रिमोट मोड](docs/guides/REMOTE-MODE.md)
### 🤝 एजेन्ट जडान गर्नुहोस् — र यसले OmniRoute लाई आफैं नियन्त्रण गर्छ
OmniRoute लाई **MCP**, **A2A**, **REST API**, **webhooks** वा **रिमोट CLI** मार्फत उपलब्ध गराउनुहोस् — कुनै पनि सक्षम एजेन्टले (वा तपाईंको आफ्नै कोडले) सम्पूर्ण गेटवेका साँचाहरू प्राप्त गर्छ: राउटिङ, प्रदायकहरू, कम्बोहरू, क्यास, कम्प्रेसन, मेमोरी — स्वायत्त रूपमा। तलका HTTP एन्डपोइन्टहरू `http://localhost:20128` अन्तर्गत उपलब्ध गराइन्छन्।
इन्टरफेस
एन्डपोइन्ट / कमान्ड
यसका लागि प्रयोग गर्नुहोस्
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor वा कुनै पनि MCP क्लाइन्टमा जडान गर्नुहोस्
अनुरोध / कोटा घटनाहरू Slack, Discord, Telegram वा कुनै पनि URL मा पुश गर्नुहोस्
🛰️ रिमोट CLI
omniroute connect
स्कोप गरिएका पहुँच टोकनहरूमार्फत रिमोट इन्स्ट्यान्स सञ्चालन गर्नुहोस्
```bash
# MCP मार्फत Claude Code लाई पूर्ण OmniRoute उपकरणसमूह दिनुहोस्:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP सर्भर](docs/frameworks/MCP-SERVER.md) · [A2A सर्भर](docs/frameworks/A2A-SERVER.md) · [एजेन्ट प्रोटोकलहरू](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 15–95% टोकन बचत गर्नुहोस् — स्वचालित रूपमा
### 📖 यसले कसरी काम गर्छ — पाइपलाइन, आर्किटेक्चर र बचतको गणना
पूर्वनिर्धारित स्ट्याक गरिएको संयोजनले `RTK → Caveman` चलाउँछ। दुवैले एउटै टुल/कन्टेक्स्ट पेलोडमा काम गर्दा बचत गुणित हुन्छ:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लकहरू, URLs, JSON र संरचित डेटा संरक्षण इन्जिनद्वारा **सधैँ सुरक्षित राखिन्छन्**।
> **थोरै टोकनले काम हुने हुँदा धेरै टोकन किन प्रयोग गर्ने?** प्रत्येक अनुरोध OmniRoute को कम्प्रेसन पाइपलाइनबाट **पारदर्शी रूपमा** जान्छ — क्लाइन्टमा कुनै परिवर्तन आवश्यक पर्दैन। अब यो **क्रममा चल्ने र प्रत्येक राउटिङ संयोजनअनुसार मिसाएर मिलाउन सकिने 12 वटा संयोजनयोग्य इन्जिनहरूको स्ट्याक** हो — जुन [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), र [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) का अवधारणाहरूमा आधारित छ।
### 🧱 12-इन्जिन स्ट्याक
इन्जिनहरू पाइपलाइनको क्रममा चल्छन्; प्रत्येकलाई हरेक संयोजनअनुसार स्वतन्त्र रूपमा चालु/बन्द र कन्फिगर गर्न सकिन्छ:
प्रत्यक्ष Anthropic वायरमा मापन गरिएको Claude Fable 5 का लागि प्रयोगात्मक कन्टेक्स्ट-एज-इमेज इन्कोडिङ; प्रदायकका रसिदहरू प्राप्त नभएसम्म GPT 5.6 ट्रान्सफर्मरहरू फेल-क्लोज्ड रहन्छन्। चार कम्प्रेसन प्रोफाइल (पूर्वनिर्धारित एग्रेसिभ, सन्तुलित, कोडिङ-सुरक्षित, पासथ्रु) (सबैभन्दा एग्रेसिभ; अप्ट-इन)
कोड ब्लकहरू, URLs र संरचित डेटा बाइट-स्तरमा पूर्ण रूपमा **सधैँ जोगाइन्छन्**। **एक-क्लिक प्रिसेटहरू** ले इन्जिनहरू संयोजन गर्छन्:
मोड
बचत
यसका लागि उत्तम
🪶 Lite
~15%
सधैँ चालु रहने सुरक्षित पूर्वनिर्धारित विकल्प
🪨 Standard (Caveman)
~30%
दैनिक कोडिङ
⚡ Aggressive
~50%
लामो, टुल-प्रधान सत्रहरू
🔥 Ultra
~75%
अधिकतम बचत
🧰 RTK
60–90%
शेल/परीक्षण/बिल्ड/git आउटपुट
🔗 Stacked (RTK → Caveman)
78–95%
मिश्रित प्रम्प्टहरू + टुल लगहरू
**वास्तविक उदाहरण — Standard मोड:**
> **अघि (69 टोकन):** _"तपाईंको React कम्पोनेन्ट पुनः रेन्डर हुनुको कारण सम्भवतः तपाईंले प्रत्येक रेन्डर चक्रमा नयाँ अब्जेक्ट रेफरेन्स सिर्जना गरिरहनुभएको हो। तपाईंले इनलाइन अब्जेक्टलाई prop का रूपमा पठाउँदा, React को सतही तुलनाले त्यसलाई हरेक पटक फरक अब्जेक्टका रूपमा देख्छ, जसले पुनः रेन्डर गराउँछ। म अब्जेक्टलाई मेमोाइज गर्न useMemo प्रयोग गर्ने सिफारिस गर्छु।"_
>
> **पछि (19 टोकन):** _"हरेक रेन्डरमा नयाँ अब्जेक्ट रेफरेन्स। इनलाइन अब्जेक्ट prop = नयाँ रेफरेन्स = पुनः रेन्डर। useMemo मा र्याप गर्नुहोस्।"_
>
> **उही उत्तर। 72% कम टोकन। सटीकतामा शून्य हानि।** ✅
**PT-BR उदाहरण — [Troglodita](https://github.com/leninejunior/troglodita) मोड:**
> **अघि (42 टोकन):** _"समस्या के हो भने, प्रत्येक रेन्डरिङ चक्रमा वस्तुको नयाँ सन्दर्भ सिर्जना भइरहेकाले कम्पोनेन्ट पुनः रेन्डर भइरहेको छ। म useMemo प्रयोग गर्न सिफारिस गर्छु।"_
>
> **पछि (12 टोकन):** _"पुनः रेन्डर: प्रत्येक चक्रमा नयाँ ref (inline वस्तु पुनः सिर्जना)। `useMemo` प्रयोग गर्नुहोस्।"_
>
> **उही उत्तर। ~70% कम टोकन। प्राविधिक शुद्धता अक्षुण्ण।** ✅
### 🎚️ इन्जिनहरूभन्दा पर — आउटपुट शैलीहरू, अनुकूलनीय डायल र प्रत्येक अनुरोधको नियन्त्रण
माथिका 12 इन्जिनले **भित्र जाने** सामग्री घटाउँछन्। थप तीन तहले **कसरी**, **कहिले**, र **के बाहिर आउँछ** भन्ने निर्धारण गर्छन्:
- **🪄 आउटपुट शैलीहरू** _(आउटपुट-अक्ष निर्देशन)_ — निर्धारणात्मक, क्यास-सुरक्षित प्रतिक्रिया-आकार दिने निर्देशनहरू समावेश गर्छ; एक-अर्कासँग संयोजन गर्न मिल्ने, प्रत्येकमा `lite` / `full` / `ultra` तीव्रता। शैली थप्न रजिस्ट्रीमा एक लाइनको प्रविष्टि पर्याप्त हुन्छ:
- **संक्षिप्त गद्य** — अनावश्यक शब्द / articles / अनिश्चितता हटाउने; प्राविधिक सार ठ्याक्कै कायम राख्ने।
- **कम कोड** — "अल्छी वरिष्ठ डेभलपर" YAGNI: काम गर्ने सबैभन्दा सानो परिवर्तन, अनुरोध नगरिएको scaffolding नथप्ने।
- **Ponytail (अल्छी वरिष्ठ डेभलपर)** — YAGNI सोपान चढ्ने, मूल कारण समाधान गर्ने, काम गर्ने सबैभन्दा सानो diff।
- **मलाई ADHD छ (कार्य-पहिले)** — अर्को कार्य सुरुमा, चरणहरू क्रमाङ्कित, एउटा ठोस अर्को चरण, कुनै प्रस्तावना नहुने।
- **संक्षिप्त CJK (文言)** — शास्त्रीय-चिनियाँ अति-संक्षिप्त शैली (`zh` मा locale-gated)।
- **🎯 अनुकूलनीय सन्दर्भ-बजेट** _(डायल)_ — एउटै अन/अफ टोकन सीमाको सट्टा, **मोडेलको सन्दर्भ विन्डोमा अटाउन** आवश्यक हदसम्म मात्र सबैभन्दा सस्ता, न्यूनतम-हानियुक्त इन्जिनहरू क्रमशः सक्रिय गर्छ। नीति: `reserve-output` (पूर्वनिर्धारित, मोडेल-सचेत) · `percentage` · `absolute`। मोड: `floor` (अटाउने सुनिश्चितता) · `replace-autotrigger` (तपाईंको स्पष्ट छनोटले प्राथमिकता पाउँछ) · `off` (पुरानो सीमा)।
- **🎛️ कम्प्रेसन कहाँ निर्धारण हुन्छ** _(प्राथमिकता, उच्च → न्यून)_ — प्रत्येक अनुरोधको `x-omniroute-compression` हेडर › routing-combo override › सक्रिय नाम दिइएको प्रोफाइल › adaptive / auto-trigger › panel default › off। लागू गरिएको योजना `X-OmniRoute-Compression: ; source=` प्रतिक्रिया हेडरमा फर्काइन्छ।
टोकन सीमाअनुसार auto-trigger गर्नुहोस्, अनुकूलनीय डायल अन गर्नुहोस्, नाम दिइएको प्रोफाइल पिन गर्नुहोस्, प्रत्येक अनुरोधका लागि एकपटकको सेटिङ निर्धारण गर्नुहोस्, वा प्रत्येक routing combo लाई pipeline तोक्नुहोस् — कार्यभारमा जुन उपयुक्त हुन्छ। Opt-in offline **eval harness** (`npm run eval:compression`) ले परिवर्तन लागू गर्नुअघि पिन गरिएको 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 scripts रोक्न सक्छ। OmniRoute को `postinstall` (`node scripts/build/postinstall.mjs`) यसको native runtime फाइलहरू तयार गर्न आवश्यक छ। विश्वव्यापी रूपमा स्थापना गर्दा npm को चेतावनीमा उल्लेख गरिएका packages लाई अनुमति दिनुहोस्। OmniRoute 3.8.51 द्वारा रिपोर्ट गरिएको package set का लागि:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> भविष्यका विश्वव्यापी स्थापनाहरूमा यो allowlist पुनः प्रयोग गर्न, यसलाई एकपटक configure गर्नुहोस्, त्यसपछि सामान्य रूपमा स्थापना गर्नुहोस्:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> निर्भरता सूची release अनुसार परिवर्तन हुन सक्छ; npm ले फरक सूची रिपोर्ट गरेमा, उक्त चेतावनीमा भएका package नामहरू प्रयोग गर्नुहोस्। कुनै package लाई अनुमति दिनाले त्यसका install scripts चल्न सक्छन्।
> **Gemini Web वा अर्को web-cookie provider प्रयोग गर्दै हुनुहुन्छ?** npm package मा
> Playwright समावेश छ, तर यसको Chromium binary छैन। पहिलो web-provider अनुरोध गर्नुअघि
> [Playwright Chromium सेटअप](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> सम्बन्धी टिप्पणी हेर्नुहोस्।
Dashboard `http://localhost:20128` मा · API `http://localhost:20128/v1` मा।
**2) आफ्नै खाता प्रयोग गरी योग्य provider जडान गर्नुहोस्**
Dashboard → **Providers** → हालका सर्तहरू र quota तपाईंको प्रयोगका लागि उपयुक्त भएको provider छान्नुहोस् → त्यसको API key थप्नुहोस् वा account flow पूरा गर्नुहोस्। निःशुल्क tiers का लागि signup, approval, वा payment method आवश्यक हुन सक्छ। [निःशुल्क Tiers मार्गदर्शिका](docs/getting-started/FREE-TIERS-GUIDE.md) समीक्षा गर्नुहोस्; keyless उपलब्धताको प्रत्याभूति छैन, र `tos: avoid` चिन्ह लगाइएका providers पूर्वनिर्धारित रूपमा `auto` बाट हटाइन्छन्।
**3) आफ्नो coding tool लाई निर्दिष्ट गर्नुहोस्**
```txt
आधार URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints बाट प्रतिलिपि गर्नुहोस्]
मोडेल: auto (योग्य connections बीच route गर्छ — वा provider/model छान्नुहोस्)
```
**4) यसले काम गरिरहेको पुष्टि गर्नुहोस्**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
तपाईंले जडान गरेका मोडेलहरू सूचीबद्ध भएको देख्नुपर्छ। 🎉 यति नै हो — coding सुरु गर्नुहोस्, र OmniRoute ले तपाईंका लागि स्वतः route तथा fallback गर्छ।
तपाईंको client ले custom headers पठाउन सक्दैन भने, OmniRoute ले tokenized compatibility aliases पनि उपलब्ध गराउँछ:
```txt
OpenAI सूची: http://localhost:20128/vscode/YOUR_KEY/
OpenAI मोडेलहरू: 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 ...` संलग्न गर्न नसक्ने clients का लागि मात्र यी प्रयोग गर्नुहोस्। 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-मात्र प्याकेज छैन।
5,100+ ट्र्याक गरिएका परीक्षण फाइलहरूमा रहेका 39,000+ स्थिर परीक्षण घोषणाहरूका लागि परीक्षण कभरेज रणनीति
# ⭐ शीर्ष योगदानकर्ताहरू
> OmniRoute एक उत्साही खुला-स्रोत समुदायद्वारा आकार लिन्छ। यी व्यक्तिहरूले परियोजनाको गुणस्तर, स्थिरता र पहुँचमा प्रत्यक्ष प्रभाव पार्ने असाधारण योगदान गरेका छन्। **धन्यवाद।**
### मर्ज गरिएका पुल रिक्वेस्टहरूका आधारमा बाह्य योगदानकर्ताहरू
2026-08-24 05:26:03 UTC सम्मका मर्जहरूसहित प्रत्यक्ष release/v3.8.50 टिप dafb4ae808 मा स्थिर गरिएको। पृष्ठाङ्कित GitHub GraphQL गणनामा 5,911 मर्ज गरिएका PR हरू छन्: रिपोजिटरी मालिकका 2,707, Dependabot का 179, र 535 विशिष्ट योगदानकर्ताहरूबाट आएका 3,025 बाह्य PR हरू। “परिवर्तन गरिएका पङ्क्तिहरू” भनेको GitHub का थपिएका + हटाइएका पङ्क्तिहरू हुन् र यसमा उत्पन्न गरिएका फाइलहरू, लकफाइलहरू, क्याटलगहरू, अनुवादहरू र कागजातहरू समावेश छन्; यो परिवर्तनको परिमाण हो, लेखकद्वारा लेखिएको LOC होइन। कटअफमा बराबरी भएका स्थानहरू कायम राखिएका छन्।
### GitHub-द्वारा श्रेय दिइएका कमिटहरू
Bob.Hou 🏅 GitHub मा श्रेय दिइएका 51 कमिटहरू · #10 मा बराबरी
Xiangzhe 🏅 GitHub मा श्रेय दिइएका 51 कमिटहरू · #10 मा बराबरी
2026-08-24 06:14:31 UTC मा पुनः जाँच गरिएको: पूर्वनिर्धारित शाखा release/v3.8.50 का लागि रिपोजिटरी Contributors API ले रिपोर्ट गरेका GitHub मा श्रेय दिइएका कमिटहरू। API ले 525 पहिचानहरू (415 प्रयोगकर्ता, 2 बट, 108 बेनामी) फिर्ता गर्यो; यस तालिकाले मर्मतकर्ता, बटहरू र बेनामी पहिचानहरूलाई समावेश गर्दैन र प्रतिस्पर्धात्मक बराबरीहरू कायम राख्छ। यो माथिको मर्ज गरिएका PR हरूको श्रेणीकरण र तलको 639-व्यक्तिको Git-मेटाडेटा जनगणना दुवैभन्दा भिन्न छ।
> 🙏 यी योगदानकर्ताहरूका सुविधाहरू, बग समाधानहरू र पूर्वाधार सुधारहरू OmniRoute लाई भरपर्दो र सुविधासम्पन्न बनाउने कुराको **मुख्य अंश** हुन्। प्रत्येक पुल अनुरोध, प्रत्येक परीक्षण केस र प्रत्येक i18n अनुवाद फाइल महत्त्वपूर्ण हुन्छ। खुला स्रोत उनीहरूजस्तै मानिसहरूद्वारा निर्माण हुन्छ।
---
## 💖 प्रायोजकहरू
आफ्नै खल्तीबाट OmniRoute लाई आर्थिक सहयोग गर्ने व्यक्तिहरूप्रति हार्दिक धन्यवाद — प्रत्येक योगदानले परियोजनालाई निःशुल्क, स्वतन्त्र र निरन्तर अघि बढिरहन मद्दत गर्छ।
… र गोप्य रहन रुचाउने अन्य व्यक्तिहरू 💛सार्वजनिक GitHub Sponsors लाई 2026-08-24 मा पुनः प्रमाणीकरण गरिएको थियो। GitHub को activeOnly स्थितिले माथिका सक्रिय लेबलहरू निर्धारण गर्छ; यसअघि खुलासा गरिएका सार्वजनिक एकपटकका समर्थकहरूलाई धन्यवाद दिन जारी राखिएको छ, र निजी प्रायोजकहरू गुमनाम रहन्छन्।💖 प्रायोजक बन्नुहोस् → — प्रत्येक डलरले OmniRoute लाई निःशुल्क र स्वतन्त्र राख्छ।
## 👥 600+ योगदानकर्ताहरू
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-08-24 मा स्थिर आधार ac02c5b42f मा परीक्षण गरिएको र प्रत्यक्ष release/v3.8.50 को नवीनतम dafb4ae808 मा पुनः जाँच गरिएको: 639 सामान्यीकृत मानवीय Git पहिचानहरू — 407 कमिट लेखकका रूपमा देखा पर्छन् (मर्मतकर्तासहित) र 232 स्पष्ट Co-authored-by ट्रेलरहरूमा मात्र देखा पर्छन्। यो गणनाले GitHub noreply ह्यान्डलहरूलाई सामान्यीकरण गर्छ, 26 बोट/एजेन्ट/सेवा/प्लेसहोल्डर पहिचानहरूलाई समावेश गर्दैन, र देखाइने नामहरू मिलेकै आधारमा सामान्य इमेल ठेगानाहरूलाई एकीकृत गर्दैन।
### योगदान कसरी गर्ने
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` ब्रान्च** राखेर पुल अनुरोध खोल्नुहोस्
विस्तृत दिशानिर्देशहरूका लागि [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 को एउटा ठोस भागलाई आकार दिएका छन्। यो ती सबैप्रति हाम्रो धन्यवाद हो। 🙏
> ⭐ ताराहरूको सङ्ख्या अगस्ट 24, 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+ अनावश्यक शब्द हटाउने/सङ्क्षेपीकरण नियमहरूलाई शक्ति दिन्छ।
PT-BR टोकन सङ्कुचन — यसले हाम्रो pt-BR भाषा प्याकलाई शक्ति दिन्छ: ब्राजिलियन-पोर्चुगिज व्याकरणअनुसार मिलाइएको अनावश्यक पुनरुक्ति न्यूनीकरण र पूरक शब्द हटाउने प्रक्रिया।
भाइरल "अल्छी वरिष्ठ विकासकर्ता" YAGNI-कोडर सीप — यसले हाम्रो less-code आउटपुट शैलीलाई प्रेरित गर्यो: _उत्पन्न_ कोड घटाउने सबैभन्दा सानो कार्यशील परिवर्तनतर्फको निर्देशन (Caveman को सङ्क्षिप्त गद्यको आउटपुट-अक्षीय सहोदर)।
Rust स्तम्भीय-JSON + सामग्री-ठेगानायुक्त पुनर्प्राप्ति + सन्देशहरूबीचको डिडुप — यसले हाम्रो headroom/ccr/session-dedup इन्जिन डिजाइन र क्यास-स्थिर "सङ्कुचित रूप स्थानबाट स्वतन्त्र हुन्छ" अपरिवर्तनीयतालाई पुष्टि गर्यो।
TypeScript Compiler API उपकरणसङ्ग्रह — यसले स्ट्रिङ, टेम्प्लेट र रेगेक्स लिटरलहरू जोगाउने हाम्रो पार्सर-आधारित टिप्पणी हटाउने प्रक्रियालाई प्रेरित गर्यो।
कोडिङ सहायक ↔ LLM ट्राफिकको MITM अवरोधन/विश्लेषणले प्रारम्भिक Traffic Inspector आवश्यकताहरूलाई दिशा दियो। पहिले व्युत्पन्न गरिएका चार मोड्युल — SSE मर्जिङ, संवाद सामान्यीकरण, गोप्य जानकारी मास्किङ र हेडर शुद्धीकरण — लाई सार्वजनिक प्रोटोकल मापदण्डहरूमा आधारित स्वतन्त्र clean-room कार्यान्वयनहरूले प्रतिस्थापन गरेका छन्। दुई host-passthrough सतहहरू (passthrough.ts र _internal/bypass.cjs) स्वतन्त्र रूपमा वर्गीकृत OmniRoute का आन्तरिक कार्यान्वयनकै रूपमा रहेका छन्; उक्त प्रतिस्थापनअन्तर्गत तिनलाई पुनर्लेखन गरिएको थिएन।
प्रति-प्रक्रिया पारदर्शी प्रोक्सी राउटिङ — यसले हाम्रो क्र्यास-सुरक्षित MITM समापन, सकेट निष्क्रियता-समयसीमा, /proc प्रक्रिया श्रेयाङ्कन र TPROXY क्याप्चरलाई प्रेरित गर्यो।
पूर्वनिर्धारित रूपमै सुरक्षित लाइब्रेरीहरूको छनोटित सूची, जसले हाम्रा सुरक्षा विकल्पहरूलाई मार्गदर्शन गर्छ (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)।
> प्रत्यक्ष `/dashboard/free-tiers` पृष्ठको एनिमेटेड सारांश। पूर्ण कार्यविधि (पूलका दोहोरिएका प्रविष्टि हटाउने प्रक्रिया, क्रेडिट टियरहरू, प्रदायकका सर्तहरू): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> यी आँकडाहरू प्रत्यक्ष सूचीसँग तुलना गरी प्रत्येक दुई हप्तामा पुनः लेखापरीक्षण गरिन्छन् र **दुवै दिशामा परिवर्तन हुन्छन्** — कुनै प्रदायकले निःशुल्क टियर बन्द गरे सङ्ख्या घट्छ; नयाँ टियर थपिए सङ्ख्या बढ्छ। हामी सूचीले वास्तवमै गणना गरेको आँकडा प्रकाशित गर्छौँ, माथितिर पूर्णाङ्कित गरिएको उत्कृष्ट सम्भावित अवस्था कहिल्यै होइन।
```bash
# प्रदायक जडान गरेपछि, Dashboard → Endpoints बाट आफ्नो OmniRoute कुञ्जी प्रतिलिपि गर्नुहोस्:
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":"नमस्कार!"}]}'
```
`auto` लाई योग्य रुट आवश्यक पर्छ। नयाँ स्थापनामा कुनै पनि योग्य कुञ्जीरहित लक्ष्य नहुन सक्छ, र कुञ्जीरहित प्रदायकले तेस्रो-पक्ष क्लाइन्टहरू अस्वीकार गर्न सक्छ। OpenCode Free र Kiro सहित `tos: avoid` चिन्ह लगाइएका प्रदायकहरू पूर्वनिर्धारित रूपमा स्वचालित राउटिङबाट बहिष्कृत हुन्छन्; खाता जडान गर्दा उक्त सेटिङ ओभरराइड हुँदैन। प्रदायक छनोट गर्नुअघि [निःशुल्क टियर मार्गदर्शिका](docs/getting-started/FREE-TIERS-GUIDE.md) हेर्नुहोस्।
📦 **Python, Node.js, PHP, र cURL** का लागि प्रतिलिपि गरेर टाँस्न मिल्ने द्रुत-सुरुवात स्क्रिप्टहरू → [`examples/quickstart/`](examples/quickstart/)
> **कम्बो** भनेको मोडेलहरूको एउटा शृङ्खला हो, जसमार्फत OmniRoute ले **स्वचालित रूपमा** राउट गर्छ। कोटा सकिएमा, प्रदायक असफल भएमा वा लागत बढेमा, कम्बो अर्को योग्य र स्वस्थ मोडेलमा जान सक्छ। 🛡️
### ⚡ शून्य-कन्फिगरेसन — केवल `auto` प्रयोग गर्नुहोस्
कम्बो सिर्जना गर्नुपर्दैन। आफ्नो मोडेललाई `auto` (वा यसको कुनै भेरियन्ट) मा सेट गर्नुहोस् र OmniRoute ले तपाईंका जडान गरिएका प्रदायकहरूबाट प्रत्यक्ष रूपमा स्कोर गरिएको भर्चुअल कम्बो बनाउँछ:
📖 [स्वचालित कम्बो इन्जिन](docs/routing/AUTO-COMBO.md) · [रेजिलियन्स मार्गदर्शिका](docs/architecture/RESILIENCE_GUIDE.md)
📊 9router, OpenRouter, CLIProxyAPI र LiteLLM सँगको पूर्ण कार्यविधि तथा प्रत्येक सुविधाको विस्तृत तुलना → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
कुञ्जी (यादृच्छिक): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix प्रतिलिपि गरेर टाँस्नुहोस्:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [प्राधिकरण](docs/architecture/AUTHZ_GUIDE.md) · [सुरक्षा सीमाहरू](docs/security/GUARDRAILS.md) · [अनुपालन](docs/security/COMPLIANCE.md)
पूर्वनिर्धारित स्ट्याक गरिएको संयोजनले `RTK → Caveman` चलाउँछ। दुवैले एउटै टुल/कन्टेक्स्ट पेलोडमा काम गर्दा बचत गुणित हुन्छ:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
कोड ब्लकहरू, URLs, JSON र संरचित डेटा संरक्षण इन्जिनद्वारा **सधैँ सुरक्षित राखिन्छन्**।
> **थोरै टोकनले काम हुने हुँदा धेरै टोकन किन प्रयोग गर्ने?** प्रत्येक अनुरोध OmniRoute को कम्प्रेसन पाइपलाइनबाट **पारदर्शी रूपमा** जान्छ — क्लाइन्टमा कुनै परिवर्तन आवश्यक पर्दैन। अब यो **क्रममा चल्ने र प्रत्येक राउटिङ संयोजनअनुसार मिसाएर मिलाउन सकिने 12 वटा संयोजनयोग्य इन्जिनहरूको स्ट्याक** हो — जुन [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), र [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) का अवधारणाहरूमा आधारित छ।
### 🧱 12-इन्जिन स्ट्याक
इन्जिनहरू पाइपलाइनको क्रममा चल्छन्; प्रत्येकलाई हरेक संयोजनअनुसार स्वतन्त्र रूपमा चालु/बन्द र कन्फिगर गर्न सकिन्छ:
