# 🚀 OmniRoute — મફત AI ગેટવે
**[Diego Souza](https://github.com/diegosouzapw) દ્વારા બનાવાયેલ**
## 💰 તૃતીય-પક્ષના મફત સ્તરોમાં દર મહિને ~1.62B ટોકન
> **તમારા પોતાના પ્રદાતા એકાઉન્ટનો ઉપયોગ કરો.** આ અલગથી પાત્ર તૃતીય-પક્ષના મફત સ્તરોનો અંદાજિત કુલ સરવાળો છે, OmniRoute તરફથી મળતી ટોકન ગ્રાન્ટ નથી. સાઇન અપ કરો, જ્યાં જરૂરી હોય ત્યાં ઓળખપત્ર મેળવો અને તમે ઉપયોગ કરી શકો તેવા પ્રદાતાઓને કનેક્ટ કરો; દરેક પ્રદાતા પોતાની મર્યાદાઓ, ઉપલબ્ધતા અને શરતો નિયંત્રિત કરે છે.
>
> મફત સ્તરોને હાથથી એકત્રિત કરવું મુશ્કેલ છે — ડઝનો SDK, ડઝનો રેટ લિમિટ અને તમારી પાસે ખરેખર કેટલું ઉપલબ્ધ છે તેની કોઈ જાણકારી નહીં. OmniRoute **34 પુનરાવર્તિત pool keysમાં 465 મફત-સ્તરની એન્ટ્રીઓ**નું કેટલોગ બનાવે છે અને **પ્રકાશિત સકારાત્મક માસિક બજેટ ધરાવતા 17 pools ઉપરાંત પાંચ પ્રતિ-મોડેલ Groq caps**માંથી ટોકનનું મુખ્ય આંકડું ગણે છે, જે shared pool મુજબ deduplicate કરવામાં આવે છે. પ્રાદેશિક ઓળખ ચકાસણી પછી જ ખુલતી ક્વોટા (આજે: ModelScope) અલગ દર્શાવવામાં આવે છે, પ્રાદેશિક ઓળખ ચકાસણી પાછળ +~6M તરીકે, અને તેને ક્યારેય મુખ્ય આંકડામાં ઉમેરવામાં આવતી નથી. પરિણામ ડેશબોર્ડ (`/dashboard/free-tiers`) પર હંમેશાં દેખાય છે.
> લાઇવ `/dashboard/free-tiers` પેજનો એનિમેટેડ સારાંશ. સંપૂર્ણ પદ્ધતિ (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> આ આંકડાઓનું લાઇવ કેટલોગ સામે દર બે અઠવાડિયે ફરી ઑડિટ કરવામાં આવે છે અને તેમાં **બંને દિશામાં ફેરફાર થઈ શકે છે** — કોઈ પ્રદાતા મફત સ્તર બંધ કરે તો સંખ્યા ઘટે છે; નવો પ્રદાતા ઉમેરાય તો તે વધે છે. અમે કેટલોગ ખરેખર જે ગણે છે તે જ પ્રકાશિત કરીએ છીએ, ક્યારેય ઉપર તરફ ગોળ કરેલો શ્રેષ્ઠ સંભવિત આંકડો નહીં.
⭐ OMNIROUTE એ તમને પૈસા બચાવવામાં અને તમારું કાર્ય સરળ બનાવવામાં મદદ કરી હોય તો repoને સ્ટાર આપો.
[](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 [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](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` માટે યોગ્ય રૂટ આવશ્યક છે. નવી ઇન્સ્ટોલેશનમાં કોઈ યોગ્ય કીવિહોણા લક્ષ્યો ન હોઈ શકે, અને કીવિહોણો પ્રોવાઇડર તૃતીય-પક્ષ ક્લાયન્ટ્સને નકારી શકે છે. `tos: avoid` તરીકે ચિહ્નિત પ્રોવાઇડર્સ, જેમાં Kiro પણ સામેલ છે, ડિફૉલ્ટ રૂપે સ્વચાલિત રૂટિંગમાંથી બાકાત રાખવામાં આવે છે; એકાઉન્ટ કનેક્ટ કરવાથી તે સેટિંગ ઓવરરાઇડ થતું નથી. પ્રોવાઇડર પસંદ કરતાં પહેલાં [મફત ટિયર્સ માર્ગદર્શિકા](docs/getting-started/FREE-TIERS-GUIDE.md) જુઓ.📦 **Python, Node.js, PHP, અને cURL** માટે કૉપી-પેસ્ટ કરી શકાય તેવી ક્વિકસ્ટાર્ટ સ્ક્રિપ્ટ્સ → [`examples/quickstart/`](examples/quickstart/)
# 💥 વચન
# 🤔 OmniRoute શા માટે?
## 🤝 અમારા ઓપન સોર્સ મિત્રો દ્વારા સમર્થિત
> **ઓપન સોર્સ મિત્ર તરીકે જોડાવા માંગો છો?** આ એવી કંપનીઓ છે જે ઓપન સોર્સને સમર્થન આપે છે અને OmniRoute ને ચાલુ રાખવામાં મદદ કરે છે — અને અમે સાર્વજનિક રીતે જણાવીએ છીએ કે તેઓ અમને આપેલો દરેક ટોકન ક્યાં જાય છે. સંપર્ક કરો: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
આ પ્રોજેક્ટને સમર્થન આપવા બદલ અમારા સ્થાપક ઓપન સોર્સ મિત્ર Kimi (Moonshot AI) નો આભાર! Kimi એ ઓપન-વેઇટ K2 અને K3 મોડેલ પરિવારો પાછળની AI લેબ છે — Kimi K3 1M-ટોકન કન્ટેક્સ્ટ વિન્ડો, નેટિવ વિઝન અને ફ્રન્ટિયર-લેવલ કોડિંગને ક્લોઝ્ડ-મોડેલ કિંમતોના અપૂર્ણાંકમાં પ્રદાન કરે છે, અને Claude Code, Codex અને OmniRoute સેવા આપતા દરેક કોડિંગ ટૂલ સાથે આઉટ ઓફ ધ બોક્સ કામ કરે છે.
Kimi નું સમર્થન શું શક્તિ આપે છે: Kimi ના API ક્રેડિટ્સ OmniRoute ની AI-માન્ય રિલીઝ પાઇપલાઇનને શક્તિ આપે છે — Kimi K3 દ્વારા સંચાલિત મર્જ માન્યતા સ્ટેજ જે દરેક પુલ રિક્વેસ્ટને શિપ કરતા પહેલા સમીક્ષા કરે છે — ઉપરાંત દૈનિક સુવિધા વિકાસ. ફર્સ્ટ-ક્લાસ Kimi સપોર્ટ બંને રેલ્સ પર શિપ થાય છે: સીધો Kimi API (kimi-k3) અને Kimi Code કોડિંગ પ્લાન (OAuth અને API કી). OmniRoute Kimi ના સપોર્ટ પ્રોગ્રામમાં પ્રથમ બ્રાઝિલિયન ઓપન-સોર્સ પ્રોજેક્ટ પણ છે. 15% વધારાના ક્રેડિટ્સ સાથે Kimi API કી મેળવો →
સસ્તી અનુમાન 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.org
એજન્ટરાઉટર — એફિલિએટ સાઇનઅપ · સાઇનઅપ પર $100 મફત ક્રેડિટ્સ (મફત સર્વર, ઉચ્ચ લેટન્સીની અપેક્ષા રાખો — પરીક્ષણ માટે શ્રેષ્ઠ, ઉત્પાદન માટે નહીં). OmniRoute માં v3.8.50 થી ફર્સ્ટ-ક્લાસ સપોર્ટ: ચેટ કમ્પ્લીશન્સ, એન્થ્રોપિક-સુસંગત વાયર ફોર્મેટ અને OpenAI-સુસંગત પાથ. ઉપલબ્ધ મોડેલ્સમાં claude-opus-4-8, claude-opus-5, gpt-5.6-sol અને વધુ શામેલ છે. તમારા $100 મેળવો →
⚠️ એફિલિએટ લિંક — OmniRoute ને આ પ્રદાતા સાથે કોઈ પ્રાયોજકતા અથવા ભાગીદારી નથી.
એવા અન્ય પ્રદાતાને જાણો છો કે જે OmniRoute વપરાશકર્તાઓને લાભ આપતો ઉદાર મફત સાઇનઅપ કૂપન ધરાવે છે? એક ઇશ્યુ ખોલો અને અમે તેને અહીં ઉમેરીશું.
## 🎯 કોમ્બોઝ — મુખ્ય સુવિધા
> **કોમ્બો** એ મોડેલોની એક શૃંખલા છે, જેની વચ્ચે OmniRoute **આપમેળે** રાઉટ કરે છે. જો ક્વોટા ખૂટી જાય, કોઈ પ્રદાતા નિષ્ફળ જાય અથવા ખર્ચ વધી જાય, તો કોમ્બો આગલા પાત્ર અને કાર્યરત મોડેલ પર જઈ શકે છે. 🛡️
### ⚡ શૂન્ય-રૂપરેખાંકન — ફક્ત `auto` વાપરો
કોઈ કોમ્બો બનાવવાની જરૂર નથી. તમારા મોડેલને `auto` (અથવા તેના કોઈ પ્રકાર) પર સેટ કરો અને OmniRoute તમારા જોડાયેલા પ્રદાતાઓમાંથી વર્ચ્યુઅલ કોમ્બો બનાવશે, જેનું જીવંત મૂલ્યાંકન થાય છે:
મોડેલ ID
તે શેને અનુકૂલિત કરે છે
auto
🎯 સંતુલિત ડિફૉલ્ટ (LKGP — તમારા છેલ્લા સારા પ્રદાતા સાથે જળવાઈ રહે છે)
auto/coding
🧑💻 કોડ જનરેશન માટે ગુણવત્તા-પ્રથમ ભારાંક
auto/fast
⚡ સૌથી ઓછી વિલંબતા પ્રથમ
auto/cheap
💰 પ્રતિ ટોકન સૌથી સસ્તું પ્રથમ
auto/subscription
🎟️ માત્ર એ સબ્સ્ક્રિપ્શન ક્વોટા જેના માટે તમે પહેલેથી ચૂકવણી કરો છો — નિષ્ફળતા આવે તો બંધ થાય છે, ક્યારેય બિલપાત્ર ફૉલબૅક નહીં (માર્ગદર્શિકા)
auto/thrifty
🪜 પહેલાં પ્લાનનો ક્વોટા, ત્યારબાદ એક સમયે એક પગથિયું ચઢીને સૌથી સસ્તા ચૂકવેલ વિકલ્પો સુધી — પ્લાન રીસેટ થયા પછી તેના પર પાછું (માર્ગદર્શિકા)
auto/offline
🔋 સૌથી વધુ ક્વોટા / દર-મર્યાદા અવકાશ પ્રથમ
auto/smart
🔭 ગુણવત્તા-પ્રથમ + વધુ સારા મોડેલો શોધવા માટે 10% અન્વેષણ
auto/lkgp
📌 સ્પષ્ટ છેલ્લો-જાણીતો-સારો-પ્રદાતા સ્થાયિત્વ
auto/chaos
🧪 મોડેલોની પેનલમાં સમાંતર ફૅન-આઉટ (પ્રતિ પ્રદાતા એક, ડિફૉલ્ટ રૂપે 5), એક જવાબ પરત કરે છે; પ્રતિ પેનલ મોડેલ એક અપસ્ટ્રીમ કૉલ, ફૉલ્ટ ઇન્જેક્શન નહીં
##
### 🔀 અથવા તમારું પોતાનું બનાવો — 20 રાઉટિંગ વ્યૂહરચનાઓ
તમામ **20** વ્યૂહરચનાઓ — દરેક કોમ્બો પગલામાં તમારી જરૂર મુજબ મિશ્રિત કરો:
#
વ્યૂહરચના
તે શું કરે છે
1
priority
પ્રથમ-લક્ષ્ય ક્રમબદ્ધ સૂચિ — આગલા પર જતાં પહેલાં દરેકને સંપૂર્ણ વાપરો 🥇
2
fill-first
આગળ વધતાં પહેલાં દરેક લક્ષ્યનો ક્વોટા સંપૂર્ણપણે ભરો
ખાલી થયેલાં એકાઉન્ટ્સને છોડો, પછી બાકી ક્વોટા ÷ ચાલુ લોડના પ્રમાણમાં પસંદ કરો — હાલની વાતચીતો નિર્ધારિત લક્ષ્ય સાથે જ જોડાયેલી રહે છે ⚖️
12
reset-window
જે લક્ષ્યની ક્વોટા વિન્ડો સૌથી વહેલી રીસેટ થાય તેને પ્રાધાન્ય આપો
13
reset-aware
ક્વોટા રીસેટ સમય પ્રમાણે ક્રમ આપો — ટૂંકી વિન્ડો પ્રથમ 📊
14
context-relay
લાંબી વાતચીતો માટે લક્ષ્યો વચ્ચે સંદર્ભ સોંપો 🧠
15
context-optimized
વર્તમાન સંદર્ભ કદ માટે સૌથી યોગ્ય વિકલ્પ પસંદ કરો
16
cache-optimized
દરેક પુનઃઉપયોગી પ્રોમ્પ્ટ પ્રીફિક્સને સમાન એકાઉન્ટ સાથે નિર્ધારિત રાખો — પ્રોમ્પ્ટ-કૅશ હિટ્સ મહત્તમ કરો 🎯
17
lkgp
છેલ્લો-જાણીતો-સારો પાથ — છેલ્લા સફળ પ્રદાતા સાથે નિર્ધારિત રહે છે, પછી નિયમો પર ફૉલબૅક કરે છે
18
auto
દરેક કનેક્શનમાં 16-પરિબળનું જીવંત સ્કોરિંગ 🤖
19
fusion
મોડેલોની પેનલમાં ફૅન-આઉટ + એક નિર્ણાયક એક જવાબનું સંશ્લેષણ કરે છે 🧬
20
pipeline
પગલાંની શૃંખલા બનાવો — દરેક લક્ષ્યનું આઉટપુટ આગલા લક્ષ્યને આપવામાં આવે છે 🔗
Auto-Combo એન્જિન દરેક ઉમેદવારને **16 પરિબળો** (આરોગ્ય, ક્વોટા, ખર્ચ, વિલંબતા, કાર્યની અનુકૂળતા, ગુણવત્તા, સત્ર ઉપલબ્ધતા…)ના આધારે સ્કોર આપે છે — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) જુઓ.
##
### 🧱 સ્થિતિસ્થાપકતા અંતર્નિર્મિત છે (3 સ્વતંત્ર સ્તરો)
📖 [Auto-Combo એન્જિન](docs/routing/AUTO-COMBO.md) · [સ્થિતિસ્થાપકતા માર્ગદર્શિકા](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute ને શું અલગ બનાવે છે
📊 9router, OpenRouter, CLIProxyAPI અને LiteLLM સામેની સંપૂર્ણ પદ્ધતિ અને દરેક સુવિધાની વિગતો → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRouteને સમર્થન આપો
OmniRoute MIT લાઇસન્સ ધરાવે છે અને ખુલ્લેઆમ જાળવવામાં આવે છે. જો તે તમારો સમય અથવા પૈસા બચાવે છે, તો તેને સ્વતંત્ર રાખવામાં મદદ કરવાની રીતો અહીં છે — તમને અનુકૂળ હોય તે પસંદ કરો. સ્પોન્સરશિપ ક્યારેય રાઉટિંગની પ્રાથમિકતાને અસર કરતી નથી; તે દૃશ્યતા ખરીદે છે, રેન્કિંગ નહીં.
**🇧🇷 PIX** — તાત્કાલિક, કોઈ ફી નહીં (બ્રાઝિલ)
કી (રેન્ડમ): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix કૉપિ અને પેસ્ટ:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ ક્રિપ્ટો — BTC · ETH · USDT-TRC20 · USDC-Solana (વિસ્તૃત કરવા માટે ક્લિક કરો)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ દરેક કૉઇન ફક્ત દર્શાવેલા નેટવર્ક પર જ મોકલો — ખોટા નેટવર્ક પર મોકલવાથી ભંડોળ ગુમાવી શકાય છે.
🐛 કોઈ બગ મળ્યો અથવા પ્રતિસાદ છે? એક [ચર્ચા](https://github.com/diegosouzapw/OmniRoute/discussions) શરૂ કરો.
ડેવલપર નોંધો: ડેવલપરની સુવિધા માટે પ્રોજેક્ટ npm install/postinstall દરમિયાન સ્થાનિક .env ફાઇલ બનાવી શકે છે. આ ફાઇલને ઇરાદાપૂર્વક .gitignore દ્વારા અવગણવામાં આવે છે (.gitignore જુઓ) અને તેને ક્યારેય કમિટ કરવી જોઈએ નહીં — જો તે આકસ્મિક રીતે કમિટ થઈ જાય, તો જાહેર થયેલા કોઈપણ સિક્રેટ્સને રોટેટ કરો અને ફાઇલને ઇતિહાસમાંથી દૂર કરો. સ્થાનિક એન્વાયર્નમેન્ટ ફાઇલો અને સિક્રેટ્સના સંચાલન અંગે માર્ગદર્શન માટે docs/DEVELOPER-ENVIRONMENT.md જુઓ.
## 📡 OmniRoute Radar
ઉપર દસ્તાવેજીકૃત, પૂલ-ડીડુપ્લિકેટેડ કૅટલૉગમાંથી મુખ્ય મફત-ટિયર મર્યાદા હજી પણ **~1.62B ટોકન્સ/મહિનો** છે. પ્રદાતાના અસ્થાયી સાઇનઅપ ક્રેડિટ્સ પ્રથમ મહિનાની મર્યાદાને અલગથી વધારીને **~2.22B** સુધી લઈ જઈ શકે છે. OmniRoute રિલીઝની વચ્ચે મફત-મૉડલની ઉપલબ્ધતા વિશે વધુ તાજી માહિતી ઇચ્છતા લોકો માટે Radar એક વૈકલ્પિક, હસ્તાક્ષરિત કૅટલૉગ ઓવરલે છે; સમુદાય કૅટલૉગ અને હાલની દરેક મફત સુવિધા મફત જ રહે છે.
સમર્થકો લાઇવ કૅટલૉગ અને પ્રદાતાઓની વધારાની તકો મેળવી શકે છે. પ્રદાતાની ઉપલબ્ધતાના આધારે, તેની અલગ અને પરિવર્તનશીલ મહત્તમ મર્યાદા **વધુમાં વધુ અંદાજે 3B ટોકન્સ/મહિનો** છે. આ મર્યાદા કોઈ બાંયધરી નથી: પ્રદાતાઓ કોઈપણ સમયે ક્વોટા, પાત્રતા, મૉડલ્સ અથવા પ્રદેશો બદલી શકે છે.
Radar વૈકલ્પિક છે અને માત્ર GET નો ઉપયોગ કરે છે. OmniRoute ક્લાયન્ટ પ્રોમ્પ્ટ્સ, ટ્રાફિક, પ્રદાતા કૉન્ફિગરેશન, ઉપયોગની ટેલિમેટ્રી અથવા સ્થાનિક જાહેરાત-બરતરફીની સ્થિતિ અપલોડ કરતું નથી. પાત્રતા અને વર્તમાન કૅટલૉગ વિશે **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** પર જાણો.
## ✨ નવું શું છે
> **v3.8.20 → v3.8.54**માંથી તાજેતરના મુખ્ય હાઇલાઇટ્સ. સંપૂર્ણ ઇતિહાસ [`CHANGELOG.md`](CHANGELOG.md)માં.
- **⚖️ `quota-weighted` રાઉટિંગ** — 20મી કોમ્બો વ્યૂહરચના ખૂટી ગયેલા એકાઉન્ટ્સને છોડે છે, પછી બાકીના એકાઉન્ટ્સમાંથી બાકી રહેલા ક્વોટા ÷ પ્રગતિમાં રહેલા લોડના પ્રમાણમાં પસંદગી કરે છે અને હાલની વાતચીતને પિન રાખે છે. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 હેડલેસ મોડ** — `omniroute serve --headless` (અથવા `OMNIROUTE_HEADLESS=1`) માત્ર `/v1/*` પ્રોક્સી એન્જિન ચલાવે છે; ડેશબોર્ડ અને માત્ર-ડેશબોર્ડ સબસિસ્ટમ્સ બંધ રહે છે. → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 મોડેલ શોધ** — `/v1/models` ક્ષમતા, કોન્ટેક્સ્ટ, પ્રકાર અને લખાણ પ્રમાણે ફિલ્ટર કરે છે, જ્યારે `POST /v1/models/query` દરેક કી માટે સમાન દૃશ્યતા સાથે ટૂંકી અને નિર્ધારિત શોર્ટલિસ્ટ આપે છે. → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 દરેક કી માટે રાઉટિંગ નિયંત્રણ** — `forcedModel` દ્વારા API કીને એક મોડેલ અથવા કોમ્બો સાથે પિન કરો અને કીના મોડેલ્સ તથા કોમ્બોઝને પરમાણુ રીતે ઉમેરો અથવા દૂર કરો (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ વધુ સૂક્ષ્મ PII નિયંત્રણો** — પ્રકાર પ્રમાણે પસંદગી, 20 સુધી માન્ય કરેલી કસ્ટમ માસ્કિંગ પેટર્ન અને પ્રકાર પ્રમાણે શોધ કાઉન્ટર્સ; માસ્કિંગ પોતે હજુ પણ opt-in રહે છે. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 ભાષાઓ** — ડેશબોર્ડ, દસ્તાવેજોના મિરર્સ અને CLIમાં, જ્યારે `npm run i18n:add-locale` એક જ કમાન્ડથી દરેક જગ્યાએ ભાષા ઉમેરે છે. → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — તમારા એજન્ટ ફ્લીટને આવતી A2A ડેલિગેશન, Agent Card પર Conductor કૌશલ્યો અને Faro push-to-talk વૉઇસ ચેટ ધરાવતી ડેશબોર્ડ પેનલ. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 અનુકૂલનશીલ પ્રવેશ અને ઓવરલોડ સુરક્ષા** — ભારે ચેટ વિનંતીઓ 503 આપવાને બદલે કતારમાં જાય છે, અને દરેક કનેક્શન માટે પરમાણુ RPM રોલિંગ લીઝ સાથે. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ પ્રમાણભૂત `/v1/models` ક્રમ** — દરેક પ્રોવાઇડર માટે એક સતત, પ્રોવાઇડર-જૂથબદ્ધ બ્લૉક (કોમ્બોઝ પ્રથમ પિન કરેલા), દરેક કેટલોગ સ્રોતમાં સ્થિર. → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ કમ્પ્રેશન હાર્ડનિંગ** — ડિફૉલ્ટ રૂપે સક્રિય inflation guard, DE / FR / JA + ચાઇનીઝ (wényán) માટે Caveman packs, Gradle અને .NET માટે RTK ફિલ્ટર્સ. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 પ્રામાણિક ફ્લેટ-રેટ ખર્ચ** — સબ્સ્ક્રિપ્શન / કોડિંગ-પ્લાન પ્રોવાઇડર્સ ખર્ચ વિશ્લેષણમાં **$0** દર્શાવે છે; બજેટ, ક્વોટા અને રાઉટિંગનું અંદાજન ચાલુ રહે છે. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share રાઉટિંગ** — શેર કરેલા એકાઉન્ટના ક્વોટાને પૂલ કરેલી કીઓમાં ન્યાયપૂર્ણ રીતે વહેંચે છે અને idle સ્લાઇસ ઉધાર આપીને કાર્યક્ષમ રહે છે. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 એક-કમાન્ડ CLI/એજન્ટ સેટઅપ** — 15 નોંધાયેલા `setup-*` કમાન્ડ્સ; `omniroute run` 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) લૉન્ચ કરે છે; `omniroute configure` ઇન્ટરેક્ટિવ provider+model picker અને દરેક કોન્ટેક્સ્ટ માટે favorites સાથે 11 targetsને સપોર્ટ કરે છે. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ રિમોટ મોડ** — scoped tokens (`connect` / `contexts` / `tokens`) સાથે રિમોટ OmniRoute ચલાવો અને VPS ઇન્સ્ટોલેશન માટે `antigravity` OAuth helper વાપરો. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 વધુ સ્માર્ટ ઑટો-રાઉટિંગ** — `auto/:` કોમ્બોઝ, **Fusion** (મોડેલ પેનલ + જજ), કાર્ય-જાગૃત રાઉટિંગ, દરેક વિનંતી માટે મોડેલ / મોડ / USD-બજેટ ઓવરરાઇડ્સ. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ પ્લગેબલ કમ્પ્રેશન** — 12 સંયોજ્ય એન્જિન્સ અને Compression Studios: LLMLingua-2, દ્વિ-સ્તરીય Ultra, omniglyph, દરેક પગલા માટે fidelity gate, GCF v3.2, drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ પારદર્શક MITM ડિક્રિપ્ટ (TPROXY)** — પ્રોક્સી પર્યાવરણ વેરિએબલ્સને અવગણતી capture CLIs માટે, દરેક SNI CA અને trust-store installer સાથે. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 દરેક જગ્યાએ ખર્ચ ટેલિમેટ્રી** — દરેક endpoint પર `X-OmniRoute-*` ખર્ચ/વપરાશ હેડર્સ, cache-HIT બચત હેડર અને દરેક કી માટે USD ખર્ચ ક્વોટા. → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 તમારા નિયંત્રણમાં મેમરી** — ડિફૉલ્ટ રૂપે બંધ, opt-in int8 vector quantization અને typed decay સાથે, દરેક વિનંતી માટે `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ સુરક્ષા** — દરેક LLM રાઉટ પર prompt-injection guard (red-team suite), opt-in credential-masking guardrail (બંને દિશામાં લીક થયેલી API keys/secretsને redact કરે છે), મફત DuckDuckGo અંતિમ-ઉપાય વેબ શોધ અને ડેશબોર્ડ માટે વૈકલ્પિક OIDC login gate (પાસવર્ડ લૉગિન હંમેશાં ઉપલબ્ધ રહે છે). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ નવા endpoints** — `/v1/ocr` (Mistral OCR) અને `/v1/audio/translations` (Whisper-style) મીડિયા સપાટી પૂર્ણ કરે છે. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 છબી / વિડિયો / ઑડિયો જનરેશન** — મીડિયા માટે એક API: xAI Grok Imagine અને Novita AI વિડિયો, ComfyUI, Magnific, Adobe Firefly, Segmind અને ElevenLabs જેવા speech providers. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 ડિપ્લોયમેન્ટ અને ઑપ્સ** — reverse-proxy `basePath`, બ્રાઉઝર-ભાષા ઑટો-ડિટેક્ટ, દરેક કી માટે device tracking, root-less MITM trust, zh-TW સ્થાનિકીકરણ. → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 વધુ પ્રોવાઇડર્સ અને એજન્ટ્સ** — cloud agents (Codex Cloud, Cursor, Devin, Jules), બ્રાઉઝર + OAuth login સાથે Grok Build (xAI), first-class card તરીકે Ollama, Claude Opus 5 અને Sonnet 5, Kimiની સત્તાવાર ભાગીદારી (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… અને નવેસરથી તૈયાર કરેલો **388-provider catalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 રાઉટિંગ પારદર્શિતા** — દરેક પ્રતિભાવમાં તેને સેવા આપનાર strategy/provider/latencyનું નામ આપતું `X-OmniRoute-Decision` હેડર હોય છે; નવી `cache-optimized` કોમ્બો વ્યૂહરચના અને Auto-Combo `cacheAffinity` factor વારંવાર આવતી વિનંતીઓને cached prefix ધરાવતા કનેક્શન તરફ પાછી રાઉટ કરે છે; અને read-only `/v1/auto-combo/{channel}/candidates` endpoint `auto/*` ચેનલનો live candidate pool જાહેર કરે છે. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ સ્થાનિક કામગીરી અને ઇન્ફ્રા** — એક-ક્લિક સ્થાનિક Redis, Cloudflare Workers / Deno Deploy રિલે ડિપ્લોયર્સ, દેખરેખ હેઠળની એમ્બેડેડ સેવાઓ તરીકે Bifrost અને Mux. → [એમ્બેડેડ સેવાઓ](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 બૉક્સમાં આ પણ સામેલ છે** — પ્લગિન ફ્રેમવર્ક + માર્કેટપ્લેસ, Omni/Agent/GitHub સ્કિલ્સ ફ્રેમવર્ક્સ, Obsidian વૉલ્ટ ઇન્ટિગ્રેશન (22 MCP ટૂલ્સ), OpenAI-સુસંગત Batch અને Files APIs, સેમેન્ટિક રિસ્પોન્સ કૅશ, લીડરબોર્ડ્સ સાથે ગેમિફિકેશન, 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)
## 🌐 388 AI પ્રોવાઇડર્સ — 153 કેટલોગ-ચિહ્નિત મફત
> **388 નોંધાયેલા પ્રોવાઇડર્સ** કેનોનિકલ ચેટ, મીડિયા, શોધ, સ્થાનિક, ક્લાઉડ-એજન્ટ અને સિસ્ટમ સંગ્રહોમાં, જેમાં **153 પાસે `hasFree: true` ડિસ્કવરી મેટાડેટા છે**. ચેટ મોડેલ રજિસ્ટ્રીમાં **239 પ્રોવાઇડર્સ / 3,059 અલગ પ્રોવાઇડર-મોડેલ જોડીઓ / 1,475 કાચા મોડેલ IDs** આવરી લેવાય છે; અલગ મફત-બજેટ કેટલોગમાં **471 પ્રતિ-મોડેલ પંક્તિઓ**, **34 પુનરાવર્તિત પૂલ્સ** અને **52 પુનરાવર્તિત/કીલેસ હંમેશાં-મફત પ્રોવાઇડર્સ** છે. આ અલગ છેદકો જાણપૂર્વક રાખવામાં આવ્યા છે; વ્યાખ્યાઓ અને પૂલ-ડિડુપ્લિકેટેડ ગણતરીઓ [પ્રોવાઇડર સંદર્ભ](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 ઑટો-રાઉટર, 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 neurons/દિવસ
NVIDIA NIM GLM, MiniMax ~40 RPM મફત
Cerebras GLM 4.7, GPT-OSS એક વખતનું $5 ક્રેડિટ; કાર્ડ જરૂરી
### 🧩 નવું: VS કોડની મૂળ Copilot ચેટની અંદર OmniRoute
> કોઈ નવી સાઇડબાર નથી, કોઈ નવી ચેટ UI નથી — દરેક મોડેલ OmniRoute સેવા આપે છે તે સીધું જ દેખાય છે** તમે પહેલેથી જ ઉપયોગ કરો છોCopilot ચેટ મોડેલ પીકર** . VS કોડ 1.122 થી, પ્રદાતા મોડલ્સ GitHub સાઇન-ઇન અથવા Copilot સબ્સ્ક્રિપ્શન વિના કામ કરે છે — એજન્ટ મોડ, ટૂલ કૉલિંગ અને વિઝન, મફતમાં.
ઇન્સ્ટોલ કરો** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** એક્સ્ટેંશન, તેને તમારા OmniRoute સર્વર પર નિર્દેશિત કરો ( `localhost:20128` પર ડિફોલ્ટ), પછી Copilot Chat → મોડલ પીકર → ખોલો** મોડલ્સ મેનેજ કરો...** →**OmniRoute** .
સંપાદકની અંદરથી: ખોલો** એક્સ્ટેન્શન્સ** જુઓ, શોધો** "OmniRoute"** , ક્લિક કરો** ઇન્સ્ટોલ કરો** - બંને સ્ટોર પર સમાન રીતે કામ કરે છે. સ્ત્રોત, મુદ્દાઓ અને પ્રકાશન રનબુક [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) પર જીવંત છે.
📖 [VS કોડ Copilot ચેટ માર્ગદર્શિકા](docs/guides/VSCODE-COPILOT.md) — સેટઅપ, પીકર શું બતાવે છે, ડેશબોર્ડ-ઇન-એ-ટેબ, સમસ્યાનિવારણ
### 🎩 નવું: OmniRouteTray — તમારું ગેટવે, મેનુ બારમાં રહે છે
> જ્યારે તે હંમેશા ચાલુ હોય ત્યારે`omniroute serve` સૌથી વધુ ખુશ હોય છે.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** તેને macOS માટે સેટ-એન્ડ-ફોર્ગેટ મેનૂ-બાર એપ્લિકેશનમાં ફેરવે છે: તે સર્વર શરૂ કરે છે, તેને રીબૂટ દરમિયાન જીવંત રાખે છે, તેને સ્થાને અપડેટ કરે છે અને તમારા લાઇવ ટોકન બજેટને એક ક્લિક દૂર રાખે છે —** કોઈ ટર્મિનલ વિન્ડો ખુલ્લી નથી, બેબીસીટ માટે કોઈ `npm install -g omniroute` નથી.**
[Tauri v2](https://v2.tauri.app/) (રસ્ટ કોર રાઉન્ડિંગ એરરનું કદ) સાથે બનેલ છે, તે તેના પોતાના હસ્તાક્ષરિત નોડ 24 રનટાઇમ મોકલે છે અને એપ્લિકેશનની માલિકીની OmniRoute ઇન્સ્ટોલનું સંચાલન કરે છે, તેથી તે ક્યારેય તમારા વૈશ્વિક `node`/`bun` સામે લડશે નહીં. તે** તમારી હાલની `~/.omniroute/` રૂપરેખા અને ડેટાબેઝ શેર કરે છે** - તેથી તે એ જ OmniRoute છે જે તમે પહેલાથી જ ચલાવો છો, ફક્ત ટોપી પહેરીને. 🎩
તે શું કરે છે
કેવી રીતે
🟢 સર્વર
સ્પાવન્સ omniroute ની દેખરેખ રાખે છે,
નું ડુપ્લિકેટ કરવાને બદલે પહેલેથી જ ચાલી રહેલ દાખલો અપનાવે છે
📊 Claude
session/weekly
🔄 સ્થાને સ્વતઃ-અપડેટ્સ
સ્ટેજ્ડ ઇન્સ્ટોલ, પરમાણુ સ્વેપ, નિષ્ફળતા પર રોલબેક — હંમેશા નવા રિલીઝ
પર
🚀 લોગિન પર પ્રારંભ કરો
લોગિન પર વૈકલ્પિક લોન્ચ; માત્ર-ટ્રે, કોઈ ડોક આયકન
🩺 ડૉક્ટર & લૉગ્સ
એક-ક્લિક ડાયગ્નોસ્ટિક્સ અને સર્વર લોગ એક્સેસ
```sh
brew install --cask zoispag/tap/omniroute-tray
```
ડાઉનલોડ કરવાનું પસંદ કરો છો? માંથી નવીનતમ .dmg મેળવો
રિલીઝ કરે છે. સ્ત્રોત, મુદ્દાઓ અને બિલ્ડ
દસ્તાવેજો zoispag/omniroute-tray પર રહે છે.
💛 @zoispag દ્વારા સમુદાય પ્રોજેક્ટ — સત્તાવાર OmniRoute રિલીઝ નથી.
> સર્વર ઉપરાંત, OmniRoute એ **80+ કમાન્ડ્સ** ધરાવતું **સંપૂર્ણ કમાન્ડ-લાઇન કૉકપિટ** છે, તેમજ ઓપન એજન્ટ પ્રોટોકોલ્સ પણ ધરાવે છે જેથી AI એજન્ટ તેને **જાતે જ** સંચાલિત કરી શકે.
### ⌨️ વાસ્તવિક CLI (માત્ર `start` નહીં)
```bash
omniroute # ગેટવે + ડૅશબોર્ડ સર્વ કરો (પોર્ટ 20128)
omniroute chat # ઇન્ટરેક્ટિવ TUI ચેટ ક્લાયન્ટ (સ્લેશ: /model /combo /skill /memory)
omniroute setup # માર્ગદર્શિત પ્રથમ-રન વિઝાર્ડ
omniroute doctor # પ્રોવાઇડર્સ, પોર્ટ્સ અને નેટિવ ડિપેન્ડન્સીઝનું નિદાન કરો
```
### 🛰️ રિમોટ મોડ — CLI અહીં ચલાવો, OmniRoute VPS પર
સર્વર પર OmniRoute છે? **એ જ CLI** વડે તેને તમારા લેપટોપ પરથી સંચાલિત કરો. સ્કોપ્ડ ઍક્સેસ ટોકન વડે એક વાર લૉગ ઇન કરો;
ત્યારબાદ દરેક કમાન્ડ રિમોટને લક્ષ્ય બનાવે છે.
```bash
omniroute connect 192.168.0.15 # પાસવર્ડ → સ્કોપ્ડ ટોકન, કોન્ટેક્સ્ટ તરીકે સાચવવામાં આવે છે
omniroute models # ← રિમોટ સર્વર સામે ચાલે છે
omniroute configure codex # ← રિમોટ મોડલ પસંદ કરે છે, સ્થાનિક Codex પ્રોફાઇલ લખે છે
omniroute tokens create --name ci --scope read # અન્ય મશીનો માટે વધુ મર્યાદિત ટોકન્સ બનાવો
omniroute contexts use default # ← સ્થાનિક સર્વર પર પાછા સ્વિચ કરો
```
ટોકન્સ `read` / `write` / `admin` સ્કોપ ધરાવે છે; પ્રોસેસ શરૂ કરતા રૂટ્સ માત્ર લૂપબૅક સુધી મર્યાદિત રહે છે.
📖 [રિમોટ મોડ](docs/guides/REMOTE-MODE.md)
### 🤝 એજન્ટને કનેક્ટ કરો — અને તે OmniRouteને જાતે નિયંત્રિત કરે છે
OmniRouteને **MCP**, **A2A**, **REST API**, **webhooks** અથવા **રિમોટ CLI** દ્વારા ઉપલબ્ધ બનાવો — કોઈપણ સક્ષમ એજન્ટ (અથવા તમારો પોતાનો કોડ) આખા ગેટવેનું નિયંત્રણ મેળવે છે: રૂટિંગ, પ્રોવાઇડર્સ, કોમ્બોઝ, કૅશ, કમ્પ્રેશન, મેમરી — સ્વાયત્ત રીતે. નીચેના HTTP એન્ડપોઇન્ટ્સ `http://localhost:20128` હેઠળ સર્વ થાય છે.
ઇન્ટરફેસ
એન્ડપોઇન્ટ / કમાન્ડ
આ માટે તેનો ઉપયોગ કરો
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor અથવા કોઈપણ MCP ક્લાયન્ટ સાથે જોડો
```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-એન્જિનનો સ્ટૅક
એન્જિન પાઇપલાઇનના ક્રમમાં ચાલે છે; દરેક એન્જિનને સ્વતંત્ર રીતે ચાલુ/બંધ કરી શકાય છે અને દરેક કોમ્બો માટે ગોઠવી શકાય છે:
#
એન્જિન
તે શું કરે છે
1
Session-Dedup
ટર્ન્સ દરમિયાન પુનરાવર્તિત કન્ટેન્ટ દૂર કરે છે (કન્ટેન્ટ-એડ્રેસ્ડ, ક્રોસ-ટર્ન)
2
CCR
મોટા બ્લૉક્સને રિટ્રીવ માર્કર્સ પાછળ આર્કાઇવ કરે છે અને જરૂર પડે ત્યારે મેળવે છે
3
Lite
વ્હાઇટસ્પેસ અને ઇમેજ-URL ટ્રિમિંગ (ઓછી લેટન્સીનો બેઝલાઇન)
4
RTK
સ્માર્ટ ટૂલ-રિઝલ્ટ ફિલ્ટરિંગ, ડિડુપ અને ટ્રન્કેશન (કમાન્ડ-અવેર)
5
Responses Tool Output
શેલ/પૅચ/સર્ચ/બિલ્ડ આઉટપુટ માટે લૉસલેસ-ફર્સ્ટ JSON અને મર્યાદિત ડાયગ્નોસ્ટિક કમ્પ્રેશન (Responses API)
છેલ્લી વપરાશકર્તા ક્વેરી સામે એક્સટ્રેક્ટિવ વાક્ય સ્કોરિંગ
8
Caveman
નિયમ-આધારિત ગદ્ય કમ્પ્રેશન (આઉટપુટ પર ~65–75%)
9
Aggressive
જૂના ટર્ન્સનું સારાંશીકરણ અને ક્રમશઃ એજિંગ
10
LLMLingua-2
MobileBERT ONNX દ્વારા ML સેમેન્ટિક પ્રુનિંગ — કોડ-સેફ, અસિંક્રોનસ
11
Ultra
વૈકલ્પિક નાના-મોડેલ (SLM) ટિયર સાથે હ્યુરિસ્ટિક ટોકન પ્રુનિંગ
12
OmniGlyph
ડાયરેક્ટ Anthropic વાયર પર માપવામાં આવેલા Claude Fable 5 માટે પ્રાયોગિક કૉન્ટેક્સ્ટ-એઝ-ઇમેજ એન્કોડિંગ; પ્રોવાઇડર રસીદો મળવાની રાહમાં GPT 5.6 ટ્રાન્સફૉર્મર્સ ફેલ-ક્લોઝ્ડ રહે છે. ચાર કમ્પ્રેશન પ્રોફાઇલ (ડિફૉલ્ટ તરીકે aggressive, balanced, coding-safe, passthrough) (સૌથી વધુ aggressive; opt-in)
કોડ બ્લૉક્સ, URL અને સ્ટ્રક્ચર્ડ ડેટા **હંમેશાં** બાઇટ-પરફેક્ટ રીતે પ્રિઝર્વ રહે છે. **વન-ક્લિક પ્રીસેટ્સ** એન્જિનોને જોડે છે:
મોડ
બચત
આ માટે શ્રેષ્ઠ
🪶 Lite
~15%
હંમેશાં ચાલુ રહેતું સુરક્ષિત ડિફૉલ્ટ
🪨 Standard (Caveman)
~30%
દૈનિક કોડિંગ
⚡ Aggressive
~50%
લાંબા ટૂલ-ભરપૂર સેશન્સ
🔥 Ultra
~75%
મહત્તમ બચત
🧰 RTK
60–90%
શેલ/ટેસ્ટ/બિલ્ડ/git આઉટપુટ
🔗 Stacked (RTK → Caveman)
78–95%
મિશ્ર પ્રૉમ્પ્ટ્સ અને ટૂલ લૉગ્સ
**વાસ્તવિક ઉદાહરણ — Standard મોડ:**
> **પહેલાં (69 ટોકન):** _"તમારો React કમ્પોનન્ટ ફરીથી રેન્ડર થવાનું કારણ સંભવતઃ એ છે કે તમે દરેક રેન્ડર સાયકલ દરમિયાન નવો ઑબ્જેક્ટ રેફરન્સ બનાવી રહ્યા છો. જ્યારે તમે inline ઑબ્જેક્ટને prop તરીકે પાસ કરો છો, ત્યારે Reactની શેલો કમ્પેરિઝન તેને દર વખતે અલગ ઑબ્જેક્ટ તરીકે જુએ છે, જેના કારણે ફરીથી રિ-રેન્ડર થાય છે. ઑબ્જેક્ટને મેમોઇઝ કરવા માટે useMemoનો ઉપયોગ કરવાની હું ભલામણ કરીશ."_
>
> **પછી (19 ટોકન):** _"દરેક રેન્ડર પર નવો ઑબ્જેક્ટ રેફ. Inline ઑબ્જેક્ટ prop = નવો રેફ = ફરી રેન્ડર. useMemoમાં રૅપ કરો."_
>
> **એ જ જવાબ. 72% ઓછા ટોકન. ચોકસાઈમાં શૂન્ય નુકસાન.** ✅
**PT-BR ઉદાહરણ — [Troglodita](https://github.com/leninejunior/troglodita) મોડ:**
> **પહેલાં (42 ટોકન):** _"સમસ્યા એ છે કે દરેક રેન્ડરિંગ ચક્રમાં ઑબ્જેક્ટનો નવો રેફરન્સ બનાવવામાં આવે છે, તેથી કમ્પોનન્ટ ફરી રેન્ડર થઈ રહ્યું છે. હું `useMemo` વાપરવાની ભલામણ કરીશ."_
>
> **પછી (12 ટોકન):** _"ફરી રેન્ડર: દરેક ચક્રમાં નવો રેફરન્સ (ઇનલાઇન ઑબ્જેક્ટ ફરી બનાવાયો). `useMemo` વાપરો."_
>
> **એ જ જવાબ. લગભગ 70% ઓછા ટોકન. તકનીકી ચોકસાઈ અખંડિત.** ✅
### 🎚️ એન્જિનથી આગળ — આઉટપુટ શૈલીઓ, અનુકૂલનશીલ ડાયલ અને પ્રતિ-વિનંતી નિયંત્રણ
ઉપરના 12 એન્જિન ઇનપુટને સંક્ષિપ્ત કરે છે. વધુ ત્રણ સ્તરો **કેવી રીતે**, **ક્યારે**, અને શું **બહાર આવે છે** તે ઘડે છે:
- **🪄 આઉટપુટ શૈલીઓ** _(આઉટપુટ-અક્ષ દિશાનિર્દેશન)_ — નિર્ધારિત, કૅશ-સુરક્ષિત પ્રતિભાવ-આકાર આપતી સૂચનાઓ દાખલ કરે છે; સંયોજ્ય, દરેક `lite` / `full` / `ultra` તીવ્રતા પર. શૈલી ઉમેરવી એ રજિસ્ટ્રીમાં એક પંક્તિ ઉમેરવા જેટલું સરળ છે:
- **ટૂંકું ગદ્ય** — ભરાવદાર શબ્દો / આર્ટિકલ / અતિસાવચેતીભર્યા શબ્દપ્રયોગ દૂર કરો; તકનીકી સારતત્ત્વ ચોક્કસ રાખો.
- **ઓછો કોડ** — "આળસુ સિનિયર ડેવ" YAGNI: સૌથી નાનો કાર્યરત ફેરફાર, ન માંગાયેલું સ્કૅફોલ્ડિંગ નહીં.
- **પોનીટેલ (આળસુ સિનિયર ડેવ)** — YAGNIની સીડી ચઢો, મૂળ કારણ ઠીક કરો, સૌથી નાનો કાર્યરત ડિફ.
- **મને ADHD છે (ઍક્શન-ફર્સ્ટ)** — આગળની ક્રિયા પ્રથમ આવે, પગલાં ક્રમાંકિત હોય, એક ચોક્કસ આગલું પગલું હોય, પ્રસ્તાવના નહીં.
- **ટૂંકું CJK (文言)** — શાસ્ત્રીય-ચીની અતિ-ટૂંકી શૈલી (`zh` માટે લોકેલ-ગેટેડ).
- **🎯 અનુકૂલનશીલ કૉન્ટેક્સ્ટ-બજેટ** _(ડાયલ)_ — એક જ ચાલુ/બંધ ટોકન થ્રેશોલ્ડને બદલે, સૌથી સસ્તા અને સૌથી ઓછા નુકસાનવાળા એન્જિનોને તેટલા જ આગળ વધારે છે જેટલા જરૂરી હોય, જેથી **મૉડલની કૉન્ટેક્સ્ટ વિન્ડોમાં ફિટ** થઈ શકે. નીતિ: `reserve-output` (ડિફૉલ્ટ, મૉડલ-જાગૃત) · `percentage` · `absolute`. મોડ: `floor` (ફિટ થવાની ખાતરી) · `replace-autotrigger` (તમારી સ્પષ્ટ પસંદગી પ્રાધાન્ય પામે) · `off` (લેગસી થ્રેશોલ્ડ).
- **🎛️ કમ્પ્રેશન ક્યાં નક્કી થાય છે** _(પ્રાધાન્યક્રમ, ઉચ્ચ → નીચું)_ — પ્રતિ-વિનંતી `x-omniroute-compression` હેડર › રાઉટિંગ-કોમ્બો ઓવરરાઇડ › સક્રિય નામિત પ્રોફાઇલ › અનુકૂલનશીલ / ઑટો-ટ્રિગર › પેનલ ડિફૉલ્ટ › બંધ. લાગુ કરાયેલ પ્લાન `X-OmniRoute-Compression: ; source=` પ્રતિભાવ હેડરમાં પાછો દર્શાવવામાં આવે છે.
ટોકન થ્રેશોલ્ડ દ્વારા ઑટો-ટ્રિગર કરો, અનુકૂલનશીલ ડાયલ ચાલુ કરો, નામિત પ્રોફાઇલ પિન કરો, પ્રતિ વિનંતી એકવારની સેટિંગ કરો, અથવા દરેક રાઉટિંગ કોમ્બો માટે પાઇપલાઇન સોંપો — વર્કલોડને જે યોગ્ય પડે તે. ફેરફાર પ્રમોટ કરતા પહેલાં પિન કરેલા કોર્પસ પર વિશ્વસનીયતા વિરુદ્ધ બચતનું મૂલ્યાંકન કરવા માટે વૈકલ્પિક ઑફલાઇન **eval harness** (`npm run eval:compression`) ઉપલબ્ધ છે.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ ઝડપી શરૂઆત
**1) ઇન્સ્ટોલ કરો અને ચલાવો**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` અથવા peer-dep ચેતવણીઓ દેખાય છે? [તે હાનિરહિત છે](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 અથવા તે પછીનું વર્ઝન વાપરો છો?** npm પેકેજની lifecycle સ્ક્રિપ્ટ્સને મંજૂરી ન હોય ત્યાં સુધી અવરોધિત કરી શકે છે. OmniRouteની `postinstall` (`node scripts/build/postinstall.mjs`) તેની native runtime ફાઇલો તૈયાર કરવા માટે જરૂરી છે. વૈશ્વિક રીતે ઇન્સ્ટોલ કરતી વખતે npmની ચેતવણીમાં દર્શાવેલા પેકેજોને મંજૂરી આપો. OmniRoute 3.8.54 દ્વારા જણાવાયેલા પેકેજ સેટ માટે:
>
> ```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 અલગ સૂચિ દર્શાવે, તો તે ચેતવણીમાં આપેલા પેકેજ નામો વાપરો. કોઈ પેકેજને મંજૂરી આપવાથી તેની install સ્ક્રિપ્ટ્સ ચલાવવાની પરવાનગી મળે છે.
> **Gemini Web અથવા અન્ય web-cookie provider વાપરો છો?** npm પેકેજમાં
> Playwright શામેલ છે, પરંતુ તેનું Chromium binary નથી. પ્રથમ web-provider વિનંતી કરતા પહેલાં
> [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> નોંધ જુઓ.
ડૅશબોર્ડ અહીં છે `http://localhost:20128` · API અહીં છે `http://localhost:20128/v1`.
**2) તમારા પોતાના એકાઉન્ટનો ઉપયોગ કરીને યોગ્ય provider કનેક્ટ કરો**
ડૅશબોર્ડ → **Providers** → એવો provider પસંદ કરો જેના વર્તમાન નિયમો અને ક્વોટા તમારા ઉપયોગપ્રસંગને અનુરૂપ હોય → તેની API key ઉમેરો અથવા એકાઉન્ટ પ્રક્રિયા પૂર્ણ કરો. Free tiers માટે signup, approval અથવા payment method જરૂરી હોઈ શકે છે. [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) જુઓ; keyless ઉપલબ્ધતાની ખાતરી નથી, અને `tos: avoid` તરીકે ચિહ્નિત providersને ડિફૉલ્ટરૂપે `auto`માંથી બાકાત રાખવામાં આવે છે.
**3) તમારા coding toolને નિર્દેશિત કરો**
```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"
```
તમને કનેક્ટ કરેલા modelsની સૂચિ દેખાવી જોઈએ. 🎉 બસ એટલું જ — કોડિંગ શરૂ કરો, અને OmniRoute તમારા માટે આપમેળે રાઉટ તથા fallback કરશે.
જો તમારું client custom headers મોકલી શકતું ન હોય, તો OmniRoute tokenized compatibility aliases પણ આપે છે:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
આનો ઉપયોગ માત્ર એવા clients માટે કરો જે `Authorization: Bearer ...` જોડાવી શકતા નથી. 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 હીપ જોઈએ છે, નહિતર બે ઓવરલૅપ થતા લાંબા કોન્ટેક્સ્ટ હેઠળ પ્રક્રિયામાં ~12 GiB પર `FATAL ERROR` આવે છે. કન્ટેનરનું કદ હીપ કરતાં મોટું રાખો (નેટિવ બફર્સ V8ની બહાર રહે છે):
| વર્કલોડ | હીપ (`-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 + સ્થાનિક રૂટલેસ Podman (રિમોટ Podman Machine ક્લાયન્ટ પર ક્યારેય નહીં):
podman unshare chown 1000:1000 ./data
# 3. રનટાઇમ સંકેત સેટ કરો, સ્થાનિક Compose ઇમેજ બિલ્ડ કરો અને શરૂ કરો
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS અથવા Windows પર, Podman રિમોટ Podman Machineનો ઉપયોગ કરે છે: `podman unshare`ને છોડી દો અને
[ટોપોલોજી-વિશિષ્ટ ડેટા ડિરેક્ટરી માર્ગદર્શન](contrib/podman/README.md#data-directory-permissions-by-topology) અનુસરો.
📖 [Podman માર્ગદર્શિકા](contrib/podman/README.md) — Compose બિલ્ડ્સ, Podman Machine અને
Linux/systemd Quadlet સેટઅપ.
**⚡ વધુ ઝડપી / હળવું ઇન્સ્ટોલેશન (નેટિવ બિલ્ડ છોડો)**
નેટિવ SQLite એન્જિન (`better-sqlite3`) એક **વૈકલ્પિક** ડિપેન્ડન્સી છે, તેથી વૈશ્વિક
ઇન્સ્ટોલેશન ક્યારેય સોર્સમાંથી કમ્પાઇલ થવાની રાહમાં અટકતું નથી: જ્યારે તમારા
પ્લૅટફૉર્મ/Node સાથે મેળ ખાતી પ્રીબિલ્ટ બાઇનરી હોય ત્યારે તેનો ઉપયોગ કરે છે, અને અન્યથા પારદર્શક રીતે શુદ્ધ-JS એન્જિન
(Node 22+ પર `node:sqlite`, નહિતર બંડલ કરેલું `sql.js` WASM) પર ફૉલબૅક કરે છે — કોઈ બિલ્ડ ટૂલ્સની જરૂર નથી.
ઇન્સ્ટોલેશન પછીનું નેટિવ વૉર્મ-અપ સંપૂર્ણપણે છોડવા માટે (CI, હેડલેસ અથવા ધીમા મશીનો):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 પણ તેને છોડી દે છે
```
સૌથી ઝડપી ઇન્સ્ટોલેશન માટે **pnpm**ને પ્રાધાન્ય આપો (કન્ટેન્ટ-એડ્રેસ્ડ સ્ટોર + હાર્ડ લિંક્સ — ઉપર જુઓ).
ડૅશબોર્ડ વિનાના, હેડલેસ રનટાઇમ માટે Docker `base` પ્રોફાઇલ (ઉપર) અથવા
[Termux માર્ગદર્શિકા](docs/guides/TERMUX_GUIDE.md)નો ઉપયોગ કરો. CLI અને વેબ ડૅશબોર્ડ સમાન
પ્રક્રિયા દ્વારા એક જ પોર્ટ પર સર્વ થાય છે, તેથી હાલમાં કોઈ અલગ ફક્ત-CLI પૅકેજ નથી.
# ⭐ ટોચના યોગદાનકર્તાઓ
> OmniRoute એક ઉત્સાહી ઓપન-સોર્સ સમુદાય દ્વારા ઘડાયેલું છે. આ વ્યક્તિઓએ પ્રોજેક્ટની ગુણવત્તા, સ્થિરતા અને પહોંચ પર સીધી અસર પાડતું અસાધારણ યોગદાન આપ્યું છે. **આભાર.**
### મર્જ થયેલી પુલ રિક્વેસ્ટ્સ પ્રમાણે બાહ્ય યોગદાનકર્તાઓ
2026-11-03 03:01:19 UTCના રોજ જીવંત release/v3.8.53 ટિપ 05bc048d6c સાથે ગણતરી કરવામાં આવી. પૃષ્ઠાંકિત GitHub GraphQL ગણતરીમાં 9,947 મર્જ થયેલી PRs છે: રિપોઝિટરી માલિક દ્વારા 4,130, Dependabot દ્વારા 240, અન્ય બૉટ્સ/ઍપ્સ દ્વારા 6, અને 883 અલગ યોગદાનકર્તાઓ તરફથી 5,571 બાહ્ય PRs. “બદલાયેલી લાઇનો” એ GitHub additions + deletions છે અને તેમાં જનરેટ થયેલી ફાઇલો, લૉકફાઇલો, કૅટલોગ્સ, અનુવાદો અને દસ્તાવેજીકરણનો સમાવેશ થાય છે; તે churn છે, લખાયેલ LOC નથી. 53 PRsમાં GitHub diffs 500,000 લાઇનો કરતાં વધુ હોવાનું દર્શાવવામાં આવ્યું છે (ઉદાહરણ તરીકે #13399, જેમાં એક જ provider addition માટે 2,347 બદલાયેલી ફાઇલો દર્શાવવામાં આવી છે), જેના કારણે ઉપરના કેટલાક કુલ આંકડા વધે છે. સમાન ક્રમ ધરાવતા યોગદાનકર્તાઓને સાથે ક્રમાંકિત કરવામાં આવ્યા છે.
### GitHub દ્વારા શ્રેય અપાયેલા કમિટ્સ
2026-11-03 02:09:16 UTC પર ફરીથી ચકાસાયેલ: ડિફૉલ્ટ બ્રાન્ચ release/v3.8.53 માટે રિપોઝિટરીની Contributors API દ્વારા જાણ કરાયેલા GitHub દ્વારા ગણાવાયેલા કમિટ્સ. API એ 903 ઓળખો પરત કરી (429 વપરાશકર્તાઓ, 2 બૉટ્સ, 472 અનામી); આ કોષ્ટક મેન્ટેનર, બૉટ્સ અને અનામી ઓળખોને બાકાત રાખે છે અને સ્પર્ધાત્મક સમતુલ્યો જાળવી રાખે છે. તે ઉપરની મર્જ્ડ-PR રેન્કિંગ અને નીચેના Git-મેટાડેટા સર્વેક્ષણ બંનેથી અલગ છે.
> 🙏 આ યોગદાનકર્તાઓની સુવિધાઓ, બગ ફિક્સ અને ઇન્ફ્રાસ્ટ્રક્ચરમાં કરાયેલા સુધારાઓ OmniRoute ને વિશ્વસનીય અને સુવિધાસંપન્ન બનાવે છે તે બાબતનો **મુખ્ય ભાગ** છે. દરેક પુલ રિક્વેસ્ટ, દરેક ટેસ્ટ કેસ અને દરેક i18n અનુવાદ ફાઇલ મહત્વ ધરાવે છે. ઓપન સોર્સ તેમના જેવા લોકો દ્વારા બનાવવામાં આવે છે.
---
## 💖 પ્રાયોજકો
પોતાના ખિસ્સામાંથી OmniRouteને નાણાકીય સહાય આપતા લોકોનો હૃદયપૂર્વક આભાર — દરેક યોગદાન પ્રોજેક્ટને મફત, સ્વતંત્ર અને આગળ વધતું રાખે છે.
… અને અન્ય લોકો, જેઓ પોતાની ઓળખ ખાનગી રાખવાનું પસંદ કરે છે 💛જાહેર GitHub Sponsorsની GitHub Sponsors GraphQL API દ્વારા 2026-10-18ના રોજ પુનઃચકાસણી કરવામાં આવી: કુલ 14માંથી 11 જાહેર પ્રાયોજકતાઓ (6 સક્રિય, 5 ભૂતપૂર્વ). GitHubનું isActive સ્ટેટસ ઉપરનાં સક્રિય લેબલ નક્કી કરે છે; ભૂતપૂર્વ જાહેર એક વખતના સમર્થકોનો આભાર યથાવત્ માનવામાં આવે છે અને ખાનગી પ્રાયોજકો અનામી રહે છે. Ko-fi, Buy Me a Coffee, Liberapay, PIX અને ક્રિપ્ટો દાનો સૂચિબદ્ધ નથી, કારણ કે તેમની કોઈ જાહેર પ્રાયોજક નોંધ ઉપલબ્ધ નથી.💖 પ્રાયોજક બનો → — દરેક ડૉલર OmniRouteને મફત અને સ્વતંત્ર રાખે છે.
## 👥 1,000+ યોગદાનકર્તાઓ
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-11-02ના રોજ live release/v3.8.53 tip 1c7135e0fb (7,972 commits) પર ઓડિટ કરવામાં આવ્યું: 1,074 સામાન્યકૃત માનવીય Git ઓળખો — 759 commit authors તરીકે દેખાય છે (maintainer સહિત) અને 315 માત્ર સ્પષ્ટ Co-authored-by trailersમાં છે. આ ગણતરીમાં .mailmap લાગુ કરવામાં આવે છે, e-mail addressesની સરખામણી case-insensitive રીતે કરવામાં આવે છે, numeric અને plain GitHub noreply addressesને માત્ર ત્યારે જોડવામાં આવે છે જ્યારે તેઓ સમાન handle દર્શાવે, 29 bot/agent/service/placeholder identitiesને બાકાત રાખવામાં આવે છે, અને માત્ર display names મેળ ખાતાં હોવાને કારણે સામાન્ય e-mail addressesને મર્જ કરવામાં આવતાં નથી. 2026-08-24ની ઓડિટમાં 639 પ્રકાશિત થયા હતા; આ ઓડિટના base ac02c5b42f પર આ પદ્ધતિ ફરી ચલાવતા 619 મળે છે, તેથી વધારો નવી યોગદાનકર્તાઓને કારણે છે, વધુ ઢીલી પદ્ધતિને કારણે નહીં.
### યોગદાન કેવી રીતે આપવું
1. repository fork કરો
2. **active** `release/vX.Y.Z` tip પરથી branch બનાવો (`main` પરથી નહીં) — [Branching & Release Model](docs/ops/BRANCHING_MODEL.md) જુઓ
3. તમારી feature branch બનાવો (`git checkout -b feat/amazing-feature`)
4. તમારા ફેરફારો commit કરો (`git commit -m 'feat: add amazing feature'`)
5. branch પર push કરો (`git push origin feat/amazing-feature`)
6. **base = તે `release/vX.Y.Z` branch** સાથે Pull Request ખોલો
વિગતવાર માર્ગદર્શિકા માટે [CONTRIBUTING.md](CONTRIBUTING.md) જુઓ.
### નવું સંસ્કરણ રિલીઝ કરવું
```bash
# રિલીઝ બનાવો — npm publish આપમેળે થાય છે
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 સ્ટાર્સ
## 🌍 StarMapper
## 🙏 આભારવિધિ
OmniRoute મહાન પ્રોજેક્ટ્સના ખભા પર ઊભું છે. તેની શરૂઆત **[9router](https://github.com/decolua/9router)** ના fork અને Go પ્રોજેક્ટ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** ના TypeScript port તરીકે થઈ હતી — અને ત્યારથી નીચેની દરેક subsystem કોઈને કોઈ એવા open-source પ્રોજેક્ટથી પ્રેરિત થઈ છે, જે આ ક્ષેત્રમાં પહેલેથી આગળ વધી ચૂક્યો હતો. દરેક પ્રોજેક્ટે OmniRouteના એક ચોક્કસ ભાગને આકાર આપ્યો છે. આ સૌ માટે અમારો આભાર. 🙏
> ⭐ 3 નવેમ્બર, 2026ના રોજ GitHubની REST API પરથી star counts ચકાસવામાં આવ્યા છે — આ પ્રોજેક્ટ્સને star આપો. આ counts ચોક્કસ તારીખનો snapshot છે અને સ્વાભાવિક રીતે બદલાતા રહેશે.
### 🧬 વારસો અને gateway
એવું AI gateway જેના public pricing dataset પરથી અમારી cost-tracking sync ચાલે છે અને જેના provider-normalization modelથી અમારી routingને માર્ગદર્શન મળ્યું.
વેચાણમાં સમાવાયેલ ChatGPT Web → Codex Responses bridgeમાં અપનાવાયેલ MIT source, જેમાં browser-session, response-framing, usage અને web-search adaptersનો સમાવેશ થાય છે.
તેના Grok model mappings, fake-TypeError Statsig generator, request અને device defaults, તથા NDJSON response processorને OmniRouteના Grok Web executorમાં નોંધપાત્ર રીતે અપનાવવામાં આવ્યા.
grok2api-merged પાછળનો મુખ્ય transitive code source; તેના model, header, payload, Statsig અને processor implementations Grok Web lineageમાં જાળવી રાખવામાં આવ્યા છે.
Grok payload અને device defaults, Statsig generator તથા TQZHR અને grok2api-merged મારફતે આગળ લાવવામાં આવેલા result.response processor માટેનો મૂળ MIT source.
તેના proxy-pool layer માટે grok2api-merged દ્વારા credit આપવામાં આવેલ transitive source; OmniRoute આ lineage notice જાળવે છે, પરંતુ તેના bounded Grok Web executorમાં proxy-pool portનો દાવો કરતું નથી.
તેના HTTP/browser upstream design માટે મૂળ Grok Web implementationનો અભ્યાસ કરવામાં આવ્યો; તેનો direct HTTP path GrokProxy પરથી ઉતરી આવ્યો છે, તેથી કોઈ સ્વતંત્ર code portનો દાવો કરવામાં આવતો નથી.
વાયરલ "શા માટે ઘણા token વાપરવા જ્યારે થોડા tokenથી કામ ચાલે" પ્રોજેક્ટ — તેની caveman-speak ફિલસૂફી અમારા standard compression mode અને 30+ filler/condensation નિયમોને શક્તિ આપે છે.
PT-BR token compression — અમારા pt-BR language packને શક્તિ આપે છે: Brazilian-Portuguese grammar માટે pleonasm reduction અને filler removalને અનુકૂળ બનાવે છે.
Rust columnar-JSON + content-addressed retrieve + cross-message dedup — તેના પરથી અમારી headroom/ccr/session-dedup engine design અને cache-stable "compressed form is position-independent" invariantને માન્યતા મળી.
coding-assistant ↔ LLM ટ્રાફિકના MITM interception/analysisથી શરૂઆતની Traffic Inspector આવશ્યકતાઓ નક્કી કરવામાં મદદ મળી. અગાઉ પ્રાપ્ત કરાયેલા ચાર modules — SSE merging, conversation normalization, secret masking અને header sanitization — હવે જાહેર protocol standards પર આધારિત સ્વતંત્ર clean-room implementations દ્વારા બદલવામાં આવ્યા છે. બે host-passthrough surfaces (passthrough.ts અને _internal/bypass.cjs) OmniRouteની આંતરિક implementations તરીકે સ્વતંત્ર રીતે વર્ગીકૃત રહે છે; તે replacementના ભાગરૂપે ફરીથી લખવામાં આવ્યા ન હતા.
દરેક process માટે પારદર્શક proxy routing — અમારા crash-safe MITM teardown, socket idle-timeouts, /proc process attribution અને TPROXY capture માટે પ્રેરણારૂપ બન્યું.
secure-by-default librariesની curated list, જે અમારી security choices (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)ને માર્ગદર્શન આપે છે.
Grok Build quota surface ઓળખી કાઢ્યું; ત્યારબાદ OmniRouteએ live wire formatનું સ્વતંત્ર રીતે verification અને correction કર્યું.
## 📄 લાઇસન્સ
MIT લાઇસન્સ - વિગતો માટે [LICENSE](LICENSE) જુઓ.
---
**[⬆ ટોચ પર પાછા જાઓ](#-omniroute)** · ઓપન-સોર્સ AI સમુદાય માટે ❤️ સાથે બનાવેલું.
Diego Souza દ્વારા બનાવેલું · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT લાઇસન્સ · omniroute.online
> લાઇવ `/dashboard/free-tiers` પેજનો એનિમેટેડ સારાંશ. સંપૂર્ણ પદ્ધતિ (pool dedupe, credit tiers, provider terms): **[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` માટે યોગ્ય રૂટ આવશ્યક છે. નવી ઇન્સ્ટોલેશનમાં કોઈ યોગ્ય કીવિહોણા લક્ષ્યો ન હોઈ શકે, અને કીવિહોણો પ્રોવાઇડર તૃતીય-પક્ષ ક્લાયન્ટ્સને નકારી શકે છે. `tos: avoid` તરીકે ચિહ્નિત પ્રોવાઇડર્સ, જેમાં Kiro પણ સામેલ છે, ડિફૉલ્ટ રૂપે સ્વચાલિત રૂટિંગમાંથી બાકાત રાખવામાં આવે છે; એકાઉન્ટ કનેક્ટ કરવાથી તે સેટિંગ ઓવરરાઇડ થતું નથી. પ્રોવાઇડર પસંદ કરતાં પહેલાં [મફત ટિયર્સ માર્ગદર્શિકા](docs/getting-started/FREE-TIERS-GUIDE.md) જુઓ.
📦 **Python, Node.js, PHP, અને cURL** માટે કૉપી-પેસ્ટ કરી શકાય તેવી ક્વિકસ્ટાર્ટ સ્ક્રિપ્ટ્સ → [`examples/quickstart/`](examples/quickstart/)
> **કોમ્બો** એ મોડેલોની એક શૃંખલા છે, જેની વચ્ચે OmniRoute **આપમેળે** રાઉટ કરે છે. જો ક્વોટા ખૂટી જાય, કોઈ પ્રદાતા નિષ્ફળ જાય અથવા ખર્ચ વધી જાય, તો કોમ્બો આગલા પાત્ર અને કાર્યરત મોડેલ પર જઈ શકે છે. 🛡️
### ⚡ શૂન્ય-રૂપરેખાંકન — ફક્ત `auto` વાપરો
કોઈ કોમ્બો બનાવવાની જરૂર નથી. તમારા મોડેલને `auto` (અથવા તેના કોઈ પ્રકાર) પર સેટ કરો અને OmniRoute તમારા જોડાયેલા પ્રદાતાઓમાંથી વર્ચ્યુઅલ કોમ્બો બનાવશે, જેનું જીવંત મૂલ્યાંકન થાય છે:
📖 [Auto-Combo એન્જિન](docs/routing/AUTO-COMBO.md) · [સ્થિતિસ્થાપકતા માર્ગદર્શિકા](docs/architecture/RESILIENCE_GUIDE.md)
📊 9router, OpenRouter, CLIProxyAPI અને LiteLLM સામેની સંપૂર્ણ પદ્ધતિ અને દરેક સુવિધાની વિગતો → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
કી (રેન્ડમ): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix કૉપિ અને પેસ્ટ:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [અધિકૃતતા](docs/architecture/AUTHZ_GUIDE.md) · [સુરક્ષા નિયંત્રણો](docs/security/GUARDRAILS.md) · [અનુપાલન](docs/security/COMPLIANCE.md)
ડિફૉલ્ટ સ્ટૅક્ડ કોમ્બો `RTK → Caveman` ચલાવે છે. જ્યારે બંને એક જ ટૂલ/કૉન્ટેક્સ્ટ પેલોડ પર કાર્ય કરે છે, ત્યારે બચત સંયુક્ત થાય છે:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
કોડ બ્લૉક્સ, 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-એન્જિનનો સ્ટૅક
એન્જિન પાઇપલાઇનના ક્રમમાં ચાલે છે; દરેક એન્જિનને સ્વતંત્ર રીતે ચાલુ/બંધ કરી શકાય છે અને દરેક કોમ્બો માટે ગોઠવી શકાય છે:
