# 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 efu **Ọ bụ [Diego Souza](https://github.com/diegosouzapw) kere ya**

OmniRoute — Akwụsịla ide koodu. Ngwaọrụ AI ọ bụla → ndị na-eweta ọrụ 388 — 150+ n’efu — site n’otu njedebe. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity banye na Claude / GPT / Gemini N’efu site na ndaghachi akpaghị aka. Mkpakọ RTK + Caveman jikọtara ọnụ na-echekwa 15–95% token (~89% nkezi) — agaghị eru oke. Ndị na-eweta AI 388 · ọkwa efu 150+ · ~1.62B token efu kwa ọnwa · usoro ntụgharị ụzọ 20 · $0 iji malite.

## 💰 ~1.62B Tokens / Ọnwa N'ofe Ọkwa Efu Ndị Ọzọ

> **Jiri akaụntụ ndị na-enye ọrụ nke gị.** Nke a bụ atụmatụ ngụkọta sitere n'ọkwa efu ndị ọzọ nwere ikike iche iche, ọ bụghị onyinye token sitere na OmniRoute. Debanye aha, nweta nzere ebe achọrọ, jikọọkwa ndị na-enye ọrụ ị nwere ike iji; onye na-enye ọrụ ọ bụla na-achịkwa oke ya, nnweta ya, na usoro ya. > > Ijikọta ọkwa efu n'onwe gị na-agwụ ike — SDK dị ọtụtụ, oke ọsọ dị ọtụtụ, enweghịkwa ụzọ isi mara ole ị nwere n'ezie. OmniRoute na-edepụta **ntinye ọkwa efu 465 n'ofe igodo ọdọ mmiri ugboro ugboro 34** ma gbakọọ isi token site na **ọdọ mmiri 17 nwere mmefu kwa ọnwa dị mma e bipụtara tinyere oke Groq ise kwa-model**, na-ewepụ ugboro ugboro site n'ịgụ ọdọ mmiri ndị e kesara naanị otu ugboro. E gosipụtara oke ndị na-emeghe naanị mgbe nyochachara njirimara mpaghara (taa: ModelScope) iche, +~6M mgbe nyochachara njirimara mpaghara, a naghị agụnyekwa ha n'isi ngụkọta. Nsonaazụ ahụ na-aga n'ihu na-apụta na dashboard (`/dashboard/free-tiers`).

Kaadị mmefu ọkwa efu OmniRoute: ~1.62B token efu kwa ọnwa n'ụzọ kwụsie ike, ruo ~2.22B n'ọnwa mbụ site na kredit ndebanye aha, sitere na igodo ọdọ mmiri ugboro ugboro 34 e dekọrọ nke na-ekpuchi ntinye ọkwa efu 465 n'okpuru otu endpoint. Mgbakọ eziokwu nke ewepụrụ ọdọ mmiri ugboro ugboro — a na-agụ ọdọ mmiri ọ bụla e kesara naanị otu ugboro, tinyere ọdọ mmiri ugboro ugboro 17 nwere mmefu token kwa ọnwa dị mma e bipụtara na oke Groq ise kwa-model; ndị na-enye ọrụ 12 ka akara ka a zere n'akwụkwọ ndekọ ihe ize ndụ nke usoro ka ị nwee ike ikpebi. Ogwe mmefu ahụ gụnyere Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (oke ise kwa-model) na ọdọ mmiri nta ndị ọzọ, tinyere kredit ndebanye aha ọnwa mbụ na ndị na-enye ọrụ na-adị n'efu ruo mgbe ebighị ebi na-enweghị oke token, nke a na-egosi iche ka ha ghara ibuli isi ngụkọta. Ojiji fọdụrụ na nke ejirila ugbu a na /dashboard/free-tiers.

> Nchịkọta na-emegharị anya nke ibe `/dashboard/free-tiers` dị ndụ. Usoro zuru ezu (iwepụ ọdọ mmiri ugboro ugboro, ọ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ụọ megide katalọgụ dị ndụ, ha **na-agbanwe n'akụkụ abụọ** — onye na-enye ọrụ kwụsịrị ọkwa efu, ọnụ ọgụgụ ahụ na-agbada; onye ọhụrụ abata, ọ na-arị elu. Anyị na-ebipụta ihe katalọgụ na-agbakọ n'ezie, ọ bụghị ọnọdụ kacha mma e buliri elu site n'ịgbakọta ya.}

⭐ 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 anyị **👋 Soro onye na-elekọta ọrụ ahụ — nweta ndị na-enye ọrụ ọhụrụ, mwepụta na ndụmọdụ tupu ndị ọzọ:** [![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 Global](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ụ ụzọ na nkwado → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Ọnụ ụzọ ahụ na-aga n’ihu na-eto

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | -------------------------------- | :--------------------: | :---------: | :-------------------: | | 🌐 Ndị na-eweta ọrụ | 352 | **358** | 388 | | 🧠 NJirimara ụdị nkata pụrụ iche | 1320 | **1374** | 1491 | | 🖼️ Àkwà njikọ ụdị mgbasa ozi | 🆕 ọhụụ + ụda + vidiyo | ✓ | ✓ | | 📡 Katalọgụ efu Radar | 🆕 nhọrọ ịbanye | ✓ | ✓ | | ⚖️ Nhazi oge maara oke ojiji | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetry oke ojiji | 🆕 dị ndụ | ✓ | ✓ | | 🧰 Ọnọdụ enweghị isi | — | — | 🆕 `serve --headless` | | 🛤️ Akụrụngwa ụzọ LTS | — | — | 🆕 ọwa mwepụta | | 🔎 API nchọpụta ụdị | — | — | 🆕 `/v1/models/query` | **→ [Atụmatụ mmepe](ROADMAP.md) — na-eso ụzọ ahụ ruo `v3.9.0 LTS`**

## 🧩 Dị [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](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) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Malite	🚀 Malite ngwa ngwa	📦 Wụnye	🆓 Jikọọ onye na-eweta ọrụ
💡 Mụta	💥 Nkwa ahụ	🤔 Gịnị mere OmniRoute	🏆 Ihe na-eme ka ọ dị iche
⚙️ Njirimara	🎯 Ngwakọta	🌐 Ndị na-eweta ọrụ	🔌 CLI & MCP
	🗜️ Mkpakọ	🖥️ Ebe ọ na-arụ ọrụ	🔒 Nkeonwe
👀 Lee ya	🎬 N’ọrụ	✨ Gịnị dị ọhụrụ	🤖 CLI ndị kwekọrọ
💚 Kwado	💚 Kwado / Nye onyinye	💬 Obodo	💖 Ndị nkwado
📦 Mmemme	🛠️ Ngwá ọrụ teknụzụ	📖 Akwụkwọ nkọwa	👥 Ndị nyere aka

🌐 N'asụsụ 67

## 🆓 Wụnye, jikọọ onye na-enye ọrụ, wee si n’otu endpoint zụọ okporo ụzọ

Nzọụkwụ atọ: wụnye ma malite OmniRoute, jikọọ onye na-enye ọrụ tozuru oke site na akaụntụ nke gị ma ọ bụ igodo API, wee tụọ ngwa gị na localhost:20128/v1 site na iji igodo API OmniRoute na model auto. Nhazi okporo ụzọ dabere na njikọ tozuru oke dị na oke onye na-enye ọrụ.

```bash # Mgbe ị jikọtara onye na-enye ọrụ, detuo igodo OmniRoute gị site na Dashboard → Endpoints: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` chọrọ okporo ụzọ tozuru oke. Nwụnye ọhụrụ nwere ike ghara inwe ebe enweghị igodo ọ bụla tozuru oke, onye na-enye ọrụ na-enweghị igodo nwekwara ike ịjụ ndị ahịa ndị ọzọ. A na-ewepụ ndị na-enye ọrụ akara `tos: avoid`, gụnyere Kiro, na nhazi okporo ụzọ akpaghị aka na ndabara; ijikọ akaụntụ adịghị agbanwe ntọala ahụ. Lee [Ntuziaka Ọkwa Ọrụ N’efu](docs/getting-started/FREE-TIERS-GUIDE.md) tupu ịhọrọ onye na-enye ọrụ.} _{📦 Detuo ma mado skript mmalite ngwa ngwa 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ụ nhazi okporo ụzọ 20, circuit breakers, TLS stealth, MCP, A2A, guardrails) nwere ike ịda azụ n’ofe ọkwa ndị na-enye ọrụ 4 ma ọ bụrụhaala na ebe tozuru oke ma dị mma ka dị — Ọkwa 1 Ndenye aha, Ọkwa 2 Igodo API, Ọkwa 3 Dị ọnụ ala na Ọkwa 4 N’efu.

## 🤝 Ndị Enyi Anyị Na-emeghe Isi Iyi Na-akwado

> **Ị chọrọ isonye dị ka Enyi Na-emeghe Isi Iyi?** Ndị a bụ ụlọ ọrụ na-akwado isi iyi mepere emepe ma na-enyere OmniRoute aka ịga n'ihu — anyị na-ekwupụta n'ihu ọha ebe token ọ bụla ha nyere anyị na-aga. Kpọtụrụ: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Ekele dịrị Kimi (Moonshot AI), Enyi Anyị Na-emeghe Isi Iyi na-amalite, maka ịkwado ọrụ a! Kimi bụ ụlọ nyocha AI n'azụ ezinụlọ ihe nlereanya K2 na K3 nwere ibu arọ mepere emepe — Kimi K3 na-enye windo gburugburu 1M-token, ọhụụ ala na koodu ọkwa ókèala na ọnụ ahịa dị ala karịa ihe nlereanya mechiri emechi, ma na-arụ ọrụ ozugbo na Claude Code, Codex na ngwaọrụ koodu ọ bụla OmniRoute na-enye.

Ihe nkwado Kimi na-enye ike: Ebe nchekwa API nke Kimi na-enye ike usoro mwepụta OmniRoute AI-validated — ọkwa nkwenye njikọta nke Kimi K3 kwadoro nke na-enyocha arịrịọ ịdọrọ ọ bụla tupu ebuga ya — tinyere mmepe njirimara kwa ụbọchị. Nkwado Kimi nke mbụ na-ebugharị n'ụzọ abụọ: Kimi API (kimi-k3) na atụmatụ koodu Kimi Code (OAuth na igodo API). OmniRoute bụkwa ọrụ isi iyi mepere emepe nke Brazil mbụ na mmemme nkwado Kimi. Nweta igodo API Kimi nwere 15% mgbakwunye kredit →

Cheaper Inference
_{cheaperinference.com} Ekele dịrị Cheaper Inference, Enyi OmniRoute Na-emeghe Isi Iyi, maka ịkwado ọrụ a! Cheaper Inference bụ ọnụ ụzọ ámá nwere ọnụ ahịa dị ọnụ ala nke na-ere ihe nlereanya ókèala 42 — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok na MiniMax — n'azụ otu njedebe dakọtara na OpenAI, na-ebugharị arịrịọ ọ bụla gaa na onye na-enye ọrụ kacha ọnụ ala na-akwụghị ụgwọ karịa ọnụ ahịa ndepụta onye na-emepụta ihe nlereanya.

Nkwado nke mbụ na OmniRoute: Nkwụsị Nkata, njedebe /v1/responses ala, ọhụụ, oku ngwaọrụ na ihe nlereanya onyonyo 3 (grok-imagine, nano-banana-pro, nano-banana-2, enwere ike iru dị ka cheaperinference/<model>). Nweta igodo API →

_{Njikọ akara aff=omniroute bụ njikọ mmekọ. Ha na-enye ọrụ ahụ ego na-enweghị ụgwọ ọ bụla ọzọ nye gị.}

_{🎟️ Mgbasa Ozi Ndị Mmekọ — kupọọn ndebanye aha n'efu sitere n'aka ndị na-enye ọrụ anyị na-adịghị akwado (pịa ka ịgbasa)}

_{Ngalaba a bụ maka koodu ntụnye aka/kupọọn naanị. Mmekọrịta nkwado dị na 🤝 Ndị Enyi Anyị Na-emeghe Isi Iyi Na-akwado n'elu. OmniRoute enweghị nkwado ma ọ bụ mmekọrịta ya na ndị na-enye ọrụ edepụtara ebe a — ndị a bụ kupọọn ọha onye ọ bụla nwere ike iji.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — ndebanye aha mmekọ · $100 kredit n'efu na ndebanye aha (ihe nkesa n'efu, tụọ anya oge nkwụsị dị elu — kacha mma maka nnwale, ọ bụghị mmepụta). Nkwado nke mbụ na OmniRoute kemgbe v3.8.50: Nkwụsị Nkata, usoro waya dakọtara na Anthropic na ụzọ dakọtara na OpenAI. Ihe nlereanya dị gụnyere claude-opus-4-8, claude-opus-5, gpt-5.6-sol na ndị ọzọ. Nweta $100 gị →}

_{⚠️ Njikọ mmekọ — OmniRoute enweghị nkwado ma ọ bụ mmekọrịta ya na onye na-enye ọrụ a.}

_{Ị ma onye na-enye ọrụ ọzọ nwere kupọọn ndebanye aha n'efu na-emesapụ aka nke na-abara ndị ọrụ OmniRoute uru? Mepee okwu anyị ga-agbakwunye ya ebe a.}

## 🎯 Combos — Nke Kachasị Pụta Ihe

Ọmụmaatụ mmegharị maka usoro ntụgharị combo 18 n'ime 20 — otu taịlị maka usoro ọ 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, lkgp, auto, fusion, pipeline. E meghị mmegharị maka cache-optimized na quota-weighted; tebụl dị n'okpuru na-akọwa ha niile 20.

> **Combo** bụ usoro ụdịdị AI nke OmniRoute na-agafe n'etiti ha **na-akpaghị aka**. Ọ bụrụ na oke ojiji agwụ, onye na-eweta ọrụ daa, ma ọ bụ ọnụahịa rịa elu, combo nwere ike ịgafe na ụdị AI ọzọ tozuru oke ma dị mma. 🛡️ ### ⚡ Enweghị nhazi — naanị jiri `auto` Ọ dịghị combo ị ga-emepụta. Tọọ ụdị AI gị ka ọ bụrụ `auto` (ma ọ bụ otu n'ime ụdị ya), OmniRoute ga-emepụta combo mebere site n'aka ndị na-eweta ọrụ ị jikọtara, ma na-enye ha akara ozugbo:

NJ ụdị AI	Ihe ọ na-eme ka ọ kacha mma
`auto`	🎯 Nhazi ndabara ziri ezi (LKGP — na-arapara n'ahụ onye na-eweta ọrụ ikpeazụ rụrụ ọrụ nke ọma)
`auto/coding`	🧑💻 Arọ ndị na-ebute ogo ụzọ maka imepụta koodu
`auto/fast`	⚡ Nke nwere oge nchere kacha nta ụzọ
`auto/cheap`	💰 Nke dị ọnụ ala kacha nta kwa token ụzọ
`auto/subscription`	🎟️ Naanị oke ojiji nke ndebanye aha ị na-akwụlarị — ọ ga-akwụsị ma ọ bụrụ na nke ahụ adịghị, ọ gaghị eji nhọrọ ndabere a na-akwụ ụgwọ mgbe ọ bụla (ntuziaka)
`auto/thrifty`	🪜 Oke ojiji nke atụmatụ ụzọ, emesịa otu ọkwa n'otu oge ruo na nhọrọ ndị a na-akwụ ụgwọ dị ọnụ ala kacha nta — laghachi n'atụmatụ ahụ mgbe e tọgharịrị ya (ntuziaka)
`auto/offline`	🔋 Nke nwere ohere fọdụrụ kachasị n'oke ojiji / oke ọsọ ụzọ
`auto/smart`	🔭 Ogo ụzọ + nyocha 10% iji chọpụta ụdị AI ndị ka mma
`auto/lkgp`	📌 Ịrapara n'ahụ onye na-eweta ọrụ ikpeazụ amaara na ọ dị mma n'ụzọ doro anya
`auto/chaos`	🧪 Iziga arịrịọ n'otu oge gaa n'ìgwè ụdị AI (otu maka onye na-eweta ọrụ ọ bụla, 5 na ndabara), wee weghachite otu azịza; otu oku upstream maka ụdị AI ọ bụla dị n'ìgwè ahụ, ọ bụghị itinye ntụpọ n'ọrụ

## ### 🔀 Ma ọ bụ mepụta nke gị — usoro ntụgharị 20 Usoro **20** niile — gwakọta ma dakọtara ha na nzọụkwụ combo ọ bụla:

#	Usoro	Ihe ọ na-eme
1	`priority`	Ndepụta ahaziri nke na-ebute ebe izizi ụzọ — mefuo nke ọ bụla tupu ịgafe na nke ọzọ 🥇
2	`fill-first`	Jiri oke ojiji nke ebe ọ bụla ruo n'uju tupu ịgafe n'ihu
3	`weighted`	Nhọrọ enweghị usoro nwere arọ dịka arọ nke ebe ọ bụla si dị
4	`round-robin`	Gafee ebe ndị ahụ n'usoro ugboro ugboro
5	`p2c`	Ịhazigharị ibu na-enweghị usoro site n'ike nhọrọ abụọ
6	`least-used`	Họrọ ebe nwere ibu dị ugbu a kacha nta
7	`random`	Nhọrọ enweghị usoro nwere ohere hà nhata (ewepụla oyiri)
8	`strict-random`	Nhọrọ enweghị usoro na-ewepụghị ihe ndị pụtara ugboro ugboro 🎲
9	`cost-optimized`	Belata $ kwa arịrịọ site n'ọnụahịa katalọgụ dị ugbu a 💸
10	`headroom`	Họrọ ebe nwere oke ojiji fọdụrụ kacha ukwuu
11	`quota-weighted`	Mafee akaụntụ ndị oke ojiji ha gwụrụ, emesịa họrọ dịka oke ojiji fọdụrụ ÷ ibu arịrịọ ndị a na-ahazi si dị — mkparịta ụka ndị dị adị ga-anọgide n'ebe e kegidere ha ⚖️
12	`reset-window`	Họrọ ụzọ ebe windo oke ojiji ya ga-atọgharị ngwa ngwa karịa
13	`reset-aware`	Hazie dịka oge ntọgharị oke ojiji si dị — windo dị mkpụmkpụ ụzọ 📊
14	`context-relay`	Nyefee ọnọdụ n'etiti ebe dị iche iche maka mkparịta ụka ogologo 🧠
15	`context-optimized`	Họrọ nke kacha dabara nha ọnọdụ dị ugbu a
16	`cache-optimized`	Kegide mbido prompt ọ bụla enwere ike iji ọzọ n'otu akaụntụ ahụ — mee ka ọnụọgụ prompt-cache hits kacha elu 🎯
17	`lkgp`	Ụzọ Ikpeazụ Amaara na Ọ Dị Mma — na-ekegide ya n'onye na-eweta ọrụ ikpeazụ gara nke ọma, emesịa jiri iwu dịka nhọrọ ndabere
18	`auto`	Inye akara ozugbo site n'ihe 16 n'ofe njikọ niile 🤖
19	`fusion`	Ziga arịrịọ n'otu oge gaa n'ìgwè ụdị AI + onye ọkaikpe na-ejikọta ha ka ha bụrụ otu azịza 🧬
20	`pipeline`	Jikọta nzọụkwụ n'usoro — mmepụta nke ebe ọ bụla na-abanye na nke na-esote 🔗

_{Igwe Auto-Combo na-enye onye ọ bụla a na-atụle akara dabere na **ihe 16** (ọnọdụ arụmọrụ, oke ojiji, ọnụ ahịa, oge nzaghachi, ndakọrịta na ọrụ, ogo, nnweta nnọkọ…) — lee [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 E wuru nkwụsi ike n'ime ya (ọkwa 3 nọọrọ onwe ha)

Nkwụsi ike OmniRoute — ọkwa 3 nọọrọ onwe ha nke na-agwọ onwe ha, ebe ọkwa kwesịrị ekwesị na-edozi ọdịda kwesịrị ekwesị. Ọkwa 1 bụ ihe nkwụsị sekit nke onye na-eweta ọrụ (onye na-eweta ọrụ dum): ọ na-arụ ọrụ naanị na 408/5xx, oke ya bụ OAuth 8× / API-key 12× / local 2×, ọ na-amalitegharị mgbe 60s/30s/15s gachara banye na nnwale HALF-OPEN, mgbake na-eme naanị mgbe achọrọ ya; mgbe ọ nọ na OPEN, combo na-ebuga arịrịọ ahụ na onye na-eweta ọrụ na-esote. Ọkwa 2 bụ oge nchere njikọ (otu igodo/akaụntụ): ntọala bụ 5s OAuth / 3s API-key, oge ndaghachi na-abawanye n'ụzọ eksponenshial ×2 yana nchedo megide ọtụtụ arịrịọ ibido n'otu oge, 429 na-asọpụrụ Retry-After, ihe ịga nke ọma na-ehichapụ ọnọdụ njehie niile; a na-amafere otu igodo nọ n'oge nchere ebe igodo ndị ibe ya na-aga n'ihu na-enye ọrụ. Ọkwa 3 bụ mkpọchi model (otu model): 429 nke otu model, local 404 ma ọ bụ mmachibido mode na-akpọchi naanị model ahụ — ọ bụghị njikọ ahụ dum ma ọlị. Ọnọdụ njedebe (amachibidoro, kubie ume, kredit agwụla) bụ maka onye na-ahụ maka sistemụ, ọ bụghị oge nchere.

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

## 🏆 Ihe Na-eme OmniRoute Ka Ọ Dị Iche

_{📊 Usoro 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 Ọhụrụ

> Isi ihe ndị ọhụrụ sitere na **v3.8.20 → v3.8.54**. Akụkọ zuru ezu dị na [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Usoro ntụgharị `quota-weighted`** — atụmatụ combo nke iri abụọ na-ezere akaụntụ ndị quota ha agwụla, wee họrọ n’etiti ndị fọdụrụ dabere na leftover quota ÷ ibu dị na arịrịọ na-aga, na-eme ka mkparịta ụka dị adị nọgide n’otu ebe. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Ọnọdụ na-enweghị UI** — `omniroute serve --headless` (ma ọ bụ `OMNIROUTE_HEADLESS=1`) na-agba naanị engine proxy `/v1/*`, ebe dashboard na subsistem ndị dashboard naanị na-anọchi. → [Ọnọdụ na-enweghị UI](docs/guides/HEADLESS.md) - **🔎 Ịchọpụta model** — `/v1/models` na-enyocha site n’ikike, context, ụdị na ederede, ebe `POST /v1/models/query` na-ewepụta ndepụta dị mkpirikpi nke nwere usoro doro anya yana otu visibiliti kwa-key ahụ. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🔑 Njikwa ntụgharị kwa-key** — jiri `forcedModel` kpọchie API key n’otu model ma ọ bụ combo, ma tinye ma ọ bụ wepụ model na combo nke key n’otu ọrụ (`/api/keys/{id}/access`). → [Ntụaka API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Njikwa PII nke ọma karị** — nhọrọ kwa-ụdị, ruo n’ụdị masking omenala 20 a kwadoro, yana counters nchọpụta kwa-ụdị; masking n’onwe ya ka bụ nke a ga-ahọrọ. → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 Asụsụ 67** — dashboard, mirrors nke docs na CLI, ebe `npm run i18n:add-locale` na-agbakwunye asụsụ n’ebe niile site n’otu iwu. → [Ntuziaka i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — inyefe ọrụ A2A na-abata n’ìgwè agents gị, nka Conductor dị na Agent Card, yana panel dashboard nwere mkparịta ụka olu Faro push-to-talk. → [Sava A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Ịnabata arịrịọ na-agbanwe agbanwe na nchedo ibu karịrị akarị** — arịrịọ chat dị arọ na-abanye n’ahịrị kama ịlaghachi na 503, yana atomic RPM rolling leases kwa njikọ. → [Ntuziaka Resilience](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Usoro canonical nke `/v1/models`** — otu ngọngọ na-aga n’usoro, nke a chịkọtara kwa-provider (combos na-abịa mbụ), ma kwụsie ike n’agbanyeghị ebe catalog si abịa. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🗜️ Ịkwalite nchedo compression** — inflation guard na-arụ ọrụ na ndabara, Caveman packs maka DE / FR / JA na Chinese (wényán), yana RTK filters maka Gradle na .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Ọnụ ego flat-rate ziri ezi** — providers subscription / coding-plan na-egosi **$0** na cost analytics; budget, quota na ntụgharị ka na-eme atụmatụ. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **⚖️ Ntugharị Quota-Share** — kewaa quota nke shared account n’ezi nha n’etiti pooled keys, na-eji akụrụngwa eme ihe nke ọma ka e wee gbazinye slices na-adịghị arụ ọrụ. → [Ntuziaka Resilience](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Nhazi CLI/agent site n’otu iwu** — iwu `setup-*` 15 e debanyere aha; `omniroute run` na-ebido CLIs 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` na-akwado targets 11 nwere onye họrọ provider+model na-emekọrịta ihe yana ọkacha mmasị kwa-context. → [Njikọ CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Ọnọdụ remote** — jiri tokens nwere oke (`connect` / `contexts` / `tokens`) chịkwaa OmniRoute dị remote, tinyekwa onye enyemaka OAuth `antigravity` maka nrụnye VPS. → [Ọnọdụ Remote](docs/guides/REMOTE-MODE.md) - **🧭 Auto-routing ka mma** — combos `auto/:`, **Fusion** (model panel + judge), ntụgharị nke maara ọrụ, na overrides kwa-arịrịọ maka model / mode / USD-budget. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Compression nwere ike ịgbakwunye engines** — engines 12 nwere ike ijikọta yana Compression Studios: LLMLingua-2, Ultra nwere tier abụọ, omniglyph, per-step fidelity gate, GCF v3.2, na drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ MITM decrypt doro anya (TPROXY)** — capture CLIs ndị na-eleghara proxy env vars anya, yana onye nrụnye CA kwa-SNI na 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 ego echekwara site na cache-HIT, yana quotas mmefu USD kwa-key. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🧠 Memory ị na-achịkwa** — ọ naghị arụ ọrụ na ndabara, opt-in int8 vector quantization + typed decay, yana `x-omniroute-no-memory` kwa-arịrịọ. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Nchekwa** — prompt-injection guard n’ụzọ LLM ọ bụla (red-team suite), credential-masking guardrail nke a ga-ahọrọ (na-ewepụ API keys/secrets ndị pụtara n’amaghị ama n’akụkụ abụọ), web search DuckDuckGo n’efu maka oge ikpeazụ, yana nhọrọ OIDC login gate maka dashboard (password login 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 media surface zuo oke. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🎨 Ịmepụta image / video / audio** — otu API maka media: xAI Grok Imagine na Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, na providers okwu dị ka ElevenLabs. → [Ntụaka API](docs/reference/API_REFERENCE.md) - **🌍 Nnyefe na ops** — `basePath` reverse-proxy, nchọpụta asụsụ browser na-akpaghị aka, nsuso ngwaọrụ kwa-key, MITM trust na-enweghị root, na localization zh-TW. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Providers na agents ndị ọzọ** — cloud agents (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) nwere browser + OAuth login, kaadị Ollama nke mbụ, Claude Opus 5 na Sonnet 5, mmekọrịta gọọmentị Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… yana catalog **388-provider** emezigharịrị. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Nghọta ntụgharị** — nzaghachi ọ bụla na-ebu header `X-OmniRoute-Decision` nke na-akpọ aha strategy/provider/latency nke nyere ya ọrụ, atụmatụ combo `cache-optimized` ọhụrụ + ihe `cacheAffinity` nke Auto-Combo na-ezighachi arịrịọ ndị a na-eme ugboro ugboro na connection nwere cached prefix, ebe endpoint `/v1/auto-combo/{channel}/candidates` nke naanị ịgụ na-egosi pool candidates dị ndụ nke channel `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Ọrụ ngwa ngwa mpaghara & akụrụngwa** — Redis mpaghara eji otu pịa, ndị na-ebubata relay Cloudflare Workers / Deno Deploy, yana Bifrost & Mux dị ka ọrụ agbakwunyere a na-elekọta. → [Ọrụ Agbakwunyere](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Ọ dịkwa n’ime ngwugwu** — usoro plugin + ahịa, usoro nka Omni/Agent/GitHub, njikọta Obsidian vault (ngwaọrụ MCP 22), API Batch & Files dakọtara na OpenAI, cache nzaghachi semantic, gamification nwere tebụl ọkwa, nchọpụta ndị nnọchi anya ACP (ndị nnọchi anya 15 arụnyere n’ime), mbupụ log ahaziri ahazi gaa BigQuery, `auto/chaos` nkesa ụdị dị iche iche n’otu oge, njikọ bot Telegram, onye njikwa ụdị n’ime ngwa, yana ọkwa ndị na-enye ọrụ n’efu LMArena-ELO. → [Akwụkwọ Nkọwa](docs/README.md)

## 🤖 CLI & Ndị Nrụpụta Koodu kwekọrọ > Otu nhazi — `http://localhost:20128/v1` — na **AI IDE** ma ọ bụ CLI ọ bụla na-agba ọsọ na ụdị n'efu & ọ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ụ OpenAI kwekọrọ ọ bụla

_{📖 Nhazi ngwá ọrụ ọ bụla n’ime ngwá ọrụ 39 niile (28 CLI Code + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Malite CLI ọ bụla a na-akwado site na OmniRoute n’otu iwu** — enweghị faịlụ nhazi e dere, akwụkwọ ikike na-etinye n’ime usoro ọ bụla, Qwen/Gemini na-enweta ebe obibi dị iche iche nke oge: ```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+nlereanya n’aka na dee nhazi ngwá ọrụ ahụ: omniroute configure codex # kwa: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Iwu ọ bụla na-asọpụrụ ọnọdụ njikọ dị ugbu a (`omniroute connect `), `--dry-run` na-egosi kpọmkwem gburugburu/argụments tupu eme ihe, na `--api-key-env NAME` na-echekwa ihe nzuzo n’akụkọ ihe omume shell gị. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 Ndị na-eweta AI 388 — 153 akara katalọgụ n’efu

> **Ndị na-eweta ọrụ 388 edebanyere aha** n’ofe nchịkọta chat, media, ọchụchọ, mpaghara, cloud-agent na sistemụ nke canonical, gụnyere **153 nwere metadata nchọpụta `hasFree: true`**. Ndebanye aha ụdị chat ahụ kpuchiri **ndị na-eweta ọrụ 239 / njikọ ndị na-eweta ọrụ na ụdị 3,059 pụrụ iche / NJ ụdị raw 1,475**; katalọgụ mmefu n’efu dị iche nwere **ahịrị kwa ụdị 471**, **ọdọ ego na-emegharị 34** na **ndị na-eweta ọrụ 52 na-enye n’efu ruo mgbe ebighị ebi na-emegharị ma ọ bụ na-achọghị igodo**. Ndị a bụ denomineta dị iche iche n’ụzọ e mere ha; nkọwa na ngụkọta ndị e wepụrụ mmegharị ọdọ ego dị na [Ntụaka Ndị Na-eweta Ọ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ị 350 — akara ngosi niile na-enweta nsonaazụ ndụ site na katalọgụ ndị na-eweta ọrụ nke dashboard. 📖 [Ntụaka Ndị Na-eweta Ọrụ](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 N’efu Ruo Mgbe Ebighị Ebi — $0, kaadị adịghị mkpa

OpenCode Zen _{DeepSeek V4, Nemotron 3 Enweghị oke token}	Kilo Code _{Onye na-ahazi ụzọ na-akpaghị aka, 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 n'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 Ọ dịghị igodo achọrọ}	Cloudflare AI _{Ụdị 50+ Neurons 10K kwa ụbọchị}	NVIDIA NIM _{GLM, MiniMax RPM ~40 n'efu}	Cerebras _{GLM 4.7, GPT-OSS Ebe e si nweta $5 otu ugboro; achọrọ kaadị}	OpenRouter _{Ụdị :free +$10 → RPM dị elu karịa}

📖 Katalọgụ zuru ezu nke igwe nwere ike ịgụ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Ebe OmniRoute na-agba ọsọ - Ebe ọ bụla

> Otu ngwa, igwe gị, iwu gị. Site na npm zuru ụwa ọnụ wụnye ruo** ekwentị gị** site na Termux.

Platform	Wụnye	Isi ihe
📦 npm (global)	`npm wụnye -g omniroute`	Otu iwu, ọ bụla OS
⚡ Bun (global)	`bun tinye -g omniroute`	Otu ndekọ tarball, wụnye ngwa ngwa
🐳 Docker	`docker ọsọ … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm ọsọ eletrọn: wuo`	Native window + usoro tray — Windows / macOS / Linux
🎩 Menu-bar (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Na-elekọta & auto-emelite ihe nkesa - macOS
💪 ARM	nwa afọ `arm64`	Raspberry Pi, ARM sava, Apple Silicon
📱 gam akporo (Termux)	`pkg install nodejs && npx -y omniroute`	Na-agba na ekwentị gị , 24/7, enweghị mgbọrọgwụ
📲 PWA	"Tinye na ihuenyo ụlọ"	Ihuenyo zuru ezu, na-anọghị n'ịntanetị, enwere ike itinye ya na ihe nchọgharị
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Native OpenCode mwekota
🤖 VS Koodu Copilot Mkparịta ụka	wụnye OmniCopilot ndọtị	Ụdị OmniRoute ọ bụla na nwa afọ Copilot Chat picker — stable & Insiders
🛠️ Site na isi iyi	`npm wụnye && npm ọsọ dev`	Anataghị ikike na ya, tinye

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

### 🧩 Ọhụrụ: OmniRoute n'ime VS Koodu Copilot nkata

> Ọ nweghị sidebar ọhụrụ, enweghị nkata ọhụrụ UI - ụdị OmniRoute ọ bụla na-eje ozi na-egosi na ya**Copilot Chat nlereanya ị na-ejibu** . Kemgbe koodu VS 1.122, ụdị ndị na-eweta ọrụ na-arụ ọrụ na-enweghị nbanye GitHub ma ọ bụ ndenye aha Copilot — ụdị nnọchite, ọkpụkpọ oku na ọhụụ, n'efu. Wụnye ya** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** ndọtị, tụọ ya na ihe nkesa OmniRoute gị (ndabere na `localhost:20128`), wee mepee Copilot Chat → ụdị picker →** Jikwaa Ụdị…** →**OmniRoute** . < td align ="aka ekpe">VS Code — stable & Insiders < td align ="ekpe">Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro...

Ụlọ ahịa	Njikọ	Na-arụ ọrụ na
🧩 VS Code Marketplace	Wụnye →
🔓 VSX	Wụnye →

Site n'ime onye nchịkọta akụkọ: mepee** Mgbatị** ele, chọọ** "OmniRoute"** , pịa** Wụnye** - na-arụ ọrụ n'otu ụzọ ahụ na ụlọ ahịa abụọ ahụ. Isi mmalite, mbipụta na mbipụta runbook na-ebi na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Usoro Copilot Ntuziaka nkata](docs/guides/VSCODE-COPILOT.md) - ntọlite , ihe onye nhọpụta na-egosi, dashboard-in-a-tab, nchọpụta nsogbu}

### 🎩 Ọhụrụ: OmniRouteTray — ọnụ ụzọ ámá gị, na-ebi na mmanya menu

> `omniroute serve` na-enwe obi ụtọ mgbe ọ na-adị mgbe niile.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** na-atụgharị nke ahụ ka ọ bụrụ ngwa ntọala-na-echefu menu-bar maka macOS: ọ na-amalite ihe nkesa ahụ, na-eme ka ọ dị ndụ n'ofe reboots, na-emelite ya n'ọnọdụ, ma tinye mmefu ego gị dị ndụ otu pịa -** enweghị windo ọnụ nke mepere emepe, enweghị `npm install -g omniroute` ka ị na-elekọta ụmụaka.** Ewuru ya na [Tauri v2](https://v2.tauri.app/) (isi rust nke nha nke njehie okirikiri), ọ na-ebufe oge Node 24 bịanyere aka na ya ma na-ejikwa ngwa OmniRoute nwere ngwa, yabụ na ọ naghị alụ ọgụ `node`/`bun` zuru ụwa ọnụ. Ọ** na-ekekọrịta nhazi `~/.omniroute/` gị dị na nchekwa data** — ya mere, ọ bụ otu OmniRoute ị na-agba ọsọ, naanị na okpu. 🎩

Ihe ọ na-eme	Olee otú
🟢 Na-ahụ maka ihe nkesa	Spawns `omniroute serving` , na-ewere ihe atụ na-agba ọsọ kama ịmegharị ya
📊 Ojiji dị ndụ na ilele	Ogwe ndị na-enye ihe, oke Claude session/weekly nwere ngụgharị nrụpụta, nbibi ọnụ ahịa ụbọchị 30
🔄 Mmelite akpaaka dị na ebe	Nrụnye arụnyere, swap atomic, nlọghachi azụ na ọdịda - mgbe niile na mwepụta kachasị ọhụrụ
🚀 Malite na nbanye	Nhọrọ nhọrọ na nbanye; tray-naanị, enweghị akara dock
🩺 Dọkịta & ndekọ	Otu-pịa nchọpụta nchọpụta na ohere ihe nkesa

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{masịrị nbudata? Jidere .dmg kacha ọhụrụ site na
weputara . Isi mmalite, nsogbu na wuo
doc na-ebi na zoispag/omniroute-tray.

💛 Ọrụ ogbe nke @zoispag — ọbụghị ntọhapụ OmniRoute.}

## 🔒 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 ahịrị iwu zuru ezu** nwere **iwu 80+**, tinyere protocol ndị nnọchi anya mepere emepe ka onye nnọchi anya AI nwee ike ijikwa ya **n'onwe ya**. ### ⌨️ Ezigbo CLI (ọ bụghị naanị `start`) ```bash omniroute # nye gateway + dashboard ọrụ (ọdụ ụgbọ mmiri 20128) omniroute chat # onye ahịa nkata TUI mmekọrịta (slash: /model /combo /skill /memory) omniroute setup # ọkachamara nduzi maka ojiji mbụ omniroute doctor # chọpụta nsogbu ndị na-eweta ọrụ, ọdụ ụgbọ mmiri, na ndabere native ``` ### 🛰️ Ọnọdụ remote — gbaa CLI ebe a, OmniRoute na VPS OmniRoute ọ dị na sava? Jiri **otu CLI ahụ** si na laptọọpụ gị jikwaa ya. Banye otu ugboro site na token nnweta nwere oke; iwu ọ bụla ga-emesịa lekwasị anya na remote ahụ. ```bash omniroute connect 192.168.0.15 # okwuntughe → token nwere oke, echekwara dị ka context omniroute models # ← na-arụ ọrụ megide sava REMOTE omniroute configure codex # ← na-ahọrọ model remote, dee profaịlụ Codex n'ime ngwaọrụ gị omniroute tokens create --name ci --scope read # mepụta token nwere oke pere mpe maka igwe ndị ọzọ omniroute contexts use default # ← laghachi na sava dị n'ime ngwaọrụ gị ``` Token nwere oke `read` / `write` / `admin`; route ndị na-amalite process na-anọgide naanị na loopback. _{📖 [Ọnọdụ Remote](docs/guides/REMOTE-MODE.md)}

Ngosipụta terminal na-emegharị anya nke na-egosi OmniRoute CLI — omniroute providers list, omniroute combo list na omniroute health — na-agagharị n'elu iwu 89 dị na ọ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ọọ onye nnọchi anya — ọ ga-ejikwa OmniRoute n'onwe ya Kpughee OmniRoute site na **MCP**, **A2A**, **REST API**, **webhooks** ma ọ bụ **CLI remote** — onye nnọchi anya ọ bụla nwere ikike (ma ọ bụ code nke gị) ga-enweta igodo gateway ahụ dum: nhazi route, ndị na-eweta ọrụ, combo, cache, compression, memory — n'onwe ya. A na-enye endpoint HTTP ndị dị n'okpuru site na `http://localhost:20128`.

Interface	Endpoint / iwu	Ihe eji ya eme
🧰 MCP (stdio)	`omniroute --mcp`	Jikọọ ya na Claude Desktop, Cursor, ma ọ bụ onye ahịa MCP ọ bụla
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP remote — ngwaọrụ 110, oke 33 (ịmanye ha bụ nhọrọ), ndekọ audit zuru ezu
📡 MCP (SSE)	`/api/mcp/sse`	Ụzọ mbufe MCP na-aga n'ihu
🤝 A2A	`/.well-known/agent.json`	Site n'aka onye nnọchi anya gaa na onye nnọchi anya, JSON-RPC 2.0 + SSE, nkà 6
🌐 REST API	`/v1/*`	Dakọtara na OpenAI — nkata, embeddings, onyonyo, ọdịyo, OCR
🔔 Webhooks	`/api/webhooks`	Ziga request / quota event na Slack, Discord, Telegram ma ọ bụ URL ọ bụla
🛰️ CLI Remote	`omniroute connect`	Jiri token nnweta nwere oke jikwaa instance remote

```bash # Nye Claude Code ngwa ọrụ OmniRoute niile site na MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Sava MCP](docs/frameworks/MCP-SERVER.md) · [Sava A2A](docs/frameworks/A2A-SERVER.md) · [Protocol Ndị Nnọchi Anya](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Chekwaa Tokens 15–95% — Na-akpaghị aka

### 📖 Otu o si arụ ọrụ — pipeline, nhazi & mgbakọ ego echekwara

Pipeline mkpakọ OmniRoute: arịrịọ onye ahịa nwere tokens 10,000 na-agafe n’ime engines 12 nwere ike ijikọta — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra na OmniGlyph — ma nwee ike iru n’aka provider n’ihe dị ka tokens 1,080 n’ihe atụ a chịkọtara nke edepụtara. A na-echekwa ọdịnaya ahaziri ahazi site na nchekwa preservation na ọnụ ụzọ fidelity nke nzọụkwụ ọ bụla; ụdị ndị na-efunahụ ozi ma ọ bụ ndị a na-anwale n’ụzọ doro anya nwere ike ịgbanwe ọdịnaya ruru eru.

Default stacked combo na-agba `RTK → Caveman`. Mgbe ha abụọ na-arụ ọrụ n’otu payload tool/context, ego echekwara na-agbakọta: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` A na-echekwa code blocks, URLs, JSON na data ahaziri ahazi **mgbe niile** site na preservation engine. > **Gịnị mere eji tokens ọtụtụ mgbe tokens ole na ole nwere ike ime ọrụ ahụ?** Arịrịọ ọ bụla na-agafe n’ime compression pipeline nke OmniRoute **n’enweghị mgbanwe a na-ahụ anya** — enweghị mgbanwe n’aka onye ahịa. Ugbu a ọ bụ **ọtụtụ engines 12 nwere ike ijikọta** na-agba n’usoro ma na-agwakọta ha dabere na routing combo — na-ewulite n’elu 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). ### 🧱 Nhazi engines 12 Engines na-agba n’usoro pipeline; enwere ike ịgbanwuo ma ọ bụ gbanyụọ nke ọ bụla n’onwe ya, ma hazie ya maka combo ọ bụla:

#	Engine	Ihe ọ na-eme
1	Session-Dedup	Na-ewepụ ọdịnaya a na-emegharị n’etiti turns (content-addressed, cross-turn)
2	CCR	Na-edobe blocks buru ibu n’azụ retrieve markers, a na-enweta ha mgbe achọrọ
3	Lite	Mbelata whitespace + image-URL (baseline dị mfe n’ihe gbasara latency)
4	RTK	Nzacha nsonaazụ tool nwere ọgụgụ isi, dedup & truncation (maara command)
5	Responses Tool Output	JSON lossless-first + mkpakọ diagnostic nwere oke maka shell/patch/search/build outputs (Responses API)
6	Headroom	Mkpakọ tabular na-enweghị ọnwụ nke JSON arrays (~30%) site na codec GCF e webatara n’ime ya
7	Relevance	Ịgụ akara ahịrịokwu ndị a họpụtara dabere na ajụjụ onye ọrụ ikpeazụ
8	Caveman	Mkpakọ prose dabere na iwu (~65–75% na output)
9	Aggressive	Nchịkọta + ime ka turns ochie kaa nká nwayọọ nwayọọ
10	LLMLingua-2	ML semantic pruning site na MobileBERT ONNX — nchekwa code, async
11	Ultra	Mbelata tokens dabere na heuristics yana tier small-model (SLM) nhọrọ
12	OmniGlyph	Nnwale encoding context-as-image maka Claude Fable 5 a tụrụ na direct Anthropic wire; GPT 5.6 transformers ka na-eme fail-closed ruo mgbe e nwetara provider receipts. Compression profiles anọ (aggressive bụ nke ndabara, balanced, coding-safe, passthrough) (nke kacha aggressive; opt-in)

A na-echekwa code blocks, URLs na data ahaziri ahazi **mgbe niile** n’ụzọ byte-perfect. **One-click presets** na-ejikọta engines:

Ụdị	Ego echekwara	Kacha mma maka
🪶 Lite	~15%	Nhọrọ ndabara dị nchebe, na-arụ ọrụ mgbe niile
🪨 Standard (Caveman)	~30%	Coding kwa ụbọchị
⚡ Aggressive	~50%	Oge sessions tool dị ogologo ma jupụta
🔥 Ultra	~75%	Ego kacha ukwuu a ga-echekwa
🧰 RTK	60–90%	Shell/test/build/git output
🔗 Stacked (RTK → Caveman)	78–95%	Prompts agwakọtara + tool logs

**Ezigbo ihe atụ — Standard mode:** > **Tupu (tokens 69):** _"Ihe kpatara React component gị ji na-eme re-render nwere ike ịbụ na ị na-emepụta object reference ọhụrụ n’oge render cycle ọ bụla. Mgbe ị na-agafe inline object dị ka prop, shallow comparison nke React na-ahụ ya dị ka object dị iche oge ọ bụla, nke na-akpalite re-render. Aga m akwado iji useMemo mee ka object ahụ bụrụ memo."_ > > **Mgbe e mesịrị (tokens 19):** _"Object ref ọhụrụ na render ọ bụla. Inline object prop = ref ọhụrụ = re-render. Kechie ya na useMemo."_ > > **Otu azịza ahụ. Tokens pere mpe 72%. Enweghị ọnwụ ziri ezi ọ bụla.** ✅ **Ihe atụ PT-BR — [Troglodita](https://github.com/leninejunior/troglodita) mode:** > **Tupu (tokens 42):** _"Nsogbu bụ na akụrụngwa ahụ na-emegharị onwe ya n'ihi na a na-emepụta ntụaka ihe ọhụrụ n'oge ọ bụla a na-emegharị ya. Aga m akwado iji useMemo."_ > > **Mgbe e mesịrị (tokens 12):** _"Imegharị ọzọ: ntụaka ọhụrụ n'oge ọ bụla (a na-emegharị ihe inline). Jiri `useMemo`."_ > > **Azịza bụ otu. Ihe dịka 70% obere tokens. Nkọwa teknụzụ ka ziri ezi.** ✅
### 🎚️ Karịa engines — ụdị mmepụta, adaptive dial na njikwa kwa-arịrịọ Engines iri na abụọ dị n'elu na-ebelata ihe na-abanye. Oyi akwa atọ ọzọ na-akpụzi **otu**, **mgbe**, na ihe na-apụta: - **🪄 Ụdị Mmepụta** _(iduzi n'akụkụ mmepụta)_ — na-etinye ntuziaka na-akpụzi nzaghachi nke a pụrụ ịkọwapụta ma chekwaa na cache; a pụrụ ijikọta ha, nke ọ bụla nwere ike `lite` / `full` / `ultra`. Ịgbakwunye ụdị bụ naanị ntinye registry otu ahịrị: - **Prose dị mkpụmkpụ** — wepụ okwu jupụtara / articles / okwu na-egosi ejighị n'aka; debe ọdịnaya teknụzụ n'ụzọ ziri ezi. - **Koodu pere mpe** — YAGNI nke "senior dev umengwụ": mgbanwe kacha nta na-arụ ọrụ, enweghị scaffolding a na-arịọghị. - **Ponytail (senior dev umengwụ)** — rịgoro n'ọkwa YAGNI, dozie ihe kpatara nsogbu ahụ, jiri diff kacha nta na-arụ ọrụ. - **Enwere m ADHD (action-first)** — mee ihe ọzọ ka ọ bụrụ ụzọ mbụ, gụọ nzọụkwụ, nwee otu nzọụkwụ doro anya ọzọ, enweghị preamble. - **Terse CJK (文言)** — ụdị Chinese oge ochie dị mkpụmkpụ nke ukwuu (locale na-achịkwa ya, naanị maka `zh`). - **🎯 Mmefu mmefu context na-agbanwe agbanwe** _(dial)_ — kama otu oke token na-agbanye/gbanyụọ, bulie engines ndị dị ọnụ ala ma na-efunahụ obere ihe naanị ruo n'ókè achọrọ iji **daba n'ime windo context nke model**. Iwu: `reserve-output` (ndabara, maara model) · `percentage` · `absolute`. Ọnọdụ: `floor` (jide n'aka na ọ dabara) · `replace-autotrigger` (nhọrọ gị doro anya na-emeri) · `off` (oke ochie). - **🎛️ Ebe a na-ekpebi mkpakọ** _(usoro ịdị elu, elu → ala)_ — isi `x-omniroute-compression` kwa-arịrịọ › routing-combo override › active named profile › adaptive / auto-trigger › panel default › off. Plan etinyere na-alaghachi na response header `X-OmniRoute-Compression: ; source=`. Kpalite ya na token threshold, gbanwee adaptive dial, tinye named profile, hazie otu arịrịọ, ma ọ bụ kenye pipeline maka routing combo — nke ọ bụla dabara workload ahụ. **eval harness** offline nke a na-ahọrọ iji ya (`npm run eval:compression`) na-atụle ntụkwasị obi megide uru nchekwa na corpus a họpụtara tupu ị kwalite mgbanwe. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Mbido Ngwa Ngwa

**1) Wụnye ma gbaa ọsọ** ```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 ka ọhụrụ?** npm nwere ike igbochi lifecycle scripts nke package ma ọ bụrụ na enyeghị ha ikike. OmniRoute's `postinstall` (`node scripts/build/postinstall.mjs`) dị mkpa iji kwadebe faịlụ native runtime ya. Kwe ka packages ndị akpọrọ na ịdọ aka ná ntị npm mgbe ị na-eji global install. Maka package set nke OmniRoute 3.8.54 kọrọ: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Iji listi ikike a ọzọ maka global installs n'ọdịnihu, hazie ya otu ugboro, wee wụnye ya 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 releases; ọ bụrụ na npm kọọ ndepụta dị iche, jiri aha package ndị dị na ịdọ aka ná ntị ahụ. Ikwe ka package nweta ikike na-enye ohere ka install scripts ya gbaa ọsọ. > **Ị na-eji Gemini Web ma ọ bụ web-cookie provider ọzọ?** npm package nwere > Playwright mana ọ naghị etinye Chromium binary ya. Lee > [nhazi Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > tupu ị mee arịrịọ web-provider nke mbụ. Dashboard dị na `http://localhost:20128` · API dị na `http://localhost:20128/v1`. **2) Jikọọ provider tozuru etozu site na akaụntụ nke gị** Dashboard → **Providers** → họrọ provider nke terms na quota ya ugbu a dabara n'iji gị → tinye API key ya ma ọ bụ mechaa usoro akaụntụ ya. Free tiers nwere ike ịchọ signup, nkwado, ma ọ bụ payment method. Nyochaa [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md); availability na-enweghị key anaghị ekwe nkwa, a na-ewepụkwa providers akara `tos: avoid` na `auto` na ndabara. **3) Tụọ coding tool gị aka** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (na-atụgharị n'etiti njikọ tozuru etozu — ma ọ bụ họrọ 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ọtara ka edepụtara. 🎉 Ọ bụ ya — bido ide koodu, OmniRoute ga-ahazi routing ma jiri fallback maka gị na akpaghị aka. Ọ bụrụ na client gị enweghị ike izipu custom headers, OmniRoute na-enyekwa tokenized compatibility aliases: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Jiri ndị a naanị maka clients na-enweghị ike itinye `Authorization: Bearer ...`. Header auth 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

_{Foto mberede nke dashboard na 2026-10-18 · Katalọgụ izizi: YT 1.352 | TT 334 | IG 290 · Ịdị ọhụrụ (ụbọchị): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — nlele 3,042,474}

🎬 #2 — Instagram
_{nnapier7 — nlele 1,454,535}

🎬 #3 — YouTube
_{Amidia AI & Tech — nlele 794,974}

🎬 #4 — Instagram
_{theopenstack — nlele 692,419}

🎬 #5 — TikTok
_{migue.baena — nlele 685,788}

**Ndepụta ọkwa zuru ezu (URL iwu nke ewepụla 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** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Metrik iwu na 2026-10-18: **vidiyo pụrụ iche 1.976** · **nlele amaara 20.220.289** (`v > 0`) · **ọwa/profaịlụ 1.210 n’otu netwọkụ**. Dashboard izizi nwere ahịrị 1.976 (YouTube 1.352 = vidiyo ogologo 740 + Shorts 612 · TikTok 334 · Instagram 290); ọ dịghị oyiri fọdụrụ mgbe emezichara ha site na URL iwu, nke na-edobe ọnụọgụ kachasị elu maka vidiyo ọ bụla. A kwụsịrị mkpokọta data YouTube na 2026-10-13 (oke ojiji API gwụrụ site na 14 ruo 18/10), ebe TikTok/Instagram kwụsịrị kemgbe 2026-09-02 (kredit mkpokọta data adịghị); vidiyo 76 ka enweghị ọnụọgụ nlele. > 🎬 **Ị mepụtara 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.

# 📧 Ogbe & Enyemaka > Ihe niile n’otu ebe — soro onye na-elekọta ọrụ ahụ, kparịta ụka na ndị ogbe, ma ọ bụ mepee nsogbu. | Ọwa | Ebe / otu esi enweta | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | 💼 **LinkedIn** — soro onye na-elekọta ya | [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** | [sonye n'òtù ahụ](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Weebụsaịtị** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Obodo StHub OmniRoute (n'efu)** | [ọnụ ụzọ sthub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Koodu isi 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ọ e si akwado ↑](#-support-omniroute) · [Ndị Nkwado GitHub](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Ngwá Ọrụ Teknụzụ

Oyi akwa	Teknụzụ
Oge ịrụ ọrụ	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Asụsụ	TypeScript 6.0 — 100% TypeScript n'ofe `src/` na `open-sse/` (`any` efu na 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) — modul ngalaba 147, mbugharị 233
Ụdị ebe nchekwa	SQLite FTS5 ọchụchọ ederede zuru ezu + ntinye vector int8-quantized, mbelata nwere ụdị
Schemas	Zod 4 — nkwado MCP tool I/O + nkwekọrịta API
Usoro nkwukọrịta	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Mbufe na-aga n'ihu	Ihe omume Server-Sent (SSE) + njikọ WebSocket (`/v1/ws`)
Mkpokọta	pipeline injin 12 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Nyocha njirimara & nchekwa	OAuth 2.0 (PKCE) + JWT + Igodo API + MCP scoped auth · AES-256-GCM mgbe echekwara · DOMPurify
Nzuzo	wreq-js — nṅomi akara mkpịsị aka JA3 / JA4 TLS, proxy ọkwa 3
Ịnagide ọdịda	Ihe na-egbochi okirikiri, nlọghachi na-abawanye n'usoro exponential, mgbochi thundering-herd, auto-combo na-agwọ onwe ya
Ndekọ	pino — ndekọ JSON ahaziri ahazi nwere ọnọdụ arịrịọ
Nnwale	Node.js test runner + Vitest — nkwupụta nnwale static karịrị 60,000 n'ofe faịlụ nnwale karịrị 8,400 a na-enyocha (unit, integration, E2E, security, ecosystem)
Platform	Kọmputa desktọpụ (Electron) · Android (Termux) · PWA (ihe nchọgharị ọ bụla)
CI/CD	GitHub Actions — mbipụta npm na-akpaghị aka + Docker Hub mgbe ewepụtara
Njikọ	Weebụsaịtị · npm · Docker Hub

## 📖 Akwụkwọ Ntuziaka

### 📘 Ịmalite

Akwụkwọ	Nkọwa
Ntuziaka Onye Ọrụ	Providers, combos, njikọta CLI, deployment
Ntuziaka Ntọlite	Ụzọ nrụnye zuru ezu, nhazi ngwaọrụ CLI, ntọlite protocol, mmezi timeout
Ntuziaka Ngwaọrụ CLI	Ntọlite maka ngwa ọ bụla nke Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Ụdị Remote	Jiri laptop CLI gị chịkwaa OmniRoute dị remote (VPS) site na access tokens nwere oke
Nhazi Claude Code	Tụnyere Claude Code na OmniRoute (local/remote) site na `launch` + profaịlụ kwa model
Ịmalite Ngwa ngwa	Nzọụkwụ 3: wụnye → jikọọ → hazie

### 🔧 Ọrụ na Deployment

Akwụkwọ	Nkọwa
Ntuziaka Docker	Docker run, profaịlụ Compose, Caddy HTTPS, tunnels, image tags
Ntuziaka Podman	Njikọ Quadlet systemd, podman-compose, SELinux
Deployment VM	Ntuziaka zuru ezu: nhazi VM + nginx + Cloudflare
Deployment Fly.io	Bugharịa na Fly.io site na nchekwa na-adịgide adịgide
Ntuziaka Termux	Jiri Termux mee OmniRoute na Android
Ntuziaka PWA	Nrụnye Progressive Web App, caching, architecture
Ntuziaka Iwepụ	Iwepụ nke ọma maka ụzọ nrụnye niile
Nhazi Environment	Variables na ntụaka `.env` niile

### 🧠 Atụmatụ na Architecture

Akwụkwọ	Nkọwa
Architecture	Architecture sistemụ, nt流 data, na ime sistemụ
Ntuziaka Compression	Pipeline nhọrọ 7: off / lite / standard / aggressive / ultra / RTK / stacked
RTK Compression	Compression nke command-output, filters, ntụkwasị obi, verify, iweghachite raw-output
Compression Engines	Caveman, RTK, pipelines stacked, dashboard/API/MCP surfaces
Usoro Compression Rules	JSON rule-pack schemas maka Caveman na RTK filters
Language Packs Compression	Nchọpụta asụsụ na ide Caveman rule-pack
Ntuziaka Resilience	Circuit breakers, cooldowns, queue, mgbochi thundering herd, TLS spoofing
Auto-Combo Engine	Ntụle ihe 16, mode packs, self-healing
Ntuziaka Proxy	Sistemụ proxy ọkwa 3, ahịa 1proxy, registry CRUD
Free Tiers	Akwụkwọ ndekọ jikọtara ọnụ: pools 34 a na-edekọ ugboro ugboro / entries free-tier 465 e depụtara
Gallery Atụmatụ	Njem dashboard a na-ahụ anya nwere screenshots
Akwụkwọ Codebase	Nkọwa codebase dị mfe maka ndị mbido

### 🤖 Protocols na APIs

Akwụkwọ	Nkọwa
Ntụaka API	Endpoints niile nwere ihe atụ
Nkọwapụta OpenAPI	Nkọwapụta OpenAPI 3.0
MCP Server	Ngwaọrụ MCP 110, nhazi IDE, ndị ahịa Python/TS/Go
Ntuziaka MCP Server	Nrụnye MCP, transports, na ntụaka ngwaọrụ
A2A Server	Protocol JSON-RPC 2.0, skills, streaming, njikwa ọrụ
Ntuziaka A2A Server	Kaadị agent A2A, ọrụ, skills, na streaming

### 📋 Ọrụ Project na Ogo

Akwụkwọ	Nkọwa
Inye aka	Ntọlite mmepe na ụkpụrụ nduzi
Ụdị nkewa na mwepụta	Ebe PRs na-aga (`release/*`), ihe `main` na mkpado pụtara
Ndekọ mgbanwe	Akụkọ mwepụta zuru ezu maka ụdị ọ bụla
Iwu nchekwa	Ịkọ akụkọ adịghị ike na omume nchekwa
Ntuziaka i18n	Nkwado asụsụ 67, usoro ntụgharị asụsụ, RTL
Ndepụta nlele mwepụta	Nzọụkwụ nkwenye tupu mwepụta
Atụmatụ mkpuchi	Usoro mkpuchi ule maka nkwupụta ule static karịrị 60,000 n'ofe faịlụ ule 8,400+ a na-enyocha

# ⭐ Ndị nyere aka kacha > Obodo open-source nwere ịnụ ọkụ n'obi na-akpụzi OmniRoute. Ndị a enyela onyinye pụrụ iche na-emetụta ogo, nkwụsi ike, na iru ọrụ ahụ ozugbo. **Daalụ.** ### Ndị nyere aka si n'èzí dịka pull requests ndị a jikọtara

Ọkwa	Onye nyere aka	PRs ejikọtara	~Ahịrị gbanwere
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Emere ngụkọ na 2026-11-03 03:01:19 UTC site na isi ndụ release/v3.8.53 05bc048d6c. Ngụkọ GitHub GraphQL nwere ibe nwere 9,947 PRs ejikọtara: 4,130 sitere n'aka onye nwe ebe nchekwa ahụ, 240 sitere n'aka Dependabot, 6 sitere n'aka bots/apps ndị ọzọ, yana 5,571 PRs sitere n'èzí sitere n'aka ndị nyere aka 883 dị iche iche. “Ahịrị gbanwere” bụ mgbakwunye + mwepụ nke GitHub, ma gụnyere faịlụ emepụtara, lockfiles, katalọgụ, ntụgharị asụsụ na akwụkwọ; ọ bụ churn, ọ bụghị LOC onye dere. PRs 53 kọrọ ọdịiche GitHub karịrị ahịrị 500,000 (dịka #13399, otu mgbakwunye provider, depụtara faịlụ 2,347 gbanwere), nke na-eme ka ngụkọta ụfọdụ dị n'elu bawanye. A na-ahọpụta ndị nwere nha nhata ọnụ.} ### Commits ndị GitHub nyere aha atribushọn

Dizzle _{🥇 418 kọmiti GitHub kenyere}	Bob.Hou _{🥈 294 kọmiti GitHub kenyere}	Paijo _{🥉 229 kọmiti GitHub kenyere}	Paco Cartones _{🏅 222 kọmiti GitHub kenyere}	backryun _{🏅 202 kọmiti GitHub kenyere}	Jan Leon _{🏅 134 kọmiti GitHub kenyere}
Ravi Tharuma _{🏅 126 kọmiti GitHub kenyere}	Markus Hartung _{🏅 115 kọmiti GitHub kenyere}	Randi _{🏅 108 kọmiti GitHub kenyere}	Chris _{🏅 70 kọmiti GitHub kenyere}	WebPerson _{🏅 68 kọmiti GitHub kenyere}	Koosha Paridehpour _{🏅 68 kọmiti GitHub kenyere}

_{Enyochagharịrị na 2026-11-03 02:09:16 UTC: Kọmiti GitHub kenyere nke API Contributors nke ebe nchekwa ahụ kọrọ maka alaka ndabara release/v3.8.53. API ahụ weghachiri njirimara 903 (ndị ọrụ 429, bots 2, ndị amaghị aha 472); tebụl a ewepụla onye na-elekọta ya, bots na ndị amaghị aha, ma debe nhata asọmpi. Ọ dị iche na nhọpụta PR ndị ejikọtara n'elu nakwa ngụkọta Git-metadata dị n'okpuru.} > 🙏 Atụmatụ, ndozi njehie, na ndozi akụrụngwa nke ndị nyere aka a bụ **akụkụ bụ isi** nke ihe na-eme ka OmniRoute bụrụ nke a pụrụ ịtụkwasị obi ma juputara n’ọrụ. Arịrịọ pull ọ bụla, ikpe ule ọ bụla, na faịlụ ntụgharị i18n ọ bụla dị mkpa. Ndị dị ka ha na-ewu sọftụwia mepere emepe.

---
## 💖 Ndị Nkwado

Ekele sitere n’obi nye ndị ji ego si n’akpa ha akwado OmniRoute — onyinye ọ bụla na-eme ka ọrụ a nọgide bụrụ n’efu, nwee nnwere onwe ma na-aga n’ihu.

Andrew _{💛 Onye nkwado kwa ọnwa ka na-arụ ọrụ}	Vlad I _{💛 Onye nkwado kwa ọnwa ka na-arụ ọrụ}	小妍儿 _{💛 Onye nkwado kwa ọnwa ka na-arụ ọrụ}	Guilherme Costa _{💛 Onye nkwado otu ugboro ka na-arụ ọrụ}	Henrique Iurkiv _{💛 Onye nkwado otu ugboro ka na-arụ ọrụ}	Somesh Ghaturle _{💛 Onye nkwado otu ugboro ka na-arụ ọrụ}
Kolonie AI _{💛 Onye nyere nkwado otu ugboro n’oge gara aga}	Prof. Igor Morais _{💛 Onye nyere nkwado otu ugboro n’oge gara aga}	Pixma _{💛 Onye nyere nkwado otu ugboro n’oge gara aga}	Paco Cartones _{💛 Onye nyere nkwado otu ugboro n’oge gara aga}	longtao _{💛 Onye nyere nkwado otu ugboro n’oge gara aga}

_{… na ndị ọzọ họọrọ ka a ghara ikpughe aha ha 💛} _{E nyochaghachiri ndị nkwado GitHub ọha na 2026-10-18 site na GitHub Sponsors GraphQL API: nkwado ọha 11 (6 ka na-arụ ọrụ, 5 bụ nke gara aga) n’ime 14 n’ozuzu. Ọnọdụ isActive nke GitHub na-ekpebi akara ndị ka na-arụ ọrụ dị n’elu; a ka na-ekele ndị nkwado ọha nyere onyinye otu ugboro n’oge gara aga, ebe ndị nkwado nzuzo ka na-anọgide n’amaghị aha. E depụtaghị onyinye sitere na Ko-fi, Buy Me a Coffee, Liberapay, PIX na crypto n’ihi na ha enweghị ndekọ onye nkwado ọha.} 💖 Bụrụ onye nkwado → — dollar ọ bụla na-eme ka OmniRoute nọgide bụrụ n’efu ma nwee nnwere onwe.

## 👥 Ndị na-enye aka karịrị 1,000

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Enyochara ya na 2026-11-02 na ndụ release/v3.8.53 tip 1c7135e0fb (commit 7,972): njirimara mmadụ Git ahaziri ahazi 1,074 — 759 pụtara dị ka ndị dere commit (gụnyere onye na-elekọta ya), ebe 315 pụtara naanị na trailers Co-authored-by doro anya. Ngụkọ a na-etinye .mailmap n'ọrụ, na-atụnyere adreesị e-mail n'agbanyeghị mkpụrụedemede ukwu ma ọ bụ nta, na-ejikọta adreesị GitHub noreply nwere ọnụọgụ na nke nkịtị naanị mgbe ha na-egosi handle otu, na-ewepụ njirimara bot/agent/service/placeholder 29, ma ọ naghị ejikọta adreesị e-mail nkịtị naanị n'ihi na aha ngosi ha dabara. Nnyocha nke 2026-08-24 bipụtara 639; ịmegharị usoro a na isi ac02c5b42f nke nyocha ahụ nyere 619, ya mere mmụba ahụ sitere n'aka ndị na-enye aka ọhụrụ, ọ bụghị n'ihi usoro dị mfe karị.} ### Otu esi enye aka 1. Mepụta fork nke repository 2. Mepụta branch site na tip `release/vX.Y.Z` **na-arụ ọrụ** (ọ bụghị `main`) — lee [Ụdị Branching na Mwepụta](docs/ops/BRANCHING_MODEL.md) 3. Mepụta feature branch gị (`git checkout -b feat/amazing-feature`) 4. Commit mgbanwe gị (`git commit -m 'feat: add amazing feature'`) 5. Push gaa na branch ahụ (`git push origin feat/amazing-feature`) 6. Mepee Pull Request nwere **base = branch `release/vX.Y.Z` ahụ** Lee [CONTRIBUTING.md](CONTRIBUTING.md) maka ntuziaka zuru ezu. ### Ịwepụta Ụdị Ọhụrụ ```bash # Mepụta mwepụta — npm publish na-eme na-akpaghị aka VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Kpakpando

## 🌍 StarMapper

## 🙏 Ekele

OmniRoute guzoro n'ubu ndị nnukwu ndị bu ya ụzọ. Ọ malitere dị ka fork nke **[9router](https://github.com/decolua/9router)** na port TypeScript nke ọrụ Go bụ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — sitekwa n'ebe ahụ, subsystem ọ bụla dị n'okpuru sitere n'ike mmụọ nsọ ọrụ open-source nke bu ụzọ rute ebe ahụ. Nke ọ bụla nyere aka ịhazi akụkụ doro anya nke OmniRoute. Nke a bụ ekele anyị nye ha niile. 🙏 > ⭐ A kwadoro ọnụọgụ kpakpando site na GitHub REST API na Nọvemba 3, 2026 — gaa nye ọrụ ndị a niile kpakpando. Ọnụọgụ ndị a bụ snapshot ziri ezi nke ụbọchị ahụ, ha ga-agbanwekwa ka oge na-aga. ### 🧬 Usoro nketa & gateway

Ọrụ	⭐	Otu o si kpalie OmniRoute
9router	31,861	Ọrụ mbụ e wuru fork a na ya — a gbasaa ya ebe a site na multi-modal APIs na idegharị ya kpamkpam na TypeScript.
CLIProxyAPI	57,329	Mmejuputa Go nke kpaliri port JavaScript / TypeScript a.
LiteLLM	62,580	AI gateway nke dataset ọnụahịa ọha ya na-enye sync nlekọta ọnụ ahịa anyị nri, ebe ụdị nhazi ndị na-eweta ọrụ ya nyere aka n'ịhazi routing anyị.
codex-chatgpt-web	15,435	MIT source a gbanwere ka ọ bụrụ ChatGPT Web → Codex Responses bridge nke vendor nwere, tinyere browser-session, response-framing, usage na web-search adapters.
free-claude-code	65,966	Ụkpụrụ e bufere n'ime stream recovery, no-thinking aliases, fallback web search, sliding-window limits, log redaction na hardened launcher flows.
composer-api	347	Ụkpụrụ Cursor Composer tool-choice, output-constraint na tool-commit ka e mere ka ha kwekọọ n'ime native Cursor executor.
codex-multi-auth	561	Ụkpụrụ fresh-login na refresh-token rotation e bufere n'ime Codex OAuth reauthentication.
opencode-anthropic-auth	562	Claude Code-compatible transform defaults na omume billing-header ka e gbasaa n'ime bridge OmniRoute nke config na-achịkwa.
grok2api-merged	2	Grok model mappings ya, fake-TypeError Statsig generator, request na device defaults, na NDJSON response processor ka e jiri n'ụzọ dị ukwuu hazie OmniRoute's Grok Web executor.
TQZHR/grok2api	707	Ọ bụ isi transitive code source dị n'azụ grok2api-merged; model, header, payload, Statsig na processor implementations ya ka echekwara n'usoro nketa Grok Web.
chenyme/grok2api	7,874	MIT source dị n'okpuru maka Grok payload na device defaults, Statsig generator, na processor `result.response` nke gafere na TQZHR na grok2api-merged.
grok2api-pro	27	Ọ bụ transitive source nke grok2api-merged kwuru maka proxy-pool layer ya; OmniRoute na-echekwa ọkwa nketa ahụ mana ọ naghị ekwu na ọ bufere proxy-pool n'ime Grok Web executor ya nwere oke.
GrokProxy	52	Cookie-authenticated Grok proxy ya na usoro `result.response.token` streaming nyere aka n'ịhazi Grok Web transport nke OmniRoute.
GrokBridge	5	A nyochara HTTP/browser upstream design nke mmejuputa Grok Web mbụ ya; direct HTTP path ya sitere na GrokProxy, ya mere a naghị ekwu na e bufere code ya n'onwe ya.

### 🗜️ Ọnọdụ gburugburu & mkpakọ token — injin

Ọrụ	⭐	Otu o si kpalie OmniRoute
Caveman	116,957	Ọrụ a ma ama nke nwere echiche “gịnị mere iji ọtụtụ token mgbe obere token nwere ike ịrụ ọrụ” — nkà ihe ọmụma asụsụ caveman ya na-akwado ọnọdụ mkpakọ ọkọlọtọ anyị na iwu 30+ maka iwepụ okwu jupụtara na ọdịnaya na ịkpụkọta ya.
RTK – Rust Token Killer	85,350	Mkpakọ mmepụta iwu na-arụ ọrụ nke ukwuu — o kpaliri engine RTK anyị, JSON filter DSL, iweghachite raw output na pipeline RTK → Caveman nke a chịkọtara.
headroom	78,672	Mkpakọ context nwere ike ịtụgharị azụ (SmartCrusher) — o kpaliri engine `headroom` anyị na usoro retrieve-marker `ccr`.
LLMLingua	6,797	Nchọpụta mkpakọ prompt (LLMLingua / LLMLingua-2) — o kpaliri engine `llmlingua` anyị nke na-arụ ọrụ async, na-echekwa code, ma na-ahapụ ọdịda ka ọ gafee n'enweghị nkwụsị.
llmlingua-2-js	33	Port JS/ONNX (MobileBERT / XLM-RoBERTa) a na-eji dị ka backend worker-thread maka engine LLMLingua anyị.
Troglodita	50	Mkpakọ token PT-BR — ọ na-akwado ngwugwu asụsụ pt-BR anyị: mbelata pleonasm na iwepụ okwu jupụtara na ọdịnaya nke a haziri maka ụtọasụsụ Portuguese nke Brazil.
ponytail	182,929	Nkà YAGNI-coder nke “lazy senior dev” a ma ama — o kpaliri ụdị mmepụta less-code anyị: nduzi na-eme mgbanwe kacha nta nke na-arụ ọrụ, nke na-ebelata _koodu emepụtara_ (nwanne axis mmepụta nke prose dị mkpụmkpụ Caveman).
i-have-adhd	59,838	Ụdị nzaghachi ya nke na-ebute omume ụzọ ma bụrụ enyi ADHD ka e mere ka ọ bụrụ akụkụ nke ụdị mmepụta dị mkpirikpi OmniRoute n'asụsụ ise.

### 🧩 Usoro dị mkpirikpi, nchọpụta token na ngwaọrụ maara code

Ọrụ	⭐	Otu o si kpalie OmniRoute
TOON	25,602	Token-Oriented Object Notation — ụdị ya nke kọlụm, nke nwere header na ahịrị, kpara ọkwa tabular compaction anyị.
GCF – Graph Compact Format	61	Ụdị graph ya dị mkpirikpi na atụmatụ generic-profile nyere ozi maka tabular compaction na ụdị Headroom codec nke OmniRoute.
gcf-typescript	4	Implementation TypeScript MIT ahụ ka e tinyere ozugbo ma gbasaa ya ka ọ bụrụ codec generic-profile Headroom.
token-optimizer-mcp	566	Cache Brotli/SQLite yana context-delta kwa session — o kpaliri engine `session-dedup` anyị.
token-savior	1,203	Mkpakọ Bash-output yana MCP profiles — o kpaliri usoro ịkwụsị mkpakọ mgbe uru ya ezughị na mbelata MCP tool-manifest.
token-saver	162	Mkpakọ mmepụta maara ọdịnaya, nke a na-eme kwa ụdị faịlụ, yana ịkwụsị mgbe ọdịda mere — o gosipụtara na per-type dispatch na minimum-gain skip anyị ziri ezi.
token-optimizer	2,853	“Chọta ghost tokens” — usoro offload + recoverable-handle ya nyere echiche maka CCR offload anyị.
TokenMizer	34	Blueprint session-graph + cross-turn line-dedup nke nyere ozi maka nhazi session-dedup anyị.
OmniCompress	3	Rust columnar-JSON + content-addressed retrieve + cross-message dedup — o gosipụtara na nhazi engine `headroom`/`ccr`/`session-dedup` anyị ziri ezi na invariant cache-stable nke na-ekwu na “compressed form is position-independent”.
mcp-compressor	140	Mkpakọ MCP tool-schema/description — o nyere ozi maka mbelata cardinality nke MCP tool-manifest anyị.
RepoMapper	218	Nhazi ọkwa repo-map nke ụdị Aider — o nyere ozi maka nyocha repo-map / retrieval-ranking anyị.
quiet-shell-mcp	4	Mbelata shell-output nke declarative n'elu MCP — o gosipụtara na declarative bash-output compaction anyị ziri ezi.
ts-morph	6,222	Ngwaọrụ TypeScript Compiler API — o kpaliri iwepụ comments dabere na parser nke na-echekwa string, template na regex literals.

### 🧠 Ebe nchekwa & RAG

Ọrụ	⭐	Otu o siri kpalite OmniRoute
Mem0	68,294	Oyi akwa ebe nchekwa zuru ụwa ọnụ — ụdị proxy-as-write/read-boundary ya kpalitere nhazi ebe nchekwa anyị.
Letta (MemGPT)	25,321	Agents nwere ọnọdụ na ebe nchekwa nwere ọkwa — kpalitere ụdị Context Control & Recovery (CCR) nwere ọkwa anyị.
WFGY	1,804	Nhazi ProblemMap nke ụdị ọdịda RAG/LLM iri na isii na-emegharị ugboro ugboro — bụ okwu nkekọrịta dị na ntuziaka nchọpụta nsogbu anyị.

### 🛰️ Nyocha okporo ụzọ, MITM & proxy na-enweghị nghọta

Ọrụ	⭐	Otu o siri kpalite OmniRoute
llm-interceptor	81	Njide/nchịkọta MITM nke okporo ụzọ coding-assistant ↔ LLM nyere aka kọwaa ihe achọrọ mbụ maka Traffic Inspector. Modul anọ e si na ya nweta mbụ — ijikọta SSE, ịhazi mkparịta ụka n’ụdị kwekọrọ, izobe nzuzo na ihicha headers — ejiri mmejuputa nọọrọ onwe ha nke clean-room dochie, dabere na ụkpụrụ protocol ọha. Ebe abụọ host-passthrough (`passthrough.ts` na `_internal/bypass.cjs`) ka bụ mmejuputa dị n’ime OmniRoute nke a kewara iche; edegharịghị ha dịka akụkụ nke nnọchi ahụ.
ProxyBridge	6,978	Ntugharị proxy kwa-process nke na-enweghị nghọta — kpalitere mmechi MITM nke na-echebe pụọ n’ihe mberede, oge nkwụsị socket mgbe ọ naghị arụ ọrụ, njirimara process site na `/proc` na njide TPROXY anyị.

### 📚 Data model, nlele arụmọrụ & UI

Ọrụ	⭐	Otu o siri kpalite OmniRoute
models.dev	7,486	Ebe nchekwa data mepere emepe nke nkọwa, ọnụahịa na ikike model AI — a na-emekọrịta ya n’ime katalọgụ model anyị n’ụzọ ala nna.
React Flow / xyflow	38,874	Ọbá akwụkwọ graph dabere na nodes nke na-akwado Compression Studio na Combo/Routing Studio anyị n’oge dị adị.
LangGraph	44,349	Ngosipụta workflow-graph dị ndụ nke LangGraph Studio kpalitere nlele cascade nke Studios anyị n’oge dị adị.
Langfuse	36,907	Ụdị nlele arụmọrụ trace → span → generation ya kpụziri waterfall nke Compression Studio anyị.
Kiali	3,647	Nlele arụmọrụ Istio service-mesh — kpalitere akara circuit-breaker na ihe ngosi error-edge anyị na Routing/Combo Studio.
lobe-icons	2,666	Logo brand AI/LLM ndị na-egosi akara provider n’ofe dashboard anyị.
flag-icons	12,499	Ọ na-enye flags SVG nwere ikike MIT nke onye na-ahọrọ asụsụ README na-eji.

### 🛡️ Nchekwa

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

### 🧭 Ngwa ndị na-akwado ibe ha

Ọrụ	⭐	Otu o siri kpalite OmniRoute
ClawRouter	6,649	Kpalitere iwepụ arịrịọ ugboro abụọ, fallback mberede na-efu efu, atụmatụ Auto-Combo nwere ike ịgbakwunye na nhazi ebumnuche nwere ọtụtụ asụsụ.
Antigravity-Manager	32,785	Remapping model nke maara akaụntụ, nkwenye executable-path na omume plan-label ya nyere aka kpụzie runtime Antigravity nke OmniRoute.
vscode-antigravity-cockpit	4,852	Ụdị ngosipụta ngụkọ dị mkpirikpi ruo mgbe quota ga-emegharị kpalitere ngosipụta provider-limit kwekọrọ na OmniRoute.
AionUi	33,996	Njikọ ACP ya kpalitere nchọpụta akpaka nke CLI agents arụnyere na OmniRoute.
CodexBar	22,955	Ọ chọpụtara ebe quota Grok Build dị; OmniRoute mechara nyochaa ma dozie usoro wire dị ndụ n’onwe ya.

## 📄 Akwụkwọ ikike Akwụkwọ ikike MIT - hụ [LICENSE](LICENSE) maka nkọwa ndị ọzọ. ---

**[⬆ Laghachi n'elu](#-omniroute)** · Ejiri ❤️ wuo ya maka obodo AI mepere emepe. _{Ọ bụ Diego Souza kere ya · OmniRoute v3.8.54 · Node ≥22.22.2 · Akwụkwọ ikike MIT · omniroute.online}