## 💰 థర్డ్-పార్టీ ఉచిత టియర్లలో నెలకు ~1.62B టోకెన్లు
> **మీ స్వంత ప్రొవైడర్ ఖాతాలను తీసుకురండి.** ఇది విడివిడిగా అర్హత కలిగిన థర్డ్-పార్టీ ఉచిత టియర్ల మొత్తం అంచనా మాత్రమే, OmniRoute అందించే టోకెన్ గ్రాంట్ కాదు. సైన్ అప్ చేయండి, అవసరమైన చోట క్రెడెన్షియల్స్ పొందండి, అలాగే మీరు ఉపయోగించగల ప్రొవైడర్లను కనెక్ట్ చేయండి; ప్రతి ప్రొవైడర్ తన పరిమితులు, లభ్యత మరియు నిబంధనలను నియంత్రిస్తుంది.
>
> ఉచిత టియర్లను చేతితో కలపడం చాలా కష్టం — డజన్ల కొద్దీ SDKలు, డజన్ల కొద్దీ రేట్ పరిమితులు, పైగా నిజంగా మీకు ఎంత అందుబాటులో ఉందో తెలియదు. OmniRoute **పునరావృతమయ్యే 35 పూల్ కీలలో 489 ఉచిత-టియర్ ఎంట్రీలను** కేటలాగ్ చేస్తుంది మరియు షేర్ చేసిన పూల్ ఆధారంగా డీడూప్లికేట్ చేసి, **ప్రచురితమైన సానుకూల నెలవారీ బడ్జెట్ ఉన్న 17 పూల్స్తో పాటు ఒక్కో మోడల్కు ఉన్న ఐదు Groq పరిమితుల** నుండి ప్రధాన టోకెన్ సంఖ్యను లెక్కిస్తుంది. ప్రాంతీయ గుర్తింపు తనిఖీ తర్వాత మాత్రమే అందుబాటులోకి వచ్చే కోటాలు (ప్రస్తుతం: ModelScope) విడిగా చూపబడతాయి, ప్రాంతీయ గుర్తింపు ధృవీకరణ వెనుక +~6Mగా ఉంటాయి, అలాగే ప్రధాన సంఖ్యలో ఎప్పుడూ కలపబడవు. ఫలితం డ్యాష్బోర్డ్లో (`/dashboard/free-tiers`) కనిపిస్తూనే ఉంటుంది.
> ప్రత్యక్ష `/dashboard/free-tiers` పేజీ యొక్క యానిమేటెడ్ సారాంశం. పూర్తి విధానం (పూల్ డీడూప్, క్రెడిట్ టియర్లు, ప్రొవైడర్ నిబంధనలు): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ఈ గణాంకాలు ప్రత్యక్ష కేటలాగ్తో పోల్చి ప్రతి రెండు వారాలకు మళ్లీ ఆడిట్ చేయబడతాయి మరియు **రెండు దిశల్లోనూ మారుతాయి** — ఒక ప్రొవైడర్ ఉచిత టియర్ను నిలిపివేస్తే సంఖ్య తగ్గుతుంది; కొత్తది చేరితే పెరుగుతుంది. కేటలాగ్ నిజంగా లెక్కించినదాన్నే మేము ప్రచురిస్తాము, ఎప్పుడూ పెంచి రౌండ్ చేసిన అత్యుత్తమ అంచనాను కాదు.
⭐ OMNIROUTE మీకు డబ్బు ఆదా చేయడంలో మరియు మీ పనిని సులభతరం చేయడంలో సహాయపడితే రెపోకు స్టార్ ఇవ్వండి.
## 🆓 ఇన్స్టాల్ చేసి, ప్రొవైడర్ను కనెక్ట్ చేసి, ఆపై ఒకే ఎండ్పాయింట్ ద్వారా రూట్ చేయండి
```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 ఎందుకు?
## 🤝 మా ఓపెన్ సోర్స్ స్నేహితుల మద్దతుతో
> **ఓపెన్ సోర్స్ స్నేహితుడిగా చేరాలనుకుంటున్నారా?** ఈ కంపెనీలు ఓపెన్ సోర్స్కు మద్దతు ఇస్తాయి మరియు ఓమ్నిరూట్ను కొనసాగించడానికి సహాయపడతాయి — మరియు వారు మాకు ఇచ్చే ప్రతి టోకెన్ ఎక్కడికి వెళ్తుందో మేము బహిరంగంగా చెబుతాము. సంప్రదించండి: [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/offline
🔋 అత్యధిక కోటా / రేట్-లిమిట్ వెసులుబాటుకు మొదటి ప్రాధాన్యం
auto/smart
🔭 నాణ్యతకు మొదటి ప్రాధాన్యం + మెరుగైన మోడళ్లను కనుగొనడానికి 10% అన్వేషణ
auto/lkgp
📌 చివరిగా బాగా పనిచేసిన ప్రొవైడర్కే స్పష్టంగా కట్టుబడి ఉండటం
auto/chaos
🧪 మోడళ్ల ప్యానెల్కు సమాంతర ఫ్యాన్-అవుట్ (ప్రతి ప్రొవైడర్కు ఒకటి, డిఫాల్ట్గా 5), ఒక సమాధానాన్ని అందిస్తుంది; ప్రతి ప్యానెల్ మోడల్కు ఒక అప్స్ట్రీమ్ కాల్, ఇది ఫాల్ట్ ఇంజెక్షన్ కాదు
##
### 🔀 లేదా మీ స్వంతదాన్ని రూపొందించండి — 19 రూటింగ్ వ్యూహాలు
మొత్తం **19** వ్యూహాలు — ప్రతి కాంబో దశలో కలిపి ఉపయోగించండి:
#
వ్యూహం
ఇది ఏమి చేస్తుంది
1
priority
మొదటి లక్ష్యానికి ప్రాధాన్యమిచ్చే క్రమబద్ధమైన జాబితా — తదుపరి దానికి వెళ్లే ముందు ప్రతి దాన్నీ పూర్తిగా వినియోగిస్తుంది 🥇
2
fill-first
తదుపరి దానికి వెళ్లే ముందు ప్రతి లక్ష్యం యొక్క కోటాను పూర్తిగా వినియోగిస్తుంది
3
weighted
ప్రతి లక్ష్యపు వెయిట్ ఆధారంగా వెయిటెడ్ యాదృచ్ఛిక ఎంపిక
4
round-robin
లక్ష్యాలను క్రమానుసారంగా చక్రీయంగా ఉపయోగిస్తుంది
5
p2c
రెండు ఎంపికల శక్తి ఆధారిత యాదృచ్ఛిక లోడ్ బ్యాలెన్సింగ్
6
least-used
ప్రస్తుత లోడ్ అత్యల్పంగా ఉన్న లక్ష్యాన్ని ఎంచుకుంటుంది
7
random
ఏకరీతి యాదృచ్ఛిక ఎంపిక (నకిలీలు తొలగించబడతాయి)
8
strict-random
పునరావృతాల నకిలీలను తొలగించకుండా యాదృచ్ఛిక ఎంపిక 🎲
9
cost-optimized
ప్రత్యక్ష కేటలాగ్ ధరల ఆధారంగా ప్రతి అభ్యర్థనకు అయ్యే $ ఖర్చును కనిష్ఠీకరిస్తుంది 💸
10
headroom
అత్యధిక మిగిలిన కోటా ఉన్న లక్ష్యాన్ని ఎంచుకుంటుంది
11
reset-window
కోటా విండో అతి త్వరగా రీసెట్ అయ్యే లక్ష్యానికి ప్రాధాన్యమిస్తుంది
12
reset-aware
కోటా రీసెట్ సమయం ఆధారంగా ర్యాంక్ చేస్తుంది — చిన్న విండోలకు మొదటి ప్రాధాన్యం 📊
13
context-relay
సుదీర్ఘ సంభాషణల కోసం లక్ష్యాల మధ్య కాంటెక్స్ట్ను బదిలీ చేస్తుంది 🧠
14
context-optimized
ప్రస్తుత కాంటెక్స్ట్ పరిమాణానికి అత్యుత్తమంగా సరిపోయేదాన్ని ఎంచుకుంటుంది
15
cache-optimized
పునర్వినియోగించగల ప్రతి ప్రాంప్ట్ ప్రిఫిక్స్ను అదే అకౌంట్కు పిన్ చేస్తుంది — ప్రాంప్ట్-క్యాష్ హిట్లను గరిష్ఠం చేస్తుంది 🎯
16
lkgp
చివరిగా బాగా పనిచేసిన మార్గం — చివరిగా విజయవంతమైన ప్రొవైడర్కు పిన్ చేసి, ఆపై నియమాలకు ఫాల్బ్యాక్ అవుతుంది
17
auto
ప్రతి కనెక్షన్లో 16 అంశాల ప్రత్యక్ష స్కోరింగ్ 🤖
18
fusion
మోడళ్ల ప్యానెల్కు ఫ్యాన్-అవుట్ చేస్తుంది + ఒక నిర్ణేత ఒకే సమాధానాన్ని సంశ్లేషిస్తుంది 🧬
19
pipeline
దశలను గొలుసుగా కలుపుతుంది — ప్రతి లక్ష్యం యొక్క అవుట్పుట్ తదుపరి దానికి ఇన్పుట్గా వెళ్తుంది 🔗
Auto-Combo ఇంజిన్ ప్రతి అభ్యర్థిని **16 అంశాల** (ఆరోగ్యం, కోటా, ఖర్చు, లేటెన్సీ, పనికి అనుకూలత, నాణ్యత, సెషన్ లభ్యత…) ఆధారంగా స్కోర్ చేస్తుంది — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) చూడండి.
##
### 🧱 స్థితిస్థాపకత అంతర్నిర్మితంగా ఉంటుంది (3 స్వతంత్ర పొరలు)
📖 [ఆటో-కాంబో ఇంజిన్](docs/routing/AUTO-COMBO.md) · [స్థితిస్థాపకత మార్గదర్శిని](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRouteను ప్రత్యేకంగా నిలబెట్టేది ఏమిటి
📊 9router, OpenRouter, CLIProxyAPI & LiteLLMతో పోల్చిన పూర్తి పద్ధతి & ప్రతి ఫీచర్ వివరాలు → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRouteకు మద్దతు ఇవ్వండి
OmniRoute MIT లైసెన్స్తో లభిస్తుంది మరియు బహిరంగంగా నిర్వహించబడుతుంది. ఇది మీ సమయం లేదా డబ్బును ఆదా చేస్తే, దీన్ని స్వతంత్రంగా కొనసాగించడానికి మీకు సరిపోయే ఏదైనా మార్గాన్ని ఎంచుకోండి. స్పాన్సర్షిప్ రూటింగ్ ప్రాధాన్యతను ఎప్పుడూ ప్రభావితం చేయదు; అది దృశ్యమానతను మాత్రమే అందిస్తుంది, ర్యాంకింగ్ను కాదు.
⚠️ ప్రతి కాయిన్ను చూపిన నెట్వర్క్లో మాత్రమే పంపండి — తప్పు నెట్వర్క్లో పంపితే నిధులు కోల్పోవచ్చు.
🐛 బగ్ను కనుగొన్నారా లేదా అభిప్రాయం ఉందా? ఒక [చర్చను](https://github.com/diegosouzapw/OmniRoute/discussions) ప్రారంభించండి.
డెవలపర్ గమనికలు: డెవలపర్ల సౌలభ్యం కోసం npm install/postinstall సమయంలో ప్రాజెక్ట్ స్థానిక .env ఫైల్ను రూపొందించవచ్చు. ఈ ఫైల్ ఉద్దేశపూర్వకంగా .gitignore ద్వారా విస్మరించబడుతుంది (.gitignore చూడండి), దీన్ని ఎప్పటికీ కమిట్ చేయకూడదు — పొరపాటున కమిట్ చేస్తే, బహిర్గతమైన సీక్రెట్లను మార్చి, చరిత్ర నుండి ఫైల్ను తొలగించండి. స్థానిక ఎన్విరాన్మెంట్ ఫైళ్లు మరియు సీక్రెట్ల నిర్వహణపై మార్గదర్శకత్వం కోసం docs/DEVELOPER-ENVIRONMENT.md చూడండి.
## 📡 OmniRoute Radar
పైన డాక్యుమెంట్ చేయబడిన, పూల్-డీడూప్లికేట్ చేసిన కేటలాగ్ నుండి ప్రధాన ఉచిత-టియర్ ముఖ్యాంశం **~1.62B టోకెన్లు/నెల**గానే ఉంది. తాత్కాలిక ప్రొవైడర్ సైన్అప్ క్రెడిట్లు మొదటి నెల పరిమితిని విడిగా **~2.22B** వరకు పెంచగలవు. OmniRoute విడుదలల మధ్య మరింత తాజా ఉచిత-మోడల్ లభ్యతను కోరుకునే వారి కోసం Radar అనేది ఐచ్ఛికమైన, సంతకం చేసిన కేటలాగ్ ఓవర్లే; కమ్యూనిటీ కేటలాగ్ మరియు ఇప్పటికే ఉన్న ప్రతి ఉచిత ఫీచర్ ఉచితంగానే ఉంటాయి.
మద్దతుదారులు లైవ్ కేటలాగ్ను మరియు అదనపు ప్రొవైడర్ అవకాశాలను పొందవచ్చు. ప్రొవైడర్ లభ్యతను బట్టి, దీని ప్రత్యేకమైన, మార్పులకు లోనయ్యే గరిష్ఠ పరిమితి **అత్యధికంగా సుమారు 3B టోకెన్లు/నెల**. ఆ గరిష్ఠ పరిమితి హామీ కాదు: ప్రొవైడర్లు కోటాలు, అర్హత, మోడళ్లు లేదా ప్రాంతాలను ఎప్పుడైనా మార్చవచ్చు.
Radar ఐచ్ఛికం మరియు GET-మాత్రమే. OmniRoute క్లయింట్ ప్రాంప్ట్లు, ట్రాఫిక్, ప్రొవైడర్ కాన్ఫిగరేషన్, వినియోగ టెలిమెట్రీ లేదా స్థానిక ప్రకటన-తొలగింపు స్థితిని అప్లోడ్ చేయదు. అర్హత మరియు ప్రస్తుత కేటలాగ్ గురించి **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** వద్ద తెలుసుకోండి.
## ✨ కొత్తగా ఏమున్నాయి
> **v3.8.20 → v3.8.50**లోని ఇటీవలి ముఖ్యాంశాలు. పూర్తి చరిత్ర [`CHANGELOG.md`](CHANGELOG.md)లో ఉంది.
- **🎛️ OmniConductor** — మీ ఏజెంట్ సమూహానికి ఇన్బౌండ్ A2A డెలిగేషన్, Agent Cardలో Conductor నైపుణ్యాలు, అలాగే Faro పుష్-టు-టాక్ వాయిస్ చాట్తో కూడిన డ్యాష్బోర్డ్ ప్యానెల్. → [A2A సర్వర్](docs/frameworks/A2A-SERVER.md)
- **🛂 అనుకూల అడ్మిషన్ & ఓవర్లోడ్ రక్షణ** — భారీ చాట్ అభ్యర్థనలు 503 లోపాన్ని ఇవ్వకుండా క్యూలో చేరతాయి, ప్రతి కనెక్షన్కు అటామిక్ RPM రోలింగ్ లీజులు ఉంటాయి. → [స్థితిస్థాపకత మార్గదర్శిని](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ ప్రామాణిక `/v1/models` క్రమం** — ప్రతి ప్రొవైడర్కు ఒక అవిచ్ఛిన్నమైన ప్రొవైడర్-గ్రూప్డ్ బ్లాక్ (కాంబోలు మొదట పిన్ చేయబడతాయి), ప్రతి కేటలాగ్ మూలంలోనూ స్థిరంగా ఉంటుంది. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🗜️ కంప్రెషన్ పటిష్ఠీకరణ** — డిఫాల్ట్గా ఆన్లో ఉండే ఇన్ఫ్లేషన్ గార్డ్, DE / FR / JA + చైనీస్ (wényán) కోసం Caveman ప్యాక్లు, Gradle & .NET కోసం RTK ఫిల్టర్లు. → [కంప్రెషన్](docs/compression/COMPRESSION_ENGINES.md)
- **💸 నిజాయితీగల ఫ్లాట్-రేట్ ఖర్చు** — సబ్స్క్రిప్షన్ / కోడింగ్-ప్లాన్ ప్రొవైడర్లు ఖర్చు విశ్లేషణలో **$0**గా చూపబడతారు; బడ్జెట్, కోటా & రూటింగ్ మాత్రం అంచనా వేయడం కొనసాగిస్తాయి. → [API సూచన](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share రూటింగ్** — పూల్ చేసిన కీల మధ్య భాగస్వామ్య ఖాతా కోటాను న్యాయంగా విభజిస్తుంది; పనిని సంరక్షించే విధానం వల్ల ఉపయోగంలో లేని వాటాలు ఇతరులకు అందించబడతాయి. → [స్థితిస్థాపకత మార్గదర్శిని](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ఒకే కమాండ్తో CLI/ఏజెంట్ సెటప్** — నమోదు చేసిన 13 `setup-*` కమాండ్లు; `omniroute run` 7 CLIలను (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ప్రారంభిస్తుంది; `omniroute configure` ఇంటరాక్టివ్ ప్రొవైడర్+మోడల్ ఎంపిక సాధనం, సందర్భానుసారమైన ఇష్టాంశాలతో 10 లక్ష్యాలకు మద్దతు ఇస్తుంది. → [CLI ఇంటిగ్రేషన్లు](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ రిమోట్ మోడ్** — స్కోప్ చేసిన టోకెన్లు (`connect` / `contexts` / `tokens`) + VPS ఇన్స్టాలేషన్ల కోసం `antigravity` OAuth సహాయకాన్ని ఉపయోగించి రిమోట్ OmniRouteను నియంత్రించండి. → [రిమోట్ మోడ్](docs/guides/REMOTE-MODE.md)
- **🧭 మరింత తెలివైన ఆటో-రూటింగ్** — `auto/:` కాంబోలు, **Fusion** (మోడల్ ప్యానెల్ + న్యాయనిర్ణేత), టాస్క్-అవేర్ రూటింగ్, ప్రతి అభ్యర్థనకు మోడల్ / మోడ్ / USD-బడ్జెట్ ఓవర్రైడ్లు. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ ప్లగ్ చేయగల కంప్రెషన్** — కలిపి ఉపయోగించగల 12 ఇంజిన్లు + Compression Studios: LLMLingua-2, రెండు-స్థాయిల Ultra, omniglyph, ప్రతి దశకు ఫిడెలిటీ గేట్, GCF v3.2, డ్రాగ్-రీఆర్డర్ ఎడిటర్. → [కంప్రెషన్](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ పారదర్శక MITM డీక్రిప్షన్ (TPROXY)** — ప్రాక్సీ ఎన్విరాన్మెంట్ వేరియబుల్లను విస్మరించే CLIలను, ప్రతి-SNI CA + ట్రస్ట్-స్టోర్ ఇన్స్టాలర్తో క్యాప్చర్ చేయండి. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 ప్రతిచోటా ఖర్చు టెలిమెట్రీ** — ప్రతి ఎండ్పాయింట్పై `X-OmniRoute-*` ఖర్చు/వినియోగ హెడర్లు, cache-HIT పొదుపు హెడర్, ప్రతి కీకి USD ఖర్చు కోటాలు. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🧠 మీ నియంత్రణలోని మెమరీ** — డిఫాల్ట్గా ఆఫ్లో ఉంటుంది, ఆప్ట్-ఇన్ int8 వెక్టర్ క్వాంటైజేషన్ + టైప్ చేసిన డికే, ప్రతి అభ్యర్థనకు `x-omniroute-no-memory`. → [మెమరీ](docs/frameworks/MEMORY.md)
- **🛡️ భద్రత** — ప్రతి LLM రూట్పై ప్రాంప్ట్-ఇంజెక్షన్ గార్డ్ (రెడ్-టీమ్ సూట్), ఆప్ట్-ఇన్ క్రెడెన్షియల్-మాస్కింగ్ గార్డ్రైల్ (రెండు దిశల్లోనూ లీకైన API కీలు/రహస్యాలను తొలగిస్తుంది), ఉచిత DuckDuckGo చివరి-ప్రయత్న వెబ్ శోధన, అలాగే డ్యాష్బోర్డ్ కోసం ఐచ్ఛిక OIDC లాగిన్ గేట్ (పాస్వర్డ్ లాగిన్ ఎల్లప్పుడూ అందుబాటులోనే ఉంటుంది). → [గార్డ్రైల్లు](docs/security/GUARDRAILS.md)
- **🖼️ కొత్త ఎండ్పాయింట్లు** — `/v1/ocr` (Mistral OCR) మరియు `/v1/audio/translations` (Whisper-శైలి) మీడియా సదుపాయాలను సంపూర్ణం చేస్తాయి. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🎨 చిత్రం / వీడియో / ఆడియో జనరేషన్** — మీడియా కోసం ఒకే API: xAI Grok Imagine & Novita AI వీడియో, ComfyUI, Magnific, Adobe Firefly, Segmind, అలాగే ElevenLabs వంటి స్పీచ్ ప్రొవైడర్లు. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🌍 డిప్లాయ్మెంట్ & ఆపరేషన్లు** — రివర్స్-ప్రాక్సీ `basePath`, బ్రౌజర్-భాష స్వయంచాలక గుర్తింపు, ప్రతి కీకి పరికర ట్రాకింగ్, రూట్-రహిత MITM ట్రస్ట్, zh-TW స్థానికీకరణ. → [ఎన్విరాన్మెంట్](docs/reference/ENVIRONMENT.md)
- **🤝 మరిన్ని ప్రొవైడర్లు & ఏజెంట్లు** — క్లౌడ్ ఏజెంట్లు (Codex Cloud, Cursor, Devin, Jules), బ్రౌజర్ + OAuth లాగిన్తో Grok Build (xAI), ప్రథమ-శ్రేణి Ollama కార్డ్, Claude Opus 5 & Sonnet 5, Kimi అధికారిక భాగస్వామ్యం (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… అలాగే నవీకరించిన **352-ప్రొవైడర్ కేటలాగ్**. → [ప్రొవైడర్లు](docs/reference/PROVIDER_REFERENCE.md)
- **📡 రూటింగ్ పారదర్శకత** — ప్రతి ప్రతిస్పందనలో దాన్ని అందించిన వ్యూహం/ప్రొవైడర్/లేటెన్సీని తెలిపే `X-OmniRoute-Decision` హెడర్ ఉంటుంది; కొత్త `cache-optimized` కాంబో వ్యూహం + Auto-Combo `cacheAffinity` కారకం పునరావృత అభ్యర్థనలను క్యాష్ చేసిన ప్రిఫిక్స్ను కలిగి ఉన్న కనెక్షన్కు తిరిగి రూట్ చేస్తాయి; అలాగే రీడ్-ఓన్లీ `/v1/auto-combo/{channel}/candidates` ఎండ్పాయింట్ ఒక `auto/*` ఛానెల్కు చెందిన లైవ్ క్యాండిడేట్ పూల్ను ప్రదర్శిస్తుంది. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ స్థానిక పనితీరు & ఇన్ఫ్రా** — ఒకే క్లిక్తో స్థానిక Redis, Cloudflare Workers / Deno Deploy రిలే డిప్లాయర్లు, పర్యవేక్షిత ఎంబెడెడ్ సర్వీస్లుగా Bifrost & Mux. → [ఎంబెడెడ్ సర్వీస్లు](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 ప్యాకేజీలో ఇంకా ఉన్నాయి** — ప్లగిన్ ఫ్రేమ్వర్క్ + మార్కెట్ప్లేస్, Omni/Agent/GitHub స్కిల్స్ ఫ్రేమ్వర్క్లు, Obsidian వాల్ట్ ఇంటిగ్రేషన్ (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 ఉచిత & తక్కువ-ఖర్చు మోడళ్లపై నడుస్తుంది.
**మద్దతు ఉన్న ఏదైనా 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
```
ప్రతి కమాండ్ సక్రియ రిమోట్ కాంటెక్స్ట్ను (`omniroute connect `) అనుసరిస్తుంది, `--dry-run`
అమలు చేయకుండానే ఖచ్చితమైన env/argsను ముందుగా చూపిస్తుంది, అలాగే `--api-key-env NAME` రహస్యాలు
మీ షెల్ హిస్టరీలో చేరకుండా ఉంచుతుంది. → [CLI ఇంటిగ్రేషన్లు](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 AI ప్రొవైడర్లు — కేటలాగ్లో గుర్తించబడిన 154 ఉచిత ప్రొవైడర్లు
> **372 నమోదిత ప్రొవైడర్లు** ప్రామాణిక చాట్, మీడియా, శోధన, లోకల్, క్లౌడ్-ఏజెంట్ మరియు సిస్టమ్ కలెక్షన్లలో ఉన్నాయి; వీటిలో **154 ప్రొవైడర్లు `hasFree: true` డిస్కవరీ మెటాడేటాను కలిగి ఉన్నాయి**. చాట్ మోడల్ రిజిస్ట్రీలో **237 ప్రొవైడర్లు / 3,009 విభిన్న ప్రొవైడర్-మోడల్ జంటలు / 1,443 ముడి మోడల్ IDలు** ఉన్నాయి; ప్రత్యేక ఉచిత-బడ్జెట్ కేటలాగ్లో **491 ఒక్కో-మోడల్ వరుసలు**, **35 పునరావృత పూల్లు** మరియు **54 పునరావృత/కీ అవసరం లేని ఎల్లప్పుడూ-ఉచిత ప్రొవైడర్లు** ఉన్నాయి. ఇవి ఉద్దేశపూర్వకంగానే వేర్వేరు హారాలను ఉపయోగిస్తాయి; నిర్వచనాలు మరియు పూల్-డీడూప్ చేసిన లెక్కలు [ప్రొవైడర్ సూచన](docs/reference/PROVIDER_REFERENCE.md) మరియు [ఉచిత టియర్లు](docs/reference/FREE_TIERS.md)లో ఉన్నాయి.
### 🏢 ప్రతి ప్రముఖ ల్యాబ్ — ఒకే ఎండ్పాయింట్ ద్వారా
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…మరియు 330+ ఇతర ప్రొవైడర్లు — ప్రతి ఐకాన్ డ్యాష్బోర్డ్ ప్రొవైడర్ కేటలాగ్ నుండి ప్రత్యక్షంగా లోడ్ అవుతుంది. 📖 [ప్రొవైడర్ సూచన](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 ఎప్పటికీ ఉచితం — $0, కార్డ్ అవసరం లేదు
OpenCode Zen DeepSeek V4, Nemotron 3 టోకెన్ పరిమితి లేదు
Kilo Code ఆటో-రౌటర్, Tencent Hy3 ఎప్పటికీ ఉచితం
Requesty GPT-OSS 120B, Nemotron ఎప్పటికీ ఉచితం
SiliconFlow DeepSeek V3.2 / R1 ఉచిత శ్రేణి
Z.AI GLM GLM-4.7 / 4.5-Flash ఎప్పటికీ ఉచితం
Baidu ERNIE ERNIE 4.0 ఎప్పటికీ ఉచితం
Qoder AI Qwen3-Max, Kimi-K2 అపరిమితంగా ఉచితం
Pollinations GPT, Llama, Claude కీ అవసరం లేదు
Cloudflare AI 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 list # ← రిమోట్ సర్వర్పై నడుస్తుంది
omniroute configure codex # ← రిమోట్ మోడల్ను ఎంచుకుని, స్థానిక Codex ప్రొఫైల్ను రాస్తుంది
omniroute tokens create --name ci --scope read # ఇతర మెషీన్ల కోసం మరింత పరిమిత టోకెన్లను సృష్టించండి
omniroute contexts use default # ← తిరిగి స్థానిక సర్వర్కు మారండి
```
టోకెన్లు `read` / `write` / `admin` స్కోప్లను కలిగి ఉంటాయి; ప్రాసెస్లను ప్రారంభించే రూట్లు లూప్బ్యాక్కు మాత్రమే పరిమితమై ఉంటాయి.
📖 [రిమోట్ మోడ్](docs/guides/REMOTE-MODE.md)
### 🤝 ఒక ఏజెంట్ను కనెక్ట్ చేయండి — అది OmniRouteనే నియంత్రిస్తుంది
OmniRouteను **MCP**, **A2A**, **REST API**, **webhooks** లేదా **రిమోట్ CLI** ద్వారా అందుబాటులో ఉంచండి — సామర్థ్యమున్న ఏ ఏజెంట్కైనా (లేదా మీ స్వంత కోడ్కు) మొత్తం గేట్వేను నియంత్రించే వీలు లభిస్తుంది: రూటింగ్, ప్రొవైడర్లు, కాంబోలు, క్యాష్, కంప్రెషన్, మెమరీ — అన్నీ స్వయంచాలకంగా. కింది HTTP ఎండ్పాయింట్లు `http://localhost:20128` కింద అందించబడతాయి.
ఇంటర్ఫేస్
ఎండ్పాయింట్ / కమాండ్
దీన్ని ఉపయోగించాల్సినవి
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor లేదా ఏదైనా MCP క్లయింట్లో అనుసంధానించండి
అభ్యర్థన / కోటా ఈవెంట్లను Slack, Discord, Telegram లేదా ఏదైనా URLకు పంపండి
🛰️ రిమోట్ CLI
omniroute connect
స్కోప్ చేసిన యాక్సెస్ టోకెన్లతో రిమోట్ ఇన్స్టాన్స్ను నియంత్రించండి
```bash
# MCP ద్వారా Claude Codeకు సంపూర్ణ OmniRoute టూల్సెట్ను అందించండి:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP సర్వర్](docs/frameworks/MCP-SERVER.md) · [A2A సర్వర్](docs/frameworks/A2A-SERVER.md) · [ఏజెంట్ ప్రోటోకాల్లు](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 15–95% టోకెన్లను ఆదా చేయండి — స్వయంచాలకంగా
### 📖 ఇది ఎలా పనిచేస్తుంది — పైప్లైన్, ఆర్కిటెక్చర్ & ఆదా గణితం
డిఫాల్ట్ స్టాక్డ్ కాంబో `RTK → Caveman`ను అమలు చేస్తుంది. రెండూ ఒకే టూల్/కాంటెక్స్ట్ పేలోడ్పై పనిచేసినప్పుడు, ఆదా సమ్మిళితమవుతుంది:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
కోడ్ బ్లాక్లు, 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%
షెల్/టెస్ట్/బిల్డ్/git అవుట్పుట్
🔗 Stacked (RTK → Caveman)
78–95%
మిశ్రమ ప్రాంప్ట్లు + టూల్ లాగ్లు
**వాస్తవ ఉదాహరణ — Standard మోడ్:**
> **ముందు (69 టోకెన్లు):** _"మీ React కాంపోనెంట్ మళ్లీ రెండర్ అవడానికి కారణం, మీరు ప్రతి రెండర్ సైకిల్లో కొత్త ఆబ్జెక్ట్ రిఫరెన్స్ను సృష్టించడం కావచ్చు. మీరు ఇన్లైన్ ఆబ్జెక్ట్ను propగా పంపినప్పుడు, React యొక్క షాలో కంపారిజన్ ప్రతిసారీ దాన్ని వేరే ఆబ్జెక్ట్గా గుర్తిస్తుంది, ఇది రీ-రెండర్ను ప్రేరేపిస్తుంది. ఆ ఆబ్జెక్ట్ను మెమోయిజ్ చేయడానికి useMemo ఉపయోగించాలని నేను సిఫార్సు చేస్తాను."_
>
> **తర్వాత (19 టోకెన్లు):** _"ప్రతి రెండర్లో కొత్త ఆబ్జెక్ట్ ref. ఇన్లైన్ ఆబ్జెక్ట్ prop = కొత్త ref = రీ-రెండర్. useMemoలో ర్యాప్ చేయండి."_
>
> **అదే సమాధానం. 72% తక్కువ టోకెన్లు. ఖచ్చితత్వ నష్టం సున్నా.** ✅
**PT-BR ఉదాహరణ — [Troglodita](https://github.com/leninejunior/troglodita) మోడ్:**
> **ముందు (42 టోకెన్లు):** _"ప్రతి రెండరింగ్ చక్రంలో కొత్త ఆబ్జెక్ట్ రిఫరెన్స్ సృష్టించబడుతున్నందున కాంపోనెంట్ మళ్లీ రెండర్ అవుతోంది. `useMemo` ఉపయోగించాలని నేను సిఫార్సు చేస్తాను."_
>
> **తర్వాత (12 టోకెన్లు):** _"రీ-రెండర్: ప్రతి చక్రంలో కొత్త ref (inline ఆబ్జెక్ట్ మళ్లీ సృష్టించబడింది). `useMemo` ఉపయోగించండి."_
>
> **అదే సమాధానం. ~70% తక్కువ టోకెన్లు. సాంకేతిక ఖచ్చితత్వం యథాతథం.** ✅
### 🎚️ ఇంజిన్లకు మించి — అవుట్పుట్ శైలులు, అనుకూల డయల్ & ప్రతి అభ్యర్థనపై నియంత్రణ
పైన ఉన్న 12 ఇంజిన్లు లోపలికి వెళ్లేదాన్ని సంక్షిప్తం చేస్తాయి. మరో మూడు పొరలు **ఎలా**, **ఎప్పుడు**, మరియు బయటకు **ఏమి** వస్తుందో నిర్దేశిస్తాయి:
- **🪄 అవుట్పుట్ శైలులు** _(అవుట్పుట్-అక్ష నియంత్రణ)_ — నిర్ణీతమైన, cache-safe ప్రతిస్పందన-రూపకల్పన సూచనలను చొప్పిస్తాయి; వీటిని కలిపి ఉపయోగించవచ్చు, ప్రతి దానికి `lite` / `full` / `ultra` తీవ్రత ఉంటుంది. ఒక శైలిని జోడించడానికి registryలో ఒకే లైన్ entry సరిపోతుంది:
- **సంక్షిప్త గద్యం** — అనవసర పదాలు / articles / సందేహ సూచనలను తొలగించండి; సాంకేతిక సారాన్ని ఖచ్చితంగా ఉంచండి.
- **తక్కువ కోడ్** — "సోమరి senior dev" YAGNI: పనిచేసే అత్యల్ప మార్పు, అడగని scaffolding వద్దు.
- **Ponytail (సోమరి senior dev)** — YAGNI మెట్లను ఎక్కి, మూల కారణాన్ని పరిష్కరించి, పనిచేసే అత్యల్ప diffను ఇవ్వండి.
- **నాకు ADHD ఉంది (చర్య-ముందు)** — తదుపరి చర్యతో ప్రారంభించండి, దశలకు సంఖ్యలు ఇవ్వండి, ఒక నిర్దిష్ట తదుపరి దశ మాత్రమే, ఉపోద్ఘాతం వద్దు.
- **సంక్షిప్త CJK (文言)** — ప్రాచీన-చైనీస్ అత్యంత సంక్షిప్త శైలి (`zh` localeకు మాత్రమే పరిమితం).
- **🎯 అనుకూల context-budget** _(డయల్)_ — ఒకే on/off టోకెన్ పరిమితికి బదులుగా, **మోడల్ context windowలో సరిపోవడానికి** అవసరమైనంత వరకే అత్యంత చౌకైన, అతి తక్కువ నష్టమున్న ఇంజిన్లను క్రమంగా అమలు చేస్తుంది. విధానం: `reserve-output` (డిఫాల్ట్, మోడల్ను పరిగణించేది) · `percentage` · `absolute`. మోడ్: `floor` (సరిపోవడాన్ని నిర్ధారిస్తుంది) · `replace-autotrigger` (మీ స్పష్టమైన ఎంపికకు ప్రాధాన్యం) · `off` (పాత threshold).
- **🎛️ Compression ఎక్కడ నిర్ణయించబడుతుంది** _(ప్రాధాన్యత, అధికం → తక్కువ)_ — ప్రతి అభ్యర్థనకు `x-omniroute-compression` header › routing-combo override › సక్రియ named profile › adaptive / auto-trigger › panel default › off. వర్తింపజేసిన ప్లాన్ `X-OmniRoute-Compression: ; source=` response headerలో తిరిగి కనిపిస్తుంది.
టోకెన్ threshold ఆధారంగా auto-trigger చేయండి, adaptive dialను ఆన్ చేయండి, named profileను స్థిరపరచండి, ప్రతి అభ్యర్థనకు ఒకసారి మాత్రమే వర్తించే సెట్టింగ్ ఇవ్వండి, లేదా ప్రతి routing comboకు ఒక pipelineను కేటాయించండి — workloadకు ఏది సరిపోతే అది ఉపయోగించండి. ఐచ్ఛిక offline **eval harness** (`npm run eval:compression`) మార్పును అమలులోకి తీసుకురాకముందు, స్థిరపరచిన corpusపై fidelityతో పోల్చి savingsకు స్కోర్ ఇస్తుంది.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ త్వరిత ప్రారంభం
**1) ఇన్స్టాల్ చేసి అమలు చేయండి**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` లేదా peer-dep హెచ్చరికలు కనిపిస్తున్నాయా? [అవి హానికరం కావు](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 లేదా తర్వాతి వెర్షన్ను ఉపయోగిస్తున్నారా?** అనుమతించకపోతే npm package lifecycle scriptsను నిరోధించవచ్చు. దాని native runtime ఫైళ్లను సిద్ధం చేయడానికి OmniRoute యొక్క `postinstall` (`node scripts/build/postinstall.mjs`) అవసరం. globally ఇన్స్టాల్ చేస్తున్నప్పుడు npm హెచ్చరికలో పేర్కొన్న packagesను అనుమతించండి. OmniRoute 3.8.51 నివేదించిన package set కోసం:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> భవిష్యత్తు global installs కోసం ఈ allowlistను మళ్లీ ఉపయోగించాలంటే, దీన్ని ఒకసారి configure చేసి, తర్వాత సాధారణంగా ఇన్స్టాల్ చేయండి:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> releases మధ్య dependency జాబితా మారవచ్చు; npm వేరే జాబితాను నివేదిస్తే, ఆ హెచ్చరికలోని package పేర్లను ఉపయోగించండి. ఒక packageను అనుమతిస్తే, దాని install scripts అమలవుతాయి.
> **Gemini Web లేదా మరొక web-cookie providerను ఉపయోగిస్తున్నారా?** npm packageలో
> Playwright ఉంటుంది, కానీ దాని Chromium binary ఉండదు. మొదటి web-provider అభ్యర్థన చేయడానికి ముందు
> [Playwright Chromium సెటప్](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> గమనికను చూడండి.
Dashboard `http://localhost:20128` వద్ద · API `http://localhost:20128/v1` వద్ద ఉంటుంది.
**2) మీ స్వంత ఖాతాతో అర్హత కలిగిన providerను కనెక్ట్ చేయండి**
Dashboard → **Providers** → మీ వినియోగ సందర్భానికి ప్రస్తుత నిబంధనలు మరియు quota సరిపోయే providerను ఎంచుకోండి → దాని API keyను జోడించండి లేదా దాని account flowను పూర్తి చేయండి. Free tiersకు signup, approval లేదా payment method అవసరం కావచ్చు. [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md)ను పరిశీలించండి; keyless లభ్యతకు హామీ లేదు, మరియు `tos: avoid`గా గుర్తించిన providers డిఫాల్ట్గా `auto` నుండి మినహాయించబడతాయి.
**3) మీ coding toolను అనుసంధానించండి**
```txt
Base URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints నుండి కాపీ చేయండి]
Model: auto (అర్హత కలిగిన connections మధ్య route చేస్తుంది — లేదా provider/modelను ఎంచుకోండి)
```
**4) ఇది పనిచేస్తోందని నిర్ధారించండి**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
మీరు కనెక్ట్ చేసిన models జాబితా కనిపించాలి. 🎉 అంతే — coding ప్రారంభించండి, OmniRoute మీ కోసం స్వయంచాలకంగా routesను ఎంచుకుని, అవసరమైతే fallback అవుతుంది.
మీ client custom headersను పంపలేకపోతే, OmniRoute tokenized compatibility aliasesను కూడా అందిస్తుంది:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
`Authorization: Bearer ...`ను జోడించలేని clients కోసం మాత్రమే వీటిని ఉపయోగించండి. Header auth ఇప్పటికీ ప్రాధాన్య మోడ్గా ఉంటుంది.
## 📦 మరిన్ని ఇన్స్టాలేషన్ పద్ధతులు — Docker, సోర్స్, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` అత్యధికంగా **ప్రచురించబడిన** స్థిరమైన SemVerను అనుసరిస్తుంది. ఇది git `main`ను ట్రాక్ చేయదు. GitOps కోసం `:X.Y.Z`ను పిన్ చేయండి. [Docker విడుదల ఛానెల్లు](docs/guides/DOCKER_GUIDE.md#release-channels) చూడండి. ఇమేజ్లో **`OMNIROUTE_MEMORY_MB=1024`** పిన్ చేయబడింది. డ్యాష్బోర్డ్ మరియు తేలికపాటి చాట్ కోసం అది సరిపోతుంది. **కోడింగ్ ఏజెంట్లకు** (Claude Code, Codex, Grok, … నుండి `POST /v1/responses`) చాలా పెద్ద V8 హీప్ అవసరం; లేకపోతే ఒకదానితో ఒకటి ఓవర్ల్యాప్ అయ్యే రెండు దీర్ఘ కాంటెక్స్ట్ల కింద సుమారు 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 టెస్ట్ రన్నర్ + Vitest — 5,100+ ట్రాక్ చేయబడిన టెస్ట్ ఫైళ్లలో 39,000+ స్టాటిక్ టెస్ట్ డిక్లరేషన్లు (యూనిట్, ఇంటిగ్రేషన్, E2E, భద్రత, ఎకోసిస్టమ్)
5,100+ ట్రాక్ చేయబడిన పరీక్ష ఫైళ్లలోని 39,000+ స్థిర పరీక్ష డిక్లరేషన్ల కోసం పరీక్ష కవరేజ్ వ్యూహం
# ⭐ అగ్ర సహకారులు
> OmniRoute ఒక ఉత్సాహభరితమైన ఓపెన్-సోర్స్ కమ్యూనిటీ చేత రూపుదిద్దుకుంది. ఈ వ్యక్తులు ప్రాజెక్ట్ నాణ్యత, స్థిరత్వం మరియు విస్తృతిపై నేరుగా ప్రభావం చూపే అసాధారణ సహకారాలు అందించారు. **ధన్యవాదాలు.**
### విలీనం చేయబడిన పుల్ రిక్వెస్ట్ల ఆధారంగా బాహ్య సహకారులు
2026-08-24 05:26:03 UTC వరకు జరిగిన విలీనాలతో, ప్రత్యక్ష release/v3.8.50 చివరి కమిట్ dafb4ae808 వద్ద స్థిరీకరించబడింది. పేజీలుగా విభజించబడిన GitHub GraphQL గణనలో 5,911 విలీనమైన PRలు ఉన్నాయి: రిపోజిటరీ యజమాని నుండి 2,707, Dependabot నుండి 179 మరియు 535 మంది విభిన్న సహకారుల నుండి 3,025 బాహ్య PRలు. “మారిన పంక్తులు” అనేది GitHub చేర్పులు + తొలగింపులు; ఇందులో రూపొందించబడిన ఫైళ్లు, లాక్ఫైళ్లు, కేటలాగ్లు, అనువాదాలు మరియు డాక్యుమెంటేషన్ ఉంటాయి; ఇది మార్పుల పరిమాణం మాత్రమే, రచించిన LOC కాదు. కటాఫ్ వద్ద సమాన స్థానాలను అలాగే ఉంచారు.
### GitHub ఆపాదించిన కమిట్లు
Bob.Hou 🏅 GitHubకు ఆపాదించబడిన 51 కమిట్లు · #10వ స్థానంలో సమానం
Xiangzhe 🏅 GitHubకు ఆపాదించబడిన 51 కమిట్లు · #10వ స్థానంలో సమానం
2026-08-24 06:14:31 UTCకి మళ్లీ తనిఖీ చేయబడింది: release/v3.8.50 డిఫాల్ట్ బ్రాంచ్ కోసం రిపోజిటరీ Contributors API నివేదించిన GitHubకు ఆపాదించబడిన కమిట్లు. API 525 గుర్తింపులను (415 వినియోగదారులు, 2 బాట్లు, 108 అనామక గుర్తింపులు) అందించింది; ఈ పట్టిక నిర్వహణకర్త, బాట్లు మరియు అనామక గుర్తింపులను మినహాయించి, సమాన స్థానాలను అలాగే ఉంచుతుంది. ఇది పైన ఉన్న విలీనం చేసిన PR ర్యాంకింగ్కు, కింద ఉన్న 639 మంది Git-మెటాడేటా జనగణనకు రెండింటికీ భిన్నమైనది.
> 🙏 ఈ కాంట్రిబ్యూటర్ల ఫీచర్లు, బగ్ పరిష్కారాలు మరియు మౌలిక సదుపాయాల మెరుగుదలలు OmniRouteను నమ్మదగినదిగా, ఫీచర్లతో సమృద్ధిగా చేసే అంశాలలో **ప్రధాన భాగం**. ప్రతి పుల్ రిక్వెస్ట్, ప్రతి టెస్ట్ కేస్ మరియు ప్రతి i18n అనువాద ఫైల్ ముఖ్యమైనవే. ఓపెన్ సోర్స్ను నిర్మించేది వీరిలాంటి వ్యక్తులే.
---
## 💖 స్పాన్సర్లు
తమ స్వంత డబ్బుతో OmniRouteకు నిధులు అందిస్తున్న వారికి హృదయపూర్వక ధన్యవాదాలు — ప్రతి సహకారం ఈ ప్రాజెక్ట్ను ఉచితంగా, స్వతంత్రంగా మరియు ముందుకు సాగేలా ఉంచుతుంది.
… మరియు తమ వివరాలను గోప్యంగా ఉంచుకోవడానికి ఇష్టపడే ఇతరులు 💛పబ్లిక్ GitHub Sponsorsను 2026-08-24న తిరిగి ధృవీకరించాం. పైన ఉన్న క్రియాశీల లేబుల్లను GitHub యొక్క activeOnly స్థితి నిర్ణయిస్తుంది; గతంలో బహిరంగంగా వెల్లడించిన ఏకకాల మద్దతుదారులకు మా కృతజ్ఞతలు కొనసాగుతాయి, అలాగే ప్రైవేట్ స్పాన్సర్లు అజ్ఞాతంగానే ఉంటారు.💖 స్పాన్సర్గా మారండి → — ప్రతి డాలర్ OmniRouteను ఉచితంగా మరియు స్వతంత్రంగా ఉంచుతుంది.
## 👥 600+ సహకారులు
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
స్థిరపరచిన ఆధారం ac02c5b42f వద్ద 2026-08-24న ఆడిట్ చేసి, ప్రత్యక్ష release/v3.8.50 అగ్రస్థానం dafb4ae808 వద్ద తిరిగి తనిఖీ చేయబడింది: సాధారణీకరించిన 639 మానవ Git గుర్తింపులు — 407 మంది commit రచయితలుగా (నిర్వాహకుడితో సహా), 232 మంది స్పష్టమైన Co-authored-by ట్రైలర్లలో మాత్రమే కనిపిస్తారు. ఈ గణన GitHub noreply హ్యాండిల్లను సాధారణీకరిస్తుంది, 26 bot/agent/service/placeholder గుర్తింపులను మినహాయిస్తుంది మరియు సాధారణ ఇమెయిల్ చిరునామాల ప్రదర్శన పేర్లు సరిపోలుతున్నాయనే కారణంతో మాత్రమే వాటిని విలీనం చేయదు.
### సహకరించడం ఎలా
1. repositoryను 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) చూడండి.
### కొత్త Versionను విడుదల చేయడం
```bash
# releaseను సృష్టించండి — npm publish స్వయంచాలకంగా జరుగుతుంది
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 స్టార్లు
## 🌍 StarMapper
## 🙏 కృతజ్ఞతలు
OmniRoute మహోన్నతుల కృషిపై నిర్మితమైంది. ఇది **[9router](https://github.com/decolua/9router)** యొక్క forkగా మరియు Go ప్రాజెక్ట్ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** యొక్క TypeScript portగా ప్రారంభమైంది — ఆ తర్వాత, దిగువ పేర్కొన్న ప్రతి subsystem, అదే పనిని ముందుగా సాధించిన ఒక open-source ప్రాజెక్ట్ నుండి ప్రేరణ పొందింది. వాటిలో ప్రతి ఒక్కటీ OmniRouteలోని ఒక నిర్దిష్ట భాగాన్ని రూపొందించడంలో సహాయపడింది. వారందరికీ ఇదే మా కృతజ్ఞత. 🙏
> ⭐ స్టార్ల సంఖ్యలు August 24, 2026న GitHub REST API ద్వారా ధృవీకరించబడ్డాయి — ఈ ప్రాజెక్ట్లకు వెళ్లి ఒక స్టార్ ఇవ్వండి. ఈ సంఖ్యలు ఆ తేదీ నాటి ఖచ్చితమైన snapshot మాత్రమే; సహజంగానే ఇవి మారుతాయి.
### 🧬 మూలపరంపర & gateway
బ్రౌజర్-సెషన్, ప్రతిస్పందన-ఫ్రేమింగ్, వినియోగం మరియు వెబ్-శోధన అడాప్టర్లతో సహా, వెండర్ చేసిన ChatGPT Web → Codex Responses బ్రిడ్జ్లోకి స్వీకరించబడిన MIT సోర్స్.
స్ట్రీమ్ పునరుద్ధరణ, ఆలోచన-రహిత అలియాస్లు, ప్రత్యామ్నాయ వెబ్ శోధన, స్లైడింగ్-విండో పరిమితులు, లాగ్ గోప్యీకరణ మరియు పటిష్ఠమైన లాంచర్ ప్రవాహాల్లోకి పోర్ట్ చేసిన నమూనాలు.
దీని Grok మోడల్ మ్యాపింగ్లు, నకిలీ-TypeError Statsig జనరేటర్, అభ్యర్థన మరియు పరికర డిఫాల్ట్లు, అలాగే NDJSON ప్రతిస్పందన ప్రాసెసర్ OmniRoute యొక్క Grok Web ఎగ్జిక్యూటర్లోకి గణనీయంగా స్వీకరించబడ్డాయి.
TQZHR మరియు grok2api-merged ద్వారా కొనసాగించబడిన Grok పేలోడ్ మరియు పరికర డిఫాల్ట్లు, Statsig జనరేటర్ మరియు result.response ప్రాసెసర్కు మూలమైన MIT సోర్స్.
దాని ప్రాక్సీ-పూల్ లేయర్కు మూలంగా grok2api-merged గుర్తింపు ఇచ్చిన పరోక్ష సోర్స్; OmniRoute ఆ వంశపరంపర గమనికను భద్రపరుస్తుంది, కానీ దాని పరిమిత Grok Web ఎగ్జిక్యూటర్లో ప్రాక్సీ-పూల్ పోర్ట్ను తనదిగా పేర్కొనదు.
అసలు Grok Web అమలు దీని HTTP/బ్రౌజర్ అప్స్ట్రీమ్ డిజైన్ను పరిశీలించింది; దీని ప్రత్యక్ష HTTP మార్గం GrokProxy నుండి ఉద్భవించింది, కాబట్టి స్వతంత్ర కోడ్ పోర్ట్గా పేర్కొనబడలేదు.
దీని Rust ChatOptions మరియు ప్రతిస్పందన-ఎన్వలప్ స్కీమాలు OmniRoute యొక్క TypeScript Grok అభ్యర్థన మరియు స్ట్రీమింగ్-ప్రతిస్పందన రకాల రూపకల్పనకు దోహదపడ్డాయి.
వైరల్ అయిన "ఎక్కువ టోకెన్లు ఎందుకు వాడాలి, కొన్ని టోకెన్లతోనే పని పూర్తయినప్పుడు" ప్రాజెక్ట్ — దాని గుహమానవుడి-మాటల తత్వమే మా ప్రామాణిక కంప్రెషన్ మోడ్కు, అలాగే 30+ అనవసర పదాల తొలగింపు/సంక్షేపణ నియమాలకు ఆధారం.
PT-BR టోకెన్ కంప్రెషన్ — మా pt-BR భాషా ప్యాక్కు ఆధారం: బ్రెజిలియన్-పోర్చుగీస్ వ్యాకరణానికి అనుగుణంగా సర్దుబాటు చేసిన పునరుక్తి తగ్గింపు, అనవసర పదాల తొలగింపు.
వైరల్ అయిన "సోమరి సీనియర్ డెవలపర్" YAGNI-కోడర్ నైపుణ్యం — మా less-code అవుట్పుట్ శైలికి స్ఫూర్తినిచ్చింది: _రూపొందించిన_ కోడ్ను తగ్గించే, పనిచేసే అతి చిన్న మార్పు వైపు నడిపించే విధానం (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.52 · Node ≥22.22.2 · MIT లైసెన్స్ · omniroute.online