## 💰 ~1.62B Token / Kwa Ọnwa N'ofe Ogo Efu nke Ndị Ọzọ
> **Weta akaụntụ ndị na-enye gị ọrụ nke onwe gị.** Nke a bụ ngụkọta e chere n'ofe ogo efu nke ndị ọzọ ruru eru iche iche, ọ bụghị onyinye token sitere n'aka OmniRoute. Debanye aha, nweta ihe akaebe ebe a chọrọ ya, jikọọ ndị na-enye ọrụ ị nwere ike iji; onye na-enye ọrụ ọ bụla na-achịkwa oke ya, nnweta ya, na usoro ya.
>
> Ịchịkọta ogo efu n'aka siri ike — ọtụtụ SDK, ọtụtụ oke ọnụego, na enweghị amụma ihe ị nwere n'ezie. OmniRoute na-edepụta **467 ndenye ogo efu n'ofe 34 igodo pool na-agba ugboro ugboro** ma gụọ isi ọnụọgụ token site na **17 pool nwere mmefu ego kwa ọnwa dị mma e bipụtara gbakwunyere ise oke Groq kwa model**, e wepụrụ nkwụghachi site na pool a kesara. A na-egosi quota ndị na-emeghe naanị mgbe a chọpụtara njirimara ókèala (taa: ModelScope) iche, +~6M n'azụ nyocha njirimara ókèala, na a naghị agụkọta ha n'isi ọnụọgụ ahụ. Nsonaazụ ahụ na-anọgide na-egosi na dashboard (`/dashboard/free-tiers`).
> Nchịkọta animation nke ibe `/dashboard/free-tiers` dị ndụ. Usoro zuru oke (iwepụ nkwụghachi pool, ogo kredit, usoro ndị na-enye ọrụ): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> A na-enyocha ọnụọgụ ndị a ọzọ kwa izu abụọ tụnyere katalọgụ dị ndụ, ha **na-agagharị n'ụzọ abụọ** — onye na-enye ọrụ kwụsịrị ogo efu, ọnụọgụ ahụ na-ebelata; nke ọhụrụ batara, ọ na-arịgo. Anyị na-ebipụta ihe katalọgụ ahụ na-agụ n'ezie, ọ bụghị ihe kacha mma e gbakọtara elu.
⭐ Nye repo ahụ kpakpando ọ bụrụ na OMNIROUTE nyere gị aka ịchekwa ego ma mee ka ọrụ gị dị mfe.
## 🆓 Wụnye, jikọọ onye na-enye ọrụ, wee ziga ozi gafee otu endpoint
```bash
# Mgbe ị jikọtara onye na-enye ọrụ, depụta igodo OmniRoute gị site na Dashboard → Endpoints:
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` chọrọ ụzọ ruru eru. Ntinye ọhụrụ nwere ike ịnweghị ebumnuche na-adịghị achọ igodo ruru eru, onye na-enye ọrụ na-adịghị achọ igodo nwekwara ike jụ ndị ahịa ndị ọzọ. E wepụtara ndị na-enye ọrụ e depụtara `tos: avoid`, gụnyere Kiro, na ịziga ozi akpaghị aka; ijikọ akaụntụ agaghị eme ka ntọala ahụ gbanwee. Lee [Ntuziaka Ọkwa Efu](docs/getting-started/FREE-TIERS-GUIDE.md) tupu ị họrọ onye na-enye ọrụ.📦 Script mmalite ngwa ngwa ị nwere ike idepụta maka **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Nkwa Ahụ
# 🤔 Gịnị Mere OmniRoute?
## 🤝 Ndị Enyi Anyị Na-emeghe Isi Iyi Na-akwado
> **Ị chọrọ isonye dị ka Enyi Na-emeghe Isi Iyi?** Ndị a bụ ụlọ ọrụ na-akwado isi iyi mepere emepe ma na-enyere OmniRoute aka ịga n'ihu — anyị na-ekwupụta n'ihu ọha ebe token ọ bụla ha nyere anyị na-aga. Kpọtụrụ: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Ekele dịrị Kimi (Moonshot AI), Enyi Anyị Na-emeghe Isi Iyi na-amalite, maka ịkwado ọrụ a! Kimi bụ ụlọ nyocha AI n'azụ ezinụlọ ihe nlereanya K2 na K3 nwere ibu arọ mepere emepe — Kimi K3 na-enye windo gburugburu 1M-token, ọhụụ ala na koodu ọkwa ókèala na ọnụ ahịa dị ala karịa ihe nlereanya mechiri emechi, ma na-arụ ọrụ ozugbo na Claude Code, Codex na ngwaọrụ koodu ọ bụla OmniRoute na-enye.
Ihe nkwado Kimi na-enye ike: Ebe nchekwa API nke Kimi na-enye ike usoro mwepụta OmniRoute AI-validated — ọkwa nkwenye njikọta nke Kimi K3 kwadoro nke na-enyocha arịrịọ ịdọrọ ọ bụla tupu ebuga ya — tinyere mmepe njirimara kwa ụbọchị. Nkwado Kimi nke mbụ na-ebugharị n'ụzọ abụọ: Kimi API (kimi-k3) na atụmatụ koodu Kimi Code (OAuth na igodo API). OmniRoute bụkwa ọrụ isi iyi mepere emepe nke Brazil mbụ na mmemme nkwado Kimi. Nweta igodo API Kimi nwere 15% mgbakwunye kredit →
Cheaper Inference cheaperinference.com
Ekele dịrị Cheaper Inference, Enyi OmniRoute Na-emeghe Isi Iyi, maka ịkwado ọrụ a! Cheaper Inference bụ ọnụ ụzọ ámá nwere ọnụ ahịa dị ọnụ ala nke na-ere ihe nlereanya ókèala 42 — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok na MiniMax — n'azụ otu njedebe dakọtara na OpenAI, na-ebugharị arịrịọ ọ bụla gaa na onye na-enye ọrụ kacha ọnụ ala na-akwụghị ụgwọ karịa ọnụ ahịa ndepụta onye na-emepụta ihe nlereanya.
Nkwado nke mbụ na OmniRoute: Nkwụsị Nkata, njedebe /v1/responses ala, ọhụụ, oku ngwaọrụ na ihe nlereanya onyonyo 3 (grok-imagine, nano-banana-pro, nano-banana-2, enwere ike iru dị ka cheaperinference/<model>). Nweta igodo API →
Njikọ akara aff=omniroute bụ njikọ mmekọ. Ha na-enye ọrụ ahụ ego na-enweghị ụgwọ ọ bụla ọzọ nye gị. 🎟️ Mgbasa Ozi Ndị Mmekọ — kupọọn ndebanye aha n'efu sitere n'aka ndị na-enye ọrụ anyị na-adịghị akwado (pịa ka ịgbasa)Ngalaba a bụ maka koodu ntụnye aka/kupọọn naanị. Mmekọrịta nkwado dị na 🤝 Ndị Enyi Anyị Na-emeghe Isi Iyi Na-akwado n'elu. OmniRoute enweghị nkwado ma ọ bụ mmekọrịta ya na ndị na-enye ọrụ edepụtara ebe a — ndị a bụ kupọọn ọha onye ọ bụla nwere ike iji.
AgentRouter agentrouter.org
AgentRouter — ndebanye aha mmekọ · $100 kredit n'efu na ndebanye aha (ihe nkesa n'efu, tụọ anya oge nkwụsị dị elu — kacha mma maka nnwale, ọ bụghị mmepụta). Nkwado nke mbụ na OmniRoute kemgbe v3.8.50: Nkwụsị Nkata, usoro waya dakọtara na Anthropic na ụzọ dakọtara na OpenAI. Ihe nlereanya dị gụnyere claude-opus-4-8, claude-opus-5, gpt-5.6-sol na ndị ọzọ. Nweta $100 gị →
⚠️ Njikọ mmekọ — OmniRoute enweghị nkwado ma ọ bụ mmekọrịta ya na onye na-enye ọrụ a.
Ị ma onye na-enye ọrụ ọzọ nwere kupọọn ndebanye aha n'efu na-emesapụ aka nke na-abara ndị ọrụ OmniRoute uru? Mepee okwu anyị ga-agbakwunye ya ebe a.
## 🎯 Combos — Nke Kachasị Pụta Ihe
> **Combo** bụ usoro ụdịdị AI nke OmniRoute na-agafe n'etiti ha **na-akpaghị aka**. Ọ bụrụ na oke ojiji agwụ, onye na-eweta ọrụ daa, ma ọ bụ ọnụahịa rịa elu, combo nwere ike ịgafe na ụdị AI ọzọ tozuru oke ma dị mma. 🛡️
### ⚡ Enweghị nhazi — naanị jiri `auto`
Ọ dịghị combo ị ga-emepụta. Tọọ ụdị AI gị ka ọ bụrụ `auto` (ma ọ bụ otu n'ime ụdị ya), OmniRoute ga-emepụta combo mebere site n'aka ndị na-eweta ọrụ ị jikọtara, ma na-enye ha akara ozugbo:
NJ ụdị AI
Ihe ọ na-eme ka ọ kacha mma
auto
🎯 Nhazi ndabara ziri ezi (LKGP — na-arapara n'ahụ onye na-eweta ọrụ ikpeazụ rụrụ ọrụ nke ọma)
auto/coding
🧑💻 Arọ ndị na-ebute ogo ụzọ maka imepụta koodu
auto/fast
⚡ Nke nwere oge nchere kacha nta ụzọ
auto/cheap
💰 Nke dị ọnụ ala kacha nta kwa token ụzọ
auto/subscription
🎟️ Naanị oke ojiji nke ndebanye aha ị na-akwụlarị — ọ ga-akwụsị ma ọ bụrụ na nke ahụ adịghị, ọ gaghị eji nhọrọ ndabere a na-akwụ ụgwọ mgbe ọ bụla (ntuziaka)
auto/thrifty
🪜 Oke ojiji nke atụmatụ ụzọ, emesịa otu ọkwa n'otu oge ruo na nhọrọ ndị a na-akwụ ụgwọ dị ọnụ ala kacha nta — laghachi n'atụmatụ ahụ mgbe e tọgharịrị ya (ntuziaka)
auto/offline
🔋 Nke nwere ohere fọdụrụ kachasị n'oke ojiji / oke ọsọ ụzọ
auto/smart
🔭 Ogo ụzọ + nyocha 10% iji chọpụta ụdị AI ndị ka mma
auto/lkgp
📌 Ịrapara n'ahụ onye na-eweta ọrụ ikpeazụ amaara na ọ dị mma n'ụzọ doro anya
auto/chaos
🧪 Iziga arịrịọ n'otu oge gaa n'ìgwè ụdị AI (otu maka onye na-eweta ọrụ ọ bụla, 5 na ndabara), wee weghachite otu azịza; otu oku upstream maka ụdị AI ọ bụla dị n'ìgwè ahụ, ọ bụghị itinye ntụpọ n'ọrụ
##
### 🔀 Ma ọ bụ mepụta nke gị — usoro ntụgharị 20
Usoro **20** niile — gwakọta ma dakọtara ha na nzọụkwụ combo ọ bụla:
#
Usoro
Ihe ọ na-eme
1
priority
Ndepụta ahaziri nke na-ebute ebe izizi ụzọ — mefuo nke ọ bụla tupu ịgafe na nke ọzọ 🥇
2
fill-first
Jiri oke ojiji nke ebe ọ bụla ruo n'uju tupu ịgafe n'ihu
3
weighted
Nhọrọ enweghị usoro nwere arọ dịka arọ nke ebe ọ bụla si dị
4
round-robin
Gafee ebe ndị ahụ n'usoro ugboro ugboro
5
p2c
Ịhazigharị ibu na-enweghị usoro site n'ike nhọrọ abụọ
6
least-used
Họrọ ebe nwere ibu dị ugbu a kacha nta
7
random
Nhọrọ enweghị usoro nwere ohere hà nhata (ewepụla oyiri)
8
strict-random
Nhọrọ enweghị usoro na-ewepụghị ihe ndị pụtara ugboro ugboro 🎲
9
cost-optimized
Belata $ kwa arịrịọ site n'ọnụahịa katalọgụ dị ugbu a 💸
10
headroom
Họrọ ebe nwere oke ojiji fọdụrụ kacha ukwuu
11
quota-weighted
Mafee akaụntụ ndị oke ojiji ha gwụrụ, emesịa họrọ dịka oke ojiji fọdụrụ ÷ ibu arịrịọ ndị a na-ahazi si dị — mkparịta ụka ndị dị adị ga-anọgide n'ebe e kegidere ha ⚖️
12
reset-window
Họrọ ụzọ ebe windo oke ojiji ya ga-atọgharị ngwa ngwa karịa
13
reset-aware
Hazie dịka oge ntọgharị oke ojiji si dị — windo dị mkpụmkpụ ụzọ 📊
14
context-relay
Nyefee ọnọdụ n'etiti ebe dị iche iche maka mkparịta ụka ogologo 🧠
15
context-optimized
Họrọ nke kacha dabara nha ọnọdụ dị ugbu a
16
cache-optimized
Kegide mbido prompt ọ bụla enwere ike iji ọzọ n'otu akaụntụ ahụ — mee ka ọnụọgụ prompt-cache hits kacha elu 🎯
17
lkgp
Ụzọ Ikpeazụ Amaara na Ọ Dị Mma — na-ekegide ya n'onye na-eweta ọrụ ikpeazụ gara nke ọma, emesịa jiri iwu dịka nhọrọ ndabere
18
auto
Inye akara ozugbo site n'ihe 16 n'ofe njikọ niile 🤖
19
fusion
Ziga arịrịọ n'otu oge gaa n'ìgwè ụdị AI + onye ọkaikpe na-ejikọta ha ka ha bụrụ otu azịza 🧬
20
pipeline
Jikọta nzọụkwụ n'usoro — mmepụta nke ebe ọ bụla na-abanye na nke na-esote 🔗
Igwe Auto-Combo na-enye onye ọ bụla a na-atụle akara dabere na **ihe 16** (ọnọdụ arụmọrụ, oke ojiji, ọnụ ahịa, oge nzaghachi, ndakọrịta na ọrụ, ogo, nnweta nnọkọ…) — lee [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 E wuru nkwụsi ike n'ime ya (ọkwa 3 nọọrọ onwe ha)
📖 [Igwe Auto-Combo](docs/routing/AUTO-COMBO.md) · [Ntuziaka Nkwụsi Ike](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Ihe Mere OmniRoute Ji Pụọ Iche
📊 Usoro nyocha zuru ezu & nkọwa atụmatụ nke ọ bụla megide 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Kwado OmniRoute
OmniRoute nwere ikikere MIT, a na-elekọtakwa ya n'ihu ọha. Ọ bụrụ na ọ na-azọpụta gị oge ma ọ bụ ego, lee otu ị ga-esi nyere ya aka ịnọgide na-enweghị onye na-achịkwa ya — họrọ nke dabara gị. Nkwado ego anaghị emetụta mkpa nhazi ụzọ; ọ na-azụta ọhụhụ, ọ bụghị ọkwa.
⚠️ Zipụ mkpụrụ ego ọ bụla naanị na netwọkụ egosiri — izipu ya na netwọkụ na-ezighi ezi nwere ike ime ka ego ahụ funahụ.
🐛 Ị hụrụ ntụpọ ma ọ bụ nwee nzaghachi? Mepee [Mkparịta ụka](https://github.com/diegosouzapw/OmniRoute/discussions).
Ihe ndị nrụpụta kwesịrị ịma: Ọrụ a nwere ike ịmepụta faịlụ .env lokelụ n'oge npm install/postinstall iji mee ka ọrụ dịrị onye nrụpụta mfe. A kpachapụrụ anya mee ka a ghara ịgụnye faịlụ a site na .gitignore (lee .gitignore), a gaghịkwa etinye ya na commit ma ọlị — ọ bụrụ na e tinyere ya na commit na mberede, gbanwee nzuzo ọ bụla ekpughere ma wepụ faịlụ ahụ n'akụkọ ihe mere eme. Lee docs/DEVELOPER-ENVIRONMENT.md maka nduzi gbasara ijikwa faịlụ gburugburu lokelụ na ihe nzuzo.
## 📡 Radar OmniRoute
Isi ozi gbasara ọkwa efu ka bụ **~1.62B token/ọnwa** sitere na katalọgụ akọwara n'elu, nke e wepụrụ ihe ndị megharịrị ugboro ugboro n'otu nchịkọta. Kredit ndebanye aha nwa oge nke ndị na-eweta ọrụ nwere ike ịgbakwunye nke a iche ma mee ka ọnwa mbụ ruo **~2.22B**. Radar bụ ihe mgbakwunye katalọgụ e binyere aka na ya, nke a na-ahọrọ iji ma ọ bụ ghara iji, maka ndị chọrọ ozi nnweta ụdịdị efu dị ọhụrụ n'etiti mbipụta OmniRoute; katalọgụ obodo na atụmatụ efu niile dị ugbu a ka ga-anọgide n'efu.
Ndị na-akwado ọrụ a nwere ike ịnata katalọgụ dị ugbu a na ohere ndị ọzọ sitere n'aka ndị na-eweta ọrụ. Oke ya dị iche ma na-agbanwe agbanwe bụ **ihe dịka 3B token/ọnwa ma ọ kachasị**, dabere na nnweta ndị na-eweta ọrụ. Oke ahụ abụghị nkwa: ndị na-eweta ọrụ nwere ike ịgbanwe oke ojiji, ntozu, ụdịdị, ma ọ bụ mpaghara n'oge ọ bụla.
A na-ahọrọ iji Radar n'onwe gị, ọ na-ejikwa naanị GET. Klayentị OmniRoute anaghị ebugo prompts, okporo ụzọ, nhazi ndị na-eweta ọrụ, telemetrị ojiji, ma ọ bụ ọnọdụ mpaghara nke igbochi ọkwa ka ọ ghara ịpụta ọzọ. Mụtakwuo gbasara ntozu na katalọgụ dị ugbu a na **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Ihe Ọhụrụ
> Ihe ndị kacha pụtara ìhè n'oge na-adịbeghị anya sitere na **v3.8.20 → v3.8.53**. Akụkọ ihe mere eme zuru oke dị na [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Nrụzi ụzọ `quota-weighted`** — usoro combo nke iri abụọ a na-awụfe akaụntụ ndị agwụla ike, ọ bụzie ịhọrọ n'etiti ndị fọdụrụ dabere na quota fọdụrụ ÷ ibu na-aga n'ihu, na-edebe mkparịta ụka ndị dị adị kpọrọ nkụ. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Ọnọdụ Headless** — `omniroute serve --headless` (ma ọ bụ `OMNIROUTE_HEADLESS=1`) na-arụ naanị engine proxy `/v1/*`, ebe dashboard na subsystems ndị bụ naanị dashboard gbanyụrụ. → [Ọnọdụ Headless](docs/guides/HEADLESS.md)
- **🔎 Nchọpụta model** — `/v1/models` na-achọcha site na ikike, ọnọdụ, ụdị na ederede, `POST /v1/models/query` na-eweta ndepụta mkpirikpi na-adịgide adịgide nwere otu nhụ̀ anya kwa igodo. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🔑 Njikwa nrụzi ụzọ kwa igodo** — jiri `forcedModel` kpọọ igodo API na otu model ma ọ bụ combo, ma tinye ma ọ bụ wepụ models na combos nke igodo n'ụzọ atomic (`/api/keys/{id}/access`). → [Ntụaka API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Njikwa PII dị nkenke karịa** — nhọrọ kwa ụdị, ruo ụkpụrụ nzochi omenala iri abụọ e kwadoro na ihe ọgụgụ nchọpụta kwa ụdị; nzochi n'onwe ya ka na-anọ opt-in. → [Nchedo](docs/security/GUARDRAILS.md)
- **🌍 Asụsụ 67** — dashboard, nlere anya akwụkwọ na CLI, na `npm run i18n:add-locale` na-agbakwụnye asụsụ n'ebe niile na otu iwu. → [Ntuziaka i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — inyefe ọrụ A2A na-abata n'ime na otu ndị nnọchi anya gị, nkà Conductor na Agent Card, na panel dashboard nwere mkparịta ụka olu push-to-talk Faro. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Nnabata na-adabara & nchekwa ibu ọrụ ukwuu** — arịrị chat arọ na-echere n'ahịrị kama ịza 503, na leases RPM na-agagharị n'ụzọ atomic kwa njikọ. → [Ntuziaka Ịdịgide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Nhazi ọkọlọtọ nke `/v1/models`** — otu ngọngọ jikọrọ ọnụ nke e jikọtara site na provider kwa provider (combos kpọrọ nkụ n'ụzọ mbụ), na-adịgide adịgide n'ofe isi iyi catalog ọ bụla. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🗜️ Ịkwado Compression** — nchebe inflation na-arụ ọrụ n'emepụtara, Caveman packs maka DE / FR / JA + Chinese (wényán), nzacha RTK maka Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Ọnụ ego flat-rate ziri ezi** — ndị na-enye subscription / coding-plan na-agụ **$0** na nyocha ọnụ ego; budget, quota & nrụzi ụzọ na-aga n'ihu na-eme atụmatụ. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **⚖️ Nrụzi ụzọ Quota-Share** — kesaa quota nke akaụntụ ekerịtara n'ụzọ ziri ezi n'ofe igodo e jikọtara ọnụ, na-echekwa ọrụ ka e fepụta ibe ndị na-adịghị arụ ọrụ. → [Ntuziaka Ịdịgide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Nhazi CLI/agent otu iwu** — iwu `setup-*` iri na ise e debanyere aha; `omniroute run` na-amalite CLIs asaa (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` na-akwado lekwasị iri na otu na onye nhọrọ provider+model interactive na favorites kwa ọnọdụ. → [Njikọ CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Ọnọdụ Remote** — chịkwaa OmniRoute dị anya site na tokens nwere oke (`connect` / `contexts` / `tokens`) + onye enyemaka OAuth `antigravity` maka ntinye VPS. → [Ọnọdụ Remote](docs/guides/REMOTE-MODE.md)
- **🧭 Auto-routing nwere amamihe karịa** — combos `auto/:`, **Fusion** (panel model + onye ikpe), nrụzi ụzọ maara ọrụ, nhọrọ-ọzọ model / ọnọdụ / USD-budget kwa arịrị. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Compression nwere ike itinye n'ụzọ** — engines iri na abụọ nwere ike ijikọ ọnụ + Compression Studios: LLMLingua-2, Ultra ogo abụọ, omniglyph, ọnụ ụzọ fidelity kwa nzọụkwụ, GCF v3.2, onye nchịkọta dọọ-ma-hazie-ọzọ. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Nkwụsị nzuzo MITM doro anya (TPROXY)** — jide CLIs ndị na-eleghị proxy env vars anya, na CA kwa SNI + onye ntinye trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Telemetry ọnụ ego n'ebe niile** — headers `X-OmniRoute-*` ọnụ ego/ojiji na endpoint ọ bụla, header nchekwa cache-HIT, quotas mmefu USD kwa igodo. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🧠 Echeta nke ị chịkwara** — gbanyụrụ n'emepụtara, opt-in int8 vector quantization + ịda ike nwere ụdị, `x-omniroute-no-memory` kwa arịrị. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Nchekwa** — nchebe prompt-injection na ụzọ LLM ọ bụla (usoro red-team), guardrail nzochi nzuzo opt-in (na-ehichapụ igodo API/nzuzo ndị gbatara n'ụzọ abụọ ahụ), nchọpụta weebụ DuckDuckGo n'efu dị ka nhọrọ ikpeazụ, na ọnụ ụzọ nbanye OIDC nhọrọ maka dashboard (nbanye paswọdụ na-anọgide na-adị mgbe niile). → [Nchedo](docs/security/GUARDRAILS.md)
- **🖼️ Endpoints ọhụrụ** — `/v1/ocr` (Mistral OCR) na `/v1/audio/translations` (ụdị Whisper) na-ezube oke mídía. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🎨 Mmepụta ihe onyonyo / vidiyo / ọdịyo** — otu API maka mídía: vidiyo xAI Grok Imagine & Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, na ndị na-enye okwu dị ka ElevenLabs. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🌍 Ntinye & ọrụ** — `basePath` nke reverse-proxy, nchọpụta akpaaka asụsụ ihe nchọgharị, nsochi ngwaọrụ kwa igodo, ntụkwasị MITM na-enweghị root, ịchịkọta mpaghara zh-TW. → [Gburugburu](docs/reference/ENVIRONMENT.md)
- **🤝 Ndị na-enye & ndị nnọchi anya ndị ọzọ** — ndị nnọchi anya igwe ojii (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) na ihe nchọgharị + nbanye OAuth, kaadị Ollama nke mbụ, Claude Opus 5 & Sonnet 5, mmekorita ọchịchị Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… na catalog ndị na-enye **375** emelitere ọhụrụ. → [Ndị na-enye](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Nhụ̀ anya nke nrụzi ụzọ** — nzaghachi ọ bụla na-ebu header `X-OmniRoute-Decision` na-akpọ aha usoro/provider/latency nke zara ya, usoro combo `cache-optimized` ọhụrụ + factor Auto-Combo `cacheAffinity` na-ezigharị arịrị ndị na-emegharị azụ na njikọ jide prefix e cache-riri, na endpoint naanị-agụ `/v1/auto-combo/{channel}/candidates` na-ekpughe igwe ndị ga-ahọrọ ndụ nke ọwa `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Arụmọrụ & ihe owuwu mpaghara** — Redis mpaghara nke otu ịpị, ndị na-ebupụ relay Cloudflare Workers / Deno Deploy, Bifrost & Mux dị ka ọrụ etinyere n'ime nke a na-ahụ maka. → [Ọrụ etinyere n'ime](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Ọzọkwa n'ime igbe** — framework plugin + ahịa, framework nkà Omni/Agent/GitHub, njikọ Obsidian vault (ihe ngwá ọrụ MCP 22), Batch & Files APIs kwekọrọ na OpenAI, cache nzaghachi semantic, gamification nwere leaderboards, ịchọpụta agent ACP (agent 15 arụnyere n'ime), mbupụ log a haziri oge gaa BigQuery, `auto/chaos` fan-out ọtụtụ ihe nlereanya parallel, àjà Telegram bot, onye njikwa ụdịdị n'ime ngwa na ọkwa ndị na-enye n'efu nke LMArena-ELO. → [Akwụkwọ](docs/README.md)
## 🤖 CLI na Ndị Ọrụ Nkọwa Koodu Dakọtara
> Otu nhazi — `http://localhost:20128/v1` — ma **IDE ma ọ bụ CLI AI ọ bụla** na-arụ ọrụ na ụdịdị efu na ndị dị ọnụ ala.
＋ ọ na-arụkwa ọrụ na · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ngwaọrụ ọ bụla dakọtara na OpenAI
📖 Nhazi pụrụ iche maka ngwaọrụ ọ bụla n’ime ngwaọrụ 37 niile (CLI Code 27 + CLI Agents 10) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Ngwa mgbakwunye OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Jiri otu iwu malite CLI ọ bụla akwadoro site na OmniRoute** — a naghị ede faịlụ nhazi ọ bụla,
a na-etinye nzere maka usoro ọ bụla, Qwen/Gemini na-enweta ebe obibi dịpụrụ adịpụ nke a ga-atụfu:
```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"
# Ma ọ bụ họrọ onye na-eweta ọrụ+ụdịdị n'ụzọ mmekọrịta ma dee nhazi nke ngwaọrụ ahụ:
omniroute configure codex # gụnyekwara: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Iwu ọ bụla na-agbaso ọnọdụ njikọ ime-anya na-arụ ọrụ (`omniroute connect `), `--dry-run`
na-egosi env/args kpọmkwem tupu emezuo ha, ebe `--api-key-env NAME` na-eme ka ihe nzuzo ghara
ịbanye n’akụkọ ihe mere eme shell gị. → [Njikọ CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 Ndị Na-enye AI 375 — 153 E Kpụrụ n'Catalog Dị ka Nke Efu
> **Ndị na-enye ọrụ 375 edebanyere aha** gafee ngwa chat, media, search, local, cloud-agent na system mbụ, gụnyere **153 na-ebu `hasFree: true` metadata nchọpụta**. Ndekọ model chat kpuchiri **ndị na-enye ọrụ 239 / nnukwu ụzọ abụọ provider-model dị iche iche 3,059 / ID model mbụ 1,475**; catalog mmefu efu dị iche nwere **ahịrị per-model 467**, **pools na-eme ugboro ugboro 34** na **ndị na-enye ọrụ efu ruo mgbe ebighị ebi na-enweghị igodo/na-eme ugboro ugboro 51**. Ndị a bụ denominators dị iche iche n'ihi atụmatụ; nkọwa na ngbako pool e wepụtara ihe oyiri ya nọ na [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) na [Free Tiers](docs/reference/FREE_TIERS.md).
### 🏢 Lab isi ọ bụla — site na otu endpoint
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…na ndị ọzọ karịrị 350 — icon ọ bụla na-akpebi ndụ site na catalog provider nke dashboard. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Efu Ruo Mgbe Ebighị Ebi — $0, enweghị kaadị
OpenCode Zen DeepSeek V4, Nemotron 3 Enweghị oke token
Kilo Code Auto-router, Tencent Hy3 N'efu mgbe ebighị ebi
Requesty GPT-OSS 120B, Nemotron N'efu mgbe ebighị ebi
SiliconFlow DeepSeek V3.2 / R1 Ọkwa n'efu
Z.AI GLM GLM-4.7 / 4.5-Flash N'efu mgbe ebighị ebi
Baidu ERNIE ERNIE 4.0 N'efu mgbe ebighị ebi
Qoder AI Qwen3-Max, Kimi-K2 N'EFU ENWEGHỊ OKE
Pollinations GPT, Llama, Claude Achọghị igodo
Cloudflare AI Ụdị 50+ neurons 10K kwa ụbọchị
NVIDIA NIM GLM, MiniMax ~40 RPM n'efu
Cerebras GLM 4.7, GPT-OSS Kredit $5 otu ugboro; achọrọ kaadị
OpenRouter Ụdị :free +$10 → RPM ka elu
📖 Ndepụta zuru oke nke igwe nwere ike ịgụ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Ebe OmniRoute Na-arụ Ọrụ — Ebe Ọ Bụla
> Otu ngwa ahụ, igwe gị, iwu gị. Site na nrụnye npm zuru ụwa ọnụ ruo na **ekwentị gị** site na Termux.
Ikpo okwu
Nrụnye
Ihe ndị pụtara ìhè
📦 npm (zuru ụwa ọnụ)
npm install -g omniroute
Otu iwu, OS ọ bụla
🐳 Docker
docker run … diegosouzapw/omniroute
Ọtụtụ ụkpụrụ nhazi AMD64 + ARM64
🖥️ Desktọpụ (Electron)
npm run electron:build
Windo nke sistemụ + tray sistemụ — Windows / macOS / Linux
🎩 Ogwe-menu (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Na-elekọta & na-emelite sava na-akpaghị aka — macOS
💪 ARM
arm64 nke sistemụ
Raspberry Pi, sava ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Na-arụ ọrụ na ekwentị gị, 24/7, na-enweghị root
📲 PWA
"Tinye na Ihuenyo Mbụ"
Ihuenyo zuru ezu, na-enweghị ịntanetị, enwere ike ịwụnye ya site na ihe nchọgharị
🧩 Ngwa mgbakwunye OpenCode
@omniroute/opencode-provider
Njikọ OpenCode nke sistemụ
🤖 VS Code Copilot Chat
wụnye ndọtị OmniCopilot
Ụdị OmniRoute niile n'ime nhọrọ Copilot Chat nke sistemụ — stable & Insiders
Site n'ime editọ: mepee nlele **Extensions**, chọọ **"OmniRoute"**, pịa **Wụnye**
— ọ na-arụ ọrụ n'otu ụzọ ahụ n'ụlọ ahịa abụọ ahụ. Koodu mmalite, nsogbu na akwụkwọ usoro mbipụta dị na
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Nduzi VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — nhazi, ihe nhọrọ ahụ na-egosi, dashboard n'ime taabụ, idozi nsogbu
### 🎩 Ihe ọhụrụ: OmniRouteTray — ụzọ mbata gị, nke bi n'ogwe-menu
> `omniroute serve` na-arụ ọrụ kacha mma mgbe ọ na-adị mgbe niile. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> na-eme ka nke ahụ bụrụ ngwa ogwe-menu macOS ị ga-ahazi otu ugboro ma chefuo ya: ọ na-amalite sava, na-eme ka ọ nọgide na-arụ ọrụ
> mgbe e mechara reboot, na-emelite ya n'ebe ahụ, ma na-eme ka mmefu token gị ugbu a dị naanị otu pịa nso — **enweghị
> windo terminal a hapụrụ ka o ghe oghe, enweghị `npm install -g omniroute` a ga na-elekọta.**
E ji [Tauri v2](https://v2.tauri.app/) wuo ya (isi Rust pere mpe nke ukwuu), ọ na-abịa
na runtime Node 24 nke ya e binyere aka ma na-ejikwa nrụnye OmniRoute nke ngwa ahụ nwe, ya mere ọ naghị emegide
`node`/`bun` zuru ụwa ọnụ gị. Ọ **na-ekekọrịta nhazi na nchekwa data `~/.omniroute/` gị dị ugbu a** — ya mere ọ bụ
otu OmniRoute ahụ ị na-agba ugbu a, naanị na o yi okpu. 🎩
Ihe ọ na-eme
Otu o si eme ya
🟢 Na-elekọta sava
Na-amalite omniroute serve, ma na-anabata instance na-arụ ọrụ ugbu a kama ịmepụta nke ọzọ
📊 Ojiji dị ugbu a n'otu nlele
Ogwe oke ndị na-eweta ọrụ, oke session Claude/izu na ngụda oge nrụgharị, nkọwa mmefu ụbọchị 30
🔄 Na-emelite onwe ya n'ebe ahụ
Nrụnye nke e kwadebere n'usoro, mgbanwe atomic, ịlaghachi azụ ma ọ daa — na-adị mgbe niile na mbipụta kachasị ọhụrụ
🚀 Malite mgbe a banyere
Nhọrọ ịmalite mgbe a banyere; naanị tray, enweghị akara ngosi dock
🩺 Nnyocha & ndekọ
Nnyocha nsogbu na ịnweta ndekọ sava site n'otu pịa
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Ị chọrọ nbudata? Nweta .dmg kachasị ọhụrụ site na
Mwepụta. Koodu mmalite, nsogbu na akwụkwọ
ntuziaka owuwu dị na zoispag/omniroute-tray.
💛 Ọrụ obodo nke @zoispag mepụtara — ọ bụghị mwepụta OmniRoute gọọmentị.
> E wezụga sava ahụ, OmniRoute bụ **ebe njikwa ahịrị iwu zuru ezu** nwere **iwu 80+**, tinyere protocol ndị nnọchi anya mepere emepe ka onye nnọchi anya AI nwee ike ijikwa ya **n'onwe ya**.
### ⌨️ Ezigbo CLI (ọ bụghị naanị `start`)
```bash
omniroute # nye gateway + dashboard ọrụ (ọdụ ụgbọ mmiri 20128)
omniroute chat # onye ahịa nkata TUI mmekọrịta (slash: /model /combo /skill /memory)
omniroute setup # ọkachamara nduzi maka ojiji mbụ
omniroute doctor # chọpụta nsogbu ndị na-eweta ọrụ, ọdụ ụgbọ mmiri, na ndabere native
```
### 🛰️ Ọnọdụ remote — gbaa CLI ebe a, OmniRoute na VPS
OmniRoute ọ dị na sava? Jiri **otu CLI ahụ** si na laptọọpụ gị jikwaa ya. Banye otu ugboro
site na token nnweta nwere oke; iwu ọ bụla ga-emesịa lekwasị anya na remote ahụ.
```bash
omniroute connect 192.168.0.15 # okwuntughe → token nwere oke, echekwara dị ka context
omniroute models # ← na-arụ ọrụ megide sava REMOTE
omniroute configure codex # ← na-ahọrọ model remote, dee profaịlụ Codex n'ime ngwaọrụ gị
omniroute tokens create --name ci --scope read # mepụta token nwere oke pere mpe maka igwe ndị ọzọ
omniroute contexts use default # ← laghachi na sava dị n'ime ngwaọrụ gị
```
Token nwere oke `read` / `write` / `admin`; route ndị na-amalite process na-anọgide naanị na loopback.
📖 [Ọnọdụ Remote](docs/guides/REMOTE-MODE.md)
### 🤝 Jikọọ onye nnọchi anya — ọ ga-ejikwa OmniRoute n'onwe ya
Kpughee OmniRoute site na **MCP**, **A2A**, **REST API**, **webhooks** ma ọ bụ **CLI remote** — onye nnọchi anya ọ bụla nwere ikike (ma ọ bụ code nke gị) ga-enweta igodo gateway ahụ dum: nhazi route, ndị na-eweta ọrụ, combo, cache, compression, memory — n'onwe ya. A na-enye endpoint HTTP ndị dị n'okpuru site na `http://localhost:20128`.
Interface
Endpoint / iwu
Ihe eji ya eme
🧰 MCP (stdio)
omniroute --mcp
Jikọọ ya na Claude Desktop, Cursor, ma ọ bụ onye ahịa MCP ọ bụla
🌊 MCP (HTTP)
/api/mcp/stream
MCP remote — ngwaọrụ 110, oke 33 (ịmanye ha bụ nhọrọ), ndekọ audit zuru ezu
📡 MCP (SSE)
/api/mcp/sse
Ụzọ mbufe MCP na-aga n'ihu
🤝 A2A
/.well-known/agent.json
Site n'aka onye nnọchi anya gaa na onye nnọchi anya, JSON-RPC 2.0 + SSE, nkà 6
🌐 REST API
/v1/*
Dakọtara na OpenAI — nkata, embeddings, onyonyo, ọdịyo, OCR
🔔 Webhooks
/api/webhooks
Ziga request / quota event na Slack, Discord, Telegram ma ọ bụ URL ọ bụla
🛰️ CLI Remote
omniroute connect
Jiri token nnweta nwere oke jikwaa instance remote
```bash
# Nye Claude Code ngwa ọrụ OmniRoute niile site na MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [Sava MCP](docs/frameworks/MCP-SERVER.md) · [Sava A2A](docs/frameworks/A2A-SERVER.md) · [Protocol Ndị Nnọchi Anya](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Chekwaa 15–95% Token — Na-akpaghị aka
### 📖 Ka o si arụ ọrụ — pipeline, ihe owuwu & mgbakọ nke nchekwa
Combo stacked ndabere na-agba `RTK → Caveman`. Mgbe ha abụọ na-arụ ọrụ na otu payload ngwá ọrụ/ọnọdụ, nchekwa na-ejikọta:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
A **na-echekwaba mgbe niile** code blocks, URLs, JSON na data usoro site n'aka engine nchekwa.
> **Gịnị mere a ga-eji token ọtụtụ mgbe ole na ole na-emecha?** Arịrị ọ bụla na-agafe compression pipeline nke OmniRoute **n'ụzọ doro anya** — enweghị mgbanwe onye ahịa. Ugbu a ọ bụ **stack nke engine 12 nwere ike ijikọta** nke na-agba ọsọ n'usoro ma jikọta & họrọ kwa combo routing — na-ewulite echiche si na [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), na [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Stack nke engine 12
Engine na-agba ọsọ n'usoro pipeline; nke ọ bụla nwere ike ịgbanye ma hazie n'otu n'otu kwa combo:
#
Engine
Ihe ọ na-eme
1
Session-Dedup
Na-ewepụ ọdịnaya a na-emegharị n'ofe turns (e dere n'adreesị ọdịnaya, n'ofe turns)
2
CCR
Na-echekwa nnukwu blocks n'azụ akara retrieve, a na-akpọta ha mgbe a chọrọ
3
Lite
Iwechapụ whitespace + image-URL (ntọala dị mfe na latency)
4
RTK
Nzacha tool-result nwere amamihe, dedup & ịbelata (maara iwu)
5
Responses Tool Output
JSON lossless-mbụ + mkpakọ diagnostic nwere oke maka outputs shell/patch/search/build (Responses API)
6
Headroom
Mkpakọ tabular lossless nke JSON arrays (~30%) site na codec GCF e tinyere n'ime
7
Relevance
Ịgọpụta ụdaokwe na-enye ha akara dabere na ajụjụ ikpeazụ nke onye ọrụ
8
Caveman
Mkpakọ prose dabere na iwu (~65–75% na output)
9
Aggressive
Nchịkọta + ịka ochie n'ụsọ nke turns ochie
10
LLMLingua-2
Iweghachị semantic ML site na MobileBERT ONNX — dị mma maka code, async
11
Ultra
Iweghachị token heuristic nwere òkè small-model (SLM) nhọrọ
12
OmniGlyph
Koodu nnwale context-dịka-onyonyo maka Claude Fable 5 a tụrụ na wire Anthropic kpọmkwem; transformers GPT 5.6 ka dị fail-closed na-echere nnata provider. Profaịlụ mkpakọ anọ (aggressive ndabere, balanced, coding-safe, passthrough) (kacha aggressive; opt-in)
A **na-echekwa mgbe niile** code blocks, URLs na data usoro n'ụzọ zuru ezu byte-site-byte. **Presets otu-pịa** na-ejikọta engine ndị ahụ:
Ọnọdụ
Nchekwa
Kacha mma maka
🪶 Lite
~15%
Ndabere dị mma na-arụ ọrụ mgbe niile
🪨 Standard (Caveman)
~30%
Ịdee koodu kwa ụbọchị
⚡ Aggressive
~50%
Oge ọrụ ogologo jupụtara na ngwá ọrụ
🔥 Ultra
~75%
Nchekwa kacha elu
🧰 RTK
60–90%
Output shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Prompts agwakọtara + ndekọ ngwá ọrụ
**Ihe nlereanya n'ezie — ọnọdụ Standard:**
> **Tupu (69 tokens):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_
>
> **Mgbe e mesịrị (19 tokens):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_
>
> **Otu azịza. Token dị 72% nkenye. Enweghị mfu nke izizi.** ✅
**Ihe nlereanya PT-BR — ọnọdụ [Troglodita](https://github.com/leninejunior/troglodita):**
> **Tupu (42 tokens):** _"Nsogbu ahụ bụ na component na-eme re-render n'ihi na a na-eke object reference ọhụrụ n'ọgụgụ rendering ọ bụla. Aga m atụ aro ka ị jiri useMemo."_
>
> **Mgbe e mesịrị (12 tokens):** _"Re-render: ref ọhụrụ kwa gburugburu (inline object e kere ọzọ). Jiri `useMemo`."_
>
> **Azịza otu ahụ. ~70% token e belatara. Kpọmkwem teknụzụ ka n'ọnọdụ zuru ezu.** ✅
### 🎚️ Gafere engines — output styles, adaptive dial & njikwa kwa arịrịọ
Engines 12 dị n'elu na-ebelata ihe na-abanye **n'ime**. Ọwa atọ ọzọ na-akpụ **otú**, **mgbe**, na ihe na-apụta **n'èzí**:
- **🪄 Output Styles** _(ntụzi output-axis)_ — tinye ntụziaka na-akpụpụta azịza nke a pụrụ ịtụ anya ya, nke dị mma maka cache; enwere ike ijikọta ha, nke ọ bụla n'ókè `lite` / `full` / `ultra`. Itinye style bụ otu ahịrị entry na registry:
- **Prose dị nkenke** — wepụ okwu mmejuputa / articles / okwu nzuzuhi; debe ihe dị mkpa teknụzụ kpọmkwem.
- **Koodu dị nta** — "lazy senior dev" YAGNI: mgbanwe kacha nta nke na-arụ ọrụ, enweghị scaffolding a chọghị.
- **Ponytail (lazy senior dev)** — rịgo YAGNI ladder, mezie ihe bụ isi nsogbu, diff kacha nta nke na-arụ ọrụ.
- **Enwere m ADHD (omume-bu-izizi)** — omume ọzọ na-edu, a na-agụ nzọụkwụ ọnụ, otu nzọụkwụ ziri ezi ọzọ, enweghị okwu mmalite.
- **CJK dị nkenke (文言)** — ụdị Chinese ochie dị nkenke karịa (e gachiri ya na locale `zh`).
- **🎯 Adaptive context-budget** _(dial ahụ)_ — kama otu on/off token threshold, welie engines dị ọnụ ala, nke na-efunahụ opekata mpe, naanị ruo ebe ọ zuru iji **soro n'ime context window nke model**. Policy: `reserve-output` (ndabara, nke maara model) · `percentage` · `absolute`. Mode: `floor` (na-ekwe nkwa na ọ dabara) · `replace-autotrigger` (nhọrọ gị pụtara ìhè na-emeri) · `off` (threshold ochie).
- **🎛️ Ebe a na-ekpebi compression** _(usoro mkpa, elu → ala)_ — header `x-omniroute-compression` kwa arịrịọ › override routing-combo › profile aha nke na-arụ ọrụ › adaptive / auto-trigger › panel ndabara › off. Atụmatụ e jiri rụọ ọrụ na-ada azụ n'ime header azịza `X-OmniRoute-Compression: ; source=`.
Jiri token threshold kpaghara auto-trigger, tụgharịa adaptive dial, kpịnye profile e dere aha, debe otu maka otu arịrịọ, ma ọ bụ kenyere pipeline kwa routing combo — nke ọ bụla dabara na ọrụ ahụ. Opt-in offline **eval harness** (`npm run eval:compression`) na-asịnye ọnụọgụ fidelity megide nchekwa n'elu corpus e kpịnyere tupu ị kwalite mgbanwe.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Malite Ngwa Ngwa
**1) Wụnye & malite**
```bash
npm install -g omniroute
omniroute
```
> 💡 Ị na-ahụ `npm warn ERESOLVE` ma ọ bụ peer-dep ịdọ aka ná ntị? [Ha adịghị egwu](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Ị na-eji npm 11 ma ọ bụ nke ka elu?** npm nwere ike igbochi package lifecycle scripts belụsọ na e kwenyere ha. `postinstall` nke OmniRoute (`node scripts/build/postinstall.mjs`) dị mkpa iji kwadebe native runtime files ya. Kwenye packages npm kpọrọ aha n'ịdọ aka ná ntị ya mgbe ị na-etinye n'ụwa niile. Maka otu packages OmniRoute 3.8.53 kọrọ:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Iji jiri allowlist a ọzọ maka ịwụnye zuru ụwa n'ọdịnihu, hazie ya otu ugboro, wee wụnye dị ka ọ dị na nkịtị:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Ndepụta dependencies nwere ike ịgbanwe n'etiti releases; ọ bụrụ na npm kọọ ndepụta dị iche, jiri aha packages sitere n'ịdọ aka ná ntị ahụ. Ikwenye package na-ekwe ka scripts ịwụnye ya rụọ ọrụ.
> **Ị na-eji Gemini Web ma ọ bụ provider web-cookie ọzọ?** Package npm gụnyere Playwright ma ọ naghị gụnye Chromium binary ya. Lee ndetu [ntọlite Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) tupu ị mee arịrịọ web-provider mbụ.
Dashboard na `http://localhost:20128` · API na `http://localhost:20128/v1`.
**2) Jikọọ provider tozuru oke site na akaụntụ gị n'onwe gị**
Dashboard → **Providers** → họrọ provider nke usoro na quota ya ugbu a dabara na ihe ị chọrọ iji ya rụọ → tinye API key ya ma ọ bụ mezue usoro akaụntụ ya. Free tiers nwere ike ịchọ ịdebanye aha, nkwenye, ma ọ bụ ụzọ ịkwụ ụgwọ. Gụọ [Ntuziaka Free Tiers](docs/getting-started/FREE-TIERS-GUIDE.md); a naghị ekwe nkwa ịnata ya na-enweghị key, a na-ewepụkwa providers e tinyere akara `tos: avoid` na `auto` ndabara.
**3) Zị ngwá ọrụ koodu gị ebe a**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) Lelee na ọ na-arụ ọrụ**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Ị kwesịrị ịhụ models ị jikọtara edepụtara. 🎉 Nke ahụ ka ọ bụ — malite ide koodu, OmniRoute ga-akpaghị aka họrọ ụzọ ma jiri fallback rụọ ọrụ maka gị.
Ọ bụrụ na client gị apụghị iziga custom headers, OmniRoute na-emeghekwa 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
```
Jiri ndị a naanị maka clients na-apụghị itinye `Authorization: Bearer ...`. Header auth ka bụ ụdị a họọrọ.
## 📦 Ụzọ nrụnye ndị ọzọ — Docker, source, 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` na-agbaso SemVer kwụsiri ike kachasị elu nke **ebipụtara**. Ọ naghị eso git `main`. Tinye `:X.Y.Z` kpọmkwem maka GitOps. Lee [Ọwa Mwepụta Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Image ahụ na-etinye **`OMNIROUTE_MEMORY_MB=1024`** kpọmkwem. Nke ahụ zuru maka dashboard na mkparịta ụka dị mfe. **Ndị nnọchi anya coding** (`POST /v1/responses` sitere na Claude Code, Codex, Grok, …) chọrọ V8 heap buru ibu karịa nke ahụ, ma ọ bụghị ya process ahụ ga-eme `FATAL ERROR` mgbe ọ ruru ihe dị ka 12 GiB n'okpuru long contexts abụọ na-adakọrịta. Hazie container ka ọ karị heap ahụ (native buffers na-anọ n'èzí V8):
| Ọrụ | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) |
| -------------------------------------- | ------------------------------- | ---------------------- |
| Dashboard / mkparịta ụka dị mfe | `1024` (ndabara image) | ≥2 g |
| Otu onye nnọchi anya coding | `8192` | ≥10 g |
| `/v1/responses` ogologo abụọ n'otu oge | `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
```
Tebụl zuru ezu: [Nduzi Docker — RAM oge ọrụ](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Ọwa Docker tupu mwepụta:** `diegosouzapw/omniroute:next` na
> `diegosouzapw/omniroute:next-web` na-agbaso branch `release/v*` nke ndabara ugbu a.
> Ebum n'uche tags ndị a na-agbanwe agbanwe bụ naanị maka ịnwale ndozi ndị a na-ewepụtabeghị,
> a **kwadoghịkwa ha maka production**. Lee
> [Ọwa Mwepụta Docker](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
A na-akwado `bun install` nkịtị na nrụnye global (`bun install -g omniroute`) site na nchọpụta Bun runtime:
- **`bun:sqlite` e wuru n'ime ya**: OmniRoute na-eji driver `bun:sqlite` e wuru n'ime Bun mgbe ọ na-arụ ọrụ n'okpuru Bun, ma na-alaghachi na `better-sqlite3` na Node.js ma ọ bụ `sql.js`.
- **Nhọrọ Webpack bundler akpaka na dev**: Development (`bun run dev`) na-achọpụta Bun na akpaka ma gbanyụọ Turbopack iji Webpack dochie ya ka e gbochie enweghị ndakọrịta nke native V8 bindings. Production builds (`bun run build`) na-agbaso `OMNIROUTE_USE_TURBOPACK` kpọmkwem dịka ọ dị na Node: Turbopack na ndabara, `OMNIROUTE_USE_TURBOPACK=0` iji Webpack wuo ya (`Dockerfile.bun` na-eme ka ọ dị dịka `--build-arg`).
- **Dockerfile pụrụ iche maka Bun**: `Dockerfile.bun` nwere ọtụtụ stages maka native Bun production deployments (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Jiri Bun wụnye ma mee ya
bun install
bun run dev
```
**🛠️ Site na source**
```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
# Iji Nix flakes
nix develop
npm run dev
# Ma ọ bụ jiri devbox
devbox run npm run dev
```
📖 [Nduzi Docker](docs/guides/DOCKER_GUIDE.md) — Compose profiles, Caddy HTTPS, Cloudflare tunnels.
**🦭 Podman**
```bash
# 1. Kwadebe data directory e ji bind mount
mkdir -p data
# 2. Naanị Linux + Podman rootless nke mpaghara (ejila remote Podman Machine client ma ọlị):
podman unshare chown 1000:1000 ./data
# 3. Tọọ runtime hint, wuo Compose image nke mpaghara, wee malite
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
Na macOS ma ọ bụ Windows, Podman na-eji remote Podman Machine: mafere `podman unshare` ma
soro [ntuziaka data directory dabere na topology](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Nduzi Podman](contrib/podman/README.md) — Compose builds, Podman Machine, na
nhazi Linux/systemd Quadlet.
**⚡ Nrụnye dị ọsọ karịa / dị mfe karịa (mafere native build)**
Native SQLite engine (`better-sqlite3`) bụ dependency **nhọrọ**, ya mere nrụnye global
anaghị akwụsị mgbe a na-compile site na source: ọ na-eji prebuilt binary mgbe nke dabara na
platform/Node gị dị, ma ọ bụghị ya, ọ na-alaghachi n'ụzọ doro anya na pure-JS engine
(`node:sqlite` na Node 22+, ma ọ bụghị ya bundled `sql.js` WASM) — achọghị build tools.
Iji mafere native warm-up mgbe nrụnye gasịrị kpamkpam (CI, headless, ma ọ bụ igwe ndị na-adịghị ọsọ):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 na-emekwa ka a mafere ya
```
Maka nrụnye kachasị ọsọ, họrọ **pnpm** (content-addressed store + hard links — lee n'elu).
Maka runtime headless na-enweghị dashboard, jiri Docker `base` profile (n'elu) ma ọ bụ
[Nduzi Termux](docs/guides/TERMUX_GUIDE.md). Otu process ahụ na-enye CLI na web dashboard
site n'otu port, ya mere enweghị package pụrụ iche nke bụ naanị CLI ugbu a.
Atụmatụ mkpuchi ule maka mkpọpụta ule kwụsie ike 56,000+ gafee faịlụ ule 7,800+ a na-eso
# ⭐ Ndị Ntinye Aka Kacha Elu
> Obodo open-source nwere mmuọ na-ekpụ OmniRoute. Ndị mmadụ ndị a emeela onyinye pụrụ iche nke metụtara ọzụzụ, kwụsie ike, na iru oke nke ọrụ ahụ ozugbo. **Daalụ.**
### Ndị na-enye aka si mpụga site na pull requests ejikọtara
E mere ịgụ ọnụ ahụ 2026-10-18 15:09:09 UTC site na tip release/v3.8.52 dị ndụ 656f01cb43. Ịgụ ọnụ GitHub GraphQL paginated ahụ nwere PRs 9,191 ejikọtara: 3,834 site n'aka onye nwe repository, 229 site n'aka Dependabot, 6 site n'aka bots/apps ndị ọzọ, na PRs mpụga 5,122 sitere na ndị na-enye aka 835 dị iche iche. "Ahịrị agbanwela" bụ GitHub additions + deletions ma gụnyere faịlụ emepụtara, lockfiles, catalogs, ntụgharị na akwụkwọ; ọ bụ churn, ọ bụghị LOC edere. PRs 49 na-akọwa GitHub diffs karịa ahịrị 500,000 (dịka #13399, otu mgbakwunye provider, na-edepụta faịlụ 2,347 agbanwela), nke na-abawanye ọnụ ọgụgụ ụfọdụ n'elu. A na-enye ndị hátara ọnụ ọkwa ọnụ.
### Commits GitHub nyere aha
Enyochagharịrị ya na 2026-10-18 14:44:45 UTC: commit ndị GitHub jikọrọ nke repository Contributors API kọrọ maka alaka ndabara release/v3.8.52. API ahụ wepụtara njirimara 849 (ndị ọrụ 429, bots 2, ndị amaghị aha 418); tebulu a wepụrụ onye nlekọta, bots na njirimara ndị amaghị aha, ma na-edebe ndị so n'otu ọkwa n'asọmpi. Ọ dị iche na ọkwa merged-PR dị n'elu na ọnụ ọgụgụ Git-metadata dị n'okpuru.
> 🙏 Atụmatụ, ndozi njehie, na mmelite ihe owuwu nke ndị ntinye aka a bụ **akụkụ bụ isi** nke ihe na-eme ka OmniRoute dị ntụkwasị obi ma jupụta na atụmatụ. Pull request ọ bụla, ule ọ bụla, na faịlụ ntụgharị i18n ọ bụla dị mkpa. Ndị mmadụ dị ka ha ka e ji arụ open source.
---
## 💖 Ndị Nkwado
Ekele sitere n’obi nye ndị ji ego si n’akpa ha akwado OmniRoute — onyinye ọ bụla na-eme ka ọrụ a nọgide bụrụ n’efu, nwee nnwere onwe ma na-aga n’ihu.
Pixma 💛 Onye nyere nkwado otu ugboro n’oge gara aga
Paco Cartones 💛 Onye nyere nkwado otu ugboro n’oge gara aga
longtao 💛 Onye nyere nkwado otu ugboro n’oge gara aga
… na ndị ọzọ họọrọ ka a ghara ikpughe aha ha 💛E nyochaghachiri ndị nkwado GitHub ọha na 2026-10-18 site na GitHub Sponsors GraphQL API: nkwado ọha 11 (6 ka na-arụ ọrụ, 5 bụ nke gara aga) n’ime 14 n’ozuzu. Ọnọdụ isActive nke GitHub na-ekpebi akara ndị ka na-arụ ọrụ dị n’elu; a ka na-ekele ndị nkwado ọha nyere onyinye otu ugboro n’oge gara aga, ebe ndị nkwado nzuzo ka na-anọgide n’amaghị aha. E depụtaghị onyinye sitere na Ko-fi, Buy Me a Coffee, Liberapay, PIX na crypto n’ihi na ha enweghị ndekọ onye nkwado ọha.💖 Bụrụ onye nkwado → — dollar ọ bụla na-eme ka OmniRoute nọgide bụrụ n’efu ma nwee nnwere onwe.
## 👥 Ndị nyere Aka 900+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
E nyochara ya na 2026-10-18 n'ọnụ ọnụ release/v3.8.52 dị ndụ, ya bụ ad160ab2d1 (commit 6,826): njirimara mmadụ 993 ahaziri nke ọma na Git — 707 pụtara dị ka ndị dere commit (gụnyere onye na-elekọta ọrụ ahụ), ebe 286 pụtara naanị na trailers Co-authored-by akọwapụtara nke ọma. Ngụkọta a na-etinye .mailmap n'ọrụ, na-atụnyere adreesị e-mail n'agbanyeghị mkpụrụedemede ukwu ma ọ bụ nta, na-ejikọta adreesị GitHub noreply nwere nọmba na nke nkịtị naanị mgbe ha na-egosi otu handle ahụ, na-ewepụ njirimara bot/agent/service/placeholder 26, ọ naghịkwa ejikọta adreesị e-mail nkịtị naanị n'ihi na aha ngosi ha bụ otu. Nnyocha nke 2026-08-24 bipụtara 639; mgbe e jiri usoro a mee ya ọzọ n'elu ntọala nnyocha ahụ, ac02c5b42f, ọ nyere 619, ya mere mmụba ahụ sitere n'aka ndị nyere aka ọhụrụ, ọ bụghị n'ihi usoro e mere ka ọ dị mfe karị.
### Otu E Si Nye Aka
1. Mee fork nke repository ahụ
2. Mepụta branch site n'ọnụ ọnụ `release/vX.Y.Z` **na-arụ ọrụ** (ọ bụghị `main`) — lee [Usoro Branch na Release](docs/ops/BRANCHING_MODEL.md)
3. Mepụta feature branch gị (`git checkout -b feat/amazing-feature`)
4. Mee commit nke mgbanwe gị (`git commit -m 'feat: add amazing feature'`)
5. Push gaa na branch ahụ (`git push origin feat/amazing-feature`)
6. Mepee Pull Request nke nwere **base = branch `release/vX.Y.Z` ahụ**
Lee [CONTRIBUTING.md](CONTRIBUTING.md) maka ntuziaka zuru ezu.
### Ịwepụta Version Ọhụrụ
```bash
# Mepụta release — npm publish ga-eme na-akpaghị aka
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Kpakpando
## 🌍 StarMapper
## 🙏 Ekele
OmniRoute guzo n’ubu ndị dike. Ọ malitere dịka fork nke **[9router](https://github.com/decolua/9router)** na TypeScript port nke ọrụ Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — ma site n’ebe ahụ gaa n’ihu, ọrụ open-source nke buru ụzọ rute ebe ahụ kpaliri subsystem ọ bụla dị n’okpuru. Nke ọ bụla n’ime ha nyere aka ịkpụzi otu akụkụ doro anya nke OmniRoute. Nke a bụ ekele anyị nye ha niile. 🙏
> ⭐ e ji GitHub REST API nyochaa ọnụọgụ star ndị a n’Ọktoba 18, 2026 — gaa nye ọrụ ndị a star. Ọnụọgụ ndị a bụ foto kpọmkwem nke ụbọchị ahụ, ha ga-agbanwekwa dịka o kwesịrị.
### 🧬 Ebe o si pụta & gateway
AI gateway nke dataset ọnụahịa ọha ya na-enye data maka mmekọrịta cost-tracking anyị, ebe model provider-normalization ya nyere aka hazie routing anyị.
E megharịrị source MIT ya n’ime bridge ChatGPT Web → Codex Responses e tinyere dịka vendored dependency, gụnyere adapter maka browser-session, response-framing, usage na web-search.
E bufechara usoro ya n’ime stream recovery, alias no-thinking, fallback web search, oke sliding-window, izochi ozi na log, na usoro launcher e mere ka ọ sie ike.
E megharịrị mappings model Grok ya, generator Statsig fake-TypeError, defaults request na device, yana NDJSON response processor ya n’ụzọ pụtara ìhè n’ime Grok Web executor nke OmniRoute.
Source MIT dị n’okpuru maka payload Grok na defaults device, generator Statsig, na processor result.response e bufere site na TQZHR na grok2api-merged.
Source transitive nke grok2api-merged nyere otuto maka proxy-pool layer ya; OmniRoute na-echekwa ọkwa banyere usoro ọmụmụ ahụ, mana ọ naghị ekwu na o mere proxy-pool port n’ime Grok Web executor ya nwere oke akọwapụtara.
Grok Web implementation mbụ nyochara atụmatụ HTTP/browser upstream ya; ụzọ HTTP kpọmkwem ya sitere na GrokProxy, ya mere a naghị ekwu na e nwere code port nọọrọ onwe ya.
Ọrụ ngo “gịnị mere e ji eji ọtụtụ token mgbe token ole na ole nwere ike ịrụ ọrụ ahụ” nke gbasara ebe niile — nkà ihe ọmụma ya nke ikwu okwu dịka onye ọgba na-akwado ọnọdụ mkpakọ ọkọlọtọ anyị na iwu 30+ maka iwepụ okwu ndochi/mkpokọta.
Nnyocha mkpakọ prompt (LLMLingua / LLMLingua-2) — kpaliri injin llmlingua anyị nke bụ async, na-echekwa koodu ma na-ahapụ usoro ka ọ gaa n'ihu mgbe ọdịda mere.
Nka onye na-ede koodu YAGNI nke “onye mmepe senior dị umengwụ” nke gbasara ebe niile — kpaliri Ụdị Nsonaazụ less-code anyị: nduzi maka mgbanwe kacha nta nke na-arụ ọrụ, nke na-ebelata koodu _emepụtara_ (nwanne dị n’akụkụ nsonaazụ nke edemede dị nkenke nke Caveman).
Mkpọkọ nsonaazụ nke na-aghọta ọdịnaya, n’ụdị faịlụ ọ bụla, tinyere nkwụsị nke na-eburu ọdịda n’uche — gosipụtara na nkesa anyị dịka ụdị na ịwụfe mgbe uru kacha nta adịghị.
Njide/nnyocha MITM nke okporo ụzọ coding-assistant ↔ LLM nyere aka ịkọwapụta ihe ndị mbụ Traffic Inspector chọrọ. E dochiela modul anọ e mepụtara na mbụ — njikọta SSE, ime ka mkparịta ụka nwee otu ụkpụrụ, ikpuchi ihe nzuzo na ihicha header — site na mmejuputa clean-room ndị nọọrọ onwe ha nke dabere n'ụkpụrụ protocol ọha. Akụkụ host-passthrough abụọ ahụ (passthrough.ts na _internal/bypass.cjs) ka bụ mmejuputa nke ime OmniRoute nke e kewapụtara iche; edegharịghị ha dịka akụkụ nke nnọchi ahụ.
Nduzi proxy na-apụtaghị ìhè maka process ọ bụla — kpaliri nkwụsị MITM anyị nke na-anagide mkpọka, oge-ngwụcha socket mgbe ọ naghị arụ ọrụ, njirimara process site na /proc na njide TPROXY.
Ndepụta ahọpụtara nke ọbá akwụkwọ ndị dị nchebe na ndabara nke na-eduzi nhọrọ nchekwa anyị (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Chọpụtara akụkụ oke Grok Build; OmniRoute mesịrị nyochaa ma dozie usoro live wire n'onwe ya.
## 📄 Ikikere
Ikikere MIT - lee [LICENSE](LICENSE) maka nkọwa.
---
**[⬆ Laghachi n'elu](#-omniroute)** · E wuru ya site n'❤️ maka obodo AI open-source.
OmniRoute v3.8.53 · Node ≥22.22.2 · Ikikere MIT · omniroute.online
> Nchịkọta animation nke ibe `/dashboard/free-tiers` dị ndụ. Usoro zuru oke (iwepụ nkwụghachi pool, ogo kredit, usoro ndị na-enye ọrụ): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> A na-enyocha ọnụọgụ ndị a ọzọ kwa izu abụọ tụnyere katalọgụ dị ndụ, ha **na-agagharị n'ụzọ abụọ** — onye na-enye ọrụ kwụsịrị ogo efu, ọnụọgụ ahụ na-ebelata; nke ọhụrụ batara, ọ na-arịgo. Anyị na-ebipụta ihe katalọgụ ahụ na-agụ n'ezie, ọ bụghị ihe kacha mma e gbakọtara elu.
```bash
# Mgbe ị jikọtara onye na-enye ọrụ, depụta igodo OmniRoute gị site na Dashboard → Endpoints:
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` chọrọ ụzọ ruru eru. Ntinye ọhụrụ nwere ike ịnweghị ebumnuche na-adịghị achọ igodo ruru eru, onye na-enye ọrụ na-adịghị achọ igodo nwekwara ike jụ ndị ahịa ndị ọzọ. E wepụtara ndị na-enye ọrụ e depụtara `tos: avoid`, gụnyere Kiro, na ịziga ozi akpaghị aka; ijikọ akaụntụ agaghị eme ka ntọala ahụ gbanwee. Lee [Ntuziaka Ọkwa Efu](docs/getting-started/FREE-TIERS-GUIDE.md) tupu ị họrọ onye na-enye ọrụ.
📦 Script mmalite ngwa ngwa ị nwere ike idepụta maka **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Combo** bụ usoro ụdịdị AI nke OmniRoute na-agafe n'etiti ha **na-akpaghị aka**. Ọ bụrụ na oke ojiji agwụ, onye na-eweta ọrụ daa, ma ọ bụ ọnụahịa rịa elu, combo nwere ike ịgafe na ụdị AI ọzọ tozuru oke ma dị mma. 🛡️
### ⚡ Enweghị nhazi — naanị jiri `auto`
Ọ dịghị combo ị ga-emepụta. Tọọ ụdị AI gị ka ọ bụrụ `auto` (ma ọ bụ otu n'ime ụdị ya), OmniRoute ga-emepụta combo mebere site n'aka ndị na-eweta ọrụ ị jikọtara, ma na-enye ha akara ozugbo:
📖 [Igwe Auto-Combo](docs/routing/AUTO-COMBO.md) · [Ntuziaka Nkwụsi Ike](docs/architecture/RESILIENCE_GUIDE.md)
📊 Usoro nyocha zuru ezu & nkọwa atụmatụ nke ọ bụla megide 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Igodo (enweghị usoro): `5d865059-bc44-483a-962d-43ceb80126eb`
Detuo ma mado Pix:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Inye Ikike](docs/architecture/AUTHZ_GUIDE.md) · [Usoro Nchedo](docs/security/GUARDRAILS.md) · [Nrubeisi n'Iwu](docs/security/COMPLIANCE.md)
Combo stacked ndabere na-agba `RTK → Caveman`. Mgbe ha abụọ na-arụ ọrụ na otu payload ngwá ọrụ/ọnọdụ, nchekwa na-ejikọta:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
A **na-echekwaba mgbe niile** code blocks, URLs, JSON na data usoro site n'aka engine nchekwa.
> **Gịnị mere a ga-eji token ọtụtụ mgbe ole na ole na-emecha?** Arịrị ọ bụla na-agafe compression pipeline nke OmniRoute **n'ụzọ doro anya** — enweghị mgbanwe onye ahịa. Ugbu a ọ bụ **stack nke engine 12 nwere ike ijikọta** nke na-agba ọsọ n'usoro ma jikọta & họrọ kwa combo routing — na-ewulite echiche si na [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), na [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Stack nke engine 12
Engine na-agba ọsọ n'usoro pipeline; nke ọ bụla nwere ike ịgbanye ma hazie n'otu n'otu kwa combo:
