> Iji aka jikọta ọkwa efughị ego dị iche iche na-agwụ ike — ọtụtụ iri SDK, ọtụtụ iri oke ọnụego, ma ị maghị kpọmkwem ole i nwere. OmniRoute na-edekọ **ntinye ọkwa efughị ego 489 n'ofe igodo ọdọ mmiri na-emegharị ugboro 35** ma na-agbakọ ọnụ ọgụgụ token bụ isi site na **ọdọ mmiri 17 nwere mmefu ego kwa ọnwa dị mma e bipụtara tinyere oke Groq ise maka ụdị nke ọ bụla**, na-ewepụgụ oyiri dịka ọdọ mmiri ha na-ekekọrịta si dị. A na-egosi oke ndị na-emeghe naanị mgbe enyochaara njirimara mpaghara (taa: ModelScope) iche, +~6M dị n'azụ nkwenye njirimara mpaghara, a naghịkwa etinye ha n'ọnụ ọgụgụ bụ isi. Nsonaazụ ahụ na-anọgide na-apụta na dashboard (`/dashboard/free-tiers`).
> Nchịkọta mmegharị nke ibe `/dashboard/free-tiers` dị ndụ. Usoro zuru ezu (iwepụ oyiri ọdọ mmiri, ọkwa kredit, usoro ndị na-enye ọrụ): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> A na-enyocha ọnụ ọgụgụ ndị a ọzọ kwa izu abụọ site n'iji katalọgụ dị ndụ tụnyere ha, ha nwekwara ike **ịga n'akụkụ abụọ** — onye na-enye ọrụ kwụsị ọkwa efughị ego, ọnụ ọgụgụ ahụ agbadaa; nke ọhụrụ abata, ọ rịgoro. Anyị na-ebipụta ihe katalọgụ ahụ na-agbakọ n'ezie, ọ bụghị ọnọdụ kacha mma e buliri ọnụ ọgụgụ ya elu.
⭐ Nye ebe nchekwa a kpakpando ma ọ bụrụ na OMNIROUTE nyeere gị aka ichekwa ego ma mee ka ọrụ gị dị mfe.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Sonyere obodo ahụ
**👋 Soro onye na-elekọta ya — buru ụzọ nweta ndị na-enye ọrụ ọhụrụ, mbipụta ọhụrụ na ndụmọdụ:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Ajụjụ, ndụmọdụ gbasara ndị na-enye ọrụ, atụmatụ mmepe na nkwado → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Ụwa Niile](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Ọnụ Ụzọ](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Ọnụ Ụzọ Ahụ Na-aga N'ihu Na-eto
## 🆓 Ọ na-arụ ọrụ ozugbo ị wụnye ya — enweghị igodo, enweghị nhazi
```bash
# Ntinye ọhụrụ, enweghị asambodo ọ bụla — `auto` na-arụ ọrụ ugbua:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Ị masịrị azụ azụ n'efu akọwapụtara? Kpọọ `oc/…` (OpenCode Free) ozugbo. Mgbe ahụ gaa na `auto` ma hapụ OmniRoute ka ọ họrọ.📦 Detuo-mado edemede mmalite ngwa ngwa maka **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Nkwa ahụ
# 🤔 Gịnị kpatara 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.
## 🎯 Ngwakọta — Ngwa Kachasị Pụta Ihe
> **Ngwakọta** bụ usoro ụdịdị nke OmniRoute na-agafe na ha **na-akpaghị aka**. Ọ bụrụ na oke ojiji agwụ, onye na-eweta ọrụ ada, ma ọ bụ ọnụ ahịa arị elu, ngwakọta ahụ nwere ike ịgafe n'ụdịdị ahụike ọzọ tozuru etozu. 🛡️
### ⚡ Enweghị nhazi — naanị jiri `auto`
Ọ dịghị ngwakọta ị ga-emepụta. Tọọ ụdịdị gị ka ọ bụrụ `auto` (ma ọ bụ otu n'ime ụdị ya), OmniRoute ga-esikwa n'aka ndị na-eweta ọrụ ị jikọtara wuo ngwakọta mebere, na-enye ya akara ozugbo:
NJ ụdịdị
Ihe ọ na-eme ka ọ kacha mma
auto
🎯 Nhọrọ ndabara nwere nguzozi (LKGP — na-anọnyere onye na-eweta ọrụ ikpeazụ rụrụ ọrụ nke ọma)
Ziga n'otu oge nye otu ụdịdị + onye ọkaikpe na-achịkọta otu azịza 🧬
19
pipeline
Jikọta usoro — mmepụta nke ebe ọ bụla na-abanye na nke na-esote 🔗
Injin Auto-Combo na-enye onye ọ bụla nwere ike ịhọrọ akara dabere na **ihe 16** (ahụike, oke ojiji, ọnụ ahịa, oge nzaghachi, ndabara maka ọrụ, ogo, ịdị adị nke nnọkọ…) — lee [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 E wuru ike iguzogide nsogbu n'ime ya (ọkwa 3 nọọrọ onwe ha)
📖 [Injin Auto-Combo](docs/routing/AUTO-COMBO.md) · [Nduzi Nkwụsi-ike](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Ihe Na-eme Ka OmniRoute Dị Iche
📊 Usoro zuru ezu & nkọwa njirimara ọ bụla ma e jiri ya tụnyere 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ụ
> Isi ihe ndị pụtara ìhè n'oge na-adịbeghị anya site na **v3.8.20 → v3.8.50**. Akụkọ zuru ezu dị na [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — nnyefe A2A na-abata gaa n’ìgwè ndị nnọchi anya gị, nka Conductor dị na Agent Card, yana panel dashboard nwere nkata olu Faro nke ịpị-ka-ekwu. → [Sava A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Nnabata na-agbanwe agbanwe & nchebe pụọ na ibu karịrị akarị** — arịrịọ nkata ndị dị arọ na-abanye n’ahịrị kama iwepụta 503, yana atomic RPM rolling leases maka njikọ ọ bụla. → [Nduzi Nkwụsi Ike](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Nhazi canonical nke `/v1/models`** — otu ngọngọ na-aga n’ihu nke a chịkọtara dịka provider maka provider ọ bụla (a na-edowe combos n’isi), nke na-adịgide otu n’ofe isi iyi katalọgụ niile. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🗜️ Ime ka mkpakọ sie ike** — ihe mgbochi inflation nke na-arụ ọrụ na ndabara, ngwugwu Caveman maka DE / FR / JA + Chinese (wényán), na nzacha RTK maka Gradle & .NET. → [Mkpakọ](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Ọnụahịa flat-rate ziri ezi** — ndị provider subscription / coding-plan na-egosi **$0** na nyocha ọnụahịa; mmefu ego, oke ojiji & routing ka na-aga n’ihu ịtụ atụmatụ. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **⚖️ Routing Quota-Share** — kesaa quota nke akaụntụ nkekọrịta n’ụzọ ziri ezi n’etiti pooled keys, ma na-echekwa ọrụ ka e wee gbazinye slices ndị na-adịghị arụ ọrụ. → [Nduzi Nkwụsi Ike](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Ntọlite CLI/agent site n’otu command** — command `setup-*` 13 edebanyere aha; `omniroute run` na-ebido CLI 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` na-akwado targets 10 site na nhọrọ provider+model mmekọrịta yana ọkacha mmasị maka context ọ bụla. → [Njikọta CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Ọnọdụ remote** — jiri scoped tokens (`connect` / `contexts` / `tokens`) jikwaa OmniRoute dị anya + enyemaka OAuth `antigravity` maka nrụnye VPS. → [Ọnọdụ Remote](docs/guides/REMOTE-MODE.md)
- **🧭 Auto-routing ka mara ihe karịa** — combos `auto/:`, **Fusion** (panel model + onye ikpe), routing maara ụdị ọrụ, na mgbanwe model / mode / USD-budget maka arịrịọ ọ bụla. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Mkpakọ a pụrụ itinye dịka plugin** — engines 12 a pụrụ ijikọta + Compression Studios: LLMLingua-2, Ultra nke ọkwa abụọ, omniglyph, fidelity gate maka nzọụkwụ ọ bụla, GCF v3.2, na editọ ịdọrọ-wee-hazigharịa. → [Mkpakọ](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ MITM decrypt doro anya (TPROXY)** — jide CLI ndị na-eleghara proxy env vars anya, site na CA maka SNI ọ bụla + ihe nrụnye trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Telemetry ọnụahịa n’ebe niile** — headers ọnụahịa/ojiji `X-OmniRoute-*` na endpoint ọ bụla, header ego echekwara site na cache-HIT, na oke mmefu USD maka key ọ bụla. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🧠 Ebe nchekwa ị na-achịkwa** — agbanyụrụ ya na ndabara, int8 vector quantization a na-ahọrọ ịgbanye + typed decay, yana `x-omniroute-no-memory` maka arịrịọ ọ bụla. → [Ebe Nchekwa](docs/frameworks/MEMORY.md)
- **🛡️ Nchekwa** — ihe mgbochi prompt-injection n’ụzọ LLM ọ bụla (red-team suite), guardrail nzuzo credential a na-ahọrọ ịgbanye (na-ekpuchi API keys/ihe nzuzo ndị gbapụtara n’akụkụ abụọ), ọchụchọ web DuckDuckGo n’efu dịka nhọrọ ikpeazụ, yana ọnụ ụzọ nbanye OIDC a na-ahọrọ maka dashboard (nbanye site na password na-adị mgbe niile). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Endpoints ọhụrụ** — `/v1/ocr` (Mistral OCR) na `/v1/audio/translations` (ụdị Whisper) na-emejupụta akụkụ media ahụ. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🎨 Mmepụta onyonyo / vidiyo / ọdịyo** — otu API maka media: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, na ndị provider okwu dịka ElevenLabs. → [Ntụaka API](docs/reference/API_REFERENCE.md)
- **🌍 Deployment & ops** — reverse-proxy `basePath`, nchọpụta akpaka nke asụsụ browser, nsuso ngwaọrụ maka key ọ bụla, ntụkwasị obi MITM na-enweghị root, na localization zh-TW. → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 Ndị provider & agents ndị ọzọ** — cloud agents (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) nwere browser + nbanye OAuth, kaadị Ollama nke klas mbụ, Claude Opus 5 & Sonnet 5, mmekọrịta ọchịchị Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… yana **katalọgụ provider 352** emelitere. → [Ndị Provider](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Nghọta doro anya banyere routing** — nzaghachi ọ bụla nwere header `X-OmniRoute-Decision` nke na-akpọ aha strategy/provider/latency nyere ya ọrụ, strategy combo ọhụrụ `cache-optimized` + factor Auto-Combo `cacheAffinity` na-eweghachi arịrịọ ugboro ugboro na njikọ nwere prefix echekwara na cache, ebe endpoint naanị-maka-ịgụ `/v1/auto-combo/{channel}/candidates` na-ekpughe pool candidates dị ndụ nke channel `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Arụmọrụ local & infra** — Redis local nke otu-click, ndị deployer relay Cloudflare Workers / Deno Deploy, yana Bifrost & Mux dịka embedded services a na-elekọta. → [Ọrụ Ndị E Tinyere N’ime Ya](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Ihe ndị ọzọ dịkwa n’ime igbe ahụ** — framework plugin + marketplace, frameworks nka Omni/Agent/GitHub, njikọta vault Obsidian (ngwa MCP 22), API Batch & Files dakọtara na OpenAI, cache nzaghachi semantic, gamification nwere leaderboards, nchọpụta agent ACP (agents 15 arụnyere n’ime ya), mbupụ log a haziri oge gaa BigQuery, fault injection `auto/chaos`, àkwà mmiri bot Telegram, njikwa version dị n’ime ngwa na ọkwa free-provider LMArena-ELO. → [Akwụkwọ Nduzi](docs/README.md)
## 🤖 CLI na Ndị Nnọchi Anya Ide Koodu Dakọtara
> Otu nhazi — `http://localhost:20128/v1` — ma **IDE AI ma ọ bụ CLI ọ bụla** na-arụ ọrụ na ụdịdị efu na ndị dị ọnụ ala.
**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-enwetakwa ebe obibi nwa oge dịpụrụ adịpụ:
```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ị n'ụzọ mmekọrịta ma dee nhazi nke ngwaọrụ ahụ:
omniroute configure codex # ndị ọzọ gụnyere: claude opencode qwen aider goose gemini cline continue kilo
```
Iwu ọ bụla na-asọpụrụ ọnọdụ ime ime nọ n'ọrụ (`omniroute connect `), `--dry-run`
na-egosi env/args kpọmkwem tupu emee ha, ebe `--api-key-env NAME` na-eme ka ihe nzuzo ghara
ịbanye n'akụkọ ihe mere eme nke shell gị. → [Njikọ CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 Ndị Na-enye AI 357 — Ndị Katalọgụ Kara 152 Dị Ka N'efu
> **Ndị na-enye ọrụ 357 e debanyere aha ha** n'ofe nchịkọta mkparịta ụka, mgbasa ozi, ọchụchọ, mpaghara, cloud-agent na sistemụ ndị bụ isi, gụnyere **152 nwere metadata nchọpụta `hasFree: true`**. Ndebanye ụdịdị mkparịta ụka ahụ kpuchiri **ndị na-enye ọrụ 229 / ngwakọta dị iche iche nke onye na-enye ọrụ na ụdịdị 2,554 / raw model IDs 1,283**; katalọgụ mmefu n'efu dị iche nwere **ahịrị maka ụdịdị ọ bụla 491**, **pool na-emegharị ugboro 35** na **ndị na-enye ọrụ n'efu ruo mgbe ebighị ebi na-emegharị ugboro/na-achọghị key 54**. Ndị a bụ ọnụ ọgụgụ ndabere dị iche iche dịka e siri hazie ya; nkọwa na mgbakọ e wepụrụ pool ndị megharịrị ugboro dị na [Ntụaka Ndị Na-enye Ọrụ](docs/reference/PROVIDER_REFERENCE.md) na [Ọkwa N'efu](docs/reference/FREE_TIERS.md).
### 🏢 Ụlọ nyocha ukwu niile — site n'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ị 330 — a na-ebute akara ngosi ọ bụla ozugbo site na katalọgụ ndị na-enye ọrụ nke dashboard ahụ. 📖 [Ntụaka Ndị Na-enye Ọrụ](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 N'efu Ruo Mgbe Ebighị Ebi — $0, achọghị kaadị
OpenCode Zen DeepSeek V4, Nemotron 3 Enweghị oke token
Kilo Code Onye-ntụgharị akpaaka, Tencent Hy3 N'efu ruo mgbe ebighị ebi
Requesty GPT-OSS 120B, Nemotron N'efu ruo mgbe ebighị ebi
SiliconFlow DeepSeek V3.2 / R1 Ọkwa efu
Z.AI GLM GLM-4.7 / 4.5-Flash N'efu ruo mgbe ebighị ebi
Baidu ERNIE ERNIE 4.0 N'efu ruo mgbe ebighị ebi
Qoder AI Qwen3-Max, Kimi-K2 N'efu NA-ENWEGHỊ OKE
Pollinations GPT, Llama, Claude Achọghị key
Cloudflare AI Ụdị 50+ Neurons 10K kwa ụbọchị
NVIDIA NIM GLM, MiniMax ~40 RPM n'efu
Cerebras GLM 4.7, GPT-OSS Token 1M kwa ụbọchị
OpenRouter Ụdị :free +$10 → RPM dị elu
📖 Katalọgụ zuru ezu 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 command-line zuru ezu** nwere **iwu 80+**, tinyere protocol agent mepere emepe ka agent AI nwee ike ijikwa ya **n'onwe ya**.
### ⌨️ Ezigbo CLI (ọ bụghị naanị `start`)
```bash
omniroute # nye gateway + dashboard ọrụ (port 20128)
omniroute chat # onye ahịa nkata TUI mmekọrịta (slash: /model /combo /skill /memory)
omniroute setup # ọkachamara na-eduzi nhazi oge mbụ
omniroute doctor # chọpụta nsogbu ndị na-eweta ọrụ, port, na native deps
```
### 🛰️ Ọnọdụ remote — mee CLI ebe a, OmniRoute na VPS
OmniRoute ọ dị na sava? Jiri **otu CLI ahụ** jikwaa ya site na laptọọpụ gị. 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 # paswọọdụ → token nwere oke, echekwara dị ka context
omniroute models list # ← na-arụ ọrụ megide sava REMOTE
omniroute configure codex # ← na-ahọrọ model remote, na-ede profaịlụ Codex mpaghara
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 mpaghara
```
Token nwere oke `read` / `write` / `admin`; route ndị na-amalite process na-anọ naanị na loopback.
📖 [Ọnọdụ Remote](docs/guides/REMOTE-MODE.md)
### 🤝 Jikọọ agent — ọ ga-ejikwa OmniRoute n'onwe ya
Mee ka OmniRoute pụta site na **MCP**, **A2A**, **REST API**, **webhooks** ma ọ bụ **CLI remote** — agent ọ bụla nwere ikike (ma ọ bụ code nke gị) ga-enweta igodo gateway ahụ niile: routing, ndị na-eweta ọrụ, combo, cache, compression, memory — n'onwe ya. A na-enye endpoint HTTP ndị dị n'okpuru ọrụ na `http://localhost:20128`.
Interface
Endpoint / iwu
Ihe a ga-eji ya mee
🧰 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 ya bụ nke a na-ahọrọ ịgbanye), ndekọ audit zuru ezu
📡 MCP (SSE)
/api/mcp/sse
Ụzọ mbufe MCP na-asọba
🤝 A2A
/.well-known/agent.json
Site na agent gaa na agent, JSON-RPC 2.0 + SSE, nka 6
🌐 REST API
/v1/*
Dakọtara na OpenAI — nkata, embeddings, onyonyo, ọdịyo, OCR
🔔 Webhooks
/api/webhooks
Zipụ arịrịọ / ihe omume quota 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 Agent](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Chekwaa Token 15–95% — Na-akpaghị Aka
### 📖 Otu o si arụ ọrụ — usoro nhazi, nhazi ụlọ & mgbakọ ego echekwara
Ngwakọta ndabara a chịkọtara na-agba `RTK → Caveman`. Mgbe ha abụọ metụtara otu payload nke ngwá ọrụ/ọnọdụ, ego echekwara na-amụba ọnụ:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Injin nchekwa na-echekwa ngọngọ koodu, URL, JSON na data ahaziri ahazi **mgbe niile**.
> **Gịnị mere a ga-eji ọtụtụ token mgbe ole na ole ga-arụ ọrụ ahụ?** Arịrịọ ọ bụla na-agafe usoro mkpakọ OmniRoute **n'ụzọ a na-adịghị ahụ anya** — enweghị mgbanwe ọ bụla n'akụkụ onye ahịa. Ugbu a, ọ bụ **nchịkọta injin 12 enwere ike ijikọ ọnụ** nke na-agba n'usoro ma na-agwakọta dịka ngwakọta ntụgharị ọ bụla si dị — dabere n'echiche sitere 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).
### 🧱 Nchịkọta injin 12 ahụ
Injin na-agba dịka usoro pipeline si dị; enwere ike ịgbanye ma ọ bụ gbanyụọ nke ọ bụla n'onwe ya ma hazie ya maka ngwakọta ọ bụla:
JSON nke na-ebute enweghị mfu ụzọ + mkpakọ nyocha nwere oke maka mmepụta shell/patch/search/build (Responses API)
6
Headroom
Mkpakọ tabụl nke array JSON na-enweghị mfu (~30%) site na kodek GCF e tinyere n'ime ya
7
Relevance
Inye ahịrịokwu e wepụtara akara dabere n'ajụjụ ikpeazụ onye ọrụ
8
Caveman
Mkpakọ ederede dabere n'iwu (~65–75% na mmepụta)
9
Aggressive
Nchịkọta + ime ka ntụgharị mkparịta ụka ochie kaa nká nwayọọ nwayọọ
10
LLMLingua-2
Mwepụ semantik ML site na MobileBERT ONNX — na-echekwa koodu, asynchronous
11
Ultra
Mwepụ token dabere na heuristic, tinyere ọkwa obere model (SLM) nke nhọrọ
12
OmniGlyph
Nnwale itinye ọnọdụ dịka onyonyo maka Claude Fable 5 a tụrụ atụ n'ahịrị Anthropic kpọmkwem; transformers GPT 5.6 ka na-emechi mgbe ha dara ruo mgbe e nwetara nnata ndị na-eweta ọrụ. Profaịlụ mkpakọ anọ (aggressive ndabara, balanced, coding-safe, passthrough) (nke kacha eme ihe ike; a ga-ahọrọ ịbanye)
A na-echekwa ngọngọ koodu, URL na data ahaziri ahazi **mgbe niile** n'ụzọ byte-perfect. **Ntọala otu-pịa** na-ejikọta injin ndị ahụ:
Ọnọdụ
Ego echekwara
Kacha mma maka
🪶 Lite
~15%
Ntọala nchekwa nke na-adị mgbe niile
🪨 Standard (Caveman)
~30%
Ide koodu kwa ụbọchị
⚡ Aggressive
~50%
Oge ọrụ ogologo juputara na ngwá ọrụ
🔥 Ultra
~75%
Ego kachasị echekwara
🧰 RTK
60–90%
Mmepụta shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Prompt agwakọtara + ndekọ ngwá ọrụ
**Ezigbo ọmụmaatụ — Ọnọdụ Standard:**
> **Tupu (token 69):** _"Ihe nwere ike ime ka akụrụngwa React gị na-render ọzọ bụ na ị na-emepụta ntụaka object ọhụrụ na okirikiri render ọ bụla. Mgbe ị gafere inline object dịka prop, ntụnyere dị mfe nke React na-ahụ ya dịka object dị iche oge ọ bụla, nke na-akpalite re-render. Aga m akwado ka ị jiri useMemo mee memoize object ahụ."_
>
> **Mgbe e mesịrị (token 19):** _"Tụaka object ọhụrụ na render ọ bụla. Inline object prop = ntụaka ọhụrụ = re-render. Kechie ya na useMemo."_
>
> **Otu azịza ahụ. Token dị 72% ole na ole. Enweghị mfu izi ezi.** ✅
**Ọmụmaatụ PT-BR — ọnọdụ [Troglodita](https://github.com/leninejunior/troglodita):**
> **Tupu (token 42):** _"Nsogbu ahụ bụ na kọmponẹntị ahụ na-eme re-render n’ihi na a na-emepụta nrụtụaka objekị ọhụrụ n’oge render ọ bụla. Aga m akwado iji useMemo."_
>
> **Mgbe e mesịrị (token 12):** _"Re-render: ref ọhụrụ n’oge ọ bụla (emepụtara objekị inline ọzọ). Jiri `useMemo`."_
>
> **Otu azịza ahụ. Ihe dị ka token 70% pere mpe. Izi ezi teknụzụ ka zuru oke.** ✅
### 🎚️ Karịrị engines ndị ahụ — ụdị mmepụta, dial na-agbanwe onwe ya & njikwa arịrịọ nke ọ bụla
Engines 12 ndị dị n’elu na-ebelata ihe na-abanye **n’ime**. Layers atọ ọzọ na-akpụzi **otu**, **mgbe**, na ihe na-apụta **n’èzí**:
- **🪄 Ụdị Mmepụta** _(njikwa axis mmepụta)_ — na-etinye ntuziaka deterministic, cache-safe maka ịkpụzi azịza; enwere ike ijikọta ha, nke ọ bụla nwere ike `lite` / `full` / `ultra`. Ịgbakwunye otu ụdị bụ naanị otu ahịrị n’ime registry:
- **Edemede nkenke** — wepụ okwu ndoju / articles / hedging; debe isi teknụzụ ahụ kpọmkwem.
- **Koodu pere mpe** — YAGNI nke “senior dev umengwụ”: mgbanwe kacha nta na-arụ ọrụ, enweghị scaffolding a na-arịọghị.
- **Ponytail (senior dev umengwụ)** — gbagoo n’usoro YAGNI, dozie isi ihe kpatara nsogbu ahụ, jiri diff kacha nta na-arụ ọrụ.
- **Enwere m ADHD (mee ihe mbụ)** — malite na ihe a ga-eme ọzọ, tinye nọmba na nzọụkwụ, nye otu nzọụkwụ doro anya a ga-eme ọzọ, enweghị okwu mmeghe.
- **CJK nkenke (文言)** — ụdị Chinese oge ochie dị nnọọ nkenke (naanị mgbe locale bụ `zh`).
- **🎯 Mmefu context na-agbanwe onwe ya** _(dial ahụ)_ — kama otu oke token nwere naanị on/off, ọ na-abawanye ojiji engines ndị kachasị ọnụ ala ma na-efunahụghị ozi naanị ruo ebe dị mkpa iji **banye n’ime context window nke model ahụ**. Iwu: `reserve-output` (ndabara, maara model) · `percentage` · `absolute`. Mode: `floor` (mee ka ịbanye bụrụ ihe e ji n’aka) · `replace-autotrigger` (nhọrọ gị kpọmkwem na-emeri) · `off` (oke ochie).
- **🎛️ Ebe a na-ekpebi mkpakọ** _(usoro ikike, elu → ala)_ — header `x-omniroute-compression` nke arịrịọ ọ bụla › routing-combo override › profaịlụ aha ya na-arụ ọrụ › adaptive / auto-trigger › ndabara panel › off. Atụmatụ etinyere na-alaghachi na header nzaghachi `X-OmniRoute-Compression: ; source=`.
Mee ka token threshold kpalite ya n’onwe ya, gbanye adaptive dial, kpọgide profaịlụ nwere aha, hazie otu arịrịọ naanị otu ugboro, ma ọ bụ kenye pipeline nye routing combo ọ bụla — họrọ nke dabara na workload ahụ. **Eval harness** offline nke a na-ahọrọ ịgbanye (`npm run eval:compression`) na-enye akara maka ntụkwasị obi ma e jiri ya tụnyere ego echekwara n’elu corpus a kpọgidere tupu i 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)
# ⚡ Mbido Ngwa Ngwa
**1) Wụnye ma mee ya**
```bash
npm install -g omniroute
omniroute
```
> 💡 Ị na-ahụ `npm warn ERESOLVE` ma ọ bụ ịdọ aka ná ntị peer-dep? [Ha adịghị emerụ ihe](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
Dashboard dị na `http://localhost:20128` · API dị na `http://localhost:20128/v1`.
**2) Jikọọ provider efu (enweghị signup)**
Dashboard → **Providers** → jikọọ **Kiro AI** (Claude efu, ihe dị ka credit 50 kwa ọnwa maka akaụntụ ọ bụla) ma ọ bụ **OpenCode Free** (achọghị auth) → emechala.
**3) Tụnye ngwa coding gị ebe a**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (zero-config smart routing — or any provider/model)
```
**4) Nyochaa na ọ na-arụ ọrụ**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Ị kwesịrị ịhụ models ndị ị jikọrọ n’ime ndepụta ahụ. 🎉 Ọ bụ naanị ya — malite coding, OmniRoute ga-eme auto-route ma jiri fallback maka gị.
Ọ bụrụ na client gị enweghị ike iziga headers omenala, OmniRoute na-enyekwa aliases ndakọrịta nwere token:
```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-enweghị ike itinye `Authorization: Bearer ...`. Auth site na header ka bụ mode a kacha akwado.
## 📦 Ụ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.
# 🎬 OmniRoute Ka Ọ Na-arụ Ọrụ
## 📹 Nduzi Vidiyo
Nseta ihuenyo nke paanụ na 2026-08-24 · Katalọgụ nke mbụ: YT 809 | TT 137 | IG 124 · Ọhụrụ (ụbọchị): YT 1 | TT 21 | IG 22
🎬 #1 — Instagram nick_saraev — nlele 3,042,474
🎬 #2 — Instagram theopenstack — nlele 692,419
🎬 #3 — TikTok milesreevesai — nlele 620,400
🎬 #4 — YouTube Vaibhav Sisinty — nlele 391,109
🎬 #5 — Instagram buildwithai.club — nlele 347,652
**Ndepụta ọkwa zuru ezu (URL izizi ndị ewepụchara oyiri, `v > 0`, iru ndị mmadụ kachasị elu):**
| #1 | #2 | #3 | #4 | #5 |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** |
| #6 | #7 | #8 | #9 | #10 |
| ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** |
Metrik izizi na 2026-08-24: **vidiyo pụrụ iche 1.029** · **nlele amaara 11.132.922** (`v > 0`) · **ọwa/profaịlụ 639 n'elu netwọkụ ọ bụla**. Paanụ nke mbụ nwere ahịrị 1.070; e mere ka oyiri Instagram 41 bụrụ otu site na URL izizi, ma debe ọnụ ọgụgụ kachasị elu maka vidiyo ọ bụla.
> 🎬 **Ị mere vidiyo gbasara OmniRoute?** Mepee [nsogbu](https://github.com/diegosouzapw/OmniRoute/issues/new) ma ọ bụ [mkparịta ụka](https://github.com/diegosouzapw/OmniRoute/discussions) tinyere njikọ ahụ — anyị ga-egosipụta ya ebe a.
# 📧 Ndị Ọgbakọ & Enyemaka
> Ihe niile dị n'otu ebe — soro onye na-elekọta ya, kparịta ụka na ndị ọgbakọ, ma ọ bụ mepee nsogbu.
| Ọwa | Ebe / otu esi eme ya |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 💼 **LinkedIn** — soro onye na-ahụ maka mmezi | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) |
| 🐙 **GitHub** — soro maka mbipụta na ndụmọdụ | [@diegosouzapw](https://github.com/diegosouzapw) |
| 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) |
| ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) |
| 🟢 **WhatsApp — 🌍 Ụwa niile** | [sonye n'òtù ahụ](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) |
| 🟢 **WhatsApp — 🇧🇷 Brazil** | [banye n'òtù ahụ](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) |
| 🌍 **Weebụsaịtị** | [omniroute.online](https://omniroute.online) |
| 🌍 **🌍Ogbe StHub OmniRoute (n'efu)** | [pọtụl StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) |
| 📦 **Koodu mmalite** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) |
| 🐛 **Kọọ ntụpọ** | [mepee nsogbu](https://github.com/diegosouzapw/OmniRoute/issues) — tinye nsonaazụ `npm run system-info` |
| 🤝 **Nye aka** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Ụdị alaka na mbipụta](docs/ops/BRANCHING_MODEL.md) · họrọ `good first issue` |
| 💚 **Kwado ọrụ a** | [Ụzọ iji kwado ↑](#-support-omniroute) · [Ndị nkwado GitHub](https://github.com/sponsors/diegosouzapw) |
Atụmatụ mkpuchi ule maka nkwupụta ule static 39,000+ gafee faịlụ ule 5,100+ a na-enyocha
# ⭐ Ndị Kasị Nye Aka
> Ọ bụ obodo open-source nwere ịnụ ọkụ n'obi na-akpụzi OmniRoute. Ndị a enyela onyinye pụrụ iche nke na-emetụta ogo, nkwụsi ike, na mgbasa nke ọrụ a ozugbo. **Daalụ.**
### Ndị nyere aka sitere n'èzí dịka pull request ndị ejikọrọ si dị
Emechiri ya na nsọtụ dị ugbu a nke release/v3.8.50, dafb4ae808, tinyere njikọta ruo 2026-08-24 05:26:03 UTC. Ọnụọgụ GitHub GraphQL e kewara n'ibe nwere PR 5,911 ejikọrọ: 2,707 sitere n'aka onye nwe repository ahụ, 179 sitere na Dependabot, yana PR mpụga 3,025 sitere n'aka ndị nyere aka 535 dị iche iche. “Ahịrị ndị gbanwere” bụ mgbakwunye + nhichapụ GitHub ma gụnye faịlụ ndị e mepụtara na-akpaghị aka, lockfiles, katalọgụ, ntụgharị asụsụ na akwụkwọ; ọ bụ ọnụọgụ mgbanwe, ọ bụghị LOC onye dere. E debere ndị nwere otu ọkwa n'ebe njedebe ahụ.
### Commit ndị GitHub kwuru onye mere ha
Enyochakwara na 2026-08-24 06:14:31 UTC: commit ndị GitHub depụtara dịka API Ndị Ntinye Aka nke ebe nchekwa ahụ kọrọ maka alaka ndabara release/v3.8.50. API ahụ weghachiri njirimara 525 (ndị ọrụ 415, bot 2, ndị amaghị aha 108); tebụl a ewepụla onye na-elekọta ọrụ ahụ, bot na njirimara ndị amaghị aha ma debe ndị ha nhata n'asọmpi. Ọ dị iche ma na nhazi ọkwa PR ndị e jikọtara ọnụ dị n'elu ma na ngụkọta mmadụ 639 sitere na metadata Git dị n'okpuru.
> 🙏 Atụmatụ ndị ntinye aka a, mmezi ntụpọ, na nkwalite akụrụngwa bụ **akụkụ bụ isi** nke ihe na-eme ka OmniRoute bụrụ nke a pụrụ ịdabere na ya ma jupụta n'atụmatụ. Arịrịọ pull ọ bụla, ikpe nnwale ọ bụla, na faịlụ ntụgharị i18n ọ bụla dị mkpa. Ọ bụ ndị dị ka ha na-ewu sọftụwia mepere emepe.
---
## 💖 Ndị Nkwado
Ekele sitere n’obi nye ndị ji ego ha na-akwado OmniRoute — onyinye ọ bụla na-eme ka ọrụ a nọgide bụrụ n’efu, nwee onwe ya ma na-aga n’ihu.
longtao 💛 Onye nyere nkwado otu oge n’oge gara aga
… na ndị ọzọ họọrọ ka a ghara ikpughe aha ha 💛E nyochakwara Ndị Nkwado GitHub ọha na 2026-08-24. Ọnọdụ activeOnly nke GitHub na-ekpebi akara ndị nọ n’ọrụ dị n’elu; a ka na-ekele ndị nyere nkwado otu oge n’ihu ọha bụ ndị e kpughere na mbụ, ebe ndị nkwado nzuzo ka na-anọghị n’aha.💖 Bụrụ onye nkwado → — dollar ọ bụla na-eme ka OmniRoute nọgide bụrụ n’efu ma nwee onwe ya.
## 👥 Ndị Nyere Aka 600+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
E nyochara ya na 2026-08-24 na ntọala akpọchiri akpọchi ac02c5b42f, ma nyochaa ya ọzọ na nsọtụ dị ugbu a nke release/v3.8.50, ya bụ dafb4ae808: njirimara mmadụ 639 nke Git ahazigharịrị — 407 pụtara dị ka ndị dere commit (gụnyere onye na-elekọta ya), ebe 232 pụtara naanị na trailer Co-authored-by e depụtara kpọmkwem. Ngụkọta a na-ahazigharị handle noreply nke GitHub, na-ewepụ njirimara bot/agent/service/placeholder 26, ọ naghịkwa ejikọta adreesị email nkịtị naanị n’ihi na aha ngosipụta ha bụ otu.
### Otu E Si Nye Aka
1. Mee fork nke ebe nchekwa ahụ
2. Mepụta branch site na nsọtụ **nọ n’ọrụ** nke `release/vX.Y.Z` (ọ bụghị `main`) — lee [Ụdị Branch na Mwepụta](docs/ops/BRANCHING_MODEL.md)
3. Mepụta branch atụmatụ gị (`git checkout -b feat/amazing-feature`)
4. Mee commit nke mgbanwe gị (`git commit -m 'feat: add amazing feature'`)
5. Mee 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.
### Iwepụta Ụdị Ọhụrụ
```bash
# Mepụta mwepụta — 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 mbufe TypeScript 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ọ ruo ebe ahụ kpaliri subsystem ọ bụla dị n’okpuru. Nke ọ bụla n’ime ha nyere aka ịkpụzi otu akụkụ pụtara ìhè nke OmniRoute. Nke a bụ ekele anyị nye ha niile. 🙏
> ⭐ e nyochara ọnụọgụ kpakpando site na GitHub REST API n’August 24, 2026 — gaanụ nye ọrụ ndị a kpakpando. Ọnụọgụ ndị a bụ snapshot ziri ezi e dere ụbọchị ya, ma ha ga-agbanwe dịka o kwesịrị.
### 🧬 Mmalite & gateway
Ọnụ ụzọ AI nke nchịkọta data ọnụahịa ọha ya na-enye data maka mmekọrịta nsuso ụgwọ anyị, nakwa nke ụdị nhazi-ndị-na-enye-ọrụ ya nyere aka n'ịkpụzi usoro ntụgharị ụzọ anyị.
Isi mmalite MIT e megharịrị n'ime njikọ ChatGPT Web → Codex Responses etinyere n'ime sistemụ ahụ, gụnyere ihe nkwụnye maka nnọkọ ihe nchọgharị, nhazi nzaghachi, ojiji na ọchụchọ weebụ.
Ụkpụrụ e bufere n'ime mgbake iyi data, aha nnọchi ndị na-enweghị echiche, ọchụchọ weebụ ndabere, oke windo na-akpụgharị, izochi ozi ndekọ na usoro mmalite e wusiri ike.
E megharịrị n'ụzọ pụtara ìhè n'ime onye mmejuputa Grok Web nke OmniRoute: njikọ ụdị Grok ya, onye nrụpụta Statsig fake-TypeError, ndabara arịrịọ na ngwaọrụ, na onye nhazi nzaghachi NDJSON.
Isi mmalite MIT dị n'okpuru maka payload Grok na ndabara ngwaọrụ, onye nrụpụta Statsig, na processor result.response nke si na TQZHR na grok2api-merged gafee.
Isi mmalite ntụgharị nke grok2api-merged nyere otuto maka oyi akwa proxy-pool ya; OmniRoute na-echekwa ọkwa usoro mmalite ahụ mana ọ naghị ekwu na ọ bufere proxy-pool n'ime onye mmejuputa Grok Web ya nwere oke.
Nhazi Grok Web izizi ahụ nyochara atụmatụ upstream HTTP/ihe nchọgharị ya; ụzọ HTTP kpọmkwem ya sitere na GrokProxy, ya mere a naghị ekwu na e nwere port koodu nọọrọ onwe ya.
Ọrụ ngo “gịnị mere a ga-eji ọtụtụ token mgbe token ole na ole ga-arụ ọrụ” gbasara ebe niile — nkà ihe ọmụma ya nke ikwu okwu dịka mmadụ ọgba bụ ntọala ọnọdụ mkpakọ ọkọlọtọ anyị na iwu 30+ maka iwepụ okwu ndochi/mkpakọ okwu.
Nka YAGNI-coder nke “onye nrụpụta sọftụwia ukwu dị umengwụ” gbasara ebe niile — kpaliri Ụdị Nsonaazụ less-code anyị: nduzi mgbanwe kacha nta nke na-arụ ọrụ, nke na-ebelata koodu _emepụtara_ (nwanne dị na axis nsonaazụ nke ederede nkenke Caveman).
Mkpakọ nsonaazụ maara ọdịnaya, nke ahaziri maka ụdị faịlụ ọ bụla ma na-akwụsị n’ụzọ maara ọdịda — kwadoro nkesa anyị dabere n’ụdị na ịmafe mgbe uru kacha nta adịghị.
Njichi/nnyocha MITM nke okporo ụzọ dị n'etiti coding-assistant ↔ LLM nyere nkọwa maka ihe ndị mbụ achọrọ n'aka Traffic Inspector. Modul anọ e nwetaburu na ya — njikọta SSE, ịhazi mkparịta ụka ka ọ bụrụ otu usoro, ikpuchi ihe nzuzo na ihicha header — ejirila mmejuputa clean-room nọọrọ onwe ya, nke dabere na ụkpụrụ protocol ọha, dochie ha. Ebe abụọ ahụ na-enyefe host ozugbo (passthrough.ts na _internal/bypass.cjs) ka bụ mmejuputa nke OmniRoute n'onwe ya, ndị e kewara iche; edegharịghị ha dịka akụkụ nke nnọchi ahụ.
Nduzi proxy transperent n'otu process n'otu process — kpaliri mmechi MITM anyị na-eguzogide crash, oge-njedebe socket mgbe ọ naghị arụ ọrụ, njirimara process site na /proc na njide TPROXY.
Chọpụtara ebe quota Grok Build dị; OmniRoute mechara nyochaa ma dozie usoro wire dị ndụ n'onwe ya.
## 📄 Ikikere
Ikikere MIT - lee [LICENSE](LICENSE) maka nkọwa ndị ọzọ.
---
**[⬆ Laghachi n'elu](#-omniroute)** · E ji ❤️ wuo ya maka obodo AI nke sọftụwia oghe.
OmniRoute v3.8.51 · Node ≥22.22.2 · Ikikere MIT · omniroute.online
> Nchịkọta mmegharị nke ibe `/dashboard/free-tiers` dị ndụ. Usoro zuru ezu (iwepụ oyiri ọdọ mmiri, ọkwa kredit, usoro ndị na-enye ọrụ): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> A na-enyocha ọnụ ọgụgụ ndị a ọzọ kwa izu abụọ site n'iji katalọgụ dị ndụ tụnyere ha, ha nwekwara ike **ịga n'akụkụ abụọ** — onye na-enye ọrụ kwụsị ọkwa efughị ego, ọnụ ọgụgụ ahụ agbadaa; nke ọhụrụ abata, ọ rịgoro. Anyị na-ebipụta ihe katalọgụ ahụ na-agbakọ n'ezie, ọ bụghị ọnọdụ kacha mma e buliri ọnụ ọgụgụ ya elu.
```bash
# Ntinye ọhụrụ, enweghị asambodo ọ bụla — `auto` na-arụ ọrụ ugbua:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Ị masịrị azụ azụ n'efu akọwapụtara? Kpọọ `oc/…` (OpenCode Free) ozugbo. Mgbe ahụ gaa na `auto` ma hapụ OmniRoute ka ọ họrọ.
📦 Detuo-mado edemede mmalite ngwa ngwa maka **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Ngwakọta** bụ usoro ụdịdị nke OmniRoute na-agafe na ha **na-akpaghị aka**. Ọ bụrụ na oke ojiji agwụ, onye na-eweta ọrụ ada, ma ọ bụ ọnụ ahịa arị elu, ngwakọta ahụ nwere ike ịgafe n'ụdịdị ahụike ọzọ tozuru etozu. 🛡️
### ⚡ Enweghị nhazi — naanị jiri `auto`
Ọ dịghị ngwakọta ị ga-emepụta. Tọọ ụdịdị gị ka ọ bụrụ `auto` (ma ọ bụ otu n'ime ụdị ya), OmniRoute ga-esikwa n'aka ndị na-eweta ọrụ ị jikọtara wuo ngwakọta mebere, na-enye ya akara ozugbo:
📖 [Injin Auto-Combo](docs/routing/AUTO-COMBO.md) · [Nduzi Nkwụsi-ike](docs/architecture/RESILIENCE_GUIDE.md)
📊 Usoro zuru ezu & nkọwa njirimara ọ bụla ma e jiri ya tụnyere 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)
Ngwakọta ndabara a chịkọtara na-agba `RTK → Caveman`. Mgbe ha abụọ metụtara otu payload nke ngwá ọrụ/ọnọdụ, ego echekwara na-amụba ọnụ:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Injin nchekwa na-echekwa ngọngọ koodu, URL, JSON na data ahaziri ahazi **mgbe niile**.
> **Gịnị mere a ga-eji ọtụtụ token mgbe ole na ole ga-arụ ọrụ ahụ?** Arịrịọ ọ bụla na-agafe usoro mkpakọ OmniRoute **n'ụzọ a na-adịghị ahụ anya** — enweghị mgbanwe ọ bụla n'akụkụ onye ahịa. Ugbu a, ọ bụ **nchịkọta injin 12 enwere ike ijikọ ọnụ** nke na-agba n'usoro ma na-agwakọta dịka ngwakọta ntụgharị ọ bụla si dị — dabere n'echiche sitere 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).
### 🧱 Nchịkọta injin 12 ahụ
Injin na-agba dịka usoro pipeline si dị; enwere ike ịgbanye ma ọ bụ gbanyụọ nke ọ bụla n'onwe ya ma hazie ya maka ngwakọta ọ bụla:
