## 💰 તૃતીય-પક્ષના મફત સ્તરોમાં દર મહિને ~1.62B ટોકન્સ
> **તમારા પોતાના પ્રદાતા એકાઉન્ટ્સનો ઉપયોગ કરો.** આ અલગથી પાત્ર તૃતીય-પક્ષ મફત સ્તરોનો અંદાજિત કુલ આંકડો છે, OmniRoute તરફથી મળતી ટોકન ગ્રાન્ટ નથી. સાઇન અપ કરો, જ્યાં જરૂરી હોય ત્યાં ઓળખપત્રો મેળવો અને તમે ઉપયોગ કરી શકો તે પ્રદાતાઓને કનેક્ટ કરો; દરેક પ્રદાતા પોતાની મર્યાદાઓ, ઉપલબ્ધતા અને શરતો નિયંત્રિત કરે છે.
>
> મફત સ્તરોને જાતે એકત્રિત કરવા કષ્ટદાયક છે — ડઝનેક SDKs, ડઝનેક દર મર્યાદાઓ અને વાસ્તવમાં તમારી પાસે કેટલું છે તેનો કોઈ ખ્યાલ નહીં. 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":"Hello!"}]}'
```
`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 કી મેળવો →
સસ્તી અનુમાન 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/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
પુનરાવર્તનોમાંથી ડુપ્લિકેટ દૂર કર્યા વિના રૅન્ડમ પસંદગી 🎲
જે ટાર્ગેટની ક્વોટા વિન્ડો સૌથી વહેલી રીસેટ થાય તેને પ્રાથમિકતા આપો
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 + Chinese (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`) વડે રિમોટ OmniRoute ચલાવો + VPS ઇન્સ્ટૉલ માટે `antigravity` OAuth સહાયક. → [રિમોટ મોડ](docs/guides/REMOTE-MODE.md)
- **🧭 વધુ સ્માર્ટ ઑટો-રાઉટિંગ** — `auto/:` કોમ્બોઝ, **Fusion** (મોડલ પેનલ + નિર્ણાયક), કાર્ય-જાગૃત રાઉટિંગ, દરેક વિનંતી દીઠ મોડલ / મોડ / USD-બજેટ ઓવરરાઇડ્સ. → [ઑટો-કોમ્બો](docs/routing/AUTO-COMBO.md)
- **🗜️ પ્લગ કરી શકાય તેવું કમ્પ્રેશન** — 12 સંયોજિત કરી શકાય તેવા એન્જિન્સ + Compression Studios: LLMLingua-2, દ્વિ-સ્તરીય Ultra, omniglyph, દરેક પગલા દીઠ ફિડેલિટી ગેટ, GCF v3.2, ડ્રૅગ-રિઑર્ડર એડિટર. → [કમ્પ્રેશન](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ પારદર્શક MITM ડિક્રિપ્શન (TPROXY)** — દરેક SNI દીઠ CA + ટ્રસ્ટ-સ્ટોર ઇન્સ્ટૉલર સાથે પ્રૉક્સી env vars અવગણતા CLIને કૅપ્ચર કરો. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 સર્વત્ર ખર્ચ ટેલિમેટ્રી** — દરેક એન્ડપૉઇન્ટ પર `X-OmniRoute-*` ખર્ચ/વપરાશ હેડર્સ, કૅશ-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/*` ચૅનલનો લાઇવ ઉમેદવાર પૂલ દર્શાવે છે. → [ઑટો-કોમ્બો](docs/routing/AUTO-COMBO.md)
- **⚡ સ્થાનિક પ્રદર્શન અને ઇન્ફ્રાસ્ટ્રક્ચર** — એક-ક્લિક સ્થાનિક Redis, Cloudflare Workers / Deno Deploy રિલે ડિપ્લૉયર્સ, નિરીક્ષણ હેઠળની એમ્બેડેડ સેવાઓ તરીકે Bifrost અને Mux. → [એમ્બેડેડ સેવાઓ](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 બૉક્સમાં આ પણ સામેલ છે** — પ્લગિન ફ્રેમવર્ક + માર્કેટપ્લેસ, Omni/Agent/GitHub સ્કિલ્સ ફ્રેમવર્ક્સ, Obsidian વૉલ્ટ ઇન્ટિગ્રેશન (22 MCP ટૂલ્સ), OpenAI-સુસંગત Batch અને Files API, સિમૅન્ટિક રિસ્પૉન્સ કૅશ, લીડરબોર્ડ્સ સાથે ગેમિફિકેશન, ACP એજન્ટ શોધ (15 બિલ્ટ-ઇન એજન્ટ્સ), BigQueryમાં શેડ્યૂલ કરેલી લૉગ નિકાસ, `auto/chaos` સમાંતર મલ્ટિ-મોડલ ફૅન-આઉટ, Telegram બૉટ બ્રિજ, ઇન-ઍપ વર્ઝન મૅનેજર અને LMArena-ELO મફત-પ્રદાતા રૅન્કિંગ્સ. → [દસ્તાવેજો](docs/README.md)
## 🤖 સુસંગત CLIs અને કોડિંગ એજન્ટ્સ
> એક જ કૉન્ફિગ — `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
```
દરેક કમાન્ડ સક્રિય રિમોટ સંદર્ભ (`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 કાચા મોડેલ IDs** આવરી લેવાયા છે; અલગ ફ્રી-બજેટ કેટલોગમાં **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 50+ મોડલ 10K ન્યુરોન/દિવસ
NVIDIA NIM GLM, MiniMax ~40 RPM મફત
Cerebras GLM 4.7, GPT-OSS એક વખતની $5 ક્રેડિટ; કાર્ડ જરૂરી
### 🧩 નવું: 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"** શોધો, **ઇન્સ્ટોલ કરો** પર ક્લિક કરો
— બંને સ્ટોર પર એ જ રીતે કામ કરે છે. સોર્સ, સમસ્યાઓ અને પ્રકાશન માટેની રનબુક
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) પર ઉપલબ્ધ છે.
📖 [VS Code Copilot Chat માર્ગદર્શિકા](docs/guides/VSCODE-COPILOT.md) — સેટઅપ, પિકર શું બતાવે છે, ટૅબમાં ડૅશબોર્ડ, સમસ્યાનિવારણ
> `omniroute serve` હંમેશાં ચાલુ હોય ત્યારે શ્રેષ્ઠ રીતે કામ કરે છે. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> તેને macOS માટે એકવાર સેટ કરીને ભૂલી જઈ શકાય તેવી મેનુ-બાર ઍપમાં ફેરવે છે: તે સર્વર શરૂ કરે છે, રીબૂટ
> પછી પણ તેને ચાલુ રાખે છે, તેને ત્યાં જ અપડેટ કરે છે અને તમારું લાઇવ ટોકન બજેટ એક ક્લિકમાં ઉપલબ્ધ કરાવે છે — **કોઈ
> ટર્મિનલ વિન્ડો ખુલ્લી રાખવાની જરૂર નહીં, દેખરેખ રાખવા માટે કોઈ `npm install -g omniroute` નહીં.**
[Tauri v2](https://v2.tauri.app/) વડે બનેલું (નગણ્ય કદનું Rust કોર), તે
પોતાના સાઇન કરેલા Node 24 રનટાઇમ સાથે આવે છે અને ઍપ-માલિકીવાળા OmniRoute ઇન્સ્ટોલેશનને મેનેજ કરે છે, તેથી તે તમારા
વૈશ્વિક `node`/`bun` સાથે ક્યારેય ટકરાતું નથી. તે **તમારા હાલના `~/.omniroute/` કન્ફિગ અને ડેટાબેઝને શેર કરે છે** — એટલે આ
એ જ OmniRoute છે જેને તમે પહેલેથી ચલાવો છો, બસ હવે તેણે ટોપી પહેરી છે. 🎩
તે શું કરે છે
કેવી રીતે
🟢 સર્વરની દેખરેખ રાખે છે
omniroute serve શરૂ કરે છે અને નવું ડુપ્લિકેટ ઇન્સ્ટન્સ બનાવવાને બદલે પહેલેથી ચાલી રહેલા ઇન્સ્ટન્સને અપનાવે છે
📊 એક નજરમાં લાઇવ વપરાશ
પ્રોવાઇડર ક્વોટા બાર, રીસેટ કાઉન્ટડાઉન સાથે Claude સેશન/સાપ્તાહિક મર્યાદાઓ, 30-દિવસનો ખર્ચ વિભાજન
🔄 ત્યાં જ આપમેળે અપડેટ થાય છે
તબક્કાવાર ઇન્સ્ટોલ, એટોમિક સ્વૅપ, નિષ્ફળતા પર રોલબૅક — હંમેશાં સૌથી નવા રિલીઝ પર
🚀 લૉગિન પર શરૂ થાય છે
લૉગિન વખતે વૈકલ્પિક શરૂઆત; ફક્ત ટ્રે, કોઈ dock આઇકન નહીં
🩺 Doctor અને લૉગ્સ
એક-ક્લિક ડાયગ્નોસ્ટિક્સ અને સર્વર લૉગ ઍક્સેસ
```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 ક્લાયન્ટમાં જોડો
### 📖 તે કેવી રીતે કાર્ય કરે છે — પાઇપલાઇન, આર્કિટેક્ચર અને બચતનું ગણિત
ડિફૉલ્ટ સ્ટૅક્ડ કોમ્બો `RTK → Caveman` ચલાવે છે. જ્યારે બંને એક જ ટૂલ/કૉન્ટેક્સ્ટ પેલોડ પર કાર્ય કરે છે, ત્યારે બચત ચક્રવૃદ્ધિ પામે છે:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
કોડ બ્લૉક્સ, URLs, JSON અને સંરચિત ડેટા પ્રિઝર્વેશન એન્જિન દ્વારા **હંમેશાં સુરક્ષિત** રાખવામાં આવે છે.
> **જ્યારે થોડા ટોકન્સથી કામ થઈ જાય ત્યારે ઘણા ટોકન્સ શા માટે વાપરવા?** દરેક વિનંતી OmniRouteની કમ્પ્રેશન પાઇપલાઇનમાંથી **પારદર્શક રીતે** પસાર થાય છે — ક્લાયન્ટમાં કોઈ ફેરફાર જરૂરી નથી. હવે તે **12 સંયોજ્ય એન્જિનોનો સ્ટૅક** છે, જે ક્રમશઃ ચાલે છે અને દરેક રૂટિંગ કોમ્બો મુજબ મિશ્રિત તથા મેળવણીય છે — જે [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), અને [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR)ના વિચારો પર આધારિત છે.
### 🧱 12-એન્જિન સ્ટૅક
એન્જિનો પાઇપલાઇનના ક્રમમાં ચાલે છે; દરેકને સ્વતંત્ર રીતે ચાલુ/બંધ કરી શકાય છે અને દરેક કોમ્બો માટે રૂપરેખાંકિત કરી શકાય છે:
#
એન્જિન
તે શું કરે છે
1
Session-Dedup
વિવિધ ટર્ન્સમાં પુનરાવર્તિત થતી સામગ્રીને દૂર કરે છે (સામગ્રી-એડ્રેસ્ડ, ક્રૉસ-ટર્ન)
2
CCR
મોટા બ્લૉક્સને રિટ્રીવ માર્કર્સ પાછળ આર્કાઇવ કરે છે અને માંગ પર મેળવે છે
MobileBERT ONNX દ્વારા ML સિમેન્ટિક પ્રૂનિંગ — કોડ-સેફ, અસિંક્રોનસ
11
Ultra
વૈકલ્પિક સ્મૉલ-મૉડલ (SLM) ટિયર સાથે હ્યુરિસ્ટિક ટોકન પ્રૂનિંગ
12
OmniGlyph
સીધા 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 કમ્પોનેન્ટ ફરી રેન્ડર થવાનું સંભવિત કારણ એ છે કે તમે દરેક રેન્ડર સાઇકલમાં એક નવો ઑબ્જેક્ટ રેફરન્સ બનાવી રહ્યા છો. જ્યારે તમે પ્રૉપ તરીકે ઇનલાઇન ઑબ્જેક્ટ પાસ કરો છો, ત્યારે Reactની શેલો કમ્પેરિઝન તેને દર વખતે અલગ ઑબ્જેક્ટ તરીકે જુએ છે, જે ફરી રેન્ડર થવાનું ટ્રિગર કરે છે. ઑબ્જેક્ટને મેમોઇઝ કરવા માટે હું useMemoનો ઉપયોગ કરવાની ભલામણ કરીશ."_
>
> **પછી (19 ટોકન્સ):** _"દરેક રેન્ડરમાં નવો ઑબ્જેક્ટ રેફરન્સ. ઇનલાઇન ઑબ્જેક્ટ પ્રૉપ = નવો રેફરન્સ = ફરી રેન્ડર. 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=` પ્રતિભાવ હેડરમાં પાછી દર્શાવવામાં આવે છે.
ટોકન થ્રેશોલ્ડ દ્વારા ઑટો-ટ્રિગર કરો, અનુકૂલનશીલ ડાયલ ચાલુ કરો, નામિત પ્રોફાઇલ પિન કરો, પ્રતિ વિનંતી એક વખતનું સેટિંગ કરો, અથવા દરેક રાઉટિંગ કોમ્બોને પાઇપલાઇન સોંપો — વર્કલોડને જે અનુકૂળ હોય તે પસંદ કરો. ઑપ્ટ-ઇન ઑફલાઇન **મૂલ્યાંકન હાર્નેસ** (`npm run eval:compression`) ફેરફાર લાગુ કરતાં પહેલાં નિશ્ચિત કોર્પસ પર વિશ્વસનીયતા અને બચતનું મૂલ્યાંકન કરે છે.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ ઝડપી શરૂઆત
**1) ઇન્સ્ટૉલ કરો અને ચલાવો**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` અથવા peer-dep ચેતવણીઓ દેખાય છે? [તે હાનિરહિત છે](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 અથવા પછીનું સંસ્કરણ વાપરો છો?** મંજૂરી ન હોય તો npm પૅકેજ લાઇફસાઇકલ સ્ક્રિપ્ટ્સને અવરોધી શકે છે. OmniRouteનું `postinstall` (`node scripts/build/postinstall.mjs`) તેના મૂળ રનટાઇમ ફાઇલો તૈયાર કરવા માટે જરૂરી છે. વૈશ્વિક રીતે ઇન્સ્ટૉલ કરતી વખતે npmની ચેતવણીમાં દર્શાવેલા પૅકેજોને મંજૂરી આપો. OmniRoute 3.8.51 દ્વારા જણાવાયેલા પૅકેજ સમૂહ માટે:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> ભવિષ્યના વૈશ્વિક ઇન્સ્ટૉલ માટે આ મંજૂરીસૂચિનો ફરીથી ઉપયોગ કરવા, તેને એક વાર કૉન્ફિગર કરો અને પછી સામાન્ય રીતે ઇન્સ્ટૉલ કરો:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> રિલીઝ વચ્ચે ડિપેન્ડન્સીની સૂચિ બદલાઈ શકે છે; જો npm અલગ સૂચિ દર્શાવે, તો તે ચેતવણીમાં આપેલા પૅકેજ નામો વાપરો. કોઈ પૅકેજને મંજૂરી આપવાથી તેની ઇન્સ્ટૉલ સ્ક્રિપ્ટ્સ ચલાવી શકાય છે.
> **Gemini Web અથવા અન્ય web-cookie પ્રદાતા વાપરો છો?** npm પૅકેજમાં
> Playwright સામેલ છે, પરંતુ તેનું Chromium બાઇનરી સામેલ નથી. પ્રથમ web-provider વિનંતી કરતાં પહેલાં
> [Playwright Chromium સેટઅપ](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> નોંધ જુઓ.
ડૅશબોર્ડ `http://localhost:20128` પર · API `http://localhost:20128/v1` પર.
**2) તમારા પોતાના એકાઉન્ટથી યોગ્ય પ્રદાતાને જોડો**
ડૅશબોર્ડ → **પ્રદાતાઓ** → જે પ્રદાતાની હાલની શરતો અને ક્વોટા તમારા ઉપયોગ માટે અનુકૂળ હોય તેને પસંદ કરો → તેની API કી ઉમેરો અથવા તેની એકાઉન્ટ પ્રક્રિયા પૂર્ણ કરો. મફત સ્તરો માટે સાઇનઅપ, મંજૂરી અથવા ચુકવણી પદ્ધતિ જરૂરી હોઈ શકે છે. [મફત સ્તરોની માર્ગદર્શિકા](docs/getting-started/FREE-TIERS-GUIDE.md)ની સમીક્ષા કરો; કી વગરની ઉપલબ્ધતાની ખાતરી નથી અને `tos: avoid` તરીકે ચિહ્નિત પ્રદાતાઓને ડિફૉલ્ટ રૂપે `auto`માંથી બાકાત રાખવામાં આવે છે.
**3) તમારા કોડિંગ ટૂલને નિર્દેશિત કરો**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) તે કાર્યરત છે તેની ચકાસણી કરો**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
તમને જોડાયેલા મોડલ્સની સૂચિ દેખાવી જોઈએ. 🎉 બસ એટલું જ — કોડિંગ શરૂ કરો અને OmniRoute તમારા માટે આપમેળે રાઉટ કરશે અને જરૂર પડે ત્યારે ફૉલબૅક કરશે.
જો તમારો ક્લાયન્ટ કસ્ટમ હેડર્સ મોકલી શકતો ન હોય, તો OmniRoute ટોકનાઇઝ્ડ સુસંગતતા ઉપનામો પણ ઉપલબ્ધ કરાવે છે:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
આનો ઉપયોગ ફક્ત એવા ક્લાયન્ટ્સ માટે કરો જે `Authorization: Bearer ...` જોડી શકતા નથી. હેડર પ્રમાણીકરણ હજી પણ પસંદગીની પદ્ધતિ છે.
## 📦 ઇન્સ્ટોલ કરવાની વધુ પદ્ધતિઓ — Docker, સોર્સ, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` સૌથી ઊંચા **પ્રકાશિત** સ્થિર SemVerને અનુસરે છે. તે git `main`ને ટ્રૅક કરતું નથી. GitOps માટે `:X.Y.Z` પિન કરો. [Docker રિલીઝ ચૅનલ્સ](docs/guides/DOCKER_GUIDE.md#release-channels) જુઓ. ઇમેજમાં **`OMNIROUTE_MEMORY_MB=1024`** પિન કરેલું છે. તે ડૅશબોર્ડ અને હળવી ચૅટ માટે પૂરતું છે. **કોડિંગ એજન્ટ્સ** (Claude Code, Codex, Grok, … તરફથી `POST /v1/responses`)ને ઘણો મોટો V8 હીપ જોઈએ છે, નહિતર બે ઓવરલૅપ થતા લાંબા કોન્ટેક્સ્ટ હેઠળ પ્રક્રિયામાં ~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-08-24 05:26:03 UTC સુધીના મર્જ સહિત, લાઇવ release/v3.8.50 ટિપ dafb4ae808 પર સ્થિર કરાયેલ. પૃષ્ઠાંકિત GitHub GraphQL ગણતરીમાં 5,911 મર્જ થયેલા PRs છે: રિપોઝિટરી માલિક દ્વારા 2,707, Dependabot દ્વારા 179 અને 535 અલગ-અલગ યોગદાનકર્તાઓના 3,025 બાહ્ય PRs. “બદલાયેલી પંક્તિઓ” એટલે GitHub ઉમેરાઓ + કાઢી નાખેલી પંક્તિઓ અને તેમાં જનરેટ કરેલી ફાઇલો, લૉકફાઇલો, કૅટલૉગ્સ, અનુવાદો તથા દસ્તાવેજીકરણનો સમાવેશ થાય છે; આ ફેરફારોનું પ્રમાણ છે, લેખક દ્વારા લખાયેલ LOC નથી. કટઑફ પરના સમાન આંકડા જાળવી રાખવામાં આવ્યા છે.
### GitHub દ્વારા એટ્રિબ્યૂટ કરાયેલા કમિટ્સ
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 commit authors તરીકે દેખાય છે (જાળવણીકર્તા સહિત) અને 232 માત્ર સ્પષ્ટ Co-authored-by ટ્રેલર્સમાં દેખાય છે. આ ગણતરી GitHub noreply હેન્ડલ્સને સામાન્યકૃત કરે છે, 26 bot/agent/service/placeholder ઓળખોને બાકાત રાખે છે અને ફક્ત તેમનાં દર્શાવાતાં નામો મેળ ખાતાં હોવાને કારણે સામાન્ય ઇમેઇલ સરનામાંને એકસાથે મર્જ કરતી નથી.
### યોગદાન કેવી રીતે આપવું
1. રિપોઝિટરીને Fork કરો
2. **સક્રિય** `release/vX.Y.Z` ટિપ પરથી 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)**ના ફોર્ક અને Go પ્રોજેક્ટ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**ના TypeScript પોર્ટ તરીકે થઈ હતી — અને ત્યારથી, નીચેની દરેક ઉપપ્રણાલી એવા ઓપન-સોર્સ પ્રોજેક્ટથી પ્રેરિત છે જેણે આ કામ પહેલાં કર્યું હતું. તેમાંથી દરેકે OmniRouteના એક નક્કર ભાગને આકાર આપ્યો છે. આ તે સૌ પ્રત્યેનો અમારો આભાર છે. 🙏
> ⭐ સ્ટારની સંખ્યાઓ 24 ઑગસ્ટ, 2026ના રોજ GitHubના REST API દ્વારા ચકાસવામાં આવી હતી — જઈને આ પ્રોજેક્ટ્સને સ્ટાર આપો. આ સંખ્યાઓ નિર્દિષ્ટ તારીખે લેવાયેલો ચોક્કસ સ્નૅપશૉટ છે અને સમય જતાં સ્વાભાવિક રીતે બદલાશે.
### 🧬 વંશાવળી અને ગેટવે
વિક્રેતા-સમાવિષ્ટ ChatGPT Web → Codex Responses બ્રિજમાં અનુકૂલિત MIT સ્રોત, જેમાં બ્રાઉઝર-સેશન, રિસ્પોન્સ-ફ્રેમિંગ, વપરાશ અને વેબ-શોધ ઍડેપ્ટર્સનો સમાવેશ થાય છે.
તેના Grok મોડેલ મેપિંગ્સ, નકલી-TypeError Statsig જનરેટર, વિનંતી અને ડિવાઇસ ડિફૉલ્ટ્સ તથા NDJSON રિસ્પોન્સ પ્રોસેસરને નોંધપાત્ર રીતે OmniRoute ના Grok Web એક્ઝિક્યુટરમાં અનુકૂલિત કરવામાં આવ્યા છે.
Grok પેલોડ અને ડિવાઇસ ડિફૉલ્ટ્સ, Statsig જનરેટર અને TQZHR તથા grok2api-merged મારફતે આગળ લાવવામાં આવેલા result.response પ્રોસેસર માટેનો અંતર્નિહિત MIT સ્રોત.
તેના પ્રૉક્સી-પૂલ સ્તર માટે grok2api-merged દ્વારા શ્રેય અપાયેલ પરોક્ષ સ્રોત; OmniRoute તે વંશાવળી સૂચનાને જાળવે છે, પરંતુ તેના મર્યાદિત Grok Web એક્ઝિક્યુટરમાં પ્રૉક્સી-પૂલ પોર્ટ હોવાનો દાવો કરતું નથી.
મૂળ Grok Web અમલીકરણે તેની HTTP/બ્રાઉઝર અપસ્ટ્રીમ ડિઝાઇનનો સંદર્ભ લીધો હતો; તેનો સીધો HTTP પાથ GrokProxy પરથી ઉતરી આવ્યો હોવાથી, કોઈ સ્વતંત્ર કોડ પોર્ટનો દાવો કરવામાં આવતો નથી.
વાઇરલ "જ્યારે થોડા ટોકનથી કામ થઈ જાય ત્યારે ઘણા ટોકન શા માટે વાપરવા" પ્રોજેક્ટ — તેની ગુફામાનવ-શૈલીની ફિલસૂફી અમારા માનક સંકોચન મોડ અને 30+ બિનજરૂરી શબ્દો દૂર કરવાના/સંઘનનના નિયમોને શક્તિ આપે છે.
વાઇરલ "આળસુ વરિષ્ઠ ડેવલપર" YAGNI-કોડર કૌશલ્ય — અમારી less-code આઉટપુટ શૈલી માટે પ્રેરણારૂપ બન્યું: સૌથી નાના કાર્યરત ફેરફાર તરફ દોરીને _જનરેટ થયેલા_ કોડમાં ઘટાડો કરે છે (Caveman ના સંક્ષિપ્ત ગદ્યનું આઉટપુટ-અક્ષ પરનું સમકક્ષ).
નિષ્ફળતા-સજાગ રીતે બહાર નીકળવાની સુવિધા સાથે સામગ્રી-સજાગ, પ્રતિ-ફાઇલ-પ્રકાર આઉટપુટ સંકોચન — અમારા પ્રતિ-પ્રકાર ડિસ્પેચ અને લઘુત્તમ-લાભ ન મળ્યે અવગણવાની પદ્ધતિને સમર્થન આપ્યું.
કોડિંગ-આસિસ્ટન્ટ ↔ LLM ટ્રાફિકના MITM ઇન્ટરસેપ્શન/વિશ્લેષણે Traffic Inspector ની પ્રારંભિક આવશ્યકતાઓ ઘડવામાં મદદ કરી. અગાઉ મેળવવામાં આવેલા ચાર મોડ્યુલો — SSE મર્જિંગ, વાર્તાલાપ નોર્મલાઇઝેશન, સિક્રેટ માસ્કિંગ અને હેડર સેનિટાઇઝેશન — ને જાહેર પ્રોટોકોલ ધોરણો પર આધારિત સ્વતંત્ર ક્લીન-રૂમ અમલીકરણોથી બદલવામાં આવ્યા છે. બે હોસ્ટ-પાસથ્રૂ સપાટીઓ (passthrough.ts અને _internal/bypass.cjs) સ્વતંત્ર રીતે વર્ગીકૃત OmniRoute-આંતરિક અમલીકરણો તરીકે યથાવત્ છે; તે બદલાવના ભાગરૂપે તેમને ફરીથી લખવામાં આવ્યા નહોતા.
ડિફૉલ્ટ રૂપે સુરક્ષિત લાઇબ્રેરીઓની ક્યુરેટ કરેલી સૂચિ, જે અમારી સુરક્ષા પસંદગીઓને માર્ગદર્શન આપે છે (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":"Hello!"}]}'
```
`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-એન્જિન સ્ટૅક
એન્જિનો પાઇપલાઇનના ક્રમમાં ચાલે છે; દરેકને સ્વતંત્ર રીતે ચાલુ/બંધ કરી શકાય છે અને દરેક કોમ્બો માટે રૂપરેખાંકિત કરી શકાય છે:
