# README (Igbo) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Ọnụ Ụzọ AI N'efu

OmniRoute — Akwụsịla ide koodu. Ngwaọrụ AI ọ bụla → ndị na-enye ọrụ 372 — ihe karịrị 150 n'efu — site n'otu endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity gaa na Claude / GPT / Gemini N'EFU nwere auto-fallback. Mkpakọ jikọtara RTK + Caveman na-echekwa token 15–95% (~89% ná nkezi) — erutela oke ma ọlị. Ndị na-enye AI 372 · ọkwa n'efu karịrị 150 · ~1.62B token n'efu kwa ọnwa · usoro routing 19 · $0 iji malite.

## 💰 ~1.62B Token / Ọnwa Site na Ọkwa Efughị Ego nke Ndị Ọzọ

> **Weta akaụntụ ndị na-enye ọrụ nke gị.** Nke a bụ ngụkọta e mere atụmatụ ya n’ofe ọkwa efughị ego nke ndị ọzọ ị nwere ike iru iche iche, ọ bụghị token OmniRoute nyere. Debanye aha, nweta nzere ebe achọrọ, wee jikọọ ndị na-enye ọrụ ị nwere ike iji; onye na-enye ọrụ ọ bụla na-achịkwa oke, nnweta, na usoro nke ya. > > Ịchịkọta ọkwa efughị ego ndị a n’aka na-esiri ike — ọtụtụ SDK, ọtụtụ oke ọnụego, na amaghị ole i nwere n’ezie. OmniRoute depụtara **ntinye ọkwa efughị ego 489 n’ofe igodo ọdọ mmiri na-emegharị ugboro 35** ma na-agbakọ isiokwu token ahụ site na **ọdọ mmiri 17 nwere mmefu ego token kwa ọnwa e bipụtara nke karịrị efu, tinyere oke Groq ise nke ụdị ọ bụla**, ebe ewepụrọ oyiri dịka ọdọ mmiri ha na-ekekọrịta si dị. A na-egosi oke ndị na-emeghe naanị mgbe emechara nyocha njirimara mpaghara (taa: ModelScope) iche, +~6M n’azụ nkwenye njirimara mpaghara, a naghịkwa etinye ha n’ime ngụkọta isiokwu ahụ. Nsonaazụ ahụ na-anọgide na dashboard (`/dashboard/free-tiers`).

Kaadị mmefu ego ọkwa efughị ego OmniRoute: ihe dị ka token efughị ego 1.62B kwa ọnwa n’ụzọ kwụsie ike, ruo ihe dị ka 2.22B n’ọnwa mbụ site na kredit ndebanye aha, sitere na igodo ọdọ mmiri na-emegharị ugboro 35 edekọtara nke na-ekpuchi ntinye ọkwa efughị ego 489 e depụtara n’azụ otu endpoint. Mgbakọ eziokwu nke ewepụrọ oyiri ọdọ mmiri — a na-agụ ọdọ mmiri ọ bụla a na-ekekọrịta naanị otu ugboro, gụnyere ọdọ mmiri na-emegharị ugboro 17 nwere mmefu ego token kwa ọnwa e bipụtara nke karịrị efu, tinyere oke Groq ise nke ụdị ọ bụla; e debere ndị na-enye ọrụ 13 akara zere n’ime katalọgụ ihe ize ndụ usoro ka ị nwee ike ikpebi. Ogwe mmefu ego gụnyere Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (oke ise nke ụdị ọ bụla) na ọdọ mmiri ndị pere mpe, tinyere kredit ndebanye aha nke ọnwa mbụ na ndị na-enye ọrụ efughị ego ruo mgbe ebighị ebi na-enweghị oke token, ndị egosiri iche ka ha ghara ịmụba isiokwu ahụ n’ụzọ ụgha. Ojiji na ihe fọdụrụ ozugbo na /dashboard/free-tiers.

> Nchịkọta na-agagharị agagharị 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ụ ndị a ọzọ kwa izu abụọ site n’iji katalọgụ dị ndụ tụnyere ha, ha nwekwara ike **ịgbanwe n’akụkụ abụọ** — onye na-enye ọrụ kwụsị ọkwa efughị ego, ọnụọgụ ahụ ada; nke ọhụrụ abata, ọ rịgo. Anyị na-ebipụta ihe katalọgụ ahụ gbakọrọ n’ezie, ọ bụghị ọnọdụ kacha mma e buliri ọnụọgụ ya elu.}

⭐ Nye repo ahụ kpakpando ma ọ bụrụ na OMNIROUTE nyere gị aka ịchekwa ego ma mee ka ọrụ gị dị mfe.

[![Kpakpando](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Ọkwa Akụkọ Kpakpando](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Soro obodo ahụ **👋 Soro onye na-elekọta ya — bụrụ onye mbụ ga-enweta ndị na-enye ọrụ ọhụrụ, mwepụta na ndụmọdụ:** [![Soro Diego na LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Soro @diegosouzapw na GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Ụwa Nile](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brazil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Weebụsaịtị](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](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 Nile](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Pọtál](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Ọnụ Ụzọ Ahụ Na-aga n’Ihu N’ịbawanye

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ----------------------------- | :----------------------: | :---------: | :-------------------: | | 🌐 Ndị na-eweta ọrụ | 352 | **358** | 372 | | 🧠 NJ pụrụ iche nke ụdị nkata | 1320 | **1374** | 1443 | | 🖼️ Àkwà mmiri ụdị mgbasa ozi | 🆕 ọhụụ + ọdịyo + vidiyo | ✓ | ✓ | | 📡 Katalọgụ Radar efu | 🆕 họrọ ịbanye | ✓ | ✓ | | ⚖️ Nhazi na-eburu oke n’uche | 🆕 Nkekọ-Oke | ✓ | ✓ | | 📊 Telemetrị oke | 🆕 na-aga ugbu a | ✓ | ✓ | | 🧰 Ọnọdụ enweghị ihu | — | — | 🆕 `serve --headless` | | 🛤️ Akụrụngwa ụzọ LTS | — | — | 🆕 ọwa mwepụta | **→ [Atụmatụ Ọdịnihu](ROADMAP.md) — na-eso ụzọ ahụ ruo `v3.9.0 LTS`**

## 🧩 Ihe Dịnụ [![ụdị npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Nbudata NPM kwa Ọnwa](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Ikikere: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Nbudata Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Nbudata Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Bido	🚀 Mmalite Ngwa Ngwa	📦 Wụnye	🆓 Enweghị Nhazi
💡 Mụta	💥 Nkwa Ahụ	🤔 Gịnị Mere OmniRoute	🏆 Ihe Mere Ya Ji Pụọ Iche
⚙️ Njirimara	🎯 Ngwakọta	🌐 Ndị Na-eweta Ọrụ	🔌 CLI & MCP Zuru Oke
	🗜️ Mkpakọ	🖥️ Ebe Ọ Na-arụ Ọrụ	🔒 Nzuzo
👀 Lee Ya	🎬 Ka Ọ Na-arụ Ọrụ	✨ Ihe Dị Ọhụrụ	🤖 CLI Ndị Dakọtara
💚 Nkwado	💚 Kwado / Nye Onyinye	💬 Ogbe Ndị Ọrụ	💖 Ndị Nkwado Ego
📦 Ihe Ọrụ	🛠️ Ngwa Teknụzụ	📖 Akwụkwọ Nkọwa	👥 Ndị Ntinye Aka

🌐 N'asụsụ 67

## 🆓 Wụnye, jikọọ onye na-enye ọrụ, wee zipụ site n'otu endpoint

Nzọụkwụ atọ: wụnye ma malite OmniRoute, jiri akaụntụ nke gị ma ọ bụ API key jikọọ onye na-enye ọrụ tozuru etozu, wee tụnye ngwá ọrụ gị na localhost:20128/v1 site n'iji OmniRoute API key na model auto. Nzipụ dabere na njikọ ndị tozuru etozu dịnụ na oke ndị na-enye ọrụ.

```bash # Mgbe ijikọchara onye na-enye ọrụ, detuo OmniRoute key 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ọ tozuru etozu. Nwụnye ọhụrụ nwere ike ọ gaghị enwe ebe keyless tozuru etozu ọ bụla, onye na-enye ọrụ keyless nwekwara ike ịjụ ndị ahịa nke ndị ọzọ. A na-ewepụ ndị na-enye ọrụ e nyere akara `tos: avoid`, gụnyere OpenCode Free na Kiro, na nzipụ akpaka na ndabara; ijikọ akaụntụ anaghị agbanwe ntọala ahụ. Hụ [Ntuziaka Free Tiers](docs/getting-started/FREE-TIERS-GUIDE.md) tupu ịhọrọ onye na-enye ọrụ.} _{📦 Skript mmalite ngwa ngwa ị nwere ike idetuo ma mado maka **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Nkwa Ahụ

# 🤔 Gịnị Mere OmniRoute?

Usoro arịrịọ OmniRoute: IDE ma ọ bụ CLI gị (Claude Code, Cursor, Cline…) na-akpọ otu endpoint mpaghara (http://localhost:20128/v1); OmniRoute Smart Router (mkpakọ RTK + Caveman, atụmatụ nzipụ 19, circuit breakers, TLS stealth, MCP, A2A, guardrails) nwere ike ịlaghachi azụ n'ofe ọkwa ndị na-enye ọrụ 4 ma ọ bụrụ na ebe tozuru etozu ma dị mma ka dị — Ọkwa 1 Subscription, Ọkwa 2 API Key, Ọkwa 3 Cheap na Ọkwa 4 Free.

## 🤝 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.}

## 🎯 Combo — Ngwa Ọrụ Kachasị Pụta Ihe

E gosipụtara atụmatụ ntụgharị combo 19 niile n'usoro mmegharị — otu tile maka atụmatụ ọ bụla: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Lee tebụl dị n'elu maka ihe nke ọ bụla na-eme.

> **Combo** bụ usoro model ndị OmniRoute na-agafe n'etiti ha **na-akpaghị aka**. Ọ bụrụ na quota agwụ, provider ada, ma ọ bụ ọnụ ahịa rịa elu, combo nwere ike ịkwaga na model ahụike ọzọ tozuru oke. 🛡️ ### ⚡ Nhazi efu — jiri naanị `auto` Ọ dịghị combo ị ga-emepụta. Tọọ model gị ka ọ bụrụ `auto` (ma ọ bụ otu n'ime variant ya), OmniRoute ga-eji provider ndị ị jikọtara wuo combo mebere, na-enye ha akara ozugbo:

ID Model	Ihe ọ na-eme ka ọ kacha mma
`auto`	🎯 Nhọrọ ndabara ziri ezi (LKGP — na-anọgide na provider ikpeazụ gị rụrụ ọrụ nke ọma)
`auto/coding`	🧑💻 Arọ ndị na-ebute ogo ụzọ maka imepụta code
`auto/fast`	⚡ Latency kacha ala na-ebute ụzọ
`auto/cheap`	💰 Nke kacha ọnụ ala kwa token na-ebute ụzọ
`auto/offline`	🔋 Quota / ohere rate-limit kachasị ukwuu na-ebute ụzọ
`auto/smart`	🔭 Ogo na-ebute ụzọ + nyocha 10% iji chọpụta model ka mma
`auto/lkgp`	📌 Ịrapara kpọmkwem na provider ikpeazụ a maara na ọ dị mma
`auto/chaos`	🧪 Na-eziga arịrịọ n'otu oge na panel model (otu kwa provider, 5 na ndabara), ma weghachite otu azịza; otu oku upstream kwa model dị na panel, ọ bụghị itinye ntụpọ n'ime sistemụ

## ### 🔀 Ma ọ bụ wuo nke gị — atụmatụ ntụgharị 19 Atụmatụ **19** niile — gwakọta ma jikọta ha na nzọụkwụ combo ọ bụla:

#	Atụmatụ	Ihe ọ na-eme
1	`priority`	Ndepụta ahaziri nke target mbụ — jiri nke ọ bụla ruo mgbe ọ gwụrụ tupu ịgafe na nke ọzọ 🥇
2	`fill-first`	Jupụta quota target ọ bụla kpamkpam tupu ịgafe na nke ọzọ
3	`weighted`	Nhọrọ random nwere arọ dabere na arọ nke target ọ bụla
4	`round-robin`	Gagharịa n'etiti target n'usoro
5	`p2c`	Ịhazigharị ibu random site n'ike nhọrọ abụọ
6	`least-used`	Họrọ target nwere ibu ugbu a kacha ala
7	`random`	Nhọrọ random hà nhata (ewepụla ndị megharịrị)
8	`strict-random`	Random na-ewepụghị ihe ndị megharịrị 🎲
9	`cost-optimized`	Belata $ kwa arịrịọ site na ọnụahịa catalog dị ugbu a 💸
10	`headroom`	Họrọ target nwere quota fọdụrụ kachasị ukwuu
11	`reset-window`	Họrọ karịa target nke windo quota ya ga-eme reset ngwa ngwa
12	`reset-aware`	Hazie dịka oge reset quota — windo ndị dị mkpụmkpụ na-ebute ụzọ 📊
13	`context-relay`	Nyefee context n'etiti target maka mkparịta ụka ndị toro ogologo 🧠
14	`context-optimized`	Họrọ nke kacha dabara nha context ugbu a
15	`cache-optimized`	Kegide prefix prompt ọ bụla a pụrụ iji ọzọ n'otu account ahụ — mee ka ọnụọgụ prompt-cache hit dịkwuo elu 🎯
16	`lkgp`	Ụzọ Ikpeazụ A Maara na Ọ Dị Mma — na-ekegide ya na provider ikpeazụ rụrụ ọrụ nke ọma, wee laghachi na iwu ma ọ bụrụ na nke ahụ ada
17	`auto`	Inye akara ozugbo site na ihe 16 n'ofe njikọ niile 🤖
18	`fusion`	Ziga arịrịọ n'otu oge na panel model + onye ọkaikpe na-achịkọta otu azịza 🧬
19	`pipeline`	Jikọta nzọụkwụ — mmepụta target ọ bụla na-abanye na nke na-esote 🔗

_{Engine Auto-Combo na-enye candidate ọ bụla akara dabere na **ihe 16** (ahụike, quota, ọnụ ahịa, latency, ndabara ya na ọrụ ahụ, ogo, nnweta session…) — lee [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 E tinyere ikike iguzogide ọdịda n'ime ya (layer 3 nọọrọ onwe ha)

Nkwụsi ike OmniRoute — ọkwa 3 nọọrọ onwe ha na-agwọ onwe ha, ọkwa kwesịrị ekwesị maka ọdịda kwesịrị ekwesị. Ọkwa 1 ihe nkwụsị sekit nke onye na-eweta ọrụ (onye na-eweta ọrụ dum): ọ na-arụ ọrụ naanị na 408/5xx, oke OAuth 8× / API-key 12× / local 2×, na-emegharị mgbe 60s/30s/15s gachara gaa na nnwale HALF-OPEN, mgbake mgbe achọrọ ya; mgbe ọ nọ na OPEN, combo na-atụgharị ụzọ gaa na onye na-eweta ọrụ na-esote. Ọkwa 2 oge nchere njikọ (otu key/account): ntọala 5s OAuth / 3s API-key, exponential ×2 backoff nwere ihe nchebe anti-thundering-herd, 429 na-asọpụrụ Retry-After, ihe ịga nke ọma na-ehichapụ ọnọdụ njehie niile; a na-awụfe otu key nọ n'oge nchere ebe key ndị ọzọ yiri ya na-aga n'ihu na-enye ọrụ. Ọkwa 3 mkpọchi model (otu model): 429 nke model ọ bụla, local 404 ma ọ bụ ịjụ mode na-akpọchi naanị model ahụ — ọ bụghị njikọ ahụ dum ma ọlị. Ọnọdụ njedebe (banned, expired, credits exhausted) bụ maka onye njikwa, ọ bụghị oge nchere.

_{📖 [Igwe Auto-Combo](docs/routing/AUTO-COMBO.md) · [Ntuziaka Nkwụsi Ike](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Ihe Na-eme Ka OmniRoute Pụọ Iche

_{📊 Usoro nyocha zuru ezu & nkọwa atụmatụ n'otu n'otu 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.

⭐ Tinye kpakpando na repo	Ọ bụ n'efu — ọ na-enyere ọhụhụ aka n'ezie	Tinye kpakpando na OmniRoute
🐙 GitHub Sponsors	Otu ugboro ma ọ bụ kwa ọnwa · enweghị ụgwọ ikpo okwu	github.com/sponsors/diegosouzapw
☕ Ko-fi	Onyinye ngwa ngwa otu ugboro, onye na-enye onyinye ekwesịghị ịdebanye aha	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Obere onyinye na-enweghị usoro siri ike	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Na-eme ugboro ugboro · anaghị achọ uru · ebe mmeghe	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Ozugbo, enweghị ụgwọ	igodo & QR dị n'okpuru
₿ Ego kripto	BTC · ETH · USDT-TRC20 · USDC-Solana	adres dị n'okpuru

**🇧🇷 PIX** — ozugbo, enweghị ụgwọ (Brazil) Koodu QR PIX nke OmniRoute

Igodo (enweghị usoro): `5d865059-bc44-483a-962d-43ceb80126eb` Detuo ma mado Pix: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Ego kripto — BTC · ETH · USDT-TRC20 · USDC-Solana (pịa iji gbasaa)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ 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 Ndị Ọhụrụ

> 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è agent gị, nkà Conductor dị na Agent Card, na panel dashboard nwere mkparịta ụka olu push-to-talk nke Faro. → [Sava A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Nnabata na-agbanwe agbanwe & nchedo pụọ na ibu karịrị akarị** — a na-etinye arịrịọ mkparịta ụka ndị dị arọ n'ahịrị kama iwepụta njehie 503, tinyere atomic RPM rolling leases maka njikọ ọ bụla. → [Ntuziaka Resilience](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-etinye combos n'isi), nke na-adịgide otu ụdị n'ofe isi mmalite catalog niile. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🗜️ Ime ka compression sie ike** — inflation guard nke na-arụ ọrụ na ndabara, ngwugwu Caveman maka DE / FR / JA + Chinese (wényán), RTK filters maka Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Ọnụ ahịa flat-rate nke ziri ezi** — providers nke subscription / coding-plan na-egosi **$0** na nyocha ọnụ ahịa; budget, quota & routing ka na-eme atụmatụ. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **⚖️ Routing Quota-Share** — kewaa quota nke akaụntụ ejikọtara ọnụ n'ụzọ ziri ezi n'etiti pooled keys, ma na-echekwa ọrụ ka e nwee ike ibinye akụkụ ndị anaghị arụ ọrụ. → [Ntuziaka Resilience](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Nhazi CLI/agent site n'otu iwu** — iwu `setup-*` 13 edebanyere aha; `omniroute run` na-ebido CLI 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` na-akwado ebe e lekwasịrị anya 10, yana ihe ịhọrọ provider+model n'ụzọ mmekọrịta na favorites maka context ọ bụla. → [Njikọ CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Remote mode** — jiri tokens nwere oke ikike (`connect` / `contexts` / `tokens`) chịkwaa OmniRoute dị anya + OAuth helper `antigravity` maka nrụnye VPS. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 Auto-routing ka mara ihe karịa** — combos `auto/:`, **Fusion** (panel model + ọkaikpe), routing nke maara ụdị ọrụ, yana overrides nke model / mode / USD-budget maka arịrịọ ọ bụla. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Compression a pụrụ itinye dị ka plugin** — engines 12 a pụrụ ijikọ ọnụ + Compression Studios: LLMLingua-2, Ultra nwere tier abụọ, omniglyph, fidelity gate maka nzọụkwụ ọ bụla, GCF v3.2, editor drag-reorder. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ MITM decrypt doro anya (TPROXY)** — jide CLI ndị na-eleghara proxy env vars anya, yana CA maka SNI ọ bụla + installer trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Cost telemetry n'ebe niile** — headers ọnụ ahịa/ojiji `X-OmniRoute-*` na endpoint ọ bụla, header nke ego echekwara site na cache-HIT, quota mmefu USD maka key ọ bụla. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🧠 Memory ị na-achịkwa** — anaghị arụ ọrụ na ndabara, int8 vector quantization a na-ahọrọ ịgbanye + typed decay, yana `x-omniroute-no-memory` maka arịrịọ ọ bụla. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Nchekwa** — prompt-injection guard na route LLM ọ bụla (red-team suite), credential-masking guardrail a na-ahọrọ ịgbanye (na-ekpuchi API keys/secrets ndị gbapụtara n'akụkụ abụọ), ọchụchọ web DuckDuckGo efu nke ikpeazụ, na ọ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-eme ka akụkụ media zuo oke. → [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 providers okwu dịka ElevenLabs. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🌍 Deployment & ops** — reverse-proxy `basePath`, nchọpụta asụsụ browser na-akpaghị aka, nsuso ngwaọrụ maka key ọ bụla, ntụkwasị obi MITM na-enweghị root, zh-TW localization. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Providers & agents ndị ọzọ** — cloud agents (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) nwere browser + nbanye OAuth, kaadị Ollama nke e nyere ọnọdụ mbụ, Claude Opus 5 & Sonnet 5, mmekorita Kimi gọọmentị (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… yana **catalog provider 352** emelitere. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Nghọta doro anya banyere routing** — nzaghachi ọ bụla nwere header `X-OmniRoute-Decision` nke na-akpọ strategy/provider/latency jere ozi nye ya, strategy combo `cache-optimized` ọhụrụ + factor Auto-Combo `cacheAffinity` na-eweghachi arịrịọ ndị ugboro ugboro na njikọ nwere prefix echekwara na cache, ebe endpoint read-only `/v1/auto-combo/{channel}/candidates` na-ekpughe candidate pool dị ndụ nke channel `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Arụmọrụ mpaghara & infra** — Redis mpaghara a na-etinye n'otu click, relay deployers Cloudflare Workers / Deno Deploy, Bifrost & Mux dịka embedded services a na-elekọta. → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Ihe ndị ọzọ dị n'ime ya** — plugin framework + marketplace, frameworks nkà Omni/Agent/GitHub, njikọ Obsidian vault (ngwaọrụ MCP 22), API Batch & Files dakọtara na OpenAI, semantic response cache, gamification nwere leaderboards, nchọpụta agent ACP (agents arụnyere n'ime 15), mbupụ log a haziri oge gaa BigQuery, `auto/chaos` parallel multi-model fan-out, njikọ bot Telegram, version manager dị n'ime ngwa na ọkwa free-provider LMArena-ELO. → [Docs](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.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ 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ụ 36 niile (CLI Code 26 + 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-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 372 — 154 Akara Ha Dị Ka Ndị N'efu na Katalọgụ

> **Ndị na-enye ọrụ 372 e debanyere aha ha** n'ofe nchịkọta nkata, mgbasa ozi, ọchụchọ, mpaghara, cloud-agent na sistemụ ndị bụ isi, gụnyere **154 nwere metadata nchọpụta `hasFree: true`**. Ndekọ ụdị nkata ahụ nwere **ndị na-enye ọrụ 237 / ụzọ njikọ provider-model 3,009 pụrụ iche / NJ ụdị 1,443 na-enweghị nhazi**; katalọgụ mmefu efu dị iche nwere **ahịrị 491 maka ụdị n'otu n'otu**, **ọdọ ego 35 na-emegharị ugboro ugboro** na **ndị na-enye ọrụ 54 na-emegharị ugboro ugboro/na-achọghị igodo, ndị bụ n'efu ruo mgbe ebighị ebi**. E ji ụma mee ka ọnụ ọgụgụ ndị a dabere na ntọala dị iche iche; nkọwa na mgbakọ ewepụla oyiri n'ọdọ ego dị na [Ntụaka Ndị Na-enye Ọrụ](docs/reference/PROVIDER_REFERENCE.md) na [Ọkwa Ọrụ Efufu](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ọ 330+ — akara ngosi ọ bụla na-apụta ozugbo site na katalọgụ ndị na-enye ọrụ dị na dashboard. 📖 [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 _{Auto-router, 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 _{Model karịrị 50 Neuron 10K kwa ụbọchị}	NVIDIA NIM _{GLM, MiniMax ~40 RPM n'efu}	Cerebras _{GLM 4.7, GPT-OSS Kredit $5 otu ugboro; a chọrọ kaadị}	OpenRouter _{Model :free +$10 → RPM dị elu}

📖 Katalọgụ zuru ezu 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 na koodu mmalite	`npm install && npm run dev`	Gbanwee ya, nye aka

_{📖 [Nduzi Docker](docs/guides/DOCKER_GUIDE.md) · [Desktọpụ](electron/README.md) · [Tray ogwe-menu](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Ihe ọhụrụ: OmniRoute n'ime Copilot Chat nke VS Code

> Enweghị sidebar ọhụrụ, enweghị UI nkata ọhụrụ — ụdị ọ bụla OmniRoute na-enye na-apụta ozugbo n'ime > **nhọrọ ụdị Copilot Chat ị na-eji ugbu a**. Malite na VS Code 1.122, ụdị ndị na-eweta ọrụ na-arụ ọrụ > na-enweghị ịbanye na GitHub ma ọ bụ ndenye aha Copilot — ọnọdụ agent, ịkpọ ngwa ọrụ na vision, > n'efu. Wụnye ndọtị **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, duzie ya na sava OmniRoute gị (ndabara bụ `localhost:20128`), wee mepee Copilot Chat → nhọrọ ụdị → **Jikwaa Ụdị…** → **OmniRoute**.

Ụlọ ahịa	Njikọ	Na-arụ ọrụ na
🧩 VS Code Marketplace	Wụnye →	VS Code — stable & Insiders
🔓 Open VSX Registry	Wụnye →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

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ị.}

## 🔒 Nzuzo & Nke Mpaghara Bụ Isi

Nke nzuzo na nke mpaghara bụ isi — ọnụ ụzọ na ebe njikwa OmniRoute na-arụ ọrụ na kọmputa gị. A na-ezigara onye na-eweta ọrụ elu ahọpụtara maka arịrịọ ọ bụla prompt; OmniRoute anaghị agbakwunye ebe nhazi prompt nke a na-akwado n'ịntanetị, ma telemetry na-abụ nke agbanyụrụ na ndabara. A na-eji AES-256-GCM ezobe ozi nzere mgbe echekwara ha; njikwa gụnyere ịkpa oke API-key, nzacha IP, oke ọnụego, ihe nchebe megide prompt-injection, ihichapụ upstream-header, ihichapụ PII nke a na-ahọrọ ịgbanye, njehie ndị e sachara na ndekọ audit SQLite dị na mpaghara. OmniRoute nwere ikike MIT, a pụkwara ịkwado ya n'onwe gị.

_{📖 [Inye Ikike](docs/architecture/AUTHZ_GUIDE.md) · [Usoro Nchedo](docs/security/GUARDRAILS.md) · [Nrubeisi n'Iwu](docs/security/COMPLIANCE.md)}

## 🔌 CLI Zuru Ezu + A2A & MCP

> 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)}

Ngosipụta terminal na-emegharị ahụ nke na-egosi OmniRoute CLI — omniroute providers list, omniroute combo list na omniroute health — na-agagharị n'elu iwu 86 dị n'ọkwa kachasị elu: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 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ụ — pipeline, nhazi ụlọ & mgbakọ ego a na-echekwa

Pipeline mkpakọ OmniRoute: arịrịọ onye ahịa nwere token 10,000 e ji ihe atụ gosipụta na-agafe engine 12 enwere ike ijikọta — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra na OmniGlyph — ma nwee ike iru onye na-eweta ọrụ na ihe dị ka token 1,080 n'ihe atụ nchịkọta e depụtara. Ndị nche nchekwa na ọnụ ụzọ nlele izi ezi nke nzọụkwụ ọ bụla na-echekwa ọdịnaya ahaziri ahazi; ọnọdụ lossy ma ọ bụ nnwale e họọrọ kpọmkwem nwere ike ịgbanwe ọdịnaya tozuru etozu.

Ngwakọta ndabara a chịkọtara na-agba `RTK → Caveman`. Mgbe ha abụọ metụtara otu payload nke ngwaọrụ/ọnọdụ, ego a na-echekwa 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% ``` Engine nchekwa na-echekwa ngọngọ koodu, URL, JSON na data ahaziri ahazi **mgbe niile**. > **Gịnị mere ị ga-eji ọtụtụ token mgbe token ole na ole ga-arụ ọrụ ahụ?** Arịrịọ ọ bụla na-agafe pipeline mkpakọ OmniRoute **n'ụzọ anaghị enye nsogbu** — enweghị mgbanwe n'akụkụ onye ahịa. Ugbu a, ọ bụ **nchịkọta engine 12 enwere ike ijikọta** nke na-agba n'usoro ma na-agwakọta dịka ngwakọta routing ọ bụla si dị — nke dabeere 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 engine 12 ahụ Engine na-agba n'usoro pipeline; enwere ike ịgbanye ma ọ bụ gbanyụọ nke ọ bụla n'onwe ya ma hazie ya maka ngwakọta ọ bụla:

#	Engine	Ihe ọ na-eme
1	Session-Dedup	Na-ewepụ ọdịnaya e megharịrị n'ofe ntụgharị mkparịta ụka (nke adreesị ọdịnaya na-achịkwa, n'ofe ntụgharị)
2	CCR	Na-edebe nnukwu ngọngọ n'azụ akara iweghachite, nke a na-eweta mgbe achọrọ ya
3	Lite	Mbelata oghere ọcha + URL onyonyo (ntọala dị mfe nke nwere obere latency)
4	RTK	Nzacha nwere ọgụgụ isi, iwepụ oyiri & mkpụbi nsonaazụ ngwaọrụ (na-aghọta iwu)
5	Responses Tool Output	JSON nke na-ebute enweghị mfu ụzọ + mkpakọ nyocha nwere oke maka mmepụta shell/patch/search/build (Responses API)
6	Headroom	Mkpakọ n'ụdị tebụl na-enweghị mfu maka array JSON (~30%) site na codec GCF e tinyere n'ime ya
7	Relevance	Ịtụ akara ahịrịokwu ewepụtara dabere n'ajụjụ ikpeazụ onye ọrụ jụrụ
8	Caveman	Mkpakọ ederede dabere n'iwu (~65–75% na mmepụta)
9	Aggressive	Nchịkọta + ime ka ntụgharị ochie kaa nká n'usoro
10	LLMLingua-2	Mbelata semantik ML site na MobileBERT ONNX — dị nchebe maka koodu, async
11	Ultra	Mbelata token dabere na heuristic, tinyere ọkwa small-model (SLM) a pụrụ ịhọrọ
12	OmniGlyph	Ntụgharị ọnọdụ ka ọ bụrụ onyonyo nke a na-anwale maka Claude Fable 5 a tụrụ na njikọ Anthropic kpọmkwem; transformer GPT 5.6 ka na-emechi ma ọ bụrụ na enwere ọdịda ruo mgbe nnata onye na-eweta ọrụ bịara. Profaịlụ mkpakọ anọ (aggressive bụ ndabara, balanced, coding-safe, passthrough) (nke kacha sie ike; a ga-ahọrọ ya kpọmkwem)

A na-echekwa ngọngọ koodu, URL na data ahaziri ahazi **mgbe niile** ka byte ọ bụla ghara ịgbanwe. **Ntọala otu-pịa** na-ejikọta engine ndị ahụ:

Ọnọdụ	Ego echekwara	Kachasị mma maka
🪶 Lite	~15%	Ntọala nchekwa a na-ahapụ ka ọ na-arụ ọrụ mgbe niile
🪨 Standard (Caveman)	~30%	Ide koodu kwa ụbọchị
⚡ Aggressive	~50%	Oge ọrụ ogologo jupụtara n'iji ngwaọrụ eme ihe
🔥 Ultra	~75%	Ego kacha ukwuu a pụrụ ịchekwa
🧰 RTK	60–90%	Mmepụta shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Prompt agwakọtara + ndekọ ngwaọrụ

**Ezigbo ihe atụ — Ọnọdụ Standard:** > **Tupu (token 69):** _"Ihe nwere ike ime ka component React gị na-eme render ọzọ bụ na ị na-emepụta reference object ọhụrụ n'oge render ọ bụla. Mgbe ị nyefere object inline dị ka prop, shallow comparison nke React na-ahụ ya dị ka object dị iche oge ọ bụla, nke na-akpalite render ọzọ. Ana m akwado ka i jiri useMemo mee memoize object ahụ."_ > > **Mgbe e mesịrị (token 19):** _"Reference object ọhụrụ na render ọ bụla. Object prop inline = reference ọhụrụ = render ọzọ. Kechie ya na useMemo."_ > > **Otu azịza ahụ. Token dị 72% ole na ole. Enweghị mfu izi ezi ọ bụla.** ✅ **Ihe atụ PT-BR — Ọnọdụ [Troglodita](https://github.com/leninejunior/troglodita):** > **Tupu (token 42):** _"Nsogbu ahụ bụ na kọmponẹntị ahụ na-emegharị render n’ihi na a na-emepụta ntụaka object ọhụrụ na render cycle ọ bụla. Aga m atụ aro iji useMemo."_ > > **Mgbe e mesịrị (token 12):** _"Re-render: ref ọhụrụ na cycle ọ bụla (emegharịrị object inline). Jiri `useMemo`."_ > > **Otu azịza ahụ. Ihe dị ka token 70% pere mpe. Ezi izi ezi teknụzụ ka dị otu ahụ.** ✅
### 🎚️ Karịrị engine ndị ahụ — ụdị mmepụta, dial na-agbanwe onwe ya & njikwa maka arịrịọ ọ bụla Engine 12 ndị dị n’elu na-ebelata ihe na-abanye **n’ime**. Layer atọ ọzọ na-akpụzi **otu**, **mgbe**, na ihe na-apụta **n’èzí**: - **🪄 Ụdị Mmepụta** _(ntuziaka n’akụkụ mmepụta)_ — tinye ntuziaka doro anya, nke dị mma maka cache, iji kpụzie azịza; enwere ike ijikọta ha, nke ọ bụla nwere ike `lite` / `full` / `ultra`. Ịgbakwunye otu ụdị bụ naanị otu ahịrị ndebanye: - **Nkọwa dị mkpụmkpụ** — wepụ okwu ndoju / article / okwu enweghị nkwenye; debe isi ihe teknụzụ kpọmkwem. - **Koodu pere mpe** — YAGNI nke “senior dev umengwụ”: mgbanwe kacha nta na-arụ ọrụ, enweghị nhazi a na-arịọghị. - **Ponytail (senior dev umengwụ)** — soro ọkwa YAGNI rịgoro, dozie isi ihe kpatara nsogbu ahụ, jiri diff kacha nta na-arụ ọrụ. - **Enwere m ADHD (ọrụ buru ụzọ)** — malite na ihe a ga-eme ọzọ, tinye usoro n’ọnụọgụ, nye otu nzọụkwụ doro anya ga-esote, enweghị okwu mmeghe. - **CJK dị mkpụmkpụ (文言)** — ụdị Chinese oge ochie dị ezigbo mkpụmkpụ (a na-amachi ya na locale `zh`). - **🎯 Mmefu context na-agbanwe onwe ya** _(dial ahụ)_ — kama iji otu oke token a na-agbanye/agbanyeghi, bulie naanị engine ndị kacha ọnụ ala ma na-efunahụghị ozi ruo n’ókè achọrọ iji **daba na context window nke model ahụ**. Iwu: `reserve-output` (nke ndabara, maara model) · `percentage` · `absolute`. Mode: `floor` (mee ka ọ daba n’ezie) · `replace-autotrigger` (nhọrọ gị doro anya na-emeri) · `off` (oke ochie). - **🎛️ Ebe a na-ekpebi mkpakọ** _(usoro mkpa, elu → ala)_ — header `x-omniroute-compression` nke arịrịọ ọ bụla › override nke routing-combo › profaịlụ akpọrọ aha na-arụ ọrụ › adaptive / auto-trigger › ndabara panel › gbanyụọ. Atụmatụ e tinyere na-alọghachi na header nzaghachi `X-OmniRoute-Compression: ; source=`. Jiri oke token mee auto-trigger, gbanye dial adaptive, kpọchie profaịlụ akpọrọ aha, tọọ nke otu oge maka arịrịọ ọ bụla, ma ọ bụ kenye pipeline maka routing combo ọ bụla — nke ọ bụla dabara n’ọrụ ahụ. **Eval harness** offline a na-ahọrọ ịbanye na ya (`npm run eval:compression`) na-atụ ogo idobe izi ezi megide ego echekwara na corpus a kpọchiri tupu i bulie 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 & mee ka ọ rụọ ọrụ** ```bash npm install -g omniroute omniroute ``` > 💡 Ị na-ahụ `npm warn ERESOLVE` ma ọ bụ ịdọ aka ná ntị peer-dep? [Ha adịghị emerụ ahụ](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Ị na-eji npm 11 ma ọ bụ nke ọhụrụ karịa?** npm nwere ike igbochi script lifecycle nke package ma ọ bụrụ na enyeghị ha ikike. `postinstall` nke OmniRoute (`node scripts/build/postinstall.mjs`) dị mkpa iji kwadebe faịlụ runtime native ya. Nye package ndị akpọrọ aha na ịdọ aka ná ntị npm ikike mgbe ị na-etinye ya globally. Maka usoro package OmniRoute 3.8.51 kọọrọ: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Iji allowlist a ọzọ maka ntinye global n’ọdịnihu, hazie ya otu ugboro, wee wụnye dịka ọ na-adị: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Ndepụta dependency nwere ike ịgbanwe n’etiti release; ọ bụrụ na npm kọọrọ ndepụta dị iche, jiri aha package ndị dị na ịdọ aka ná ntị ahụ. Inye package ikike na-enye install script ya ohere ịrụ ọrụ. > **Ị na-eji Gemini Web ma ọ bụ provider ọzọ na-eji web-cookie?** Package npm ahụ gụnyere > Playwright mana ọ naghị agụnye Chromium binary ya. Hụ ndetu > [nhazi Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > tupu iziga arịrịọ web-provider mbụ. Dashboard dị na `http://localhost:20128` · API dị na `http://localhost:20128/v1`. **2) Jikọọ provider tozuru etozu site na iji akaụntụ nke gị** Dashboard → **Providers** → họrọ provider nke usoro ojiji na quota ya ugbu a dabara n’ihe ị chọrọ ime → tinye API key ya ma ọ bụ mezue usoro akaụntụ ya. Free tier nwere ike ịchọ signup, nkwenye, ma ọ bụ usoro ịkwụ ụgwọ. Nyochaa [Ntuziaka Free Tiers](docs/getting-started/FREE-TIERS-GUIDE.md); nnweta na-enweghị key abụghị ihe e kwere nkwa, a na-ewepụkwa provider akara `tos: avoid` na `auto` na ndabara. **3) Tụnye coding tool gị aka ebe ahụ** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Nyochaa na ọ na-arụ ọrụ** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ị kwesịrị ịhụ model ndị ị jikọrọ ka edepụtara. 🎉 Ọ bụ ya — malite ide koodu, OmniRoute ga-emere gị auto-route ma laghachi na nhọrọ ọzọ ma nke mbụ daa. Ọ bụrụ na client gị enweghị ike izipu header omenala, OmniRoute na-enyekwa compatibility alias 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 client ndị na-enweghị ike itinye `Authorization: Bearer ...`. Nyocha ikike 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) |

---

## 🛠️ Ngwa Teknụzụ

Ọkwa	Teknụzụ
Gburugburụ ọrụ	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Asụsụ	TypeScript 6.0 — 100% TypeScript n'ime `src/` na `open-sse/` niile (enweghị `any` n'ime isi sistemụ kemgbe v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Ebe nchekwa data	better-sqlite3 (SQLite, ndekọ WAL) + LowDB (JSON ochie) — modulu ngalaba 137, mbugharị 202
Ebe nchekwa ncheta	Ọchụchọ ederede zuru ezu SQLite FTS5 + ntinye vector int8-quantized, mbelata nwere ụdị
Schema	Zod 4 — nkwado izi ezi I/O nke ngwa MCP + nkwekọrịta API
Usoro nkwukọrịta	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Mgbasa data	Server-Sent Events (SSE) + àkwà mmiri WebSocket (`/v1/ws`)
Mkpakọ	Usoro engine 12 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Nnyocha njirimara & nchekwa	OAuth 2.0 (PKCE) + JWT + API Keys + nkwenye nwere oke MCP · AES-256-GCM mgbe echekwara ya · DOMPurify
Nzuzo	wreq-js — nnọchianya akara mkpịsịaka JA3 / JA4 TLS, proxy ọkwa 3
Ikike iguzogide ọdịda	Ihe nkwụsị sekit, exponential backoff, mgbochi ìgwè arịrịọ na-abịa n'otu oge, auto-combo na-agwọ onwe ya
Ndekọ	pino — ndekọ JSON ahaziri nke nwere ọnọdụ arịrịọ
Nnwale	Ngwa nnwale Node.js + Vitest — nkwupụta nnwale static 39,000+ n'ofe faịlụ nnwale 5,100+ a na-esochi (unit, integration, E2E, nchekwa, ecosystem)
Platform	Desktọpụ (Electron) · Android (Termux) · PWA (ihe nchọgharị ọ bụla)
CI/CD	GitHub Actions — mbipụta npm akpaka + Docker Hub mgbe a tọhapụrụ ụdị ọhụrụ
Njikọ	Weebụsaịtị · npm · Docker Hub

## 📖 Akwụkwọ Nkọwa

### 📘 Mmalite

Akwụkwọ	Nkọwa
Ntuziaka Onye Ọrụ	Ndị na-eweta ọrụ, ngwakọta, njikọ CLI, na mbugharị
Ntuziaka Nhazi	Ụzọ nrụnye zuru ezu, nhazi ngwa CLI, nhazi protocol, na idozi oge nchere
Ntuziaka Ngwa CLI	Nhazi nke ngwa ọ bụla maka Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Ọnọdụ Ime Anya	Jikwaa OmniRoute dị anya (VPS) site na CLI laptọọpụ gị site na token nnweta nwere oke
Nhazi Claude Code	Jikọọ Claude Code na OmniRoute (mpaghara/ime anya) site na `launch` + profaịlụ maka model ọ bụla
Mmalite Ngwa Ngwa	Nrụnye nwere usoro 3 → jikọọ → hazie

### 🔧 Ọrụ & Mbugharị

Akwụkwọ	Nkọwa
Ntuziaka Docker	Docker run, profaịlụ Compose, Caddy HTTPS, ọwara, na mkpado image
Ntuziaka Podman	Njikọ Quadlet systemd, podman-compose, SELinux
Mbugharị VM	Ntuziaka zuru ezu: nhazi VM + nginx + Cloudflare
Mbugharị Fly.io	Bugharịa na Fly.io site na nchekwa na-adịgide adịgide
Ntuziaka Termux	Gbaa OmniRoute na Android site na Termux
Ntuziaka PWA	Nrụnye Progressive Web App, nchekwa cache, na nhazi ụlọ
Ntuziaka Iwepụ Nrụnye	Mwepụ dị ọcha maka ụzọ nrụnye niile
Nhazi Gburugburụ	Variable `.env` na ntụaka ha niile

### 🧠 Atụmatụ & Nhazi Ụlọ

Akwụkwọ	Nkọwa
Nhazi Ụlọ	Nhazi ụlọ sistemụ, nrugharị data, na ọrụ ime
Ntuziaka Mkpakọ	Usoro nwere nhọrọ 7: gbanyụọ / obere / ọkọlọtọ / siri ike / kacha elu / RTK / jikọtara ọnụ
Mkpakọ RTK	Mkpakọ nsonaazụ iwu, nzacha, ntụkwasị obi, nkwado, na iweghachite nsonaazụ raw
Igwe Mkpakọ	Caveman, RTK, usoro jikọtara ọnụ, ihu dashboard/API/MCP
Ụdị Iwu Mkpakọ	Schema ngwugwu-iwu JSON maka nzacha Caveman na RTK
Ngwugwu Asụsụ Mkpakọ	Ịmata asụsụ na ide ngwugwu-iwu Caveman
Ntuziaka Nkwụsi Ike	Ndị nkwụsị sekit, oge izu ike, kwụ, mgbochi ìgwè na-awụli n'otu oge, na nṅomi TLS
Igwe Auto-Combo	Ntụle ihe 16, ngwugwu ọnọdụ, na ịgwọ onwe ya
Ntuziaka Proxy	Sistemụ proxy ọkwa 3, ahịa 1proxy, na CRUD ndekọ
Ọkwa Efughị Ego	Ndekọ ejikọtara ọnụ: ọdọ ọrụ na-emegharị ugboro ugboro 35 e dere nkọwa ha / ndenye ọkwa efughị ego 489 e depụtara
Ụlọ Ngosi Atụmatụ	Njem nlele dashboard nwere onyonyo ihuenyo
Akwụkwọ Nkọwa Codebase	Njem nkọwa codebase dị mfe maka ndị mbido

### 🤖 Protocol & API

Akwụkwọ	Nkọwa
Ntụaka API	Endpoint niile nwere ihe atụ
Nkọwa OpenAPI	Nkọwapụta OpenAPI 3.0
Sava MCP	Ngwa MCP 110, nhazi IDE, ndị ahịa Python/TS/Go
Ntuziaka Sava MCP	Nrụnye MCP, ụzọ mbufe, na ntụaka ngwa
Sava A2A	Protocol JSON-RPC 2.0, nka, nkwanye data, na njikwa ọrụ
Ntuziaka Sava A2A	Kaadị agent A2A, ọrụ, nka, na nkwanye data

### 📋 Pọjektị & Ogo

Akwụkwọ	Nkọwa
Ịtụnye onyinye	Ntọala na ntuziaka maka mmepe
Ụdị Alaka & Mwepụta	Ebe PR na-ezubere (`release/*`), na ihe `main` na mkpado pụtara
Ndekọ Mgbanwe	Akụkọ mwepụta zuru ezu maka ụdị ọ bụla
Iwu Nche	Ịkọ adịghị ike na usoro nchekwa
Ntuziaka i18n	Nkwado asụsụ 42, usoro ọrụ ntụgharị asụsụ, RTL
Ndepụta Nlele Mwepụta	Usoro nkwado tupu mwepụta
Atụmatụ Mkpuchi	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ị

Ọkwa	Onye nyere aka	PR ndị ejikọrọ	~Ahịrị ndị gbanwere
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{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

backryun _{🥇 commit 220 ndị GitHub depụtara}	Paijo _{🥈 commit 219 ndị GitHub depụtara}	Randi _{🥉 commit 108 ndị GitHub depụtara}	Ravi Tharuma _{🏅 commit 81 ndị GitHub depụtara}	Chris _{🏅 commit 70 ndị GitHub depụtara}	Markus Hartung _{🏅 commit 69 ndị GitHub depụtara · ha nhata n'ọkwa #6}
Dizzle _{🏅 commit 69 ndị GitHub depụtara · ha nhata n'ọkwa #6}	Jan Leon _{🏅 commit 64 ndị GitHub depụtara}	zenobit _{🏅 commit 62 ndị GitHub depụtara}	Bob.Hou _{🏅 commit 51 ndị GitHub depụtara · ha nhata n'ọkwa #10}	Xiangzhe _{🏅 commit 51 ndị GitHub depụtara · ha nhata n'ọkwa #10}

_{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.

Andrew
_{💛 Onye nkwado kwa ọnwa nọ n’ọrụ}

Vlad I
_{💛 Onye nkwado kwa ọnwa nọ n’ọrụ}

Paco Cartones
_{💛 Onye nkwado otu oge nọ n’ọrụ}

Prof. Igor Morais
_{💛 Onye nyere nkwado otu oge n’oge gara aga}

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+

[![Ndị Nyere Aka](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](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

Projekti	⭐	Otu o si kpalie OmniRoute
9router	26,161	Projekti izizi e ji wuo fork a — nke a gbasaara ebe a site n'ịgbakwunye API ọtụtụ ụdị na idegharị ya kpamkpam na TypeScript.
CLIProxyAPI	48,497	Nhazi Go nke kpaliri port JavaScript / TypeScript a.
LiteLLM	57,100	Ọ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ị.
codex-chatgpt-web	1,410	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ụ.
free-claude-code	48,112	Ụ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.
composer-api	322	Ụkpụrụ nhọrọ ngwaọrụ, mmachi mmepụta na nkwado ngwaọrụ nke Cursor Composer, nke e megharịrị n'ime onye mmejuputa Cursor nke ime.
codex-multi-auth	457	Ụkpụrụ nbanye ọhụrụ na ntụgharị refresh-token e bufere n'ime nnwapụta njirimara Codex OAuth ọzọ.
opencode-anthropic-auth	510	Ndabara mgbanwe dakọtara na Claude Code na omume nkụnye-isi ịgba ụgwọ, nke e mere ka ọ bụrụ nke izugbe n'ime njikọ OmniRoute nke nhazi na-achịkwa.
grok2api-merged	2	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.
TQZHR/grok2api	705	Isi mmalite koodu ntụgharị kachasị mkpa dị n'azụ grok2api-merged; a na-echekwa nhazi ụdị, nkụnye-isi, payload, Statsig na processor ya n'usoro mmalite Grok Web.
chenyme/grok2api	7,520	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.
grok2api-pro	27	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.
GrokProxy	50	Proxy Grok ya nke kuki na-enyocha njirimara na ụkpụrụ nkwanye `result.response.token` nyere aka n'ịkpụzi usoro mbufe Grok Web nke OmniRoute.
GrokBridge	5	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.
grok-web-api	14	Schema Rust `ChatOptions` ya na nke mkpuchi nzaghachi nyere aka n'ịkpụzi ụdị arịrịọ Grok na nzaghachi nkwanye nke TypeScript n'ime OmniRoute.

### 🗜️ Mkpakọ ọnọdụ & token — injin

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
Caveman	100,538	Ọ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.
RTK – Rust Token Killer	77,185	Mkpakọ nsonaazụ iwu nwere arụmọrụ dị elu — kpaliri injin RTK anyị, DSL nzacha JSON, iweghachite nsonaazụ na-enweghị nhazi, yana usoro jikọtara ọnụ RTK → Caveman.
headroom	67,310	Mkpakọ context enwere ike ịtụgharị azụ (SmartCrusher) — kpaliri injin `headroom` anyị na ụkpụrụ akara-nweghachite `ccr`.
LLMLingua	6,598	Nnyocha mkpakọ prompt (LLMLingua / LLMLingua-2) — kpaliri injin `llmlingua` anyị nke na-arụ ọrụ async, na-echekwa koodu, ma na-ahapụ usoro ka ọ gaa n’ihu mgbe ọdịda mere.
llmlingua-2-js	31	Mbubata JS/ONNX (MobileBERT / XLM-RoBERTa) eji dị ka backend worker-thread maka injin LLMLingua anyị.
Troglodita	40	Mkpakọ token PT-BR — na-enye ngwugwu asụsụ pt-BR anyị ike: mbelata nkwughachi okwu na iwepụ okwu ndochi ahaziri maka ụtọasụsụ Portuguese-Brazil.
ponytail	108,957	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).
i-have-adhd	23,526	A gbanwere ụdị nzaghachi ya nke na-ebute ime ihe ụzọ ma dị mfe maka ndị nwere ADHD ka ọ bụrụ ụdị nsonaazụ nkenke OmniRoute n’asụsụ ise.

### 🧩 Usoro kọmpat, nnyocha token & ngwaọrụ maara koodu

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
TOON	25,233	Token-Oriented Object Notation — usoro ya nke kọlụm, isiokwu-gbakwunyere-ahịrị nyere aka ịkpụzi ogbo mkpakọ tebụl anyị.
GCF – Graph Compact Format	41	Usoro eserese kọmpat ya na nhazi generic-profile nyere aka hazie mkpakọ tebụl OmniRoute na usoro codec Headroom.
gcf-typescript	4	Ntinyeọrụ MIT TypeScript e tinyere ozugbo n’ime ọrụ ahụ ma gbasaa ka ọ bụrụ codec generic-profile Headroom.
token-optimizer-mcp	494	Cache Brotli/SQLite + context-delta maka session ọ bụla — kpaliri injin `session-dedup` anyị.
token-savior	1,122	Nkpakọ nsonaazụ Bash + profaịlụ MCP — kpaliri usoro anyị nke ịkwụsị mkpakọ n’oge kwesịrị ekwesị na mbelata tool-manifest MCP.
token-saver	138	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ị.
token-optimizer	1,951	“Chọta token ndị mmụọ” — ụkpụrụ ya nke ibupụ ihe + aka enwere ike iji weghachite ya nyere aka n’echiche anyị banyere mbupụ CCR.
TokenMizer	28	Ụkpụrụ session-graph + iwepụ ahịrị ugboro abụọ n’ofe turn nke nyere aka hazie session-dedup anyị.
OmniCompress	3	JSON kọlụm Rust + nweghachite dabere na ọdịnaya + iwepụ ihe ugboro abụọ n’ofe ozi — kwadoro nhazi injin `headroom`/`ccr`/`session-dedup` anyị na invariant cache-stable “ụdị emekọtara adabereghị n’ọnọdụ”.
mcp-compressor	113	Mkpakọ schema/nkọwa ngwaọrụ MCP — nyere aka hazie mbelata ọnụọgụ tool-manifest MCP anyị.
RepoMapper	197	Nhazi ọkwa repo-map ụdị Aider — nyere aka hazie nyocha repo-map / retrieval-ranking anyị.
quiet-shell-mcp	4	Mbelata nsonaazụ shell n’ụzọ nkwupụta iwu site na MCP — kwadoro mkpakọ nsonaazụ bash anyị nke dabere na nkwupụta iwu.
ts-morph	6,162	Ngwaọrụ TypeScript Compiler API — kpaliri iwepụ comment anyị dabere na parser, nke na-echekwa literal eriri, template na regex.

### 🧠 Ebe nchekwa & RAG

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
Mem0	63,902	Ọkwa ebe nchekwa zuru ụwa ọnụ — usoro proxy-dị-ka-ókè-ide/ịgụ ya nyere aka ịkpụzi nhazi ebe nchekwa anyị.
Letta (MemGPT)	24,382	Ndị nnọchiteanya na-edobe ọnọdụ nwere ebe nchekwa e kewara n'ọkwa — kpaliri usoro e kewara n'ọkwa nke Njikwa na Mweghachi Ọnọdụ (CCR) anyị.
WFGY	1,781	Nhazi ProblemMap nke ụdị ọdịda RAG/LLM 16 na-eme ugboro ugboro — okwu ndị anyị ji emekọrịta ihe n'ime ntuziaka nchọpụta na mmezi nsogbu anyị.

### 🛰️ Nnyocha okporo ụzọ, MITM na proxy transperent

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
llm-interceptor	66	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ụ.
ProxyBridge	5,995	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.

### 📚 Data model, nleba anya na UI

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
models.dev	6,555	Ebe nchekwa data mepere emepe nke nkọwapụta, ọnụahịa na ike model AI — a na-emekọrịta ya ozugbo n'ime katalọgụ model anyị.
React Flow / xyflow	38,108	Ọba akwụkwọ graph dabeere na node nke na-enye Compression Studio na Combo/Routing Studio anyị na-arụ ọrụ n'oge ahụ ike.
LangGraph	40,314	Ngosipụta graph usoro ọrụ dị ndụ nke LangGraph Studio kpaliri nlele cascade na-eme n'oge ahụ nke Studios anyị.
Langfuse	33,592	Usoro nleba anya trace → span → generation ya nyere aka ịkpụzi ngosipụta waterfall nke Compression Studio anyị.
Kiali	3,631	Nleba anya service-mesh Istio — kpaliri baajị circuit-breaker na ngosipụta error-edge anyị n'ime Routing/Combo Studio.
lobe-icons	2,428	Akara ụghalaahịa AI/LLM ndị na-egosi akara ngosi provider n'ofe dashboard anyị.
flag-icons	12,354	Na-enye ọkọlọtọ SVG nwere ikikere MIT nke onye nhọpụta asụsụ README na-eji.

### 🛡️ Nchekwa

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
awesome-secure-defaults	721	Ndepụta ahọpụtara nke ọba akwụkwọ ndị nwere nchekwa dịka ndabara, nke na-eduzi nhọrọ nchekwa anyị (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Ngwaọrụ ndị na-emeju ibe ha

Ọrụ ngo	⭐	Otu o siri kpalie OmniRoute
ClawRouter	6,564	Kpaliri iwepụ arịrịọ ndị megharịrị emegharị, fallback mberede na-enweghị ego, atụmatụ Auto-Combo ndị a pụrụ itinye ma wepụ, na nhazi ebumnuche n'ọtụtụ asụsụ.
Antigravity-Manager	30,652	Ntughari model na-eburu account n'uche, nkwado executable-path na omume plan-label ya nyere nkọwa maka runtime Antigravity nke OmniRoute.
vscode-antigravity-cockpit	4,817	Usoro dị mkpụmkpụ ya maka ngụkọ oge na-agbadata ruo mgbe a ga-emegharị quota kpaliri ngosipụta provider-limit kwekọrọ na ya n'ime OmniRoute.
AionUi	32,230	Njikọta ACP ya kpaliri nchọpụta akpaka OmniRoute nke ndị nnọchiteanya CLI arụnyere.
CodexBar	20,507	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.52 · Node ≥22.22.2 · Ikikere MIT · omniroute.online}