> ఉచిత స్థాయిలను చేతితో కలిపి నిర్వహించడం కష్టమైన పని — డజన్ల కొద్దీ 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
# కొత్త ఇన్స్టాల్, జీరో ఆధారాలు — `auto` ఇప్పటికే పని చేస్తుంది:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
నిర్దిష్ట ఉచిత బ్యాకెండ్ను ఇష్టపడతారా? `oc/…` (OpenCode Free)ని నేరుగా కాల్ చేయండి. ఆపై `auto`కి అప్గ్రేడ్ చేయండి మరియు OmniRoute ఎంచుకోనివ్వండి.📦 **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
🧪 స్థితిస్థాపకత పరీక్ష కోసం ఫాల్ట్-ఇంజెక్షన్ వెయిట్లు (కేయాస్ ఇంజినీరింగ్)
##
### 🔀 లేదా మీ స్వంతదాన్ని నిర్మించండి — 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)
## 🏆 ఓమ్నిరూట్ ను ప్రత్యేకంగా నిలబెట్టేది ఏమిటి
📊 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 + Chinese (wényán) కోసం Caveman ప్యాక్లు, Gradle & .NET కోసం RTK ఫిల్టర్లు. → [కంప్రెషన్](docs/compression/COMPRESSION_ENGINES.md)
- **💸 నిజాయితీగల ఫ్లాట్-రేట్ ఖర్చు** — సబ్స్క్రిప్షన్ / కోడింగ్-ప్లాన్ ప్రొవైడర్ల ఖర్చు విశ్లేషణలో **$0**గా చూపబడుతుంది; బడ్జెట్, కోటా & రూటింగ్ మాత్రం అంచనా వేయడాన్ని కొనసాగిస్తాయి. → [API సూచన](docs/reference/API_REFERENCE.md)
- **⚖️ కోటా-షేర్ రూటింగ్** — పూల్ చేసిన కీలు అంతటా భాగస్వామ్య ఖాతా కోటాను న్యాయంగా విభజిస్తుంది; ఉపయోగంలో లేని వాటాలను ఇతరులకు అందించడం ద్వారా పని సామర్థ్యాన్ని కాపాడుతుంది. → [స్థితిస్థాపకత గైడ్](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ఒకే కమాండ్తో CLI/ఏజెంట్ సెటప్** — నమోదు చేసిన 13 `setup-*` కమాండ్లు; `omniroute run` 7 CLIలను (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ప్రారంభిస్తుంది; `omniroute configure` ఇంటరాక్టివ్ ప్రొవైడర్+మోడల్ పికర్ మరియు ప్రతి సందర్భానికి ఇష్టాంశాలతో 10 లక్ష్యాలకు మద్దతు ఇస్తుంది. → [CLI ఇంటిగ్రేషన్లు](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ రిమోట్ మోడ్** — స్కోప్ చేసిన టోకెన్లు (`connect` / `contexts` / `tokens`) + VPS ఇన్స్టాలేషన్ల కోసం `antigravity` OAuth సహాయకంతో రిమోట్ OmniRouteను నిర్వహించండి. → [రిమోట్ మోడ్](docs/guides/REMOTE-MODE.md)
- **🧭 మరింత తెలివైన ఆటో-రూటింగ్** — `auto/:` కాంబోలు, **Fusion** (మోడల్ ప్యానెల్ + జడ్జ్), టాస్క్-అవేర్ రూటింగ్, ప్రతి అభ్యర్థనకు మోడల్ / మోడ్ / USD-బడ్జెట్ ఓవర్రైడ్లు. → [ఆటో-కాంబో](docs/routing/AUTO-COMBO.md)
- **🗜️ ప్లగ్ చేయగల కంప్రెషన్** — కలిపి ఉపయోగించగల 12 ఇంజిన్లు + Compression Studios: LLMLingua-2, రెండు-స్థాయుల Ultra, omniglyph, ప్రతి దశకు ఫిడెలిటీ గేట్, GCF v3.2, డ్రాగ్-రీఆర్డర్ ఎడిటర్. → [కంప్రెషన్](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ పారదర్శక MITM డిక్రిప్షన్ (TPROXY)** — ప్రతి SNIకి ప్రత్యేక CA + ట్రస్ట్-స్టోర్ ఇన్స్టాలర్తో, ప్రాక్సీ ఎన్విరాన్మెంట్ వేరియబుల్స్ను పట్టించుకోని CLIలను క్యాప్చర్ చేయండి. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 ప్రతిచోటా ఖర్చు టెలిమెట్రీ** — ప్రతి ఎండ్పాయింట్పై `X-OmniRoute-*` ఖర్చు/వినియోగ హెడర్లు, క్యాష్-HIT ఆదా హెడర్, ప్రతి కీకి USD ఖర్చు కోటాలు. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🧠 మీ నియంత్రణలో ఉండే మెమరీ** — డిఫాల్ట్గా ఆఫ్లో ఉంటుంది; ఎంపిక చేసుకుని ప్రారంభించగల int8 వెక్టర్ క్వాంటైజేషన్ + టైప్ చేసిన డికే, ప్రతి అభ్యర్థనకు `x-omniroute-no-memory`. → [మెమరీ](docs/frameworks/MEMORY.md)
- **🛡️ భద్రత** — ప్రతి LLM రూట్పై ప్రాంప్ట్-ఇంజెక్షన్ గార్డ్ (రెడ్-టీమ్ సూట్), ఎంపిక చేసుకుని ప్రారంభించగల క్రెడెన్షియల్-మాస్కింగ్ గార్డ్రైల్ (రెండు దిశల్లోనూ లీకైన API కీలు/సీక్రెట్లను తొలగిస్తుంది), ఉచిత DuckDuckGo చివరి-ప్రయత్న వెబ్ శోధన, అలాగే డ్యాష్బోర్డ్ కోసం ఐచ్ఛిక OIDC లాగిన్ గేట్ (పాస్వర్డ్ లాగిన్ ఎల్లప్పుడూ అందుబాటులో ఉంటుంది). → [గార్డ్రైల్లు](docs/security/GUARDRAILS.md)
- **🖼️ కొత్త ఎండ్పాయింట్లు** — `/v1/ocr` (Mistral OCR) మరియు `/v1/audio/translations` (Whisper-శైలి) మీడియా సామర్థ్యాలను సంపూర్ణం చేస్తాయి. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🎨 చిత్రం / వీడియో / ఆడియో జనరేషన్** — మీడియా కోసం ఒకే API: xAI Grok Imagine & Novita AI వీడియో, ComfyUI, Magnific, Adobe Firefly, Segmind, అలాగే ElevenLabs వంటి స్పీచ్ ప్రొవైడర్లు. → [API సూచన](docs/reference/API_REFERENCE.md)
- **🌍 డిప్లాయ్మెంట్ & ఆపరేషన్లు** — రివర్స్-ప్రాక్సీ `basePath`, బ్రౌజర్ భాషను స్వయంచాలకంగా గుర్తించడం, ప్రతి కీకి పరికర ట్రాకింగ్, రూట్ అవసరం లేని MITM ట్రస్ట్, zh-TW స్థానికీకరణ. → [ఎన్విరాన్మెంట్](docs/reference/ENVIRONMENT.md)
- **🤝 మరిన్ని ప్రొవైడర్లు & ఏజెంట్లు** — క్లౌడ్ ఏజెంట్లు (Codex Cloud, Cursor, Devin, Jules), బ్రౌజర్ + OAuth లాగిన్తో Grok Build (xAI), ప్రథమ-శ్రేణి Ollama కార్డ్, Claude Opus 5 & Sonnet 5, Kimi అధికారిక భాగస్వామ్యం (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… అలాగే నవీకరించిన **352-ప్రొవైడర్ కేటలాగ్**. → [ప్రొవైడర్లు](docs/reference/PROVIDER_REFERENCE.md)
- **📡 రూటింగ్ పారదర్శకత** — ప్రతి ప్రతిస్పందనలో దాన్ని అందించిన వ్యూహం/ప్రొవైడర్/లేటెన్సీని పేర్కొనే `X-OmniRoute-Decision` హెడర్ ఉంటుంది; కొత్త `cache-optimized` కాంబో వ్యూహం + Auto-Combo `cacheAffinity` కారకం, క్యాష్ చేసిన ప్రిఫిక్స్ను కలిగి ఉన్న కనెక్షన్కే పునరావృత అభ్యర్థనలను తిరిగి రూట్ చేస్తాయి; అలాగే రీడ్-ఓన్లీ `/v1/auto-combo/{channel}/candidates` ఎండ్పాయింట్ ఒక `auto/*` ఛానెల్ యొక్క ప్రత్యక్ష అభ్యర్థుల పూల్ను వెల్లడిస్తుంది. → [ఆటో-కాంబో](docs/routing/AUTO-COMBO.md)
- **⚡ స్థానిక పనితీరు & మౌలిక సదుపాయాలు** — ఒకే క్లిక్తో స్థానిక Redis, Cloudflare Workers / Deno Deploy రిలే డిప్లాయర్లు, పర్యవేక్షిత ఎంబెడెడ్ సేవలుగా Bifrost & Mux. → [ఎంబెడెడ్ సేవలు](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 ప్యాకేజీలో ఇవీ ఉన్నాయి** — ప్లగిన్ ఫ్రేమ్వర్క్ + మార్కెట్ప్లేస్, Omni/Agent/GitHub నైపుణ్యాల ఫ్రేమ్వర్క్లు, Obsidian వాల్ట్ ఇంటిగ్రేషన్ (22 MCP టూల్స్), OpenAI-అనుకూల Batch & Files APIలు, సెమాంటిక్ రెస్పాన్స్ క్యాష్, లీడర్బోర్డ్లతో గేమిఫికేషన్, ACP ఏజెంట్ డిస్కవరీ (అంతర్నిర్మితంగా 15 ఏజెంట్లు), BigQueryకి షెడ్యూల్ చేసిన లాగ్ ఎగుమతి, `auto/chaos` ఫాల్ట్ ఇంజెక్షన్, Telegram బాట్ బ్రిడ్జ్, యాప్లోనే వెర్షన్ మేనేజర్ మరియు LMArena-ELO ఉచిత-ప్రొవైడర్ ర్యాంకింగ్లు. → [డాక్యుమెంటేషన్](docs/README.md)
## 🤖 అనుకూలమైన CLIs & కోడింగ్ ఏజెంట్లు
> ఒకే కాన్ఫిగ్ — `http://localhost:20128/v1` — తో **ప్రతి** AI IDE లేదా CLI ఉచిత & తక్కువ-ఖర్చు మోడళ్లపై నడుస్తుంది.
**మద్దతు ఉన్న ఏదైనా 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)
## 🌐 357 AI ప్రొవైడర్లు — కేటలాగ్లో ఉచితంగా గుర్తించబడినవి 152
> కానానికల్ చాట్, మీడియా, సెర్చ్, లోకల్, క్లౌడ్-ఏజెంట్ మరియు సిస్టమ్ కలెక్షన్లలో **357 నమోదిత ప్రొవైడర్లు** ఉన్నారు; వీటిలో **152 ప్రొవైడర్లు `hasFree: true` డిస్కవరీ మెటాడేటాను కలిగి ఉన్నారు**. చాట్ మోడల్ రిజిస్ట్రీలో **229 ప్రొవైడర్లు / 2,554 ప్రత్యేక ప్రొవైడర్-మోడల్ జతలు / 1,283 ముడి మోడల్ 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 రోజుకు 1M టోకెన్లు
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-ఇంజిన్ల స్టాక్
ఇంజిన్లు పైప్లైన్ క్రమంలో అమలవుతాయి; ప్రతి ఇంజిన్ను విడిగా ఆన్/ఆఫ్ చేయవచ్చు మరియు ప్రతి కాంబోకు కాన్ఫిగర్ చేయవచ్చు:
ప్రత్యక్ష 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 ఇంజిన్లు లోపలికి వెళ్లేదాన్ని కుదిస్తాయి. మరో మూడు లేయర్లు **ఎలా**, **ఎప్పుడు**, మరియు బయటకు **ఏమి** వస్తుందో రూపొందిస్తాయి:
- **🪄 అవుట్పుట్ శైలులు** _(అవుట్పుట్-అక్ష నియంత్రణ)_ — నిర్దిష్టమైన, క్యాష్కు సురక్షితమైన ప్రతిస్పందన-రూపకల్పన సూచనలను చొప్పిస్తాయి; వీటిని కలిపి ఉపయోగించవచ్చు, ప్రతి ఒక్కటి `lite` / `full` / `ultra` తీవ్రతలో ఉంటుంది. ఒక శైలిని జోడించడానికి రిజిస్ట్రీలో ఒకే పంక్తి ఎంట్రీ సరిపోతుంది:
- **సంక్షిప్త గద్యం** — అనవసర పదాలు / ఆర్టికల్లు / సందిగ్ధతను తొలగిస్తుంది; సాంకేతిక సారాన్ని ఖచ్చితంగా ఉంచుతుంది.
- **తక్కువ కోడ్** — "సోమరి సీనియర్ డెవలపర్" YAGNI: పని చేసే అతి చిన్న మార్పు, అడగని స్కాఫోల్డింగ్ ఉండదు.
- **పోనీటెయిల్ (సోమరి సీనియర్ డెవలపర్)** — YAGNI నిచ్చెనను ఎక్కి, మూల కారణాన్ని పరిష్కరించి, పని చేసే అతి చిన్న diffను అందిస్తుంది.
- **నాకు ADHD ఉంది (చర్య-ముందు)** — తదుపరి చర్య ముందుగా వస్తుంది, దశలు సంఖ్యలతో ఉంటాయి, ఒక నిర్దిష్ట తదుపరి దశ ఉంటుంది, ఉపోద్ఘాతం ఉండదు.
- **సంక్షిప్త CJK (文言)** — సాంప్రదాయ-చైనీస్ అత్యంత సంక్షిప్త శైలి (`zh` లోకేల్కు మాత్రమే పరిమితం).
- **🎯 అడాప్టివ్ కాంటెక్స్ట్-బడ్జెట్** _(డయల్)_ — ఒకే ఆన్/ఆఫ్ టోకెన్ థ్రెషోల్డ్కు బదులుగా, **మోడల్ కాంటెక్స్ట్ విండోలో సరిపడేందుకు** అవసరమైనంత వరకే అతి చవకైన, అత్యల్ప-నష్ట ఇంజిన్లను క్రమంగా వర్తింపజేస్తుంది. విధానం: `reserve-output` (డిఫాల్ట్, మోడల్-అవగాహనతో) · `percentage` · `absolute`. మోడ్: `floor` (సరిపోతుందని హామీ) · `replace-autotrigger` (మీ స్పష్టమైన ఎంపికకు ప్రాధాన్యం) · `off` (పాత థ్రెషోల్డ్).
- **🎛️ కంప్రెషన్ ఎక్కడ నిర్ణయించబడుతుంది** _(ప్రాధాన్య క్రమం, ఎక్కువ → తక్కువ)_ — ప్రతి అభ్యర్థనకు `x-omniroute-compression` హెడర్ › రౌటింగ్-కాంబో ఓవర్రైడ్ › సక్రియ నేమ్డ్ ప్రొఫైల్ › అడాప్టివ్ / ఆటో-ట్రిగర్ › ప్యానెల్ డిఫాల్ట్ › ఆఫ్. వర్తింపజేసిన ప్లాన్ `X-OmniRoute-Compression: ; source=` ప్రతిస్పందన హెడర్లో తిరిగి ప్రతిధ్వనిస్తుంది.
టోకెన్ థ్రెషోల్డ్ ద్వారా ఆటో-ట్రిగర్ చేయండి, అడాప్టివ్ డయల్ను ఆన్ చేయండి, నేమ్డ్ ప్రొఫైల్ను పిన్ చేయండి, ప్రతి అభ్యర్థనకు ఒకసారి మాత్రమే వర్తించే సెట్టింగ్ను నిర్దేశించండి, లేదా ప్రతి రౌటింగ్ కాంబోకు ఒక పైప్లైన్ను కేటాయించండి — పనిభారానికి ఏది సరిపోతే అది ఉపయోగించండి. మార్పును అమల్లోకి తీసుకురావడానికి ముందు, స్వచ్ఛందంగా ఉపయోగించగల ఆఫ్లైన్ **మూల్యాంకన హార్నెస్** (`npm run eval:compression`) పిన్ చేసిన కార్పస్పై నాణ్యత పరిరక్షణను ఆదాతో పోల్చి స్కోర్ చేస్తుంది.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ త్వరిత ప్రారంభం
**1) ఇన్స్టాల్ చేసి అమలు చేయండి**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` లేదా peer-dep హెచ్చరికలు కనిపిస్తున్నాయా? [అవి హానికరం కావు](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
డ్యాష్బోర్డ్ `http://localhost:20128` వద్ద · API `http://localhost:20128/v1` వద్ద.
**2) ఉచిత ప్రొవైడర్ను కనెక్ట్ చేయండి (సైన్అప్ అవసరం లేదు)**
డ్యాష్బోర్డ్ → **ప్రొవైడర్లు** → **Kiro AI** (ఉచిత Claude, ఒక్కో ఖాతాకు ~50 క్రెడిట్లు/నెల) లేదా **OpenCode Free** (ప్రామాణీకరణ అవసరం లేదు) కనెక్ట్ చేయండి → పూర్తయింది.
**3) మీ కోడింగ్ సాధనాన్ని అనుసంధానించండి**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (zero-config smart routing — or any provider/model)
```
**4) ఇది పనిచేస్తోందని ధృవీకరించండి**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
మీరు కనెక్ట్ చేసిన మోడల్లు జాబితాలో కనిపించాలి. 🎉 అంతే — కోడింగ్ ప్రారంభించండి; OmniRoute మీ కోసం స్వయంచాలకంగా రూట్ చేసి, అవసరమైతే ప్రత్యామ్నాయానికి మారుతుంది.
మీ క్లయింట్ కస్టమ్ హెడర్లను పంపలేకపోతే, OmniRoute టోకెన్తో కూడిన అనుకూలత అలియాస్లను కూడా అందిస్తుంది:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
`Authorization: Bearer ...` జోడించలేని క్లయింట్ల కోసం మాత్రమే వీటిని ఉపయోగించండి. హెడర్ ప్రామాణీకరణే ప్రాధాన్య మోడ్గా కొనసాగుతుంది.
## 📦 మరిన్ని ఇన్స్టాలేషన్ పద్ధతులు — Docker, సోర్స్, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` అత్యధికంగా **ప్రచురించబడిన** స్థిరమైన SemVerను అనుసరిస్తుంది. ఇది git `main`ను ట్రాక్ చేయదు. GitOps కోసం `:X.Y.Z`ను పిన్ చేయండి. [Docker విడుదల ఛానెల్లు](docs/guides/DOCKER_GUIDE.md#release-channels) చూడండి. ఇమేజ్లో **`OMNIROUTE_MEMORY_MB=1024`** పిన్ చేయబడింది. డ్యాష్బోర్డ్ మరియు తేలికపాటి చాట్ కోసం అది సరిపోతుంది. **కోడింగ్ ఏజెంట్లకు** (Claude Code, Codex, Grok, … నుండి `POST /v1/responses`) చాలా పెద్ద V8 హీప్ అవసరం; లేకపోతే ఒకదానితో ఒకటి ఓవర్ల్యాప్ అయ్యే రెండు దీర్ఘ కాంటెక్స్ట్ల కింద సుమారు 12 GiB వద్ద ప్రాసెస్ `FATAL ERROR`తో విఫలమవుతుంది. కంటైనర్ పరిమాణాన్ని హీప్ కంటే ఎక్కువగా సెట్ చేయండి (నేటివ్ బఫర్లు V8 వెలుపల ఉంటాయి):
| వర్క్లోడ్ | హీప్ (`-e OMNIROUTE_MEMORY_MB`) | కంటైనర్ (`--memory`) |
| ------------------------------------ | ------------------------------- | -------------------- |
| డ్యాష్బోర్డ్ / తేలికపాటి చాట్ | `1024` (ఇమేజ్ డిఫాల్ట్) | ≥2 g |
| ఒక కోడింగ్ ఏజెంట్ | `8192` | ≥10 g |
| ఏకకాలంలో రెండు దీర్ఘ `/v1/responses` | `10240`–`12288` | ≥12–16 g |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
పూర్తి పట్టిక: [Docker గైడ్ — రన్టైమ్ RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **ప్రీ-రిలీజ్ Docker ఛానెల్:** `diegosouzapw/omniroute:next` మరియు
> `diegosouzapw/omniroute:next-web` ప్రస్తుత డిఫాల్ట్ `release/v*`
> బ్రాంచ్ను అనుసరిస్తాయి. ఈ మార్చగల ట్యాగ్లు విడుదల కాని పరిష్కారాలను పరీక్షించడానికి మాత్రమే
> ఉద్దేశించబడ్డాయి మరియు **ప్రొడక్షన్లో వినియోగానికి మద్దతు లేదు**. చూడండి:
> [Docker విడుదల ఛానెల్లు](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Bun రన్టైమ్ గుర్తింపు ద్వారా ప్రామాణిక `bun install` మరియు గ్లోబల్ ఇన్స్టాలేషన్ (`bun install -g omniroute`)కు మద్దతు ఉంది:
- **అంతర్నిర్మిత `bun:sqlite`**: Bun కింద రన్ అవుతున్నప్పుడు OmniRoute, Bun యొక్క అంతర్నిర్మిత `bun:sqlite` డ్రైవర్ను ఉపయోగిస్తుంది; Node.jsలో `better-sqlite3`కు లేదా `sql.js`కు ఫాల్బ్యాక్ అవుతుంది.
- **డెవలప్మెంట్లో ఆటోమేటిక్ Webpack బండ్లర్ ఎంపిక**: నేటివ్ 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-మాత్రమే ప్యాకేజ్ లేదు.
pino — అభ్యర్థన సందర్భంతో కూడిన స్ట్రక్చర్డ్ JSON లాగ్లు
పరీక్ష
Node.js టెస్ట్ రన్నర్ + Vitest — 39,000+ స్టాటిక్ టెస్ట్ డిక్లరేషన్లు 5,100+ ట్రాక్ చేయబడిన టెస్ట్ ఫైల్లలో (యూనిట్, ఇంటిగ్రేషన్, 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.51 · Node ≥22.22.2 · MIT లైసెన్స్ · omniroute.online
> ప్రత్యక్ష `/dashboard/free-tiers` పేజీ యొక్క యానిమేటెడ్ సారాంశం. పూర్తి విధానం (పూల్ నకిలీల తొలగింపు, క్రెడిట్ స్థాయిలు, ప్రొవైడర్ నిబంధనలు): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> ఈ గణాంకాలు ప్రత్యక్ష జాబితాతో పోల్చి ప్రతి రెండు వారాలకు ఒకసారి మళ్లీ ఆడిట్ చేయబడతాయి మరియు **రెండు దిశల్లోనూ మారుతాయి** — ఒక ప్రొవైడర్ ఉచిత స్థాయిని నిలిపివేస్తే సంఖ్య తగ్గుతుంది; కొత్తది చేరితే పెరుగుతుంది. జాబితా వాస్తవంగా లెక్కించిన దానినే మేము ప్రచురిస్తాము, పెంచి గుండ్రంగా చేసిన అత్యుత్తమ సంభావ్య సంఖ్యను కాదు.
```bash
# కొత్త ఇన్స్టాల్, జీరో ఆధారాలు — `auto` ఇప్పటికే పని చేస్తుంది:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
నిర్దిష్ట ఉచిత బ్యాకెండ్ను ఇష్టపడతారా? `oc/…` (OpenCode Free)ని నేరుగా కాల్ చేయండి. ఆపై `auto`కి అప్గ్రేడ్ చేయండి మరియు OmniRoute ఎంచుకోనివ్వండి.
📦 **Python, Node.js, PHP, మరియు cURL** కోసం క్విక్స్టార్ట్ స్క్రిప్ట్లను కాపీ-పేస్ట్ చేయండి → [`examples/quickstart/`](examples/quickstart/)
> **కాంబో** అనేది OmniRoute **స్వయంచాలకంగా** రూట్ చేసే మోడళ్ల గొలుసు. కోటా అయిపోయినా, ప్రొవైడర్ విఫలమైనా లేదా ఖర్చులు పెరిగినా, కాంబో తదుపరి అర్హతగల ఆరోగ్యకరమైన మోడల్కు మారగలదు. 🛡️
### ⚡ శూన్య-కాన్ఫిగరేషన్ — `auto`ను ఉపయోగిస్తే చాలు
కాంబోను సృష్టించాల్సిన అవసరం లేదు. మీ మోడల్ను `auto`కు (లేదా దాని వేరియంట్కు) సెట్ చేయండి; OmniRoute మీ కనెక్ట్ చేసిన ప్రొవైడర్ల నుంచి వర్చువల్ కాంబోను నిర్మించి, ప్రత్యక్షంగా స్కోర్ చేస్తుంది:
📖 [ఆటో-కాంబో ఇంజిన్](docs/routing/AUTO-COMBO.md) · [స్థితిస్థాపకత మార్గదర్శిని](docs/architecture/RESILIENCE_GUIDE.md)
📊 9router, OpenRouter, CLIProxyAPI & LiteLLM లతో పోలిస్తే పూర్తి పద్ధతి & ఫీచర్ వారీ వివరాలు → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
కీ (యాదృచ్ఛికం): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix కాపీ చేసి అతికించండి:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [ఆథరైజేషన్](docs/architecture/AUTHZ_GUIDE.md) · [గార్డ్రైల్స్](docs/security/GUARDRAILS.md) · [కంప్లయన్స్](docs/security/COMPLIANCE.md)
డిఫాల్ట్ స్టాక్డ్ కాంబో `RTK → Caveman`ను అమలు చేస్తుంది. రెండూ ఒకే టూల్/కాంటెక్స్ట్ పేలోడ్పై పనిచేసినప్పుడు, ఆదా చక్రవడ్డీలా పెరుగుతుంది:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
కోడ్ బ్లాక్లు, 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-ఇంజిన్ల స్టాక్
ఇంజిన్లు పైప్లైన్ క్రమంలో అమలవుతాయి; ప్రతి ఇంజిన్ను విడిగా ఆన్/ఆఫ్ చేయవచ్చు మరియు ప్రతి కాంబోకు కాన్ఫిగర్ చేయవచ్చు:
