## 💰 మూడవ పార్టీ ఉచిత టైర్లలో నెలకు ~1.62B టోకెన్లు
> **మీ స్వంత ప్రొవైడర్ ఖాతాలను తీసుకురండి.** ఇది OmniRoute నుండి టోకెన్ గ్రాంట్ కాదు, విడివిడిగా అర్హత పొందిన మూడవ పార్టీ ఉచిత టైర్ల యొక్క అంచనా మొత్తం. సైన్ అప్ చేయండి, అవసరమైన చోట క్రెడెన్షియల్స్ పొందండి, మరియు మీరు ఉపయోగించగల ప్రొవైడర్లను కనెక్ట్ చేయండి; ప్రతి ప్రొవైడర్ తన పరిమితులు, లభ్యత మరియు నిబంధనలను నియంత్రిస్తుంది.
>
> ఉచిత టైర్లను చేతితో స్టాక్ చేయడం కష్టమైన పని — డజన్ల కొద్దీ SDKలు, డజన్ల కొద్దీ రేట్ పరిమితులు, మరియు మీ వద్ద నిజంగా ఎంత ఉందో అస్సలు తెలియదు. OmniRoute **34 రికరింగ్ పూల్ కీలలో 467 ఉచిత-టైర్ ఎంట్రీలను** కాటలాగ్ చేస్తుంది మరియు **ప్రచురిత పాజిటివ్ నెలవారీ బడ్జెట్ ఉన్న 17 పూల్స్ ప్లస్ ఐదు పర్-మోడల్ Groq క్యాప్ల** నుండి టోకెన్ హెడ్లైన్ను లెక్కిస్తుంది, షేర్డ్ పూల్ ద్వారా డీడుప్లికేట్ చేయబడింది. ప్రాంతీయ గుర్తింపు తనిఖీ తర్వాత మాత్రమే తెరవబడే కోటాలు (ప్రస్తుతం: ModelScope) విడిగా చూపబడతాయి, ప్రాంతీయ గుర్తింపు ధృవీకరణ వెనుక +~6M, మరియు వాటిని ఎప్పుడూ హెడ్లైన్లోకి కలపరు. ఫలితం డాష్బోర్డ్లో (`/dashboard/free-tiers`) ఎల్లప్పుడూ కనిపిస్తుంది.
> లైవ్ `/dashboard/free-tiers` పేజీ యొక్క యానిమేటెడ్ సారాంశం. పూర్తి పద్ధతి (పూల్ డీడూప్, క్రెడిట్ టైర్లు, ప్రొవైడర్ నిబంధనలు): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ఈ గణాంకాలు ప్రతి రెండు వారాలకు లైవ్ కాటలాగ్తో మళ్లీ ఆడిట్ చేయబడతాయి మరియు **రెండు దిశల్లోనూ కదుతాయి** — ఒక ప్రొవైడర్ ఉచిత టైర్ను ముగిస్తే సంఖ్య తగ్గుతుంది; కొత్తది వస్తే అది పెరుగుతుంది. కాటలాగ్ నిజంగా లెక్కించిన దాన్నే మేము ప్రచురిస్తాము, రౌండ్-అప్ చేసిన ఉత్తమ అంచనాను ఎప్పుడూ కాదు.
⭐ OMNIROUTE మీకు డబ్బు ఆదా చేయడానికి మరియు మీ పనిని సులభతరం చేయడానికి సహాయపడితే, రెపోకు స్టార్ ఇవ్వండి.
## 🆓 ఇన్స్టాల్ చేయండి, ప్రొవైడర్ను కనెక్ట్ చేయండి, ఆపై ఒకే ఎండ్పాయింట్ ద్వారా రూట్ చేయండి
```bash
# ప్రొవైడర్ను కనెక్ట్ చేసిన తర్వాత, Dashboard → Endpoints నుండి మీ OmniRoute కీని కాపీ చేయండి:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` కు అర్హత పొందిన రూట్ అవసరం. కొత్త ఇన్స్టాలేషన్లో అర్హత పొందిన కీలెస్ లక్ష్యాలు ఏవీ ఉండకపోవచ్చు, మరియు కీలెస్ ప్రొవైడర్ మూడవ పార్టీ క్లయింట్లను తిరస్కరించవచ్చు. Kiro సహా `tos: avoid` గా గుర్తించబడిన ప్రొవైడర్లు డిఫాల్ట్గా ఆటోమేటిక్ రూటింగ్ నుండి మినహాయించబడతారు; ఖాతాను కనెక్ట్ చేయడం ఆ సెట్టింగ్ను భేదించదు. ప్రొవైడర్ను ఎంచుకోవడానికి ముందు [ఉచిత టైర్ల గైడ్](docs/getting-started/FREE-TIERS-GUIDE.md) చూడండి.📦 **Python, Node.js, PHP, మరియు cURL** కోసం కాపీ-పేస్ట్ క్విక్స్టార్ట్ స్క్రిప్ట్లు → [`examples/quickstart/`](examples/quickstart/)
# 💥 వాగ్దానం
# 🤔 ఎందుకు OmniRoute?
## 🤝 మా ఓపెన్ సోర్స్ స్నేహితుల మద్దతుతో
> **ఓపెన్ సోర్స్ స్నేహితుడిగా చేరాలనుకుంటున్నారా?** ఈ కంపెనీలు ఓపెన్ సోర్స్కు మద్దతు ఇస్తాయి మరియు ఓమ్నిరూట్ను కొనసాగించడానికి సహాయపడతాయి — మరియు వారు మాకు ఇచ్చే ప్రతి టోకెన్ ఎక్కడికి వెళ్తుందో మేము బహిరంగంగా చెబుతాము. సంప్రదించండి: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
కిమి మూన్షాట్ AI
ఈ ప్రాజెక్ట్కు మద్దతు ఇచ్చిన మా స్థాపక ఓపెన్ సోర్స్ స్నేహితుడు కిమి (మూన్షాట్ AI)కి ధన్యవాదాలు! కిమి అనేది ఓపెన్-వెయిట్ K2 మరియు K3 మోడల్ కుటుంబాల వెనుక ఉన్న AI ల్యాబ్ — కిమి K3 1M-టోకెన్ సందర్భ విండో, స్థానిక దృష్టి మరియు క్లోజ్డ్-మోడల్ ధరలలో కొంత భాగంలో ఫ్రాంటియర్-స్థాయి కోడింగ్ను అందిస్తుంది మరియు క్లాడ్ కోడ్, కోడెక్ మరియు ఓమ్నిరూట్ అందించే ప్రతి కోడింగ్ టూల్తో బాక్స్ వెలుపల పనిచేస్తుంది.
కిమి మద్దతు ఏమిటి: కిమి యొక్క API క్రెడిట్లు ఓమ్నిరూట్ యొక్క AI-ధృవీకరించబడిన విడుదల పైప్లైన్కు శక్తినిస్తాయి — ప్రతి పుల్ రిక్వెస్ట్ను షిప్ చేయడానికి ముందు సమీక్షించే కిమి K3 ద్వారా విలీన ధృవీకరణ దశ — ప్లస్ రోజువారీ ఫీచర్ అభివృద్ధి. ఫస్ట్-క్లాస్ కిమి మద్దతు రెండు రైళ్లలో షిప్లు: డైరెక్ట్ కిమి API (kimi-k3) మరియు కిమి కోడ్ కోడింగ్ ప్లాన్ (OAuth మరియు API కీ). కిమి మద్దతు కార్యక్రమంలో ఓమ్నిరూట్ మొదటి బ్రెజిలియన్ ఓపెన్-సోర్స్ ప్రాజెక్ట్ కూడా. 15% అదనపు క్రెడిట్లతో కిమి API కీని పొందండి →
చీపర్ ఇన్ఫరెన్స్ cheaperinference.com
ఈ ప్రాజెక్ట్కు మద్దతు ఇచ్చిన ఓమ్నిరూట్ ఓపెన్ సోర్స్ స్నేహితుడు చీపర్ ఇన్ఫరెన్స్కి ధన్యవాదాలు! చీపర్ ఇన్ఫరెన్స్ అనేది ఒక ఖర్చు-ర్యాంక్డ్ గేట్వే, ఇది 42 ఫ్రాంటియర్ మోడళ్లను తిరిగి విక్రయిస్తుంది — క్లాడ్, GPT-5.x, జెమిని, కిమి K3, GLM, డీప్సీక్, గ్రోక్ మరియు మినీమాక్స్ — ఒక OpenAI-అనుకూల ఎండ్పాయింట్ వెనుక, ప్రతి అభ్యర్థనను మోడల్ మేకర్ యొక్క జాబితా ధర కంటే ఎక్కువ వసూలు చేయకుండా చౌకైన అర్హత కలిగిన ప్రొవైడర్కు రూట్ చేస్తుంది.
ఓమ్నిరూట్లో ఫస్ట్-క్లాస్ మద్దతు: చాట్ కంప్లీషన్స్, స్థానిక /v1/responses ఎండ్పాయింట్, విజన్, టూల్ కాలింగ్ మరియు 3 ఇమేజ్ మోడల్స్ (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model>గా అందుబాటులో ఉన్నాయి). API కీని పొందండి →
aff=omniroute ట్యాగ్ చేయబడిన లింక్లు భాగస్వామి లింక్లు. అవి మీకు అదనపు ఖర్చు లేకుండా ప్రాజెక్ట్కు నిధులు సమకూరుస్తాయి. 🎟️ అనుబంధ ప్రోమో — మేము స్పాన్సర్ చేయని ప్రొవైడర్ల నుండి ఉచిత సైన్అప్ కూపన్లు (విస్తరించడానికి క్లిక్ చేయండి)ఈ విభాగం రిఫరల్/కూపన్ కోడ్ల కోసం మాత్రమే. స్పాన్సర్ చేయబడిన భాగస్వామ్యాలు పైన ఉన్న 🤝 మా ఓపెన్ సోర్స్ స్నేహితుల మద్దతుతోలో ఉంటాయి. ఓమ్నిరూట్కు ఇక్కడ జాబితా చేయబడిన ప్రొవైడర్లతో ఎటువంటి స్పాన్సర్షిప్ లేదా భాగస్వామ్యం లేదు — ఇవి ఎవరైనా ఉపయోగించగల పబ్లిక్ కూపన్లు.
ఏజెంట్ రూటర్ agentrouter.org
ఏజెంట్ రూటర్ — అనుబంధ సైన్అప్ · సైన్అప్లో $100 ఉచిత క్రెడిట్లు (ఉచిత సర్వర్, అధిక లేటెన్సీని ఆశించండి — పరీక్ష కోసం ఉత్తమం, ఉత్పత్తికి కాదు). v3.8.50 నుండి ఓమ్నిరూట్లో ఫస్ట్-క్లాస్ మద్దతు: చాట్ కంప్లీషన్స్, ఆంత్రోపిక్-అనుకూల వైర్ ఫార్మాట్ మరియు OpenAI-అనుకూల మార్గం. అందుబాటులో ఉన్న మోడల్లలో claude-opus-4-8, claude-opus-5, gpt-5.6-sol మరియు మరిన్ని ఉన్నాయి. $100 పొందండి →
⚠️ అనుబంధ లింక్ — ఓమ్నిరూట్కు ఈ ప్రొవైడర్తో ఎటువంటి స్పాన్సర్షిప్ లేదా భాగస్వామ్యం లేదు.
ఓమ్నిరూట్ వినియోగదారులకు ప్రయోజనం చేకూర్చే ఉదారమైన ఉచిత సైన్అప్ కూపన్తో మరొక ప్రొవైడర్ తెలుసా? ఒక ఇష్యూను తెరవండి మరియు మేము దానిని ఇక్కడ జోడిస్తాము.
## 🎯 కాంబోలు — ప్రధాన ఫీచర్
> **కాంబో** అనేది 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
తదుపరి లక్ష్యానికి వెళ్లే ముందు ప్రతి లక్ష్యం యొక్క కోటాను పూర్తిగా వినియోగిస్తుంది
3
weighted
ప్రతి లక్ష్యపు వెయిట్ ఆధారంగా వెయిటెడ్ రాండమ్ ఎంపిక
4
round-robin
లక్ష్యాలను క్రమంగా చక్రీయంగా ఉపయోగిస్తుంది
5
p2c
రెండు ఎంపికల శక్తి ఆధారిత రాండమ్ లోడ్ బ్యాలెన్సింగ్
6
least-used
ప్రస్తుతం అత్యల్ప లోడ్ ఉన్న లక్ష్యాన్ని ఎంచుకుంటుంది
ప్రత్యక్ష కేటలాగ్ ధరల ఆధారంగా ప్రతి అభ్యర్థనకు అయ్యే $ ఖర్చును కనిష్ఠీకరిస్తుంది 💸
10
headroom
అత్యధిక మిగిలిన కోటా ఉన్న లక్ష్యాన్ని ఎంచుకుంటుంది
11
quota-weighted
కోటా అయిపోయిన ఖాతాలను దాటవేసి, ఆపై మిగిలిన కోటా ÷ ప్రాసెస్లో ఉన్న లోడ్ నిష్పత్తిలో ఎంచుకుంటుంది — ఇప్పటికే ఉన్న సంభాషణలు అదే లక్ష్యానికి పిన్ చేయబడి ఉంటాయి ⚖️
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 లైసెన్స్తో లభిస్తుంది మరియు బహిరంగంగా నిర్వహించబడుతుంది. ఇది మీ సమయం లేదా డబ్బును ఆదా చేస్తే, దీన్ని స్వతంత్రంగా కొనసాగించడానికి మీకు సరిపోయే ఏదైనా మార్గాన్ని ఎంచుకోండి. స్పాన్సర్షిప్ రూటింగ్ ప్రాధాన్యతను ఎప్పుడూ ప్రభావితం చేయదు; అది దృశ్యమానతను మాత్రమే అందిస్తుంది, ర్యాంకింగ్ను కాదు.
⚠️ ప్రతి కాయిన్ను చూపిన నెట్వర్క్లో మాత్రమే పంపండి — తప్పు నెట్వర్క్లో పంపితే నిధులు కోల్పోవచ్చు.
🐛 బగ్ను కనుగొన్నారా లేదా అభిప్రాయం ఉందా? ఒక [చర్చను](https://github.com/diegosouzapw/OmniRoute/discussions) ప్రారంభించండి.
డెవలపర్ గమనికలు: డెవలపర్ల సౌలభ్యం కోసం npm install/postinstall సమయంలో ప్రాజెక్ట్ స్థానిక .env ఫైల్ను రూపొందించవచ్చు. ఈ ఫైల్ ఉద్దేశపూర్వకంగా .gitignore ద్వారా విస్మరించబడుతుంది (.gitignore చూడండి), దీన్ని ఎప్పటికీ కమిట్ చేయకూడదు — పొరపాటున కమిట్ చేస్తే, బహిర్గతమైన సీక్రెట్లను మార్చి, చరిత్ర నుండి ఫైల్ను తొలగించండి. స్థానిక ఎన్విరాన్మెంట్ ఫైళ్లు మరియు సీక్రెట్ల నిర్వహణపై మార్గదర్శకత్వం కోసం docs/DEVELOPER-ENVIRONMENT.md చూడండి.
## 📡 OmniRoute Radar
పైన డాక్యుమెంట్ చేయబడిన, పూల్-డీడూప్లికేట్ చేసిన కేటలాగ్ నుండి ప్రధాన ఉచిత-టియర్ ముఖ్యాంశం **~1.62B టోకెన్లు/నెల**గానే ఉంది. తాత్కాలిక ప్రొవైడర్ సైన్అప్ క్రెడిట్లు మొదటి నెల పరిమితిని విడిగా **~2.22B** వరకు పెంచగలవు. OmniRoute విడుదలల మధ్య మరింత తాజా ఉచిత-మోడల్ లభ్యతను కోరుకునే వారి కోసం Radar అనేది ఐచ్ఛికమైన, సంతకం చేసిన కేటలాగ్ ఓవర్లే; కమ్యూనిటీ కేటలాగ్ మరియు ఇప్పటికే ఉన్న ప్రతి ఉచిత ఫీచర్ ఉచితంగానే ఉంటాయి.
మద్దతుదారులు లైవ్ కేటలాగ్ను మరియు అదనపు ప్రొవైడర్ అవకాశాలను పొందవచ్చు. ప్రొవైడర్ లభ్యతను బట్టి, దీని ప్రత్యేకమైన, మార్పులకు లోనయ్యే గరిష్ఠ పరిమితి **అత్యధికంగా సుమారు 3B టోకెన్లు/నెల**. ఆ గరిష్ఠ పరిమితి హామీ కాదు: ప్రొవైడర్లు కోటాలు, అర్హత, మోడళ్లు లేదా ప్రాంతాలను ఎప్పుడైనా మార్చవచ్చు.
Radar ఐచ్ఛికం మరియు GET-మాత్రమే. OmniRoute క్లయింట్ ప్రాంప్ట్లు, ట్రాఫిక్, ప్రొవైడర్ కాన్ఫిగరేషన్, వినియోగ టెలిమెట్రీ లేదా స్థానిక ప్రకటన-తొలగింపు స్థితిని అప్లోడ్ చేయదు. అర్హత మరియు ప్రస్తుత కేటలాగ్ గురించి **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** వద్ద తెలుసుకోండి.
## ✨ కొత్తవి ఏమిటి
> **v3.8.20 → v3.8.53** నుండి ఇటీవలి ముఖ్యాంశాలు. పూర్తి చరిత్ర [`CHANGELOG.md`](CHANGELOG.md)లో ఉంది.
- **⚖️ `quota-weighted` రూటింగ్** — 20వ కాంబో వ్యూహం ఖర్చైపోయిన ఖాతాలను దాటవేసి, మిగిలిన కోటా ÷ ఇన్-ఫ్లైట్ లోడ్ నిష్పత్తిలో మిగిలిన వాటి నుండి ఎంపిక చేస్తుంది, ఇప్పటికే ఉన్న సంభాషణలను పిన్ చేసి ఉంచుతుంది. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 హెడ్లెస్ మోడ్** — `omniroute serve --headless` (లేదా `OMNIROUTE_HEADLESS=1`) కేవలం `/v1/*` ప్రాక్సీ ఇంజిన్ను మాత్రమే నడుపుతుంది, డాష్బోర్డ్ మరియు డాష్బోర్డ్-ప్రత్యేక ఉపవ్యవస్థలు ఆఫ్ అవుతాయి. → [హెడ్లెస్ మోడ్](docs/guides/HEADLESS.md)
- **🔎 మోడల్ డిస్కవరీ** — `/v1/models` సామర్థ్యం, సందర్భం, రకం మరియు టెక్స్ట్ ద్వారా ఫిల్టర్ చేస్తుంది, మరియు `POST /v1/models/query` అదే కీ-వారీ విజిబిలిటీతో చిన్న డిటర్మినిస్టిక్ షార్ట్లిస్ట్ను అందిస్తుంది. → [API రిఫరెన్స్](docs/reference/API_REFERENCE.md)
- **🔑 కీ-వారీ రూటింగ్ నియంత్రణ** — `forcedModel`తో API కీని ఒక మోడల్ లేదా కాంబోకు పిన్ చేయండి, మరియు కీ యొక్క మోడళ్లు మరియు కాంబోలను ఆటమిక్గా జోడించండి లేదా తొలగించండి (`/api/keys/{id}/access`). → [API రిఫరెన్స్](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ మరింత సూక్ష్మమైన PII నియంత్రణలు** — రకం-వారీ ఎంపిక, 20 వరకు ధృవీకరించబడిన కస్టమ్ మాస్కింగ్ నమూనాలు మరియు రకం-వారీ డిటెక్షన్ కౌంటర్లు; మాస్కింగ్ ఆప్ట్-ఇన్గానే ఉంటుంది. → [గార్డ్రైల్స్](docs/security/GUARDRAILS.md)
- **🌍 67 భాషలు** — డాష్బోర్డ్, డాక్స్ మిర్రర్లు మరియు CLI; `npm run i18n:add-locale` ఒకే కమాండ్తో ప్రతిచోటా భాషను జోడిస్తుంది. → [i18n గైడ్](docs/guides/I18N.md)
- **🎛️ OmniConductor** — మీ ఏజెంట్ ఫ్లీట్కు ఇన్బౌండ్ A2A డెలిగేషన్, ఏజెంట్ కార్డ్పై కండక్టర్ స్కిల్స్, మరియు Faro పుష్-టు-టాక్ వాయిస్ చాట్తో డాష్బోర్డ్ ప్యానెల్. → [A2A సర్వర్](docs/frameworks/A2A-SERVER.md)
- **🛂 అడాప్టివ్ అడ్మిషన్ & ఓవర్లోడ్ ప్రొటెక్షన్** — హెవీవెయిట్ చాట్ అభ్యర్థనలు 503 అవ్వకుండా క్యూలో వేచి ఉంటాయి, కనెక్షన్కు ఆటమిక్ RPM రోలింగ్ లీజ్లతో. → [రెసిలియన్స్ గైడ్](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ కెనానికల్ `/v1/models` క్రమం** — ప్రతి ప్రొవైడర్కు ఒకే వరుస ప్రొవైడర్-గ్రూప్ చేసిన బ్లాక్ (కాంబోలు మొదట పిన్ చేయబడతాయి), ప్రతి కేటలాగ్ సోర్స్లోనూ స్థిరంగా ఉంటుంది. → [API రిఫరెన్స్](docs/reference/API_REFERENCE.md)
- **🗜️ కంప్రెషన్ హార్డెనింగ్** — డిఫాల్ట్-ఆన్ ఇన్ఫ్లేషన్ గార్డ్, DE / FR / JA + చైనీస్ (wényán) కోసం Caveman ప్యాక్లు, Gradle & .NET కోసం RTK ఫిల్టర్లు. → [కంప్రెషన్](docs/compression/COMPRESSION_ENGINES.md)
- **💸 నిజాయితీగల ఫ్లాట్-రేట్ ఖర్చు** — సబ్స్క్రిప్షన్ / కోడింగ్-ప్లాన్ ప్రొవైడర్లు కాస్ట్ అనలిటిక్స్లో **$0**గా కనిపిస్తారు; బడ్జెట్, కోటా & రూటింగ్ అంచనాలు కొనసాగుతాయి. → [API రిఫరెన్స్](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share రూటింగ్** — భాగస్వామ్య ఖాతా యొక్క కోటాను పూల్ చేసిన కీల్లో సమానంగా విభజిస్తుంది, పని-సంరక్షకంగా ఉండటం వల్ల నిష్క్రియ స్లైస్లు ఇతరులకు అప్పుగా ఇవ్వబడతాయి. → [రెసిలియన్స్ గైడ్](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ఒకే-కమాండ్ CLI/ఏజెంట్ సెటప్** — 15 నమోదిత `setup-*` కమాండ్లు; `omniroute run` 7 CLIలను లాంచ్ చేస్తుంది (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` ఇంటరాక్టివ్ ప్రొవైడర్+మోడల్ పికర్ మరియు సందర్భం-వారీ ఫేవరెట్లతో 11 టార్గెట్లకు మద్దతు ఇస్తుంది. → [CLI ఇంటిగ్రేషన్లు](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ రిమోట్ మోడ్** — స్కోప్డ్ టోకెన్లతో (`connect` / `contexts` / `tokens`) రిమోట్ OmniRouteను నడపండి + VPS ఇన్స్టాల్ల కోసం `antigravity` OAuth హెల్పర్. → [రిమోట్ మోడ్](docs/guides/REMOTE-MODE.md)
- **🧭 మరింత తెలివైన ఆటో-రూటింగ్** — `auto/:` కాంబోలు, **Fusion** (మోడల్ ప్యానెల్ + జడ్జ్), టాస్క్-అవేర్ రూటింగ్, అభ్యర్థన-వారీ మోడల్ / మోడ్ / USD-బడ్జెట్ ఓవర్రైడ్లు. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ ప్లగబుల్ కంప్రెషన్** — 12 కంపోజబుల్ ఇంజిన్లు + కంప్రెషన్ స్టూడియోలు: LLMLingua-2, టూ-టైర్ Ultra, omniglyph, స్టెప్-వారీ ఫిడెలిటీ గేట్, GCF v3.2, డ్రాగ్-రీఆర్డర్ ఎడిటర్. → [కంప్రెషన్](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ పారదర్శక MITM డిక్రిప్ట్ (TPROXY)** — ప్రాక్సీ env వేరియబుల్స్ను పట్టించుకోని CLIలను పట్టుకోండి, SNI-వారీ CA + ట్రస్ట్-స్టోర్ ఇన్స్టాలర్తో. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 ప్రతిచోటా కాస్ట్ టెలిమెట్రీ** — ప్రతి ఎండ్పాయింట్పై `X-OmniRoute-*` కాస్ట్/యూసేజ్ హెడర్లు, కాష్-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… మరియు రిఫ్రెష్ చేసిన **375-ప్రొవైడర్ కేటలాగ్**. → [ప్రొవైడర్లు](docs/reference/PROVIDER_REFERENCE.md)
- **📡 రూటింగ్ పారదర్శకత** — ప్రతి రెస్పాన్స్ దాన్ని సర్వ్ చేసిన వ్యూహం/ప్రొవైడర్/లేటెన్సీ పేరు పేర్కొనే `X-OmniRoute-Decision` హెడర్ను కలిగి ఉంటుంది, కొత్త `cache-optimized` కాంబో వ్యూహం + Auto-Combo `cacheAffinity` ఫ్యాక్టర్ పునరావృత అభ్యర్థనలను కాష్ చేసిన ప్రీఫిక్స్ ఉన్న కనెక్షన్కు తిరిగి రూట్ చేస్తాయి, మరియు రీడ్-ఓన్లీ `/v1/auto-combo/{channel}/candidates` ఎండ్పాయింట్ `auto/*` ఛానల్ యొక్క లైవ్ క్యాండిడేట్ పూల్ను బహిర్గతం చేస్తుంది. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ స్థానిక పనితీరు & ఇన్ఫ్రా** — వన్-క్లిక్ స్థానిక Redis, Cloudflare Workers / Deno Deploy రిలే డిప్లాయర్లు, పర్యవేక్షించబడే ఎంబెడెడ్ సేవలుగా Bifrost & Mux. → [ఎంబెడెడ్ సేవలు](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 బాక్స్లో మరిన్ని** — ప్లగిన్ ఫ్రేమ్వర్క్ + మార్కెట్ప్లేస్, Omni/Agent/GitHub స్కిల్స్ ఫ్రేమ్వర్క్లు, Obsidian వాల్ట్ ఇంటిగ్రేషన్ (22 MCP టూల్స్), OpenAI-అనుకూల Batch & Files APIలు, సిమాంటిక్ రెస్పాన్స్ కాషే, లీడర్బోర్డ్లతో గేమిఫికేషన్, ACP ఏజెంట్ డిస్కవరీ (15 బిల్ట్-ఇన్ ఏజెంట్లు), BigQueryకి షెడ్యూల్డ్ లాగ్ ఎక్స్పోర్ట్, `auto/chaos` పారలెల్ మల్టీ-మోడల్ ఫ్యాన్-అవుట్, Telegram బాట్ బ్రిడ్జ్, ఇన్-యాప్ వెర్షన్ మేనేజర్ మరియు LMArena-ELO ఫ్రీ-ప్రొవైడర్ ర్యాంకింగ్లు. → [డాక్స్](docs/README.md)
## 🤖 అనుకూలమైన CLIలు & కోడింగ్ ఏజెంట్లు
> ఒకే కాన్ఫిగ్ — `http://localhost:20128/v1` —తో **ప్రతి** AI IDE లేదా CLI ఉచిత & తక్కువ-ధర మోడళ్లపై నడుస్తుంది.
**మద్దతు ఉన్న ఏదైనా CLIని OmniRoute ద్వారా ఒకే కమాండ్తో ప్రారంభించండి** — ఎలాంటి కాన్ఫిగరేషన్ ఫైల్లు వ్రాయబడవు,
ప్రతి ప్రాసెస్కు క్రెడెన్షియల్లు ఇంజెక్ట్ చేయబడతాయి, Qwen/Geminiలకు తాత్కాలికంగా వేరుచేయబడిన హోమ్ లభిస్తుంది:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# లేదా ప్రొవైడర్+మోడల్ను ఇంటరాక్టివ్గా ఎంచుకుని, సాధనం యొక్క స్వంత కాన్ఫిగరేషన్ను వ్రాయండి:
omniroute configure codex # ఇవి కూడా: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
ప్రతి కమాండ్ సక్రియ రిమోట్ సందర్భాన్ని (`omniroute connect `) గౌరవిస్తుంది, `--dry-run`
అమలు చేయకుండానే ఖచ్చితమైన env/argsను ముందస్తుగా చూపిస్తుంది, అలాగే `--api-key-env NAME` రహస్యాలను
మీ షెల్ చరిత్రలో చేరకుండా ఉంచుతుంది. → [CLI ఇంటిగ్రేషన్లు](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 AI ప్రొవైడర్లు — క్యాటలాగ్లో ఉచితంగా గుర్తించబడిన 153
> కానొనికల్ చాట్, మీడియా, సెర్చ్, లోకల్, క్లౌడ్-ఏజెంట్ మరియు సిస్టమ్ కలెక్షన్లలో **375 నమోదైన ప్రొవైడర్లు** ఉన్నారు, వీటిలో **153 మంది `hasFree: true` డిస్కవరీ మెటాడేటాను కలిగి ఉన్నారు**. చాట్ మోడల్ రిజిస్ట్రీ **239 ప్రొవైడర్లు / 3,059 విభిన్న ప్రొవైడర్-మోడల్ జతలు / 1,475 ముడి మోడల్ IDలను** కవర్ చేస్తుంది; ప్రత్యేక ఫ్రీ-బడ్జెట్ క్యాటలాగ్లో **467 పర్-మోడల్ వరుసలు**, **34 రికరింగ్ పూల్లు** మరియు **51 రికరింగ్/కీలెస్ ఫ్రీ-ఫరెవర్ ప్రొవైడర్లు** ఉన్నాయి. ఇవి డిజైన్ ప్రకారమే వేర్వేరు హారాలు; నిర్వచనాలు మరియు పూల్-డూప్లికేట్లు తీసివేసిన లెక్కలు [ప్రొవైడర్ రిఫరెన్స్](docs/reference/PROVIDER_REFERENCE.md) మరియు [ఫ్రీ టైర్స్](docs/reference/FREE_TIERS.md)లో ఉన్నాయి.
### 🏢 ప్రతి ప్రధాన ల్యాబ్ — ఒకే ఎండ్పాయింట్ ద్వారా
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…మరియు మరో 350+ — ప్రతి ఐకాన్ డాష్బోర్డ్ యొక్క ప్రొవైడర్ క్యాటలాగ్ నుండి ప్రత్యక్షంగా రిజాల్వ్ అవుతుంది. 📖 [ప్రొవైడర్ రిఫరెన్స్](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 ఎప్పటికీ ఉచితం — $0, కార్డ్ అవసరం లేదు
OpenCode Zen DeepSeek V4, Nemotron 3 టోకెన్ పరిమితి లేదు
Kilo Code ఆటో-రూటర్, Tencent Hy3 ఎప్పటికీ ఉచితం
Requesty GPT-OSS 120B, Nemotron ఎప్పటికీ ఉచితం
SiliconFlow DeepSeek V3.2 / R1 ఉచిత టైర్
Z.AI GLM GLM-4.7 / 4.5-Flash ఎప్పటికీ ఉచితం
Baidu ERNIE ERNIE 4.0 ఎప్పటికీ ఉచితం
Qoder AI Qwen3-Max, Kimi-K2 అపరిమిత ఉచితం
Pollinations GPT, Llama, Claude కీ అవసరం లేదు
Cloudflare AI 50+ మోడల్లు రోజుకు 10K న్యూరాన్లు
NVIDIA NIM GLM, MiniMax ~40 RPM ఉచితం
Cerebras GLM 4.7, GPT-OSS ఒక్కసారి $5 క్రెడిట్; కార్డ్ అవసరం
OpenRouter :free మోడల్లు +$10 → అధిక RPM
📖 పూర్తి యంత్ర-పఠనీయ జాబితా → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute ఎక్కడ నడుస్తుంది — ఎక్కడైనా
> అదే యాప్, మీ మెషీన్, మీ నియమాలు. గ్లోబల్ npm ఇన్స్టాల్ నుండి Termux ద్వారా **మీ ఫోన్** వరకు.
ప్లాట్ఫారమ్
ఇన్స్టాల్
ముఖ్యాంశాలు
📦 npm (గ్లోబల్)
npm install -g omniroute
ఒకే కమాండ్, ఏ OS అయినా
🐳 Docker
docker run … diegosouzapw/omniroute
మల్టీ-ఆర్క్ AMD64 + ARM64
🖥️ డెస్క్టాప్ (Electron)
npm run electron:build
నేటివ్ విండో + సిస్టమ్ ట్రే — Windows / macOS / Linux
🎩 మెనూ-బార్ (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
సర్వర్ను పర్యవేక్షించి, స్వయంచాలకంగా అప్డేట్ చేస్తుంది — macOS
💪 ARM
నేటివ్ arm64
Raspberry Pi, ARM సర్వర్లు, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
మీ ఫోన్లోనే 24/7 నడుస్తుంది, root అవసరం లేదు
📲 PWA
"హోమ్ స్క్రీన్కు జోడించండి"
పూర్తి స్క్రీన్, ఆఫ్లైన్, బ్రౌజర్ నుండి ఇన్స్టాల్ చేసుకోవచ్చు
🧩 OpenCode ప్లగిన్
@omniroute/opencode-provider
నేటివ్ OpenCode ఇంటిగ్రేషన్
🤖 VS Code Copilot Chat
OmniCopilot ఎక్స్టెన్షన్ను ఇన్స్టాల్ చేయండి
నేటివ్ Copilot Chat పికర్లో ప్రతి OmniRoute మోడల్ — స్థిరమైన & Insiders వెర్షన్లు
### 🧩 కొత్తది: 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) — సెటప్, పికర్లో కనిపించేవి, ట్యాబ్లో డ్యాష్బోర్డ్, సమస్య పరిష్కారం
### 🎩 కొత్తది: OmniRouteTray — మెనూ బార్లో ఉండే మీ గేట్వే
> `omniroute serve` ఎల్లప్పుడూ ఆన్లో ఉన్నప్పుడే అత్యుత్తమంగా పనిచేస్తుంది. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> దాన్ని macOS కోసం ఒకసారి సెట్ చేసి మర్చిపోగల మెనూ-బార్ యాప్గా మారుస్తుంది: ఇది సర్వర్ను ప్రారంభించి, రీబూట్ల
> తర్వాత కూడా దాన్ని నడుస్తూ ఉంచుతుంది, అక్కడికక్కడే అప్డేట్ చేస్తుంది, అలాగే మీ లైవ్ టోకెన్ బడ్జెట్ను ఒక్క క్లిక్ దూరంలో ఉంచుతుంది — **తెరిచి ఉంచాల్సిన
> టెర్మినల్ విండో లేదు, పర్యవేక్షిస్తూ ఉండాల్సిన `npm install -g omniroute` లేదు.**
[Tauri v2](https://v2.tauri.app/)తో నిర్మించబడిన ఇది (రౌండింగ్ లోపం అంత పరిమాణంలో ఉండే Rust కోర్), తన
సొంత సంతకం చేసిన Node 24 రన్టైమ్తో వస్తుంది మరియు యాప్ యాజమాన్యంలోని OmniRoute ఇన్స్టాలేషన్ను నిర్వహిస్తుంది, కాబట్టి ఇది మీ
గ్లోబల్ `node`/`bun`తో ఎప్పుడూ విభేదించదు. ఇది **మీ ప్రస్తుత `~/.omniroute/` కాన్ఫిగ్ మరియు డేటాబేస్ను పంచుకుంటుంది** — కాబట్టి ఇది
మీరు ఇప్పటికే నడుపుతున్న అదే OmniRoute, కేవలం టోపీ పెట్టుకున్నది. 🎩
ఇది చేసేది
ఎలా
🟢 సర్వర్ను పర్యవేక్షిస్తుంది
omniroute serveను ప్రారంభిస్తుంది, నకలు సృష్టించడానికి బదులుగా ఇప్పటికే నడుస్తున్న ఇన్స్టాన్స్ను స్వీకరిస్తుంది
📊 ఒక్క చూపులో లైవ్ వినియోగం
ప్రొవైడర్ కోటా బార్లు, రీసెట్ కౌంట్డౌన్లతో Claude సెషన్/వారపు పరిమితులు, 30 రోజుల ఖర్చు విభజన
🔄 అక్కడికక్కడే స్వయంచాలకంగా అప్డేట్ అవుతుంది
దశలవారీ ఇన్స్టాల్, అటామిక్ స్వాప్, విఫలమైతే రోల్బ్యాక్ — ఎల్లప్పుడూ సరికొత్త విడుదలలో ఉంటుంది
🚀 లాగిన్ సమయంలో ప్రారంభం
లాగిన్ సమయంలో ఐచ్ఛిక ప్రారంభం; ట్రేలో మాత్రమే, డాక్ ఐకాన్ ఉండదు
🩺 డాక్టర్ & లాగ్లు
ఒక్క క్లిక్తో డయాగ్నస్టిక్స్ మరియు సర్వర్ లాగ్లకు యాక్సెస్
```sh
brew install --cask zoispag/tap/omniroute-tray
```
డౌన్లోడ్ను ఇష్టపడుతున్నారా? తాజా .dmgను
విడుదలలు నుండి పొందండి. సోర్స్, సమస్యలు మరియు బిల్డ్
డాక్యుమెంటేషన్ zoispag/omniroute-trayలో ఉన్నాయి.
💛 @zoispag రూపొందించిన కమ్యూనిటీ ప్రాజెక్ట్ — ఇది అధికారిక OmniRoute విడుదల కాదు.
> సర్వర్కు మించి, OmniRoute అనేది **80+ కమాండ్లతో కూడిన సంపూర్ణ కమాండ్-లైన్ కాక్పిట్**, అలాగే AI ఏజెంట్ దానిని **స్వయంగా** నడపగలిగేలా ఓపెన్ ఏజెంట్ ప్రోటోకాల్లను కూడా అందిస్తుంది.
### ⌨️ నిజమైన CLI (`start` మాత్రమే కాదు)
```bash
omniroute # గేట్వే + డ్యాష్బోర్డ్ను అందిస్తుంది (పోర్ట్ 20128)
omniroute chat # ఇంటరాక్టివ్ TUI చాట్ క్లయింట్ (స్లాష్: /model /combo /skill /memory)
omniroute setup # మార్గదర్శిత తొలి-రన్ విజార్డ్
omniroute doctor # ప్రొవైడర్లు, పోర్ట్లు, నేటివ్ డిపెండెన్సీలను నిర్ధారిస్తుంది
```
### 🛰️ రిమోట్ మోడ్ — CLIని ఇక్కడ, OmniRouteని VPSలో అమలు చేయండి
OmniRoute సర్వర్లో ఉందా? **అదే CLI**తో మీ ల్యాప్టాప్ నుండి దాన్ని నడపండి. స్కోప్ చేసిన యాక్సెస్ టోకెన్తో ఒకసారి
లాగిన్ అవ్వండి; ఆ తర్వాత ప్రతి కమాండ్ రిమోట్ను లక్ష్యంగా చేసుకుంటుంది.
```bash
omniroute connect 192.168.0.15 # పాస్వర్డ్ → స్కోప్ చేసిన టోకెన్, కాంటెక్స్ట్గా సేవ్ చేయబడుతుంది
omniroute models # ← రిమోట్ సర్వర్పై అమలవుతుంది
omniroute configure codex # ← రిమోట్ మోడల్ను ఎంచుకుని, స్థానిక Codex ప్రొఫైల్ను వ్రాస్తుంది
omniroute tokens create --name ci --scope read # ఇతర మెషీన్ల కోసం మరింత పరిమితమైన టోకెన్లను సృష్టిస్తుంది
omniroute contexts use default # ← తిరిగి స్థానిక సర్వర్కు మారుతుంది
```
టోకెన్లు `read` / `write` / `admin`గా స్కోప్ చేయబడతాయి; ప్రాసెస్లను ప్రారంభించే రూట్లు లూప్బ్యాక్కు మాత్రమే పరిమితమై ఉంటాయి.
📖 [రిమోట్ మోడ్](docs/guides/REMOTE-MODE.md)
### 🤝 ఏజెంట్ను కనెక్ట్ చేయండి — అది OmniRouteనే నియంత్రిస్తుంది
**MCP**, **A2A**, **REST API**, **webhooks** లేదా **రిమోట్ CLI** ద్వారా OmniRouteను అందుబాటులో ఉంచండి — సామర్థ్యం ఉన్న ఏ ఏజెంట్కైనా (లేదా మీ స్వంత కోడ్కు) మొత్తం గేట్వేను నియంత్రించే అధికారం లభిస్తుంది: రూటింగ్, ప్రొవైడర్లు, కాంబోలు, క్యాష్, కంప్రెషన్, మెమరీ — అన్నీ స్వయంచాలకంగా. దిగువ HTTP ఎండ్పాయింట్లు `http://localhost:20128` కింద అందించబడతాయి.
ఇంటర్ఫేస్
ఎండ్పాయింట్ / కమాండ్
దీని ఉపయోగం
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor లేదా ఏదైనా MCP క్లయింట్కు అనుసంధానించండి
రిక్వెస్ట్ / కోటా ఈవెంట్లను Slack, Discord, Telegram లేదా ఏదైనా URLకు పంపండి
🛰️ రిమోట్ CLI
omniroute connect
స్కోప్ చేసిన యాక్సెస్ టోకెన్లతో రిమోట్ ఇన్స్టాన్స్ను నడపండి
```bash
# MCP ద్వారా సంపూర్ణ OmniRoute సాధన సమితిని Claude Codeకు అందించండి:
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
పెద్ద బ్లాక్లను రిట్రీవ్ మార్కర్ల వెనుక ఆర్కైవ్ చేస్తుంది, అవసరమైనప్పుడు పొందబడతాయి
డైరెక్ట్ Anthropic వైర్పై కొలవబడిన Claude Fable 5 కోసం ఎక్స్పెరిమెంటల్ కంటెక్స్ట్-యాజ్-ఇమేజ్ ఎన్కోడింగ్; ప్రొవైడర్ రసీదులు పెండింగ్లో ఉన్నందున GPT 5.6 ట్రాన్స్ఫార్మర్లు ఫెయిల్-క్లోజ్డ్గా ఉన్నాయి. నాలుగు కంప్రెషన్ ప్రొఫైల్స్ (అగ్రెసివ్ డిఫాల్ట్, బ్యాలెన్స్డ్, కోడింగ్-సేఫ్, పాస్త్రూ) (అత్యంత అగ్రెసివ్; ఆప్ట్-ఇన్)
కోడ్ బ్లాక్లు, URLలు మరియు స్ట్రక్చర్డ్ డేటా **ఎల్లప్పుడూ** బైట్-పర్ఫెక్ట్గా **భద్రపరచబడతాయి**. **వన్-క్లిక్ ప్రీసెట్లు** ఇంజిన్లను కలుపుతాయి:
మోడ్
ఆదా
దేనికి అనుకూలం
🪶 Lite
~15%
ఎల్లప్పుడూ ఆన్లో ఉండే సురక్షిత డిఫాల్ట్
🪨 Standard (Caveman)
~30%
రోజువారీ కోడింగ్
⚡ Aggressive
~50%
సుదీర్ఘ టూల్-భారీ సెషన్లు
🔥 Ultra
~75%
గరిష్ఠ ఆదా
🧰 RTK
60–90%
Shell/test/build/git అవుట్పుట్
🔗 Stacked (RTK → Caveman)
78–95%
మిక్స్డ్ ప్రాంప్ట్లు + టూల్ లాగ్లు
**నిజమైన ఉదాహరణ — స్టాండర్డ్ మోడ్:**
> **ముందు (69 టోకెన్లు):** _"మీ React కాంపోనెంట్ రీ-రెండర్ అవుతున్నదానికి కారణం బహుశా మీరు ప్రతి రెండర్ సైకిల్లో కొత్త ఆబ్జెక్ట్ రిఫరెన్స్ను సృష్టిస్తున్నట్లే. మీరు ఇన్లైన్ ఆబ్జెక్ట్ను prop గా పాస్ చేసినప్పుడు, React యొక్క షాలో పోలిక దాన్ని ప్రతిసారీ వేరే ఆబ్జెక్ట్గా చూస్తుంది, ఇది రీ-రెండర్ను ట్రిగ్గర్ చేస్తుంది. ఆబ్జెక్ట్ను మెమోయిజ్ చేయడానికి useMemo ఉపయోగించాలని నేను సిఫార్సు చేస్తాను."_
>
> **తర్వాత (19 టోకెన్లు):** _"ప్రతి రెండర్లో కొత్త ఆబ్జెక్ట్ రిఫ్. ఇన్లైన్ ఆబ్జెక్ట్ prop = కొత్త రిఫ్ = రీ-రెండర్. useMemo లో రాప్ చేయండి."_
>
> **అదే సమాధానం. 72% తక్కువ టోకెన్లు. ఖచ్చితత్వ నష్టం సున్నా.** ✅
**PT-BR ఉదాహరణ — [Troglodita](https://github.com/leninejunior/troglodita) మోడ్:**
> **ముందు (42 టోకెన్లు):** _"సమస్య ఏమిటంటే, ప్రతి రెండర్ సైకిల్లో కొత్త ఆబ్జెక్ట్ రిఫరెన్స్ సృష్టించబడటం వల్ల కాంపోనెంట్ రీ-రెండర్ అవుతోంది. useMemo ఉపయోగించమని నేను సిఫార్సు చేస్తాను."_
>
> **తర్వాత (12 టోకెన్లు):** _"రీ-రెండర్: ప్రతి సైకిల్లో కొత్త ref (inline ఆబ్జెక్ట్ మళ్లీ సృష్టించబడింది). `useMemo` ఉపయోగించండి."_
>
> **అదే సమాధానం. ~70% తక్కువ టోకెన్లు. సాంకేతిక ఖచ్చితత్వం అలాగే.** ✅
### 🎚️ ఇంజిన్ల కంటే మించి — అవుట్పుట్ శైలులు, అడాప్టివ్ డయల్ & per-request నియంత్రణ
పైన ఉన్న 12 ఇంజిన్లు **లోపలికి** వెళ్ళే దాన్ని సంకుచితం చేస్తాయి. మరో మూడు పొరలు **ఎలా**, **ఎప్పుడు**, మరియు **బయటకు** ఏమి వస్తుందో రూపొందిస్తాయి:
- **🪄 Output Styles** _(అవుట్పుట్-అక్ష స్టీరింగ్)_ — deterministic, cache-safe ప్రతిస్పందన-రూపకల్పన సూచనలను inject చేస్తాయి; కలపవచ్చు, ప్రతి ఒకటి `lite` / `full` / `ultra` తీవ్రతలో. శైలిని జోడించడం అంటే ఒకే-లైన్ registry ఎంట్రీ:
- **Terse prose** — filler / articles / hedging తొలగించండి; సాంకేతిక సారాన్ని ఖచ్చితంగా ఉంచండి.
- **Less code** — "lazy senior dev" YAGNI: అతి చిన్న పనిచేసే మార్పు, అడగని scaffolding లేదు.
- **Ponytail (lazy senior dev)** — YAGNI నిచ్చెన ఎక్కండి, మూల కారణాన్ని సరిచేయండి, అతి చిన్న పనిచేసే diff.
- **I have ADHD (action-first)** — తదుపరి చర్య ముందుంటుంది, దశలు సంఖ్యితం, ఒక కాంక్రీట్ తదుపరి దశ, ఉపోద్ఘాతం లేదు.
- **Terse CJK (文言)** — శాస్త్రీయ-చైనీస్ అల్ట్రా-terse శైలి (`zh` కు locale-gated).
- **🎯 Adaptive context-budget** _(డయల్)_ — ఒకే on/off token threshold బదులు, **మోడల్ యొక్క context window కు సరిపోయేందుకు** అవసరమైనంత వరకు మాత్రమే అత్యంత చౌకైన, అత్యంత lossless ఇంజిన్లను ఎస్కలేట్ చేస్తుంది. Policy: `reserve-output` (డిఫాల్ట్, model-aware) · `percentage` · `absolute`. Mode: `floor` (fit హామీ) · `replace-autotrigger` (మీ స్పష్టమైన ఎంపిక గెలుస్తుంది) · `off` (legacy threshold).
- **🎛️ compression ఎక్కడ నిర్ణయించబడుతుంది** _(ప్రాధాన్యత, అధిక → తక్కువ)_ — per-request `x-omniroute-compression` header › routing-combo override › యాక్టివ్ named profile › adaptive / auto-trigger › ప్యానెల్ డిఫాల్ట్ › off. వర్తించిన ప్లాన్ `X-OmniRoute-Compression: ; source=` response header లో తిరిగి ప్రతిధ్వనిస్తుంది.
token threshold ద్వారా auto-trigger చేయండి, adaptive డయల్ ఆన్ చేయండి, named profile ను pin చేయండి, ప్రతి request కు one-off సెట్ చేయండి, లేదా ప్రతి routing combo కు pipeline ను కేటాయించండి — workload కు ఏది సరిపోతుందో. మీరు మార్పును promote చేయడానికి ముందు pinned corpus పై fidelity vs. savings ను స్కోర్ చేసే opt-in offline **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 స్క్రిప్ట్లను బ్లాక్ చేయవచ్చు. దాని native runtime ఫైల్లను సిద్ధం చేయడానికి OmniRoute యొక్క `postinstall` (`node scripts/build/postinstall.mjs`) అవసరం. గ్లోబల్గా ఇన్స్టాల్ చేసేటప్పుడు npm హెచ్చరికలో పేర్కొన్న ప్యాకేజీలను అనుమతించండి. OmniRoute 3.8.53 నివేదించిన ప్యాకేజీ సెట్ కోసం:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> భవిష్యత్ గ్లోబల్ ఇన్స్టాల్ల కోసం ఈ allowlist ను తిరిగి ఉపయోగించడానికి, దాన్ని ఒక్కసారి కాన్ఫిగర్ చేసి, తర్వాత సాధారణంగా ఇన్స్టాల్ చేయండి:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> డిపెండెన్సీ జాబితా రిలీజ్ల మధ్య మారవచ్చు; npm వేరే జాబితాను నివేదిస్తే, ఆ హెచ్చరికలోని ప్యాకేజీ పేర్లను ఉపయోగించండి. ప్యాకేజీని అనుమతించడం దాని ఇన్స్టాల్ స్క్రిప్ట్లు అమలు చేయడానికి అనుమతిస్తుంది.
> **Gemini Web లేదా మరో web-cookie ప్రొవైడర్ ఉపయోగిస్తున్నారా?** npm ప్యాకేజీలో
> Playwright ఉంది కానీ దాని Chromium binary లేదు. మొదటి web-provider అభ్యర్థన చేయడానికి ముందు
> [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> గమనిక చూడండి.
Dashboard `http://localhost:20128` వద్ద · API `http://localhost:20128/v1` వద్ద.
**2) మీ స్వంత ఖాతాను ఉపయోగించి అర్హత గల ప్రొవైడర్ను కనెక్ట్ చేయండి**
Dashboard → **Providers** → మీ use case కు ప్రస్తుత నిబంధనలు మరియు కోటా సరిపోయే ప్రొవైడర్ను ఎంచుకోండి → దాని API key జోడించండి లేదా దాని ఖాతా ప్రవాహాన్ని పూర్తి చేయండి. ఉచిత టైర్లకు సైన్-అప్, ఆమోదం లేదా చెల్లింపు పద్ధతి అవసరం కావచ్చు. [ఉచిత టైర్ల గైడ్](docs/getting-started/FREE-TIERS-GUIDE.md) సమీక్షించండి; keyless లభ్యత హామీ లేదు, మరియు `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 మీ కోసం auto-route చేస్తుంది & fallback అవుతుంది.
మీ క్లయింట్ కస్టమ్ హెడర్లను పంపలేకపోతే, OmniRoute tokenized compatibility aliases ను కూడా అందిస్తుంది:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
`Authorization: Bearer ...` జోడించలేని క్లయింట్ల కోసం మాత్రమే వీటిని ఉపయోగించండి. 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 బండ్లర్ ఎంపిక**: నేటివ్ V8 బైండింగ్ అనుకూలత సమస్యలను నివారించడానికి, డెవలప్మెంట్ (`bun run dev`) స్వయంచాలకంగా Bunను గుర్తించి Turbopackను నిలిపివేసి Webpackను ఉపయోగిస్తుంది. ప్రొడక్షన్ బిల్డ్లు (`bun run build`) Nodeలో మాదిరిగానే `OMNIROUTE_USE_TURBOPACK`ను ఖచ్చితంగా అనుసరిస్తాయి: డిఫాల్ట్గా Turbopack, Webpackతో బిల్డ్ చేయడానికి `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` దీన్ని `--build-arg`గా అందుబాటులో ఉంచుతుంది).
- **ప్రత్యేక Bun Dockerfile**: నేటివ్ Bun ప్రొడక్షన్ డిప్లాయ్మెంట్ల కోసం మల్టీ-స్టేజ్ `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Bunతో ఇన్స్టాల్ చేసి రన్ చేయండి
bun install
bun run dev
```
**🛠️ సోర్స్ నుండి**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flakesను ఉపయోగించడం
nix develop
npm run dev
# లేదా devboxను ఉపయోగించడం
devbox run npm run dev
```
📖 [Docker గైడ్](docs/guides/DOCKER_GUIDE.md) — Compose ప్రొఫైల్లు, Caddy HTTPS, Cloudflare టన్నెల్లు.
**🦭 Podman**
```bash
# 1. బైండ్-మౌంట్ చేసిన డేటా డైరెక్టరీని సిద్ధం చేయండి
mkdir -p data
# 2. Linux + స్థానిక rootless Podman కోసం మాత్రమే (రిమోట్ Podman Machine క్లయింట్పై ఎప్పుడూ కాదు):
podman unshare chown 1000:1000 ./data
# 3. రన్టైమ్ సూచనను సెట్ చేసి, స్థానిక Compose ఇమేజ్ను బిల్డ్ చేసి, ప్రారంభించండి
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS లేదా Windowsలో, Podman రిమోట్ Podman Machineను ఉపయోగిస్తుంది: `podman unshare`ను దాటవేసి,
[టోపాలజీ-నిర్దిష్ట డేటా డైరెక్టరీ మార్గదర్శకాన్ని](contrib/podman/README.md#data-directory-permissions-by-topology) అనుసరించండి.
📖 [Podman గైడ్](contrib/podman/README.md) — Compose బిల్డ్లు, Podman Machine మరియు
Linux/systemd Quadlet సెటప్.
**⚡ వేగవంతమైన / తేలికైన ఇన్స్టాలేషన్ (నేటివ్ బిల్డ్ను దాటవేయండి)**
నేటివ్ SQLite ఇంజిన్ (`better-sqlite3`) ఒక **ఐచ్ఛిక** డిపెండెన్సీ, కాబట్టి గ్లోబల్
ఇన్స్టాలేషన్ ఎప్పుడూ సోర్స్ నుండి కంపైల్ కావడం కోసం నిలిచిపోదు: మీ ప్లాట్ఫారమ్/Nodeకు సరిపోయేది
ఉన్నప్పుడు ఇది ముందే బిల్డ్ చేసిన బైనరీని ఉపయోగిస్తుంది; లేకపోతే పారదర్శకంగా ప్యూర్-JS ఇంజిన్కు
ఫాల్బ్యాక్ అవుతుంది (Node 22+లో `node:sqlite`, లేకపోతే బండిల్ చేసిన `sql.js` WASM) — బిల్డ్ టూల్స్ అవసరం లేదు.
ఇన్స్టాలేషన్ తర్వాతి నేటివ్ వార్మ్-అప్ను పూర్తిగా దాటవేయడానికి (CI, హెడ్లెస్ లేదా నెమ్మదైన మెషీన్లు):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 కూడా దీన్ని దాటవేస్తుంది
```
అత్యంత వేగవంతమైన ఇన్స్టాలేషన్ల కోసం **pnpm**ను ప్రాధాన్యంగా ఉపయోగించండి (కంటెంట్-అడ్రెస్డ్ స్టోర్ + హార్డ్ లింక్లు — పైన చూడండి).
డ్యాష్బోర్డ్ లేని హెడ్లెస్ రన్టైమ్ కోసం Docker `base` ప్రొఫైల్ను (పైన) లేదా
[Termux గైడ్ను](docs/guides/TERMUX_GUIDE.md) ఉపయోగించండి. CLI మరియు వెబ్ డ్యాష్బోర్డ్ ఒకే పోర్ట్పై ఒకే
ప్రాసెస్ ద్వారా అందించబడతాయి, కాబట్టి ప్రస్తుతం ప్రత్యేక CLI-మాత్రమే ప్యాకేజ్ లేదు.
Node.js test runner + Vitest — 7,800+ ట్రాక్ చేయబడిన టెస్ట్ ఫైళ్లలో 56,000+ స్టాటిక్ టెస్ట్ డిక్లరేషన్లు (యూనిట్, ఇంటిగ్రేషన్, E2E, సెక్యూరిటీ, ఎకోసిస్టమ్)
7,800+ ట్రాక్ చేయబడిన టెస్ట్ ఫైళ్లలోని 56,000+ స్టాటిక్ టెస్ట్ డిక్లరేషన్ల కోసం టెస్ట్ కవరేజ్ వ్యూహం
# ⭐ టాప్ కంట్రిబ్యూటర్లు
> OmniRoute అభిరుచి గల ఓపెన్-సోర్స్ కమ్యూనిటీచే రూపొందించబడింది. ఈ వ్యక్తులు ప్రాజెక్ట్ యొక్క నాణ్యత, స్థిరత్వం మరియు చేరువను ప్రత్యక్షంగా ప్రభావితం చేసే అసాధారణమైన సహకారాలను అందించారు. **ధన్యవాదాలు.**
### మెర్జ్ చేయబడిన పుల్ రిక్వెస్ట్ల ద్వారా బాహ్య కంట్రిబ్యూటర్లు
ఈ లెక్కలు 2026-10-18 15:09:09 UTC నాటికి ప్రత్యక్ష release/v3.8.52 టిప్ 656f01cb43 తో తీసుకోబడ్డాయి. పేజినేటెడ్ GitHub GraphQL లెక్కల్లో 9,191 మెర్జ్ చేయబడిన PRలు ఉన్నాయి: రిపాజిటరీ యజమానిచే 3,834, Dependabotచే 229, ఇతర బాట్లు/యాప్లచే 6, మరియు 835 మంది విభిన్న కంట్రిబ్యూటర్ల నుండి 5,122 బాహ్య PRలు. "మార్పు చేయబడిన పంక్తులు" అంటే GitHub additions + deletions; ఇది జనరేట్ చేయబడిన ఫైళ్లు, lockfileలు, క్యాటలాగ్లు, అనువాదాలు మరియు డాక్యుమెంటేషన్ను కలిగి ఉంటుంది; ఇది churn, రచయిత రాసిన LOC కాదు. 49 PRలు 500,000 పంక్తుల కంటే ఎక్కువ GitHub diffలను నివేదిస్తాయి (ఉదాహరణకు #13399, ఒకే ప్రొవైడర్ జోడింపు, 2,347 మార్పు చేయబడిన ఫైళ్లను జాబితా చేస్తుంది), ఇది పైన ఉన్న అనేక మొత్తాలను పెంచుతుంది. సమాన స్థానాలు కలిపి ర్యాంక్ చేయబడతాయి.
### GitHub ద్వారా ఆపాదించబడిన కమిట్లు
2026-10-18 14:44:45 UTC వద్ద తిరిగి తనిఖీ చేయబడింది: release/v3.8.52 డిఫాల్ట్ బ్రాంచ్ కోసం రిపోజిటరీ Contributors API ద్వారా నివేదించబడిన GitHub-ఆపాదిత కమిట్లు. API 849 గుర్తింపులను అందించింది (429 మంది వినియోగదారులు, 2 బాట్లు, 418 అనామక); ఈ పట్టిక నిర్వాహకుడిని, బాట్లను మరియు అనామక గుర్తింపులను మినహాయిస్తుంది మరియు పోటీ సమస్థాయిత్వాలను నిలుపుకుంటుంది. ఇది పైన ఉన్న merged-PR ర్యాంకింగ్ మరియు కింది Git-metadata గణన రెండింటి నుండి భిన్నంగా ఉంటుంది.
> 🙏 ఈ సహకారుల ఫీచర్లు, బగ్ ఫిక్స్లు మరియు ఇన్ఫ్రాస్ట్రక్చర్ మెరుగుదలలు 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ను ఉచితంగా మరియు స్వతంత్రంగా ఉంచుతుంది.
## 👥 900+ సహకారులు
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-10-18న ప్రత్యక్ష release/v3.8.52 టిప్ ad160ab2d1 వద్ద ఆడిట్ చేయబడింది (6,826 కమిట్లు): 993 సాధారణీకరించిన మానవ Git గుర్తింపులు — 707 కమిట్ రచయితలుగా (నిర్వాహకుడితో సహా), 286 కేవలం స్పష్టమైన Co-authored-by ట్రైలర్లలో కనిపిస్తాయి. ఈ గణన .mailmapను వర్తింపజేస్తుంది, ఇ-మెయిల్ చిరునామాలను అక్షరాల కేసుతో సంబంధం లేకుండా పోలుస్తుంది, సంఖ్యాత్మక మరియు సాధారణ GitHub noreply చిరునామాలు ఒకే హ్యాండిల్ను సూచించినప్పుడు మాత్రమే వాటిని కలుపుతుంది, 26 బాట్/ఏజెంట్/సర్వీస్/ప్లేస్హోల్డర్ గుర్తింపులను మినహాయిస్తుంది మరియు సాధారణ ఇ-మెయిల్ చిరునామాల ప్రదర్శన పేర్లు సరిపోలినంత మాత్రాన వాటిని విలీనం చేయదు. 2026-08-24 ఆడిట్లో 639గా ప్రచురించబడింది; అదే ఆడిట్ యొక్క బేస్ ac02c5b42fపై ఈ పద్ధతిని మళ్లీ అమలు చేయగా 619 వచ్చింది, కాబట్టి ఈ పెరుగుదల మరింత సడలించిన పద్ధతి వల్ల కాకుండా కొత్త సహకారుల వల్ల వచ్చింది.
### ఎలా సహకరించాలి
1. రిపాజిటరీని ఫోర్క్ చేయండి
2. **సక్రియంగా ఉన్న** `release/vX.Y.Z` టిప్ నుండి బ్రాంచ్ను సృష్టించండి (`main` నుండి కాదు) — [బ్రాంచింగ్ & విడుదల నమూనా](docs/ops/BRANCHING_MODEL.md) చూడండి
3. మీ ఫీచర్ బ్రాంచ్ను సృష్టించండి (`git checkout -b feat/amazing-feature`)
4. మీ మార్పులను కమిట్ చేయండి (`git commit -m 'feat: add amazing feature'`)
5. బ్రాంచ్కు పుష్ చేయండి (`git push origin feat/amazing-feature`)
6. **base = ఆ `release/vX.Y.Z` బ్రాంచ్**తో Pull Requestను తెరవండి
వివరణాత్మక మార్గదర్శకాల కోసం [CONTRIBUTING.md](CONTRIBUTING.md) చూడండి.
### కొత్త వెర్షన్ను విడుదల చేయడం
```bash
# విడుదలను సృష్టించండి — npm publish స్వయంచాలకంగా జరుగుతుంది
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 స్టార్లు
## 🌍 StarMapper
## 🙏 కృతజ్ఞతలు
OmniRoute మహాకాయుల భుజాలపై నిలిచింది. ఇది **[9router](https://github.com/decolua/9router)** యొక్క ఫోర్క్గా మరియు Go ప్రాజెక్ట్ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** యొక్క TypeScript పోర్ట్గా ప్రారంభమైంది — అక్కడి నుంచి, దిగువనున్న ప్రతి ఉపవ్యవస్థ ముందుగా ఆ స్థాయికి చేరుకున్న ఒక ఓపెన్-సోర్స్ ప్రాజెక్ట్ నుంచి ప్రేరణ పొందింది. వాటిలో ప్రతి ఒక్కటీ OmniRouteలోని ఒక నిర్దిష్ట భాగాన్ని తీర్చిదిద్దింది. వారందరికీ ఇది మా కృతజ్ఞతార్పణ. 🙏
> ⭐ స్టార్ల సంఖ్యలు అక్టోబర్ 18, 2026న GitHub REST API ద్వారా ధ్రువీకరించబడ్డాయి — వెళ్లి ఈ ప్రాజెక్ట్లకు ఒక స్టార్ ఇవ్వండి. ఈ సంఖ్యలు ఒక నిర్దిష్ట తేదీ నాటి ఖచ్చితమైన స్నాప్షాట్; సహజంగానే ఇవి మారుతాయి.
### 🧬 వంశపారంపర్యం & గేట్వే
దీని పబ్లిక్ ధరల డేటాసెట్ మా వ్యయ-ట్రాకింగ్ సమకాలీకరణకు సమాచారాన్ని అందిస్తుంది; దీని ప్రొవైడర్-సాధారణీకరణ నమూనా మా రూటింగ్ రూపకల్పనకు మార్గనిర్దేశం చేసింది.
బ్రౌజర్-సెషన్, రెస్పాన్స్-ఫ్రేమింగ్, వినియోగం మరియు వెబ్-సెర్చ్ అడాప్టర్లతో సహా, వెండర్ చేసిన ChatGPT Web → Codex Responses బ్రిడ్జ్లోకి అనుకూలీకరించబడిన MIT సోర్స్.
స్ట్రీమ్ రికవరీ, నో-థింకింగ్ అలియాస్లు, ఫాల్బ్యాక్ వెబ్ సెర్చ్, స్లైడింగ్-విండో పరిమితులు, లాగ్ రిడాక్షన్ మరియు మరింత పటిష్ఠమైన లాంచర్ ప్రవాహాల్లోకి పోర్ట్ చేసిన నమూనాలు.
దీని Grok మోడల్ మ్యాపింగ్లు, నకిలీ-TypeError Statsig జనరేటర్, రిక్వెస్ట్ మరియు డివైస్ డిఫాల్ట్లు, అలాగే NDJSON రెస్పాన్స్ ప్రాసెసర్ OmniRoute యొక్క Grok Web ఎగ్జిక్యూటర్లో గణనీయంగా అనుకూలీకరించబడ్డాయి.
grok2api-merged వెనుకనున్న ప్రధాన ట్రాన్సిటివ్ కోడ్ మూలం; దీని మోడల్, హెడర్, పేలోడ్, Statsig మరియు ప్రాసెసర్ అమలులు Grok Web వంశపారంపర్యంలో సంరక్షించబడ్డాయి.
TQZHR మరియు grok2api-merged ద్వారా కొనసాగించబడిన Grok పేలోడ్ మరియు డివైస్ డిఫాల్ట్లు, Statsig జనరేటర్ మరియు result.response ప్రాసెసర్కు అంతర్లీన MIT మూలం.
దీని ప్రాక్సీ-పూల్ లేయర్ కోసం grok2api-merged గుర్తింపునిచ్చిన ట్రాన్సిటివ్ మూలం; OmniRoute ఆ వంశపారంపర్య గమనికను సంరక్షిస్తుంది, కానీ దాని పరిమిత Grok Web ఎగ్జిక్యూటర్లో ప్రాక్సీ-పూల్ పోర్ట్ను తమదిగా పేర్కొనదు.
దీని కుకీ-ప్రమాణీకృత Grok ప్రాక్సీ మరియు result.response.token స్ట్రీమింగ్ నమూనా OmniRoute యొక్క Grok Web ట్రాన్స్పోర్ట్ రూపకల్పనకు మార్గనిర్దేశం చేశాయి.
అసలు Grok Web అమలు దీని HTTP/బ్రౌజర్ అప్స్ట్రీమ్ డిజైన్ను పరిశీలించింది; దీని ప్రత్యక్ష HTTP మార్గం GrokProxy నుంచి ఉద్భవించినందున, స్వతంత్ర కోడ్ పోర్ట్గా పేర్కొనబడలేదు.
వైరల్ అయిన "చాలా టోకెన్లతో పని చేయాల్సిన అవసరం ఏముంది, కొన్ని టోకెన్లతోనే పని జరిగితే" ప్రాజెక్ట్ — దాని గుహమానవుడి-మాటల తత్వం మా ప్రామాణిక కంప్రెషన్ మోడ్కు, అలాగే 30+ పూరక పదాల తొలగింపు/సంక్షేపణ నియమాలకు ఆధారం.
PT-BR టోకెన్ కంప్రెషన్ — మా pt-BR భాషా ప్యాక్కు ఆధారం: బ్రెజిలియన్-పోర్చుగీస్ వ్యాకరణానికి అనుగుణంగా సర్దుబాటు చేసిన పునరుక్తి తగ్గింపు, పూరక పదాల తొలగింపు.
వైరల్ అయిన "బద్ధకపు సీనియర్ డెవలపర్" YAGNI-కోడర్ నైపుణ్యం — మా తక్కువ-కోడ్ అవుట్పుట్ శైలికి ప్రేరణనిచ్చింది: _రూపొందించిన_ కోడ్ను తగ్గించే అతి చిన్న-పనిచేసే-మార్పు మార్గనిర్దేశం (Caveman సంక్షిప్త గద్యానికి అవుట్పుట్-అక్ష సహోదరి).
Rust నిలువు వరుసల-JSON + కంటెంట్-అడ్రెస్డ్ రిట్రీవ్ + సందేశాల-మధ్య డీడూప్ — మా headroom/ccr/session-dedup ఇంజిన్ డిజైన్ను, అలాగే క్యాష్-స్థిరమైన "కంప్రెస్ చేసిన రూపం స్థానంతో సంబంధం లేనిది" అనే మార్పులేని నియమాన్ని ధ్రువీకరించింది.
కోడింగ్-అసిస్టెంట్ ↔ LLM ట్రాఫిక్కు సంబంధించిన MITM అంతరాయ స్వీకరణ/విశ్లేషణ ప్రారంభ Traffic Inspector అవసరాలను నిర్దేశించడంలో తోడ్పడింది. ఇంతకుముందు ఉత్పన్నమైన నాలుగు మాడ్యూళ్లు — SSE విలీనం, సంభాషణ సాధారణీకరణ, రహస్యాల మాస్కింగ్ మరియు హెడర్ శుద్ధీకరణ — పబ్లిక్ ప్రోటోకాల్ ప్రమాణాల ఆధారంగా రూపొందించిన స్వతంత్ర క్లీన్-రూమ్ అమలులతో భర్తీ చేయబడ్డాయి. రెండు హోస్ట్-పాస్త్రూ ఉపరితలాలు (passthrough.ts మరియు _internal/bypass.cjs) స్వతంత్రంగా వర్గీకరించబడిన OmniRoute-అంతర్గత అమలులుగానే ఉన్నాయి; ఆ భర్తీలో భాగంగా వాటిని తిరిగి వ్రాయలేదు.
మా భద్రతా ఎంపికలకు మార్గనిర్దేశం చేసే, డిఫాల్ట్గానే సురక్షితమైన లైబ్రరీల క్యూరేటెడ్ జాబితా (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
దాని ఖాతా-అవగాహన గల మోడల్ రీమ్యాపింగ్, ఎగ్జిక్యూటబుల్-పాత్ ధ్రువీకరణ మరియు ప్లాన్-లేబుల్ ప్రవర్తన OmniRoute యొక్క Antigravity రన్టైమ్ రూపకల్పనకు తోడ్పడ్డాయి.
Grok Build కోటా ఉపరితలాన్ని గుర్తించింది; ఆపై OmniRoute ప్రత్యక్ష వైర్ ఫార్మాట్ను స్వతంత్రంగా ధ్రువీకరించి సరిచేసింది.
## 📄 లైసెన్స్
MIT లైసెన్స్ - వివరాల కోసం [LICENSE](LICENSE) చూడండి.
---
**[⬆ పైకి తిరిగి వెళ్ళండి](#-omniroute)** · ఓపెన్-సోర్స్ AI కమ్యూనిటీ కోసం ❤️తో నిర్మించబడింది.
OmniRoute v3.8.53 · Node ≥22.22.2 · MIT లైసెన్స్ · omniroute.online
> లైవ్ `/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` కు అర్హత పొందిన రూట్ అవసరం. కొత్త ఇన్స్టాలేషన్లో అర్హత పొందిన కీలెస్ లక్ష్యాలు ఏవీ ఉండకపోవచ్చు, మరియు కీలెస్ ప్రొవైడర్ మూడవ పార్టీ క్లయింట్లను తిరస్కరించవచ్చు. Kiro సహా `tos: avoid` గా గుర్తించబడిన ప్రొవైడర్లు డిఫాల్ట్గా ఆటోమేటిక్ రూటింగ్ నుండి మినహాయించబడతారు; ఖాతాను కనెక్ట్ చేయడం ఆ సెట్టింగ్ను భేదించదు. ప్రొవైడర్ను ఎంచుకోవడానికి ముందు [ఉచిత టైర్ల గైడ్](docs/getting-started/FREE-TIERS-GUIDE.md) చూడండి.
📦 **Python, Node.js, PHP, మరియు cURL** కోసం కాపీ-పేస్ట్ క్విక్స్టార్ట్ స్క్రిప్ట్లు → [`examples/quickstart/`](examples/quickstart/)
> **కాంబో** అనేది OmniRoute **స్వయంచాలకంగా** రూట్ చేసే మోడళ్ల గొలుసు. కోటా అయిపోయినా, ప్రొవైడర్ విఫలమైనా లేదా ఖర్చులు పెరిగినా, కాంబో తదుపరి అర్హత కలిగిన, సక్రమంగా పనిచేస్తున్న మోడల్కు మారగలదు. 🛡️
### ⚡ కాన్ఫిగరేషన్ అవసరం లేదు — `auto`ని ఉపయోగించండి
కాంబోను సృష్టించాల్సిన అవసరం లేదు. మీ మోడల్ను `auto`కి (లేదా దాని వేరియంట్కు) సెట్ చేయండి; OmniRoute మీరు కనెక్ట్ చేసిన ప్రొవైడర్ల నుంచి వర్చువల్ కాంబోను నిర్మించి, ప్రత్యక్షంగా స్కోర్ చేస్తుంది:
📖 [Auto-Combo ఇంజిన్](docs/routing/AUTO-COMBO.md) · [స్థితిస్థాపకత మార్గదర్శిని](docs/architecture/RESILIENCE_GUIDE.md)
📊 పూర్తి పద్ధతి & 9router, OpenRouter, CLIProxyAPI & LiteLLMతో ప్రతి ఫీచర్కు సంబంధించిన వివరణాత్మక పోలిక → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
కీ (యాదృచ్ఛికం): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix కాపీ చేసి అతికించండి:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [ఆథరైజేషన్](docs/architecture/AUTHZ_GUIDE.md) · [గార్డ్రైల్స్](docs/security/GUARDRAILS.md) · [కంప్లయన్స్](docs/security/COMPLIANCE.md)
డిఫాల్ట్ స్టాక్డ్ కాంబో `RTK → Caveman` అమలవుతుంది. రెండూ ఒకే టూల్/కంటెక్స్ట్ పేలోడ్పై పనిచేసినప్పుడు, ఆదాలు కంపౌండ్ అవుతాయి:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
కోడ్ బ్లాక్లు, URLలు, JSON మరియు స్ట్రక్చర్డ్ డేటా ప్రిజర్వేషన్ ఇంజిన్ ద్వారా **ఎల్లప్పుడూ రక్షించబడతాయి**.
> **కొన్ని టోకెన్లతో పని అయితే ఎందుకు అనేక టోకెన్లు వాడాలి?** ప్రతి రిక్వెస్ట్ OmniRoute యొక్క కంప్రెషన్ పైప్లైన్ గుండా **పారదర్శకంగా** వెళ్తుంది — క్లయింట్ మార్పులు అవసరం లేదు. ఇది ఇప్పుడు వరుసగా అమలవ్వే, రూటింగ్ కాంబో వారీగా మిక్స్ & మ్యాచ్ అయ్యే **12 కంపోజబుల్ ఇంజిన్ల స్టాక్** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), మరియు [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) ఆలోచనలపై నిర్మించబడింది.
### 🧱 12-ఇంజిన్ స్టాక్
ఇంజిన్లు పైప్లైన్ క్రమంలో అమలవుతాయి; ప్రతిదీ స్వతంత్రంగా టాగుల్ చేయవచ్చు మరియు కాంబో వారీగా కాన్ఫిగర్ చేయవచ్చు:
