# README (Yorùbá) 🌐 **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) · 🇳🇬 [ig](../ig/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) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Ẹnu-ọ̀nà AI Ọ̀fẹ́

OmniRoute — Má dá kíkọ kóòdù dúró láéláé. Gbogbo irinṣẹ́ AI → àwọn olùpèsè 372 — 150+ ọ̀fẹ́ — nípasẹ̀ ẹ̀ka ìbánisọ̀rọ̀ kan ṣoṣo. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity sínú Claude / GPT / Gemini Ọ̀FẸ́ pẹ̀lú ìyípadà aládàáṣiṣẹ́ nígbà ìkùnà. Ìpọ́npọ̀ RTK + Caveman tí a tò pọ̀ ń dín àwọn token kù ní 15–95% (~89% ní ìwọ̀n àárín) — má kọlu àwọn ààlà láéláé. Àwọn olùpèsè AI 372 · àwọn ìpele ọ̀fẹ́ 150+ · ~1.62B token ọ̀fẹ́/oṣù · àwọn ọgbọ́n ìdarí ọ̀nà 19 · $0 láti bẹ̀rẹ̀.

## 💰 ~1.62B Tókẹ́ẹ̀tì / Oṣù Láti Àwọn Ìpele Ọ̀fẹ́ Ẹnikẹta

> **Mú àwọn àkọọ́lẹ̀ olupèsè tirẹ wá.** Èyí jẹ́ àpapọ̀ ìṣírò láti inú àwọn ìpele ọ̀fẹ́ ẹnikẹta tí ẹnì kọ̀ọ̀kan lè yẹ fún lọ́tọ̀ọ̀tọ̀, kì í ṣe ìfúnni tókẹ́ẹ̀tì láti OmniRoute. Forúkọsílẹ̀, gba ẹ̀rí ìdánimọ̀ níbi tí a bá ti nílò rẹ̀, kí o sì so àwọn olupèsè tí o lè lò pọ̀; olupèsè kọ̀ọ̀kan ló ń ṣàkóso àwọn ààlà, wíwà-lárọwọ́tó, àti àwọn òfin rẹ̀. > > Ṣíṣe àkójọpọ̀ àwọn ìpele ọ̀fẹ́ pẹ̀lú ọwọ́ máa ń nira — ọ̀pọ̀lọpọ̀ SDK, ọ̀pọ̀lọpọ̀ ààlà ìbéèrè, tí kò sì sí ìmọ̀ iye tí o ní ní tòótọ́. OmniRoute ṣe àkójọ **àwọn àkọsílẹ̀ ìpele ọ̀fẹ́ 489 káàkiri àwọn kọ́kọ́rọ́ àkójọpọ̀ tó ń tún wáyé 35** ó sì ń ṣírò àkòrí tókẹ́ẹ̀tì láti inú **àwọn àkójọpọ̀ 17 tó ní ìnáwó oṣooṣù rere tí a tẹ̀ jáde, pẹ̀lú ààlà Groq márùn-ún fún awoṣe kọ̀ọ̀kan**, nípa yíyọ àwọn àkójọpọ̀ tí wọ́n pín pa pọ̀ kúrò nínú àtúnṣe. Àwọn iye tí a yọ̀ǹda tí kì í ṣí títí lẹ́yìn àyẹ̀wò ìdánimọ̀ ẹkùn (lónìí: ModelScope) ni a fi hàn lọ́tọ̀, +~6M lẹ́yìn ìjẹ́rìí ìdánimọ̀ ẹkùn, a kò sì kà wọ́n pọ̀ mọ́ àkòrí náà láéláé. Àbájáde náà máa ń hàn lórí pátákó ìṣàkóso (`/dashboard/free-tiers`).

Káàdì ìnáwó ìpele ọ̀fẹ́ OmniRoute: ~1.62B tókẹ́ẹ̀tì ọ̀fẹ́ lọ́ṣù ní ìwọ̀n tí ó dúró ṣinṣin, tó lè dé ~2.22B ní oṣù àkọ́kọ́ pẹ̀lú kírẹ́díìtì ìforúkọsílẹ̀, láti inú àwọn kọ́kọ́rọ́ àkójọpọ̀ tó ń tún wáyé 35 tí a ṣàkọsílẹ̀, tí wọ́n bo àwọn àkọsílẹ̀ ìpele ọ̀fẹ́ 489 tí a kó sínú àkójọ lẹ́yìn ibi ìwọlé kan. Ìṣirò olóòótọ́ tí a ti yọ àtúnṣe àkójọpọ̀ kúrò — a ka àkójọpọ̀ tí a pín kọ̀ọ̀kan lẹ́ẹ̀kan ṣoṣo, pẹ̀lú àwọn àkójọpọ̀ tó ń tún wáyé 17 tí ó ní ìnáwó tókẹ́ẹ̀tì oṣooṣù rere tí a tẹ̀ jáde, àti ààlà Groq márùn-ún fún awoṣe kọ̀ọ̀kan; a sàmì sí àwọn olupèsè 13 gẹ́gẹ́ bí èyí tí ó yẹ kí a yẹra fún nínú àkójọ ewu àwọn òfin, kí ìwọ lè pinnu. Ọ̀pá ìnáwó ní Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (ààlà márùn-ún fún awoṣe kọ̀ọ̀kan) àti àwọn àkójọpọ̀ kéékèèké, pẹ̀lú kírẹ́díìtì ìforúkọsílẹ̀ oṣù àkọ́kọ́ àti àwọn olupèsè ọ̀fẹ́ títí láé tí kò ní ààlà tókẹ́ẹ̀tì tí a fi hàn lọ́tọ̀, kí wọ́n má bàa mú àkòrí náà tóbi ju bó ṣe yẹ lọ. Ìlò/èyí tó kù ní àkókò gidi lórí /dashboard/free-tiers.

> Àkótán aláwòrán tí ń rìn ti ojú-ewé `/dashboard/free-tiers` ní àkókò gidi. Ọ̀nà ìṣirò ní ẹ̀kúnrẹ́rẹ́ (yíyọ àtúnṣe àkójọpọ̀ kúrò, àwọn ìpele kírẹ́díìtì, àwọn òfin olupèsè): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{A máa ń tún ṣàyẹ̀wò àwọn nọ́ńbà wọ̀nyí ní gbogbo ọ̀sẹ̀ méjì sí àkójọ tó wà ní àkókò gidi, wọ́n sì **lè lọ sókè tàbí sọ̀kalẹ̀** — bí olupèsè kan bá fòpin sí ìpele ọ̀fẹ́, nọ́ńbà náà á dín kù; bí tuntun bá dé, yóò pọ̀ sí i. Ohun tí àkójọ náà ṣírò ní tòótọ́ la ń tẹ̀ jáde, kì í ṣe ìṣírò ọ̀ràn tó dára jù lọ tí a mú ga.}

⭐ Fi ìràwọ̀ fún ibi ìpamọ́ náà bí OMNIROUTE bá ti ràn ọ́ lọ́wọ́ láti fi owó pamọ́ àti láti mú iṣẹ́ rẹ rọrùn.

[![Àwọn ìràwọ̀](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Ipò Ìtàn Ìràwọ̀](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) ### 💬 Darapọ̀ mọ́ àwùjọ náà **👋 Tẹ̀lé olùtọ́jú náà — jẹ́ ẹni àkọ́kọ́ láti gba àwọn olupèsè tuntun, àwọn ìtújáde àti àwọn ìmọ̀ràn:** [![Tẹ̀lé Diego lórí 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/) [![Tẹ̀lé @diegosouzapw lórí 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 Àgbáyé](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 Brasil](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) [![Ojú-òpó wẹ́ẹ̀bù](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Àwọn ìbéèrè, ìmọ̀ràn nípa olupèsè, ètò ọjọ́ iwájú àti àtìlẹ́yìn → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Àgbáyé](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](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)**
## 📈 Ẹnu-ọ̀nà Náà Ń Bá A Lọ Ní Dídàgbà

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ------------------------------------ | :----------------------: | :---------: | :--------------------: | | 🌐 Àwọn olupèsè | 352 | **358** | 372 | | 🧠 Àwọn ID àwòṣe ìfọ̀rọ̀wérọ̀ aláìlẹ́gbẹ́ | 1320 | **1374** | 1443 | | 🖼️ Afárá Modality | 🆕 ìríran + ohun + fídíò | ✓ | ✓ | | 📡 Àkójọ Radar ọ̀fẹ́ | 🆕 yíyàn-láti-wọlé | ✓ | ✓ | | ⚖️ Ìṣètò tó mọ iye ìpín | 🆕 Quota-Share | ✓ | ✓ | | 📊 Tẹlifíṣọ̀nù iye ìpín | 🆕 lọ́wọ́lọ́wọ́ | ✓ | ✓ | | 🧰 Ipò aláìní ojú-ìwòye | — | — | 🆕 `serve --headless` | | 🛤️ Amáyédẹrùn ipa-ọ̀nà LTS | — | — | 🆕 àwọn ikanni ìtújáde | **→ [Ètò Ọ̀nà](ROADMAP.md) — lílọ lórí ipa-ọ̀nà sí `v3.9.0 LTS`**

## 🧩 Ó Wà [![ẹ̀yà npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Oṣooṣù](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) [![Ìwé-àṣẹ: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Àwọn Ìgbàsílẹ̀ Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Àwọn Ìgbàsílẹ̀ Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Bẹ̀rẹ̀	🚀 Ìbẹ̀rẹ̀ Kíákíá	📦 Fi Sórí Ẹ̀rọ	🆓 Láìsí Àtòpọ̀
💡 Kọ́ Ẹ̀kọ́	💥 Ìlérí Náà	🤔 Kí Nìdí OmniRoute	🏆 Ohun Tó Mú Un Yàtọ̀
⚙️ Àwọn Ẹ̀ya	🎯 Àwọn Àpapọ̀	🌐 Àwọn Olùpèsè	🔌 CLI & MCP
	🗜️ Ìfunpọ̀	🖥️ Ibi Tó Ti N Ṣiṣẹ́	🔒 Àṣírí
👀 Wò Ó	🎬 Bí Ó Ṣe N Ṣiṣẹ́	✨ Ohun Tó Tún Wà	🤖 Àwọn CLI Tó Bá A Mu
💚 Àtìlẹ́yìn	💚 Ṣètìlẹ́yìn / Ṣètọrẹ	💬 Àwùjọ	💖 Àwọn Alágbàtọ́
📦 Iṣẹ́ Àkànṣe	🛠️ Àkójọpọ̀ Ìmọ̀ Ẹ̀rọ	📖 Ìwé Àlàyé	👥 Àwọn Olùkópa

🌐 Ní èdè 67

## 🆓 Fi sílẹ̀, so olùpèsè kan pọ̀, lẹ́yìn náà darí ìrìnàjò nípasẹ̀ ojú-ọ̀nà kan ṣoṣo

Ìgbésẹ̀ mẹ́ta: fi OmniRoute sílẹ̀ kí o sì bẹ̀rẹ̀ rẹ̀, so olùpèsè tó yẹ pọ̀ pẹ̀lú àkọọ́lẹ̀ tirẹ tàbí kọ́kọ́rọ́ API, lẹ́yìn náà tọ́ irinṣẹ́ rẹ sí localhost:20128/v1 ní lílo kọ́kọ́rọ́ API OmniRoute àti awoṣe auto. Ìdarí ìrìnàjò dá lórí àwọn ìsopọ̀ tó yẹ tí ó wà àti àwọn ààlà olùpèsè.

```bash # Lẹ́yìn tí o bá so olùpèsè kan pọ̀, da kọ́kọ́rọ́ OmniRoute rẹ láti 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` nílò ọ̀nà tó yẹ. Ìfisílẹ̀ tuntun lè má ní àwọn ibi-àfojúsùn aláìní-kọ́kọ́rọ́ tó yẹ, olùpèsè aláìní-kọ́kọ́rọ́ sì lè kọ àwọn oníbàárà ẹnikẹta. Àwọn olùpèsè tí a sàmì sí `tos: avoid`, tó fi mọ́ OpenCode Free àti Kiro, ni a yọ kúrò nínú ìdarí ìrìnàjò aládàáṣiṣẹ́ nípa àìròtẹ́lẹ̀; sísopọ̀ àkọọ́lẹ̀ kan kò ní borí ètò yẹn. Wo [Ìtọ́sọ́nà Àwọn Ìpele Ọ̀fẹ́](docs/getting-started/FREE-TIERS-GUIDE.md) kí o tó yan olùpèsè kan.} _{📦 Àwọn ìwé afọwọ́kọ ìbẹ̀rẹ̀-kíákíá tí o lè dà kọ́ lẹ́ẹ̀ mọ́ fún **Python, Node.js, PHP, àti cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Ìlérí Náà

# 🤔 Kí nìdí tí OmniRoute?

Ìṣàn ìbéèrè OmniRoute: IDE tàbí CLI rẹ (Claude Code, Cursor, Cline…) ń pe ojú-ọ̀nà agbègbè kan ṣoṣo (http://localhost:20128/v1); OmniRoute Smart Router (ìfúnpọ̀ RTK + Caveman, àwọn ọgbọ́n ìdarí ìrìnàjò 19, àwọn olùdádúró àyíká, ìfarapamọ́ TLS, MCP, A2A, àwọn ààbò) lè padà sẹ́yìn láàárín àwọn ìpele olùpèsè mẹ́rin níwọ̀n ìgbà tí ibi-àfojúsùn tó yẹ, tó sì ní ìlera bá ṣì wà — Ìpele 1 Subscription, Ìpele 2 API Key, Ìpele 3 Cheap àti Ìpele 4 Free.

## 🤝 Atilẹyin lati ọdọ Awọn Ọrẹ Orisun Ṣiṣi Wa

> **Ṣe o fẹ darapọ mọ bi Ọrẹ Orisun Ṣiṣi?** Iwọnyi ni awọn ile-iṣẹ ti o ṣe atilẹyin orisun ṣiṣi ati ṣe iranlọwọ lati jẹ ki OmniRoute n lọ — ati pe a sọ ni gbangba ibi ti gbogbo ami ti wọn fun wa ti lọ. Kan si wa: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} O ṣeun si Kimi (Moonshot AI), Ọrẹ Orisun Ṣiṣi oludasile wa, fun atilẹyin iṣẹ akanṣe yii! Kimi jẹ yàrá AI lẹhin awọn idile awoṣe K2 ati K3 ti o ni iwuwo ṣiṣi — Kimi K3 n pese window ipo 1M-token, iran abinibi ati koodu ipele aala ni ida kan ti awọn idiyele awoṣe pipade, ati pe o ṣiṣẹ ni ita apoti pẹlu Claude Code, Codex ati gbogbo ohun elo koodu ti OmniRoute n pese.

Kini atilẹyin Kimi n fun agbara: Awọn kirediti API Kimi n fun agbara opo gigun ti ifasilẹ ti OmniRoute ti AI-fọwọsi — ipele ijẹrisi iṣọkan ti o ni agbara nipasẹ Kimi K3 ti o ṣe atunyẹwo gbogbo ibeere ifamọra ṣaaju ki o to firanṣẹ — pẹlu idagbasoke ẹya ojoojumọ. Atilẹyin Kimi kilasi akọkọ n firanṣẹ lori awọn oju-irin mejeeji: taara Kimi API (kimi-k3) ati eto koodu Kimi Code (OAuth ati bọtini API). OmniRoute tun jẹ iṣẹ akanṣe orisun ṣiṣi akọkọ ti Brazil ninu eto atilẹyin Kimi. Gba bọtini API Kimi pẹlu 15% awọn kirediti afikun →

Inference ti o din owo
_{cheaperinference.com} O ṣeun si Inference ti o din owo, Ọrẹ Orisun Ṣiṣi OmniRoute, fun atilẹyin iṣẹ akanṣe yii! Inference ti o din owo jẹ ẹnu-ọna ti o ni idiyele idiyele ti o tun ta awọn awoṣe aala 42 — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ati MiniMax — lẹhin ipari-ojuami kan ti o ni ibamu pẹlu OpenAI, ti n ṣe ipa-ọna gbogbo ibeere si olupese ti o yẹ ti o din owo julọ laisi gbigba agbara ju idiyele atokọ ti olupilẹṣẹ awoṣe lọ.

Atilẹyin kilasi akọkọ ni OmniRoute: Awọn ipari iwiregbe, ipari-ojuami abinibi /v1/responses, iran, ipe ohun elo ati awọn awoṣe aworan 3 (grok-imagine, nano-banana-pro, nano-banana-2, ti o le de ọdọ bi cheaperinference/<model>). Gba bọtini API →

_{Awọn ọna asopọ ti a fi aami si aff=omniroute jẹ awọn ọna asopọ alabaṣepọ. Wọn ṣe inawo iṣẹ akanṣe laisi idiyele afikun si ọ.}

_{🎟️ Ipolowo Awọn alafaramo — awọn kuponu iforukọsilẹ ọfẹ lati ọdọ awọn olupese ti a ko ṣe onigbọwọ (tẹ lati faagun)}

_{Abala yii jẹ fun awọn koodu itọkasi/kuponu nikan. Awọn ajọṣepọ onigbọwọ wa ni 🤝 Atilẹyin lati ọdọ Awọn Ọrẹ Orisun Ṣiṣi Wa loke. OmniRoute ko ni onigbọwọ tabi ajọṣepọ pẹlu awọn olupese ti a ṣe akojọ si nibi — iwọnyi jẹ awọn kuponu gbangba ti ẹnikẹni le lo.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — iforukọsilẹ alafaramo · $100 awọn kirediti ọfẹ lori iforukọsilẹ (olupin ọfẹ, nireti idaduro ti o ga julọ — o dara julọ fun idanwo, kii ṣe iṣelọpọ). Atilẹyin kilasi akọkọ ni OmniRoute lati v3.8.50: Awọn ipari iwiregbe, ọna kika okun ti o ni ibamu pẹlu Anthropic ati ọna ti o ni ibamu pẹlu OpenAI. Awọn awoṣe ti o wa pẹlu claude-opus-4-8, claude-opus-5, gpt-5.6-sol ati diẹ sii. Gba $100 rẹ →}

_{⚠️ Ọna asopọ alafaramo — OmniRoute ko ni onigbọwọ tabi ajọṣepọ pẹlu olupese yii.}

_{Ṣe o mọ olupese miiran pẹlu kuponu iforukọsilẹ ọfẹ ti o ni inurere ti o ṣe anfani awọn olumulo OmniRoute? Ṣii ọran kan ati pe a yoo fi kun nibi.}

## 🎯 Àwọn Combo — Àkọ́kọ́ Pátápátá

Àwọn ọgbọ́n ìdarí combo mẹ́rìndínlógún [19] ní ìṣípò — àwo kan fún ọgbọ́n kọ̀ọ̀kan: 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. Wo tábìlì òkè fún ohun tí ọ̀kọ̀ọ̀kan ń ṣe.

> **Combo** jẹ́ ẹ̀wọ̀n àwọn model tí OmniRoute ń darí kọjá láàárín wọn **láìfọwọ́ṣe**. Bí quota bá tán, provider kan kùnà, tàbí iye owó bá ga lójijì, combo lè lọ sí model tó péye, tó sì ní ìlera tí ó tẹ̀lé. 🛡️ ### ⚡ Kò nílò àtòpọ̀ — kan lo `auto` Kò sí combo kankan láti ṣẹ̀dá. Ṣètò model rẹ sí `auto` (tàbí ọ̀kan lára àwọn ẹ̀yà rẹ̀), OmniRoute yóò sì kọ́ combo aláfojúṣe kan láti inú àwọn provider tí o ti sopọ̀, pẹ̀lú ìṣirò ààyè gidi:

ID Model	Ohun tí ó ń mú kí ó dára jù
`auto`	🎯 Ìwọ̀ntúnwọ̀nsì àìyípadà (LKGP — dúró mọ́ provider rere rẹ tó kẹ́yìn)
`auto/coding`	🧑💻 Ìwọ̀n tó fi dídára ṣáájú fún ṣíṣẹ̀dá kóòdù
`auto/fast`	⚡ Àkókò ìdádúró tó kéré jù lọ lákọ̀ọ́kọ́
`auto/cheap`	💰 Èyí tó din owó jù fún token kọ̀ọ̀kan lákọ̀ọ́kọ́
`auto/offline`	🔋 Quota / ààyè rate-limit tó pọ̀ jù lọ lákọ̀ọ́kọ́
`auto/smart`	🔭 Dídára lákọ̀ọ́kọ́ + ìṣàwárí 10% láti rí àwọn model tó dára jù
`auto/lkgp`	📌 Dídúró mọ́ provider rere tí a mọ̀ kẹ́yìn ní tààrà
`auto/chaos`	🧪 Pípín ìbéèrè lọ ní ìṣọ̀kan sí àkójọpọ̀ àwọn model (ọ̀kan fún provider kọ̀ọ̀kan, 5 ní àìyípadà), ó sì dá ìdáhùn kan padà; ìpè upstream kan fún model kọ̀ọ̀kan nínú àkójọpọ̀, kì í ṣe fífi àṣìṣe sínú ètò

## ### 🔀 Tàbí kọ tirẹ — àwọn ọgbọ́n ìdarí 19 Gbogbo ọgbọ́n **19** — dapọ̀ wọn bí o ṣe fẹ́ fún ìgbésẹ̀ combo kọ̀ọ̀kan:

#	Ọgbọ́n	Ohun tí ó ń ṣe
1	`priority`	Àtòjọ tí target àkọ́kọ́ ń ṣáájú — lo ọ̀kọ̀ọ̀kan tán kí o tó lọ sí èyí tó tẹ̀lé 🥇
2	`fill-first`	Lo quota target kọ̀ọ̀kan dé ẹ̀kúnrẹ́rẹ́ kí o tó tẹ̀síwájú
3	`weighted`	Yíyan láìlẹ́sẹ̀-n-lẹ̀ gẹ́gẹ́ bí ìwọ̀n target kọ̀ọ̀kan
4	`round-robin`	Yípo láàárín àwọn target ní ìtòlẹ́sẹẹsẹ
5	`p2c`	Pínpín ẹrù láìlẹ́sẹ̀-n-lẹ̀ pẹ̀lú agbára yíyan méjì
6	`least-used`	Yan target tó ní ẹrù lọ́wọ́lọ́wọ́ tó kéré jù
7	`random`	Yíyan láìlẹ́sẹ̀-n-lẹ̀ tó dọ́gba (pẹ̀lú yiyọ àwọn àtúnṣe kúrò)
8	`strict-random`	Yíyan láìlẹ́sẹ̀-n-lẹ̀ láìyọ àwọn àtúnṣe kúrò 🎲
9	`cost-optimized`	Dín $ fún ìbéèrè kọ̀ọ̀kan kù ní lílo iye owó àkójọ ọjà ààyè gidi 💸
10	`headroom`	Yan target tó ní quota tó pọ̀ jù lọ tó kù
11	`reset-window`	Fi target tí fèrèsé quota rẹ̀ máa tún bẹ̀rẹ̀ láìpẹ́ jù ṣáájú
12	`reset-aware`	Ṣètò gẹ́gẹ́ bí àkókò ìtúnrẹ̀ quota — àwọn fèrèsé kúkúrú lákọ̀ọ́kọ́ 📊
13	`context-relay`	Fi context lé àwọn target lọ́wọ́ láti ọ̀kan sí òmíràn fún ìjíròrò gígùn 🧠
14	`context-optimized`	Yan èyí tó bá ìwọ̀n context lọ́wọ́lọ́wọ́ mu jù
15	`cache-optimized`	Di ìbẹ̀rẹ̀ prompt kọ̀ọ̀kan tí a lè tún lò mọ́ account kan náà — mú kí lílu prompt-cache pọ̀ sí i 🎯
16	`lkgp`	Ọ̀nà Rere Tí A Mọ̀ Kẹ́yìn — di mọ́ provider tó ṣàṣeyọrí kẹ́yìn, lẹ́yìn náà ó padà sí àwọn òfin bí ó bá kùnà
17	`auto`	Ìṣirò ààyè gidi onípòkùnlé mẹ́rìndínlógún lórí gbogbo connection 🤖
18	`fusion`	Pín ìbéèrè sí àkójọpọ̀ àwọn model + adájọ́ kan ṣàkójọpọ̀ ìdáhùn kan 🧬
19	`pipeline`	So àwọn ìgbésẹ̀ pọ̀ — àbájáde target kọ̀ọ̀kan ń wọ èyí tó tẹ̀lé 🔗

_{Ẹ́ńjìnnì Auto-Combo ń ṣe ìṣirò olùdíje kọ̀ọ̀kan lórí **okùnfà 16** (ìlera, quota, iye owó, àkókò ìdádúró, ìbámu pẹ̀lú iṣẹ́, dídára, wíwà session…) — wo [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 A ti kọ́ agbára ìfaradà sínú rẹ̀ (ìpele olómìnira 3)

Ìfaradà OmniRoute — àwọn ipele ìmúpadàbọ̀ ara-ẹni olómìnira mẹ́ta, ipele tó yẹ fún ìkùnà tó yẹ. Ipele 1 olùdènà àyíká olùpèsè (gbogbo olùpèsè): ó máa ń dáwọ́ dúró lórí 408/5xx nìkan, àwọn ààlà OAuth 8× / API-key 12× / local 2×, ó máa ń tún ara rẹ̀ ṣe lẹ́yìn 60s/30s/15s sínú ìdánwò HALF-OPEN, ìmúpadàbọ̀ nígbà tí a bá nílò rẹ̀; nígbà tó wà ní OPEN, àkójọpọ̀ náà máa ń yí ìdarí sí olùpèsè tó kàn. Ipele 2 àkókò ìtutù àsopọ̀ (kọ́kọ́rọ́/àkọọ́lẹ̀ kan): ìpilẹ̀ 5s OAuth / 3s API-key, ìfàsẹ́yìn alágbára ×2 pẹ̀lú ààbò lòdì sí ìṣúra-ìbéèrè-lójijì, 429 máa ń tẹ̀lé Retry-After, àṣeyọrí máa ń pa gbogbo ipò àṣìṣe rẹ́; a máa ń foju kọ kọ́kọ́rọ́ kan tó ń tutù nígbà tí àwọn kọ́kọ́rọ́ ẹlẹgbẹ́ rẹ̀ ń bá a lọ láti ṣiṣẹ́. Ipele 3 ìdènà àwòṣe (àwòṣe kan): 429 fún àwòṣe kọ̀ọ̀kan, 404 local tàbí ìkọ̀sílẹ̀ mode máa ń ti àwòṣe yẹn nìkan pa — kì í ṣe gbogbo àsopọ̀ láéláé. Àwọn ipò ìparí (tí a fòfin dè, tí ó ti parí, tí kírẹ́díìtì ti tán) jẹ́ ti olùdarí, kì í ṣe fún àkókò ìtutù.

_{📖 [Ẹ̀rọ Auto-Combo](docs/routing/AUTO-COMBO.md) · [Ìtọ́sọ́nà Ìfaradà](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Ohun Tó Jẹ́ Kí OmniRoute Yàtọ̀

_{📊 Ìlànà ìṣètò kíkún & àlàyé ẹ̀ya kọ̀ọ̀kan ní ìfiwéra pẹ̀lú 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Ṣe Àtìlẹ́yìn fún OmniRoute OmniRoute ní ìwé-àṣẹ MIT, a sì ń tọ́jú rẹ̀ ní gbangba. Bí ó bá ń fi àkókò tàbí owó rẹ pamọ́, àwọn ọ̀nà tí o lè gbà jẹ́ kí ó wà ní òmìnira nìyí — yan èyíkéyìí tó bá ọ mu. Ìgbọ́wọ́ kò ní ipa lórí ààyò ìdarí láéláé; ó ń ra ìfarahàn, kì í ṣe ipò.

⭐ Fi ìràwọ̀ sí repo náà	Ọ̀fẹ́ — ó ń ṣèrànwọ́ fún ìfarahàn ní tòótọ́	Fi ìràwọ̀ sí OmniRoute
🐙 Àwọn Olùgbọ́wọ́ GitHub	Ẹ̀ẹ̀kan ṣoṣo tàbí lóṣooṣù · kò sí owó pẹpẹ	github.com/sponsors/diegosouzapw
☕ Ko-fi	Owó ọ̀rẹ́ ẹ̀ẹ̀kan ṣoṣo ní kíákíá, kò nílò ìforúkọsílẹ̀ fún olùfúnni	ko-fi.com/diegosouzapw
🧋 Ra kọ́fí kan fún mi	Ìṣe kékeré, tí kì í ṣe ti àjọṣe	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Tí ń ṣẹlẹ̀ léraléra · kì í ṣe fún èrè · orísun ṣíṣí	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Lẹ́sẹ̀kẹsẹ̀, kò sí owó iṣẹ́	kọ́kọ́rọ́ & QR wà nísàlẹ̀
₿ Crypto	BTC · ETH · USDT-TRC20 · USDC-Solana	àwọn àdírẹ́sì wà nísàlẹ̀

**🇧🇷 PIX** — lẹ́sẹ̀kẹsẹ̀, kò sí owó iṣẹ́ (Brazil) Kóòdù QR PIX OmniRoute

Kọ́kọ́rọ́ (àìròtẹ́lẹ̀): `5d865059-bc44-483a-962d-43ceb80126eb` Da Pix kọ, kí o sì lẹ̀ ẹ́ mọ́: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Crypto — BTC · ETH · USDT-TRC20 · USDC-Solana (tẹ̀ láti ṣí i)

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

_{⚠️ Fi owó kọ̀ọ̀kan ránṣẹ́ lórí network tí a fihàn nìkan — fífi ránṣẹ́ lórí network tí kò tọ́ lè mú kí owó náà sọnù.}

🐛 Ṣé o rí àṣìṣe kan tàbí o ní èsì? Ṣí [Ìjíròrò](https://github.com/diegosouzapw/OmniRoute/discussions) kan.

Àwọn àkọsílẹ̀ fún olùgbéejáde: Project náà lè ṣẹ̀dá fáìlì .env agbègbè kan nígbà npm install/postinstall láti mú iṣẹ́ rọrùn fún olùgbéejáde. A mọ̀ọ́mọ̀ foju fáìlì yìí kọjá nípasẹ̀ .gitignore (wo .gitignore), a kò sì gbọ́dọ̀ commit rẹ̀ láéláé — bí a bá commit rẹ̀ láìròtẹ́lẹ̀, yí gbogbo secrets tó fara hàn padà, kí o sì yọ fáìlì náà kúrò nínú ìtàn. Wo docs/DEVELOPER-ENVIRONMENT.md fún ìtọ́sọ́nà lórí bí a ṣe ń ṣàkóso àwọn fáìlì environment agbègbè àti secrets.

## 📡 Radar OmniRoute Àkọlé pàtàkì fún ìpele ọ̀fẹ́ ṣì jẹ́ **~1.62B àmì/oṣù** láti inú àkójọ tí a ṣàkọsílẹ̀ rẹ̀ lókè, tí a sì ti yọ àwọn ohun tó tún ara wọn ṣe nínú àkójọpọ̀ kúrò. Àwọn kirẹditi ìforúkọsílẹ̀ olùpèsè fún ìgbà díẹ̀ lè mú oṣù àkọ́kọ́ ga sí **~2.22B** lọ́tọ̀. Radar jẹ́ àfikún àkójọ tí a fọwọ́sí, tí lílò rẹ̀ sì jẹ́ àṣàyàn, fún àwọn tó fẹ́ ìsọfúnni tuntun sí i nípa wíwà àwọn àwòṣe ọ̀fẹ́ láàárín àwọn ìtújáde OmniRoute; àkójọ àwùjọ àti gbogbo àwọn ẹ̀yà ọ̀fẹ́ tó ti wà tẹ́lẹ̀ ṣì jẹ́ ọ̀fẹ́. Àwọn alátìlẹ́yìn lè gba àkójọ àkókò-gidi àti àwọn àǹfààní olùpèsè míì. Òkè ààlà rẹ̀ tó jẹ́ ọ̀tọ̀, tí ó sì lè yí padà, jẹ́ **ìwọ̀n 3B àmì/oṣù ní ó pọ̀ jù**, ó da lórí wíwà àwọn olùpèsè. Òkè ààlà yẹn kì í ṣe ìlérí: àwọn olùpèsè lè yí ìwọ̀n lílò, ìbéèrè yíyẹ, àwọn àwòṣe, tàbí àwọn ẹkùn padà nígbàkigbà. Lílò Radar jẹ́ àṣàyàn, GET nìkan sì ni ó ń lò. Oníbàárà OmniRoute kì í ṣe ìrùsókè àwọn àṣẹ, ìṣàn ìbéèrè, ààtò olùpèsè, tẹlifíṣọ̀nù lílò, tàbí ipò ìkọ̀sílẹ̀ ìkéde abẹ́lẹ̀. Kọ́ sí i nípa ìbéèrè yíyẹ àti àkójọ lọ́wọ́lọ́wọ́ ní **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Kí Ló Tuntun

> Àwọn àkíyèsí pàtàkì láìpẹ́ láti **v3.8.20 → v3.8.50**. Ìtàn kíkún wà nínú [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — fífi iṣẹ́ A2A tí ń wọlé lé ẹgbẹ́ àwọn agent rẹ lọ́wọ́, àwọn ọ̀nà ìṣiṣẹ́ Conductor lórí Agent Card, àti paneli dashboard kan pẹ̀lú ìfọ̀rọ̀wérọ̀ ohùn Faro push-to-talk. → [Sẹ́fà A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Ìgbàwọlé aláṣàmúlò & ààbò kúrò lọ́wọ́ ìrùpọ̀** — àwọn ìbéèrè chat tó wuwo máa ń dúró ní ìlà dípò kí wọ́n dá 503 padà, pẹ̀lú atomic RPM rolling leases fún ìsopọ̀ kọ̀ọ̀kan. → [Ìtọ́sọ́nà Resilience](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Ìṣètò Canonical `/v1/models`** — block kan ṣoṣo tí ó so pọ̀, tí a pín sí ẹgbẹ́ nípa provider, fún provider kọ̀ọ̀kan (àwọn combo tí a pin síwájú), tí ó sì dúró ṣinṣin káàkiri gbogbo orísun catalog. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) - **🗜️ Fífún compression lókun** — inflation guard tí ó ṣiṣẹ́ láìyípadà, àwọn pack Caveman fún DE / FR / JA + Chinese (wényán), àwọn filter RTK fún Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Iye owó flat-rate tí ó ṣe kedere** — àwọn provider subscription / coding-plan ń fi **$0** hàn nínú àyẹ̀wò iye owó; budget, quota & routing ṣì ń ṣe ìṣírò àfojúsùn. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) - **⚖️ Routing Quota-Share** — pín quota account tí a jọ ń lò lọ́nà tó dọ́gba láàárín àwọn key tí a kó jọ, ó sì ń lo gbogbo agbára tó wà nípa yíyá àwọn ìpín tí kò ṣiṣẹ́ fún àwọn mìíràn. → [Ìtọ́sọ́nà Resilience](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Ìṣètò CLI/agent pẹ̀lú command kan ṣoṣo** — àwọn command `setup-*` 13 tí a forúkọsílẹ̀; `omniroute run` ń bẹ̀rẹ̀ CLI 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` ṣe àtìlẹ́yìn fún target 10 pẹ̀lú olùyan provider+model alábáṣepọ̀ àti àwọn ààyò fún context kọ̀ọ̀kan. → [Àwọn Ìsopọ̀ CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Ipo remote** — darí OmniRoute remote kan pẹ̀lú àwọn token tí a fi scope sí (`connect` / `contexts` / `tokens`) + olùrànlọ́wọ́ OAuth `antigravity` fún àwọn ìfisílẹ̀ VPS. → [Ipo Remote](docs/guides/REMOTE-MODE.md) - **🧭 Auto-routing tó túbọ̀ gbọ́n** — àwọn combo `auto/:`, **Fusion** (panel model + judge), routing tó mọ irú iṣẹ́, àti àwọn override model / mode / USD-budget fún ìbéèrè kọ̀ọ̀kan. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Compression tí a lè so mọ́ ọn** — engine 12 tí a lè darapọ̀ + Compression Studios: LLMLingua-2, Ultra onípele méjì, omniglyph, fidelity gate fún ìgbésẹ̀ kọ̀ọ̀kan, GCF v3.2, olootu drag-reorder. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Ìtúpalẹ̀ MITM tó hàn gbangba (TPROXY)** — gba àwọn CLI tí kò ka proxy env vars sí, pẹ̀lú CA fún SNI kọ̀ọ̀kan + olùfisórí trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Cost telemetry níbi gbogbo** — àwọn header iye owó/lílo `X-OmniRoute-*` lórí gbogbo endpoint, header ìfipamọ́ cache-HIT, àti àwọn quota ìnáwó USD fún key kọ̀ọ̀kan. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) - **🧠 Memory tí ìwọ ń ṣàkóso** — kò ṣiṣẹ́ láìyípadà, int8 vector quantization tí a gbọdọ̀ yàn láti lò + typed decay, àti `x-omniroute-no-memory` fún ìbéèrè kọ̀ọ̀kan. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Ààbò** — prompt-injection guard lórí gbogbo route LLM (red-team suite), credential-masking guardrail tí a gbọdọ̀ yàn láti lò (ń bo àwọn API key/secret tó tú jáde mọ́lẹ̀ ní ìhà méjèèjì), ìṣàwárí wẹ́ẹ̀bù DuckDuckGo ọ̀fẹ́ gẹ́gẹ́ bí ìgbésẹ̀ ìkẹyìn, àti ẹnubodè ìwọlé OIDC àṣàyàn fún dashboard (ìwọlé pẹ̀lú password máa ń wà nígbà gbogbo). → [Àwọn Guardrail](docs/security/GUARDRAILS.md) - **🖼️ Àwọn endpoint tuntun** — `/v1/ocr` (Mistral OCR) àti `/v1/audio/translations` (ara Whisper) parí ààyè media náà. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) - **🎨 Ṣíṣẹ̀dá àwòrán / fídíò / ohùn** — API kan ṣoṣo fún media: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, àti àwọn provider speech bíi ElevenLabs. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) - **🌍 Ìfisílẹ̀ & iṣẹ́ àbójútó** — reverse-proxy `basePath`, ìṣàwárí èdè browser láìfọwọ́ṣe, títọpa device fún key kọ̀ọ̀kan, ìgbẹ́kẹ̀lé MITM láìsí root, àti ìtumọ̀ sí zh-TW. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Àwọn provider & agent púpọ̀ sí i** — àwọn cloud agent (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) pẹ̀lú browser + ìwọlé OAuth, card Ollama alákọ̀ọ́kọ́, Claude Opus 5 & Sonnet 5, ìfọwọ́sowọ́pọ̀ Kimi tó jẹ́ òṣìṣẹ́ (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… àti **catalog provider 352** tí a sọ di tuntun. → [Àwọn Provider](docs/reference/PROVIDER_REFERENCE.md) - **📡 Ìṣípayá routing** — gbogbo response ní header `X-OmniRoute-Decision` tí ń sọ orúkọ strategy/provider/latency tó ṣe ìpèsè rẹ̀, strategy combo `cache-optimized` tuntun + factor Auto-Combo `cacheAffinity` ń darí àwọn ìbéèrè àtúnṣe padà sí ìsopọ̀ tó di cached prefix mú, endpoint read-only `/v1/auto-combo/{channel}/candidates` sì ń fi candidate pool tó ń ṣiṣẹ́ fún channel `auto/*` hàn. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Performance & infra agbègbè** — Redis agbègbè pẹ̀lú click kan, àwọn deployer relay Cloudflare Workers / Deno Deploy, àti Bifrost & Mux gẹ́gẹ́ bí supervised embedded services. → [Àwọn Embedded Service](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Àwọn ohun míì tó wà nínú àpótí** — framework plugin + marketplace, àwọn framework skill Omni/Agent/GitHub, ìsopọ̀ Obsidian vault (irinṣẹ́ MCP 22), Batch & Files APIs tó bá OpenAI mu, semantic response cache, gamification pẹ̀lú leaderboard, ìṣàwárí agent ACP (agent 15 tó wà nínú rẹ̀), fífi log ránṣẹ́ sí BigQuery ní àkókò tí a ṣètò, `auto/chaos` parallel multi-model fan-out, afárá bot Telegram, olùṣàkóso version inú app àti àwọn ranking provider ọ̀fẹ́ LMArena-ELO. → [Àwọn Ìwé Ìtọ́sọ́nà](docs/README.md)

## 🤖 Àwọn CLI & Aṣojú Kóòdù Tó Bára Mu > Àtòjọ kan ṣoṣo — `http://localhost:20128/v1` — àti pé **gbogbo** IDE AI tàbí CLI ń ṣiṣẹ́ lórí àwọn àwòṣe ọ̀fẹ́ & olówó-kékeré.

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

＋ ó tún ń ṣiṣẹ́ pẹ̀lú · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ohun èlò èyíkéyìí tó bá OpenAI mu

_{📖 Ìṣètò fún irinṣẹ́ kọ̀ọ̀kan fún gbogbo irinṣẹ́ 36 (CLI Code 26 + CLI Agents 10) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Àfikún OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Ṣàgbéjáde CLI èyíkéyìí tí a ṣe àtìlẹ́yìn fún nípasẹ̀ OmniRoute pẹ̀lú àṣẹ kan ṣoṣo** — kò kọ fáìlì ìṣètò kankan, a ń fi àwọn ẹ̀rí ìwọlé sínú process kọ̀ọ̀kan, Qwen/Gemini sì máa ń gba home àdádó ìgbà díẹ̀: ```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" # Tàbí yan olùpèsè+àwòṣe ní ìbánisọ̀rọ̀, kí o sì kọ ìṣètò ti irinṣẹ́ náà fúnra rẹ̀: omniroute configure codex # bákan náà: claude opencode qwen aider goose gemini cline continue kilo ``` Gbogbo àṣẹ máa ń tẹ̀lé àyíká jíjìn tó ń ṣiṣẹ́ (`omniroute connect `), `--dry-run` máa ń ṣàfihàn env/args gangan láì ṣiṣẹ́ wọn, `--api-key-env NAME` sì ń jẹ́ kí àwọn àṣírí má wọ inú ìtàn shell rẹ. → [Àwọn Ìṣọ̀kan CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 Olùpèsè AI 372 — 154 Tí A Ṣàmì Sí Nínú Àkójọ Gẹ́gẹ́ Bí Ọ̀fẹ́

> **Àwọn olùpèsè 372 tí a forúkọsílẹ̀** káàkiri àwọn àkójọpọ̀ ìfọ̀rọ̀wérọ̀ àṣẹ̀dá, mídíà, ìṣàwárí, ti agbègbè, aṣojú-àwọsánmà àti ètò, pẹ̀lú **154 tí ó ní metadata ìṣàwárí `hasFree: true`**. Ìforúkọsílẹ̀ módẹ́ẹ̀lì ìfọ̀rọ̀wérọ̀ ní **olùpèsè 237 / àpapọ̀ olùpèsè-módẹ́ẹ̀lì ọ̀tọ̀ọ̀tọ̀ 3,009 / ID módẹ́ẹ̀lì àìṣàtúnṣe 1,443**; àkójọ ìnáwó-ọ̀fẹ́ tí ó yàtọ̀ ní **ìlà 491 fún módẹ́ẹ̀lì kọ̀ọ̀kan**, **àkójọpọ̀ àtúnwá 35** àti **olùpèsè ọ̀fẹ́-títíláé 54 tí ó jẹ́ àtúnwá/tí kò nílò kọ́kọ́rọ́**. Àwọn iye ìpìlẹ̀ wọ̀nyí yàtọ̀ nípasẹ̀ àpẹrẹ; àwọn ìtumọ̀ àti àwọn ìṣirò tí a ti mú àdáwòkọ àkójọpọ̀ kúrò wà nínú [Ìtọ́kasí Olùpèsè](docs/reference/PROVIDER_REFERENCE.md) àti [Àwọn Ìpele Ọ̀fẹ́](docs/reference/FREE_TIERS.md).

### 🏢 Gbogbo yàrá ìwádìí pàtàkì — nípasẹ̀ endpoint kan ṣoṣo

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…àti àwọn 330+ míì — gbogbo ààmì máa ń yanjú lọ́wọ́lọ́wọ́ láti inú àkójọ olùpèsè dashboard náà. 📖 [Ìtọ́kasí Olùpèsè](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Ọ̀fẹ́ Títíláé — $0, kò nílò káàdì

OpenCode Zen _{DeepSeek V4, Nemotron 3 Kò sí òpin token}	Kilo Code _{Olùdarí-àdáṣe, Tencent Hy3 Ọ̀fẹ́ títí láé}	Requesty _{GPT-OSS 120B, Nemotron Ọ̀fẹ́ títí láé}	SiliconFlow _{DeepSeek V3.2 / R1 Ìpele ọ̀fẹ́}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Ọ̀fẹ́ títí láé}	Baidu ERNIE _{ERNIE 4.0 Ọ̀fẹ́ títí láé}
Qoder AI _{Qwen3-Max, Kimi-K2 Ọ̀FẸ́ láìlópin}	Pollinations _{GPT, Llama, Claude Kò nílò kọ́kọ́rọ́}	Cloudflare AI _{Àwọn àwòṣe 50+ 10K neuron/ọjọ́}	NVIDIA NIM _{GLM, MiniMax ~40 RPM lọ́fẹ̀ẹ́}	Cerebras _{GLM 4.7, GPT-OSS Kírẹ́dítì $5 ẹ̀ẹ̀kan ṣoṣo; káàdì jẹ́ dandan}	OpenRouter _{Àwọn àwòṣe :free +$10 → RPM tó ga jù}

📖 Àkójọ kíkún tí ẹ̀rọ lè kà → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Ibi tí OmniRoute Ti Ń Ṣiṣẹ́ — Níbikíbi

> Ètò kan náà, ẹ̀rọ rẹ, àwọn òfin rẹ. Láti ìfìsórí npm àgbáyé títí dé **fóònù rẹ** nípasẹ̀ Termux.

Pẹpẹ	Ìfìsórí	Àwọn Ànfàní Pàtàkì
📦 npm (àgbáyé)	`npm install -g omniroute`	Àṣẹ kan, OS èyíkéyìí
🐳 Docker	`docker run … diegosouzapw/omniroute`	Ọ̀pọ̀ àkitektọ̀ AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Fèrèsé abínibí + àpótí ètò — Windows / macOS / Linux
🎩 Àkójọ-àṣàyàn (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Ń ṣàkóso & ń ṣe ìmúdójúìwọ̀n olupin fúnra rẹ̀ — macOS
💪 ARM	abínibí `arm64`	Raspberry Pi, àwọn olupin ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Ń ṣiṣẹ́ lórí fóònù rẹ, 24/7, láìsí root
📲 PWA	"Ṣàfikún sí Ojú Ìbẹ̀rẹ̀"	Ojú-kíkún, láìsí ayélujára, ó ṣeé fi sórí láti inú aṣàwákiri
🧩 Àfikún OpenCode	`@omniroute/opencode-provider`	Ìṣọ̀kan OpenCode abínibí
🤖 VS Code Copilot Chat	fi àfikún OmniCopilot sórí	Gbogbo àwòṣe OmniRoute nínú aṣàyàn Copilot Chat abínibí — stable & Insiders
🛠️ Láti kóòdù orísun	`npm install && npm run dev`	Ṣàtúnṣe rẹ̀, kópa nínú rẹ̀

_{📖 [Ìtọ́sọ́nà Docker](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Àpótí àkójọ-àṣàyàn](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Tuntun: OmniRoute nínú Copilot Chat abínibí ti VS Code

> Kò sí pẹpẹ-ẹ̀gbẹ́ tuntun, kò sí ojú ìbánisọ̀rọ̀ tuntun — gbogbo àwòṣe tí OmniRoute ń pèsè yóò hàn ní tààràtà nínú > **aṣàyàn àwòṣe Copilot Chat tí o ti ń lò**. Láti VS Code 1.122, àwọn àwòṣe olùpèsè ń ṣiṣẹ́ > láìsí wíwọlé GitHub tàbí ìforúkọsílẹ̀ Copilot — ipò aṣojú, pípè irinṣẹ́ àti ìríran, lọ́fẹ̀ẹ́. Fi àfikún **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** sórí, darí rẹ̀ sí olupin OmniRoute rẹ (àtìlẹ́yìn àkọ́kọ́ ni `localhost:20128`), lẹ́yìn náà ṣí Copilot Chat → aṣàyàn àwòṣe → **Ṣàkóso Àwọn Àwòṣe…** → **OmniRoute**.

Ilé Ìtajà	Ọ̀nà Àsopọ̀	Ń ṣiṣẹ́ pẹ̀lú
🧩 VS Code Marketplace	Fi sórí →	VS Code — stable & Insiders
🔓 Open VSX Registry	Fi sórí →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Láti inú olóòtú: ṣí ojú **Àwọn Àfikún**, wá **"OmniRoute"**, tẹ **Fi sórí** — ó ń ṣiṣẹ́ lọ́nà kan náà lórí ilé ìtajà méjèèjì. Kóòdù orísun, àwọn ìṣòro àti ìwé ìtọ́sọ́nà ìtẹ̀jáde wà ní [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Ìtọ́sọ́nà VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — ìṣètò, ohun tí aṣàyàn náà ń fi hàn, àtẹ ìṣàkóso nínú taabu, yíyanjú ìṣòro}

### 🎩 Tuntun: OmniRouteTray — ẹnubodè rẹ, tí ń gbé inú ọ̀pá àkójọ-àṣàyàn

> `omniroute serve` máa ń dára jù lọ nígbà tí ó bá ń ṣiṣẹ́ ní gbogbo ìgbà. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > ń yí èyí padà sí ètò ọ̀pá àkójọ-àṣàyàn fún macOS tí o lè ṣètò kí o sì gbàgbé rẹ̀: ó ń bẹ̀rẹ̀ olupin, ó ń jẹ́ kí ó máa ṣiṣẹ́ > lẹ́yìn àwọn àtún-bẹ̀rẹ̀, ó ń ṣe ìmúdójúìwọ̀n rẹ̀ níbi kan náà, ó sì ń jẹ́ kí ìwọ̀n token rẹ ní àkókò gidi wà ní ìtẹ̀ kan — **kò sí > fèrèsé terminal tí a fi sílẹ̀ ní ṣíṣí, kò sí `npm install -g omniroute` tí o ní láti máa tọ́jú.** A kọ́ ọ pẹ̀lú [Tauri v2](https://v2.tauri.app/) (ìpìlẹ̀ Rust tí ó kéré gan-an), ó mú runtime Node 24 tirẹ̀ tí a fọwọ́sí wá, ó sì ń ṣàkóso ìfìsórí OmniRoute tí ètò náà ní, nítorí náà kò ní bá `node`/`bun` àgbáyé rẹ figagbága. Ó **ń pín àtòpọ̀ àti ibi ìpamọ́ dátà `~/.omniroute/` rẹ tí ó ti wà tẹ́lẹ̀** — nítorí náà, OmniRoute kan náà tí o ti ń ṣiṣẹ́ ni, ó kàn wọ fìlà ni. 🎩

Ohun tí ó ń ṣe	Bí ó ṣe ń ṣe é
🟢 Ó ń ṣàkóso olupin	Ó ń ṣe ìpilẹ̀ṣẹ̀ `omniroute serve`, ó ń gba instance tí ó ti ń ṣiṣẹ́ dípò ṣíṣe ẹ̀dà rẹ̀ méjì
📊 Ìlò ní àkókò gidi ní ojú kan	Àwọn ọ̀pá ìpín olùpèsè, ààlà session/ọ̀sẹ̀ Claude pẹ̀lú ìṣírò àkókò tó kù sí àtúntò, ìpín iye owó ọjọ́ 30
🔄 Ó ń ṣe ìmúdójúìwọ̀n fúnra rẹ̀ níbi kan náà	Ìfìsórí ní ìpele, ìpàrọ̀ atomic, ìpadà sí ẹ̀yà àtijọ́ nígbà ìkùnà — ó máa ń wà lórí ìtẹ̀jáde tuntun jù lọ ní gbogbo ìgbà
🚀 Bẹ̀rẹ̀ nígbà wíwọlé	Ìpilẹ̀ṣẹ̀ àṣàyàn nígbà wíwọlé; àpótí nìkan, kò sí àmì dock
🩺 Àyẹ̀wò & àwọn àkọsílẹ̀	Àyẹ̀wò ìṣòro pẹ̀lú ìtẹ̀ kan àti ìráyè sí àkọsílẹ̀ olupin

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Ṣé o fẹ́ràn ìgbàsílẹ̀? Gba .dmg tuntun láti
Àwọn Ẹ̀yà Tí A Ti Tu Sílẹ̀. Kóòdù orísun, àwọn ìṣòro àti àwọn àkọsílẹ̀ ìkọ́lé
wà ní zoispag/omniroute-tray.

💛 Iṣẹ́ àkànṣe àwùjọ láti ọwọ́ @zoispag — kì í ṣe ẹ̀yà OmniRoute tí a tú sílẹ̀ ní ọ̀nà ìjọba.}

## 🔒 Àṣírí & Agbègbè-Lákọ̀ọ́kọ́

Àṣírí àti agbègbè-lákọ̀ọ́kọ́ — ẹnu-ọ̀nà àti pẹ̀tẹ́lẹ̀ ìṣàkóso OmniRoute ń ṣiṣẹ́ lórí ẹ̀rọ rẹ. A máa ń fi àwọn ìtọ́sọ́nà ránṣẹ́ sí olupèsè upstream tí a yàn fún ìbéèrè kọ̀ọ̀kan; OmniRoute kò fi ìpele ìṣiṣẹ́ ìtọ́sọ́nà tí a gbàlejò kún un, telemetry sì jẹ́ pípà látọwọ́ àtìlẹ́yìn. A fi AES-256-GCM paroko àwọn ẹ̀rí ìwọlé níbi ìpamọ́; àwọn ìṣàkóso ní ìdíwọ̀n agbègbè API-key, àsẹ IP, àwọn òpin ìwọ̀n, àwọn olùṣọ́ lòdì sí àbáwọlé ìtọ́sọ́nà, ìmúkúrò header upstream, àtúnṣe PII tí a yàn láti ṣiṣẹ́, àwọn àṣìṣe tí a ti sọ di mímọ́ àti àkọsílẹ̀ àyẹ̀wò SQLite agbègbè kan. OmniRoute ní ìwé-àṣẹ MIT, ó sì ṣeé gbàlejò fúnra ẹni.

_{📖 [Ìfúnni Láṣẹ](docs/architecture/AUTHZ_GUIDE.md) · [Àwọn Ààbò](docs/security/GUARDRAILS.md) · [Ìbámu](docs/security/COMPLIANCE.md)}

## 🔌 CLI Kíkún + A2A & MCP

> Yàtọ̀ sí server náà, OmniRoute jẹ́ **ibi ìṣàkóso command-line kíkún** pẹ̀lú **àwọn àṣẹ 80+**, àti àwọn protocol agent ṣíṣí kí agent AI lè darí rẹ̀ **fúnra rẹ̀**. ### ⌨️ CLI gidi kan (kì í ṣe `start` nìkan) ```bash omniroute # ṣe ìpèsè gateway + dashboard (port 20128) omniroute chat # client ìfọ̀rọ̀wérọ̀ TUI aláṣepọ̀ (slash: /model /combo /skill /memory) omniroute setup # wizard ìtọ́sọ́nà fún ìṣiṣẹ́ àkọ́kọ́ omniroute doctor # ṣe àyẹ̀wò providers, ports, native deps ``` ### 🛰️ Ipò jíjìn — ṣiṣẹ́ CLI níbí, OmniRoute lórí VPS kan OmniRoute wà lórí server kan? Darí rẹ̀ láti laptop rẹ pẹ̀lú **CLI kan náà**. Wọlé lẹ́ẹ̀kan pẹ̀lú token ìwọlé tí a ní ìdíwọ̀n agbègbè; lẹ́yìn náà, gbogbo àṣẹ yóò tọ́ka sí èyí tí ó wà ní jíjìn. ```bash omniroute connect 192.168.0.15 # ọ̀rọ̀ aṣínà → token tí a ní ìdíwọ̀n agbègbè, tí a fipamọ́ gẹ́gẹ́ bí context omniroute models list # ← ń ṣiṣẹ́ lòdì sí server JÍJÌN náà omniroute configure codex # ← yan model jíjìn kan, kọ profile Codex agbègbè kan omniroute tokens create --name ci --scope read # ṣẹ̀dá àwọn token tó ní ìdíwọ̀n tóóró fún àwọn ẹ̀rọ mìíràn omniroute contexts use default # ← padà sí server agbègbè náà ``` A pín àwọn token sí agbègbè `read` / `write` / `admin`; àwọn route tó ń dá process sílẹ̀ wà fún loopback nìkan. _{📖 [Ipò Jíjìn](docs/guides/REMOTE-MODE.md)}

Àfihàn terminal alárinrin tí ń ṣe àfihàn OmniRoute CLI — omniroute providers list, omniroute combo list àti omniroute health — tí ń yí ká lórí ojú àṣẹ ìpele-òkè 86: 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 …

### 🤝 So agent kan pọ̀ — yóò sì ṣàkóso OmniRoute fúnra rẹ̀ Ṣí OmniRoute síta nípasẹ̀ **MCP**, **A2A**, **REST API**, **webhooks** tàbí **CLI jíjìn** — agent èyíkéyìí tó lágbára (tàbí code tirẹ) yóò gba kọ́kọ́rọ́ sí gbogbo gateway náà: routing, providers, combos, cache, compression, memory — láìsí ìdarí ènìyàn. Àwọn endpoint HTTP tó wà nísàlẹ̀ ni a pèsè lábẹ́ `http://localhost:20128`.

Ojú-ìbáṣepọ̀	Endpoint / àṣẹ	Lò ó fún
🧰 MCP (stdio)	`omniroute --mcp`	So pọ̀ mọ́ Claude Desktop, Cursor, tàbí client MCP èyíkéyìí
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP jíjìn — irinṣẹ́ 110, agbègbè 33 (ìmúlò jẹ́ àṣàyàn), àkọsílẹ̀ àyẹ̀wò kíkún
📡 MCP (SSE)	`/api/mcp/sse`	Ọ̀nà ìgbékalẹ̀ MCP ṣiṣànwọlé
🤝 A2A	`/.well-known/agent.json`	Agent-sí-agent, JSON-RPC 2.0 + SSE, ọgbọ́n 6
🌐 REST API	`/v1/*`	Ó bá OpenAI mu — ìfọ̀rọ̀wérọ̀, embeddings, àwòrán, ohun, OCR
🔔 Webhooks	`/api/webhooks`	Fi àwọn ìṣẹ̀lẹ̀ ìbéèrè / quota ránṣẹ́ sí Slack, Discord, Telegram tàbí URL èyíkéyìí
🛰️ CLI Jíjìn	`omniroute connect`	Darí instance jíjìn kan pẹ̀lú àwọn token ìwọlé tí a ní ìdíwọ̀n agbègbè

```bash # Fún Claude Code ní gbogbo àkójọpọ̀ irinṣẹ́ OmniRoute nípasẹ̀ MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Server MCP](docs/frameworks/MCP-SERVER.md) · [Server A2A](docs/frameworks/A2A-SERVER.md) · [Àwọn Protocol Agent](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Fi 15–95% Àwọn Tókìnì Pamọ́ — Láìfọwọ́ṣe

### 📖 Bí ó ṣe ń ṣiṣẹ́ — ìpele ìṣiṣẹ́, àwòrán ètò & ìṣirò ìfipamọ́

Ìpele ìṣiṣẹ́ fún ìfúnpọ̀ OmniRoute: ìbéèrè oníbàárà tó ní tókìnì 10,000 gẹ́gẹ́ bí àpẹẹrẹ ń gba inú àwọn ẹ̀rọ 12 tí a lè ṣàkójọpọ̀ kọjá — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra àti OmniGlyph — ó sì lè dé ọ̀dọ̀ olùpèsè pẹ̀lú nǹkan bí tókìnì 1,080 nínú àpẹẹrẹ àkójọpọ̀ tí a ṣàkọsílẹ̀. Àwọn olùṣọ́ ìpamọ́ àti àwọn ẹnu-ọ̀nà ìṣòtítọ́ ní ìgbésẹ̀ kọ̀ọ̀kan ń dáàbò bo àkóónú tó ní ìṣètò; àwọn ìpo tí ń pàdánù àlàyé tàbí ti àdánwò tí a yàn ní kedere lè yí àkóónú tó yẹ padà.

Àkójọpọ̀ àìyípadà máa ń ṣiṣẹ́ ní ìtẹ̀lé `RTK → Caveman`. Nígbà tí àwọn méjèèjì bá ṣiṣẹ́ lórí ẹrù irinṣẹ́/àyíká-ọ̀rọ̀ kan náà, ìfipamọ́ máa ń pọ̀ sí i ní ìlọ́po: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Ẹ̀rọ ìpamọ́ **máa ń dáàbò bo** àwọn búlọ́ọ̀kù kóòdù, àwọn URL, JSON àti dátà tó ní ìṣètò **ní gbogbo ìgbà**. > **Kí ló dé tí a fi máa lo ọ̀pọ̀ tókìnì nígbà tí díẹ̀ lè ṣe iṣẹ́ náà?** Gbogbo ìbéèrè máa ń gba inú ìpele ìfúnpọ̀ OmniRoute kọjá **láìfarahàn** — kò sí ìyípadà kankan fún oníbàárà. Ní báyìí, ó jẹ́ **àkójọpọ̀ àwọn ẹ̀rọ 12 tí a lè ṣàkójọpọ̀** tí ń ṣiṣẹ́ ní ìtẹ̀lé, tí a sì lè pò tàbí mú bá ara wọn mu fún àkójọpọ̀ ìdarí ọ̀nà kọ̀ọ̀kan — tí ó gbé karí àwọn èrò láti [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), àti [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Àkójọpọ̀ ẹ̀rọ 12 náà Àwọn ẹ̀rọ máa ń ṣiṣẹ́ ní ìtẹ̀lé ìpele ìṣiṣẹ́; a lè tan tàbí pa ọ̀kọ̀ọ̀kan lọ́tọ̀, a sì lè ṣètò rẹ̀ fún àkójọpọ̀ kọ̀ọ̀kan:

#	Ẹ̀rọ	Ohun tí ó ń ṣe
1	Session-Dedup	Ń yọ àkóónú tí a tún lò láàárín àwọn ìfèsì (tí a ń tọ́ka sí nípasẹ̀ àkóónú, tó sì ń ṣiṣẹ́ kọjá àwọn ìfèsì)
2	CCR	Ń fi àwọn búlọ́ọ̀kù ńlá pamọ́ lẹ́yìn àwọn àmì ìmúpadàbọ̀, a sì ń mú wọn wá nígbà tí a bá nílò wọn
3	Lite	Ààyè òfìfo + gígé URL àwòrán kúrú (ìpìlẹ̀ tó fẹ́rẹ̀ẹ́ má ní ìdádúró)
4	RTK	Àlẹ̀mọ́ ọlọ́gbọ́n fún èsì irinṣẹ́, yíyọ àwọn àdàkọ & gígé kúrú (tó mọ àṣẹ)
5	Responses Tool Output	JSON tí kò pàdánù àlàyé lákọ̀ọ́kọ́ + ìfúnpọ̀ àyẹ̀wò tó ní ààlà fún àbájáde shell/patch/search/build (Responses API)
6	Headroom	Ìṣọdipúpọ̀ tábìlì tí kò pàdánù àlàyé fún àwọn àkójọ JSON (~30%) nípasẹ̀ codec GCF tí a ṣàkópọ̀ mọ́ ọn
7	Relevance	Ìfún àwọn gbólóhùn ní àmì láti mú èyí tó ṣe pàtàkì jáde ní ìfiwéra pẹ̀lú ìbéèrè oníṣe tó ṣẹ̀ṣẹ̀ dé
8	Caveman	Ìfúnpọ̀ ọ̀rọ̀ àpilẹ̀kọ tó dá lórí àwọn òfin (~65–75% lórí àbájáde)
9	Aggressive	Ṣíṣe àkótán + dídi àwọn ìfèsì àtijọ́ kúrú sí i ní ṣísẹ̀-n-tẹ̀lé
10	LLMLingua-2	Yíyọ apá ìtumọ̀ tí kò ṣe pàtàkì pẹ̀lú ML nípasẹ̀ MobileBERT ONNX — tó dáàbò bo kóòdù, async
11	Ultra	Yíyọ tókìnì nípasẹ̀ ìlànà àfojúsùn pẹ̀lú ìpele small-model (SLM) àṣàyàn
12	OmniGlyph	Ìyípadà àyíká-ọ̀rọ̀ sí àwòrán fún Claude Fable 5 tí a wọn lórí ìsopọ̀ Anthropic tààrà gẹ́gẹ́ bí àdánwò; àwọn transformer GPT 5.6 ṣì máa ń kọ̀ láìsí ẹ̀rí ìjẹ́rìísí láti ọ̀dọ̀ olùpèsè. Àwọn profaili ìfúnpọ̀ mẹ́rin (aggressive gẹ́gẹ́ bí àìyípadà, balanced, coding-safe, passthrough) (tó le jù lọ; a gbọ́dọ̀ yàn láti lò ó)

Àwọn búlọ́ọ̀kù kóòdù, àwọn URL àti dátà tó ní ìṣètò ni a **máa ń tọ́jú ní gbogbo ìgbà** ní ìbámu pípé dé ìwọ̀n byte. **Àwọn àtòjọ tí a lè yàn pẹ̀lú ìtẹ̀ kan** ń darapọ̀ àwọn ẹ̀rọ náà:

Ìpo	Ìfipamọ́	Ó dára jù fún
🪶 Lite	~15%	Àìyípadà tó ní ààbò tí a lè máa lò ní gbogbo ìgbà
🪨 Standard (Caveman)	~30%	Kíkọ kóòdù ojoojúmọ́
⚡ Aggressive	~50%	Àwọn sáà gígùn tó kún fún lílo irinṣẹ́
🔥 Ultra	~75%	Ìfipamọ́ tó pọ̀ jù lọ
🧰 RTK	60–90%	Àbájáde shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Àwọn ìtọ́ni àdàpọ̀ + àkọsílẹ̀ irinṣẹ́

**Àpẹẹrẹ gidi — Ìpo Standard:** > **Ṣáájú (tókìnì 69):** _"Ìdí tí kọ́ńpónẹ́ǹtì React rẹ fi ń tún ara rẹ̀ ṣe àfihàn ṣeé ṣe kó jẹ́ pé o ń ṣẹ̀dá ìtọ́kasí object tuntun ní gbogbo ìyípo àfihàn. Nígbà tí o bá fi inline object ránṣẹ́ gẹ́gẹ́ bí prop, ìfiwéra React tí kò jinlẹ̀ máa ń rí i gẹ́gẹ́ bí object tó yàtọ̀ ní gbogbo ìgbà, èyí sì ń fa àtúnṣe àfihàn. Mo dábàá pé kí o lo useMemo láti fi object náà sínú memo."_ > > **Lẹ́yìn (tókìnì 19):** _"Ìtọ́kasí object tuntun ní gbogbo àfihàn. Inline object prop = ìtọ́kasí tuntun = àtúnṣe àfihàn. Fi useMemo yí i ká."_ > > **Èsì kan náà. Tókìnì dín kù ní 72%. Kò pàdánù ìpéye rárá.** ✅ **Àpẹẹrẹ PT-BR — Ìpo [Troglodita](https://github.com/leninejunior/troglodita):** > **Ṣáájú (42 tokens):** _"Ìṣòro náà ni pé component náà ń tún render nítorí reference object tuntun ni a ń ṣẹ̀dá ní gbogbo render cycle. Màá dábàá lílo useMemo."_ > > **Lẹ́yìn náà (12 tokens):** _"Àtún-render: ref tuntun ní gbogbo cycle (object inline tí a tún ṣẹ̀dá). Lo `useMemo`."_ > > **Ìdáhùn kan náà. Tókìn dín kù ní ~70%. Ìpéye ìmọ̀ ẹ̀rọ kò yí padà.** ✅
### 🎚️ Kọjá àwọn engine — àwọn style output, dial aṣamubadọ́gba àti ìṣàkóso fún request kọ̀ọ̀kan Àwọn engine 12 tó wà lókè dín ohun tó ń wọlé kù. Àwọn layer mẹ́ta míì ń ṣàkóso **bí**, **ìgbà wo**, àti ohun tó ń **jáde**: - **🪄 Àwọn Style Output** _(ìdarí lórí axis output)_ — fi àwọn ìtọ́nisọ́nà tó dájú, tí kò ba cache jẹ́, sínú ìdáhùn láti mọ bí yóò ṣe rí; a lè da wọn pọ̀, ọ̀kọ̀ọ̀kan sì ní ìwọ̀n `lite` / `full` / `ultra`. Fífi style kan kún un jẹ́ entry registry onílà-kan: - **Ọ̀rọ̀ ṣókí** — yọ ọ̀rọ̀ àfikún / article / ọ̀rọ̀ àní-àní kúrò; pa kókó ìmọ̀ ẹ̀rọ mọ́ ní pípé. - **Code díẹ̀** — YAGNI ti “senior dev ọ̀lẹ”: àyípadà tó kéré jù tó sì ṣiṣẹ́, láìsí scaffolding tí a kò béèrè fún. - **Ponytail (senior dev ọ̀lẹ)** — gun àkàbà YAGNI, tún gbòǹgbò ìṣòro náà ṣe, lo diff tó kéré jù tó sì ṣiṣẹ́. - **Mo ní ADHD (ìgbésẹ̀-lákọ̀ọ́kọ́)** — bẹ̀rẹ̀ pẹ̀lú ìgbésẹ̀ tó kàn, fi nọ́ńbà sí àwọn ìgbésẹ̀, ìgbésẹ̀ gidi kan ṣoṣo tó kàn, kò sí ọ̀rọ̀ ìṣáájú. - **CJK ṣókí (文言)** — style Ṣáínà àtijọ́ tó ṣókí gan-an (a fi locale mọ́ `zh` nìkan). - **🎯 Ìwọ̀n context tó ń bá ipò mu** _(dial náà)_ — dípò threshold tókìn on/off kan ṣoṣo, mú àwọn engine tó wọ́pọ̀ jù, tí kò sì pàdánù ìtumọ̀ púpọ̀, ga dé ibi tó yẹ nìkan láti **ba context window model náà mu**. Policy: `reserve-output` (àiyipada, tó mọ model) · `percentage` · `absolute`. Mode: `floor` (jẹ́rìí pé yóò wọlé) · `replace-autotrigger` (àyàn rẹ tó ṣe kedere ló borí) · `off` (threshold àtijọ́). - **🎛️ Ibi tí a ti pinnu compression** _(àṣẹ ìṣáájú, gíga → kékeré)_ — header `x-omniroute-compression` fún request kọ̀ọ̀kan › override routing-combo › profile olórúkọ tó ń ṣiṣẹ́ › adaptive / auto-trigger › àiyipada panel › off. Ètò tí a lò yóò tún hàn nínú header ìdáhùn `X-OmniRoute-Compression: ; source=`. Ṣètò auto-trigger nípa threshold tókìn, tan dial adaptive, dì profile olórúkọ kan mú, ṣètò ti ẹ̀ẹ̀kan fún request kan, tàbí yan pipeline fún routing combo kọ̀ọ̀kan — èyíkéyìí tó bá iṣẹ́ náà mu. **Eval harness** offline tí o lè yàn láti lò (`npm run eval:compression`) ń díwọ̀n bí ìdúróṣinṣin ìtumọ̀ ṣe rí sí iye ìfipamọ́ lórí corpus tí a dì mú kí o tó gbé àyípadà kan ga. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Bẹ̀rẹ̀ Kíákíá

**1) Fi sílẹ̀ kí o sì ṣiṣẹ́** ```bash npm install -g omniroute omniroute ``` > 💡 Ṣé o rí `npm warn ERESOLVE` tàbí àwọn ìkìlọ̀ peer-dep? [Wọn kò léwu](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Ṣé o ń lo npm 11 tàbí tuntun ju bẹ́ẹ̀ lọ?** npm lè dí àwọn script lifecycle package mọ́ àyàfi tí a bá gba wọn láàyè. `postinstall` ti OmniRoute (`node scripts/build/postinstall.mjs`) ṣe pàtàkì láti pèsè àwọn file runtime native rẹ̀. Gba àwọn package tí a dárúkọ nínú ìkìlọ̀ npm láàyè nígbà tí o bá ń fi í sílẹ̀ globally. Fún àkójọpọ̀ package tí OmniRoute 3.8.51 jabo: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Láti tún allowlist yìí lò fún àwọn fifi-sílẹ̀ global lọ́jọ́ iwájú, ṣètò rẹ̀ lẹ́ẹ̀kan, lẹ́yìn náà fi sílẹ̀ bí àtẹ̀yìnwá: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Àkójọ dependency lè yí padà láàárín àwọn release; bí npm bá jabo àkójọ mìíràn, lo àwọn orúkọ package inú ìkìlọ̀ náà. Gbigba package kan láàyè túmọ̀ sí fífàyè gba àwọn script install rẹ̀ láti ṣiṣẹ́. > **Ṣé o ń lo Gemini Web tàbí provider web-cookie mìíràn?** Package npm náà ní > Playwright, ṣùgbọ́n kò ní binary Chromium rẹ̀. Wo àkíyèsí > [ìṣètò Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > kí o tó ṣe request àkọ́kọ́ sí web-provider. Dashboard wà ní `http://localhost:20128` · API wà ní `http://localhost:20128/v1`. **2) So provider tó yẹ pọ̀ ní lílo account tirẹ** Dashboard → **Providers** → yan provider kan tí àwọn terms àti quota rẹ̀ lọ́wọ́lọ́wọ́ bá use case rẹ mu → fi API key rẹ̀ kún un tàbí parí account flow rẹ̀. Àwọn free tier lè béèrè fún signup, approval, tàbí payment method. Ṣàyẹ̀wò [Ìtọ́sọ́nà Free Tiers](docs/getting-started/FREE-TIERS-GUIDE.md); a kò lè ṣe ìdánilójú pé keyless availability yóò wà, àwọn provider tí a sì sàmì sí `tos: avoid` ni a yọ kúrò nínú `auto` ní àiyipada. **3) Darí coding tool rẹ sí i** ```txt URL Ìpìlẹ̀: http://localhost:20128/v1 API Key: [dà á láti Dashboard → Endpoints] Model: auto (ń route láàárín àwọn connection tó yẹ — tàbí yan provider/model) ``` **4) Jẹ́rìí pé ó ń ṣiṣẹ́** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ó yẹ kí o rí àkójọ àwọn model tí o ti so pọ̀. 🎉 Ó tán — bẹ̀rẹ̀ sí í kọ code, OmniRoute yóò sì ṣe auto-route àti fallback fún ọ. Bí client rẹ kò bá lè fi custom header ránṣẹ́, OmniRoute tún pèsè àwọn alias compatibility tí a fi token mọ́: ```txt Àkójọ OpenAI: http://localhost:20128/vscode/YOUR_KEY/ Àwọn model OpenAI: http://localhost:20128/vscode/YOUR_KEY/models Chat OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions Ìdáhùn OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses Chat Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat Àwọn tag Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Lo àwọn wọ̀nyí fún àwọn client tí kò lè so `Authorization: Bearer ...` mọ́ request nìkan. Ìfàṣẹ̀sí nípasẹ̀ header ṣì ni mode tí a fẹ́ràn jù.
## 📦 Àwọn ọ̀nà ìfisílẹ̀ míì — 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` ń tẹ̀lé ẹ̀yà SemVer tó dúró ṣinṣin tó ga jù lọ tí a ti **tẹ̀ jáde**. Kò tẹ̀lé git `main`. Lo `:X.Y.Z` pàtó fún GitOps. Wo [Àwọn Ikanni Ìtújáde Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Àwòrán náà ṣètò **`OMNIROUTE_MEMORY_MB=1024`** gẹ́gẹ́ bí iye pàtó. Ìyẹn tó fún dashboard àti ìfọ̀rọ̀wérọ̀ kékeré. **Àwọn aṣojú coding** (`POST /v1/responses` láti Claude Code, Codex, Grok, …) nílò V8 heap tó tóbi púpọ̀ sí i, bí bẹ́ẹ̀ kọ́ process náà yóò ṣe `FATAL ERROR` ní nǹkan bí 12 GiB lábẹ́ àwọn context gígùn méjì tó bẹ̀rẹ̀ sí í lé ara wọn lórí. Ṣètò container náà kí ó tóbi ju heap lọ (àwọn native buffer wà ní òde V8): | Irú iṣẹ́ | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ------------------------------------- | ------------------------------- | ---------------------- | | Dashboard / ìfọ̀rọ̀wérọ̀ kékeré | `1024` (ìpìlẹ̀ àwòrán) | ≥2 g | | Aṣojú coding kan | `8192` | ≥10 g | | `/v1/responses` gígùn méjì lẹ́ẹ̀kan náà | `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 ``` Tábìlì kíkún: [Ìtọ́sọ́nà Docker — RAM àsìkò ìṣiṣẹ́](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Ikanni Docker ṣáájú ìtújáde:** `diegosouzapw/omniroute:next` àti > `diegosouzapw/omniroute:next-web` ń tẹ̀lé ẹ̀ka `release/v*` tó jẹ́ àìyẹsẹ̀ lọ́wọ́lọ́wọ́. > Àwọn tag tí ó lè yí padà wọ̀nyí wà fún dídán àwọn àtúnṣe tí a kò tíì tú jáde wò nìkan, wọn kò sì > **ní àtìlẹ́yìn fún production**. Wo > [Àwọn Ikanni Ìtújáde Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** A ṣàtìlẹ́yìn fún `bun install` àtijọ́ àti ìfisílẹ̀ kárí-ayé (`bun install -g omniroute`) nípasẹ̀ ìṣàwárí runtime Bun: - **`bun:sqlite` tí a kọ sínú rẹ̀**: OmniRoute máa ń lo driver `bun:sqlite` tí a kọ sínú Bun nígbà tó bá ń ṣiṣẹ́ lábẹ́ Bun, yóò sì yí padà sí `better-sqlite3` lórí Node.js tàbí `sql.js`. - **Yíyan bundler Webpack láìfọwọ́ṣe ní dev**: Development (`bun run dev`) máa ń ṣàwárí Bun láìfọwọ́ṣe, yóò sì pa Turbopack láti lo Webpack dípò rẹ̀ láti dènà àìbáramu native V8 binding. Àwọn build production (`bun run build`) ń tẹ̀lé `OMNIROUTE_USE_TURBOPACK` gan-an bíi ti Node: Turbopack gẹ́gẹ́ bí àìyẹsẹ̀, `OMNIROUTE_USE_TURBOPACK=0` láti build pẹ̀lú Webpack (`Dockerfile.bun` ń mú un wà gẹ́gẹ́ bí `--build-arg`). - **Dockerfile Bun àkànṣe**: `Dockerfile.bun` alápele-púpọ̀ fún àwọn deployment production Bun native (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Fi sílẹ̀ kí o sì ṣiṣẹ́ pẹ̀lú Bun bun install bun run dev ``` **🛠️ Láti 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 # Lílo àwọn flake Nix nix develop npm run dev # Tàbí lílo devbox devbox run npm run dev ``` 📖 [Ìtọ́sọ́nà Docker](docs/guides/DOCKER_GUIDE.md) — Àwọn profile Compose, Caddy HTTPS, àwọn tunnel Cloudflare. **🦭 Podman** ```bash # 1. Pèsè àkọsílẹ̀ data tí a so mọ́ nípasẹ̀ bind mkdir -p data # 2. Linux + Podman rootless ti agbègbè nìkan (kì í ṣe client Podman Machine jíjìn rárá): podman unshare chown 1000:1000 ./data # 3. Ṣètò ìtọ́kasí runtime, build àwòrán Compose agbègbè, kí o sì bẹ̀rẹ̀ echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Lórí macOS tàbí Windows, Podman máa ń lo Podman Machine jíjìn: má ṣe lo `podman unshare`, kí o sì tẹ̀lé [ìtọ́sọ́nà àkọsílẹ̀ data tó dá lórí topology](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Ìtọ́sọ́nà Podman](contrib/podman/README.md) — Àwọn build Compose, Podman Machine, àti ìṣètò Quadlet Linux/systemd. **⚡ Ìfisílẹ̀ tó yára / fẹ́ẹrẹ̀ sí i (fo native build)** Ẹ̀rọ SQLite native (`better-sqlite3`) jẹ́ dependency **àṣàyàn**, nítorí náà ìfisílẹ̀ kárí-ayé kì í dúró de compilation láti source: ó máa ń lo binary tí a ti kọ́ tẹ́lẹ̀ nígbà tí èyí tó bá platform/Node rẹ mu bá wà, bí bẹ́ẹ̀ kọ́ yóò yí padà láìsí ìdíwọ́ sí ẹ̀rọ pure-JS (`node:sqlite` lórí Node 22+, tàbí WASM `sql.js` tí a kó pọ̀ mọ́ ọn) — kò nílò àwọn irinṣẹ́ build. Láti fo ìmúrúgbóná native lẹ́yìn ìfisílẹ̀ pátápátá (CI, headless, tàbí àwọn ẹ̀rọ tó lọ́ra): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 náà máa ń fò ó ``` Fún ìfisílẹ̀ tó yára jù lọ, yan **pnpm** (ibi ìpamọ́ tó dá lórí àkóónú + àwọn hard link — wo òkè). Fún runtime headless tí kò ní dashboard, lo profile `base` Docker (lókè) tàbí [ìtọ́sọ́nà Termux](docs/guides/TERMUX_GUIDE.md). Process kan náà ló ń pèsè CLI àti dashboard wẹ́ẹ̀bù lórí port kan, nítorí náà kò sí package CLI-nìkan lọ́tọ̀ ní báyìí.

# 🎬 OmniRoute Níbi Iṣẹ́

## 📹 Àwọn Ìtọ́sọ́nà Fídíò

_{Àwòrán pánẹ́ẹ̀lì ní 2026-08-24 · Àkójọ àìṣètò: YT 809 | TT 137 | IG 124 · Bí ó ṣe jẹ́ tuntun (ọjọ́): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — ìwòran 3,042,474}

🎬 #2 — Instagram
_{theopenstack — ìwòran 692,419}

🎬 #3 — TikTok
_{milesreevesai — ìwòran 620,400}

🎬 #4 — YouTube
_{Vaibhav Sisinty — ìwòran 391,109}

Fídíò Kúkúrú Instagram — buildwithai.club

🎬 #5 — Instagram
_{buildwithai.club — ìwòran 347,652}

**Ipò-kíkọ kíkún (àwọn URL àkọ́kọ́ tí a ti yọ àdáwòkọ kúrò, `v > 0`, ìwọ̀n ìkànnì tó ga jù):** | #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 — Àwọn Fídíò Kúkúrú YouTube](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** | Àwọn òṣùwọ̀n àkọ́kọ́ ní 2026-08-24: **fídíò aláìlẹ́gbẹ́ 1.029** · **ìwòran tí a mọ̀ 11.132.922** (`v > 0`) · **ìkànnì/prófáìlì 639 ní ìkànnì àjọlò kọ̀ọ̀kan**. Pánẹ́ẹ̀lì àìṣètò náà ní ìlà 1.070; a ṣe ìṣọ̀kan àdáwòkọ Instagram 41 nípasẹ̀ URL àkọ́kọ́, ní dídá iye tó ga jù sílẹ̀ fún fídíò kọ̀ọ̀kan. > 🎬 **Ṣé o ṣe fídíò kan nípa OmniRoute?** Ṣí [ìṣòro](https://github.com/diegosouzapw/OmniRoute/issues/new) tàbí [ìjíròrò](https://github.com/diegosouzapw/OmniRoute/discussions) pẹ̀lú ọ̀nà asopọ náà — a ó fi hàn níbí.

# 📧 Àwùjọ & Ìrànlọ́wọ́ > Gbogbo nǹkan ní ibi kan — tẹ̀lé olùtọ́jú náà, bá àwùjọ sọ̀rọ̀, tàbí ṣí ìṣòro kan. | Ìkànnì | Ibi / bí a ṣe lè rí i | | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — tẹ̀lé olùtọ́jú náà | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — tẹ̀lé fún àwọn ìtújáde àti àbá | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Àgbáyé** | [darapọ̀ mọ́ ẹgbẹ́ náà](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brasil** | [darapọ̀ mọ́ ẹgbẹ́ náà](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Ojúlé** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Àwùjọ StHub OmniRoute (ọ̀fẹ́)** | [póòtù StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Kóòdù orísun** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Jábọ̀ àṣìṣe kan** | [ṣí ìṣòro kan](https://github.com/diegosouzapw/OmniRoute/issues) — so àbájáde `npm run system-info` mọ́ ọn | | 🤝 **Ṣe àfikún** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Àwoṣe Ẹ̀ka àti Ìtújáde](docs/ops/BRANCHING_MODEL.md) · yan `good first issue` | | 💚 **Ṣe àtìlẹ́yìn fún iṣẹ́ náà** | [Àwọn ọ̀nà láti ṣe àtìlẹ́yìn ↑](#-support-omniroute) · [Àwọn Olùgbọ̀wọ́ GitHub](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Àkójọpọ̀ Ìmọ̀ Ẹ̀rọ

Ìpele	Ìmọ̀ Ẹ̀rọ
Àyíká Ìṣiṣẹ́	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Èdè	TypeScript 6.0 — 100% TypeScript jákèjádò `src/` àti `open-sse/` (kò sí `any` nínú kókó láti v2.0)
Àgbékalẹ̀	Next.js 16 + React 19 + Tailwind CSS 4
Àkójọ Ìwífún	better-sqlite3 (SQLite, ìkọsílẹ̀ WAL) + LowDB (ogún JSON) — àwọn módùùlù àgbègbè 137, àwọn ìṣíkiri 202
Ìrántí	Ọ̀rọ̀-kíkún SQLite FTS5 + àwọn ìfìdí-fẹ́ńbẹ́ẹ̀kì int8-quantized, ìdínkù onírúurú
Àwọn Àwòṣe	Zod 4 — ìfọwọ́sí I/O irinṣẹ́ MCP + àwọn àdéhùn API
Àwọn Ìlànà Ìbánisọ̀rọ̀	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Ṣíṣànwọlé	Server-Sent Events (SSE) + afárá WebSocket (`/v1/ws`)
Ìfúnpọ̀	Ọ̀nà-ìṣiṣẹ́ ẹ̀rọ 12 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Ìfàṣẹsí & ààbò	OAuth 2.0 (PKCE) + JWT + àwọn Kọ́kọ́rọ́ API + ìfàṣẹsí MCP oníwọ̀n · AES-256-GCM nígbà ìpamọ́ · DOMPurify
Ìfarapamọ́	wreq-js — àfarawé àmì ìdánimọ̀ TLS JA3 / JA4, aṣojú alápele mẹ́ta
Ìfaradà	Olùdádúró sákítì, ìfàsẹ́yìn olóòdì, ìdènà ìrùjọ-ìbéèrè, ìmúláradá ara-ẹni aládàáṣiṣẹ́ auto-combo
Ìkọsílẹ̀	pino — àwọn àkọsílẹ̀ JSON tí a ṣètò pẹ̀lú àyíká ìbéèrè
Ìdánwò	Olùṣiṣẹ́ ìdánwò Node.js + Vitest — 39,000+ ìkéde ìdánwò dúróṣinṣin jákèjádò àwọn fáìlì ìdánwò 5,100+ tí a ń tọpa (ẹyọ, ìṣọ̀kan, E2E, ààbò, ètò àyíká)
Àwọn Pẹpẹ	Kọ̀ǹpútà alátẹ̀jáde (Electron) · Android (Termux) · PWA (aṣàwákiri èyíkéyìí)
CI/CD	GitHub Actions — ìtẹ̀jáde npm aládàáṣiṣẹ́ + Docker Hub nígbà ìtújáde
Àwọn Ọ̀nà Asopọ̀	Ojú-òpó Wẹ́ẹ̀bù · npm · Docker Hub

## 📖 Àkọsílẹ̀

### 📘 Bíbẹ̀rẹ̀

Àkọsílẹ̀	Àpèjúwe
Ìtọ́sọ́nà Olùlò	Àwọn olupèsè, àwọn àkójọpọ̀, ìṣọ̀kan CLI, àti ìmúṣiṣẹ́
Ìtọ́sọ́nà Ìṣètò	Gbogbo ọ̀nà ìfiṣètò, àwọn àtòpọ̀ irinṣẹ́ CLI, ìṣètò protocol, àti àtúnṣe àkókò ìdádúró
Ìtọ́sọ́nà Àwọn Irinṣẹ́ CLI	Ìṣètò fún irinṣẹ́ kọ̀ọ̀kan bíi Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, àti Copilot
Ipò Àjìnnà	Darí OmniRoute àjìnnà kan (VPS) láti CLI kọ̀ǹpútà alágbèéká rẹ nípasẹ̀ àwọn àmì ìráyè tí a fi ààlà sí
Àtòpọ̀ Claude Code	Darí Claude Code sí OmniRoute (agbegbe/àjìnnà) pẹ̀lú `launch` + àwọn prófáìlì fún model kọ̀ọ̀kan
Ìbẹ̀rẹ̀ Kíákíá	Ìfiṣètò ìgbésẹ̀ mẹ́ta → so pọ̀ → ṣètò

### 🔧 Ìṣiṣẹ́ & Ìmúṣiṣẹ́

Àkọsílẹ̀	Àpèjúwe
Ìtọ́sọ́nà Docker	Ṣíṣe Docker, àwọn prófáìlì Compose, Caddy HTTPS, àwọn tunnel, àti àwọn àmì image
Ìtọ́sọ́nà Podman	Ìṣọ̀kan Quadlet systemd, podman-compose, àti SELinux
Ìmúṣiṣẹ́ VM	Ìtọ́sọ́nà pípé: ìṣètò VM + nginx + Cloudflare
Ìmúṣiṣẹ́ Fly.io	Mú un ṣiṣẹ́ lórí Fly.io pẹ̀lú ibi ìpamọ́ tí ó dúró ṣinṣin
Ìtọ́sọ́nà Termux	Ṣiṣẹ́ OmniRoute lórí Android nípasẹ̀ Termux
Ìtọ́sọ́nà PWA	Ìfiṣètò Progressive Web App, caching, àti àwòrán-ẹ̀rọ
Ìtọ́sọ́nà Ìyọkúrò	Ìyọkúrò mímọ́ fún gbogbo ọ̀nà ìfiṣètò
Àtòpọ̀ Àyíká	Gbogbo àwọn oníyípadà `.env` àti àwọn ìtọ́kasí

### 🧠 Àwọn Ẹ̀ya & Àwòrán-ẹ̀rọ

Àkọsílẹ̀	Àpèjúwe
Àwòrán-ẹ̀rọ	Àwòrán-ẹ̀rọ ètò, ìṣàn dátà, àti àwọn iṣẹ́ inú
Ìtọ́sọ́nà Ìfúnpọ̀	Ìlànà aṣàyàn méje: pípa / fúyẹ́ / boṣewa / líle / gíga jù / RTK / títẹ̀lé ara wọn
Ìfúnpọ̀ RTK	Ìfúnpọ̀ àbájáde àṣẹ, àwọn àsẹ̀, ìgbẹ́kẹ̀lé, ìjẹ́rìísí, àti ìmúpadàbọ̀ àbájáde àìṣe
Àwọn Ẹ̀rọ Ìfúnpọ̀	Caveman, RTK, àwọn ìlànà tí ń tẹ̀lé ara wọn, àti àwọn ojú-iṣẹ́ dashboard/API/MCP
Ọ̀nà Ìkọ̀wé Àwọn Òfin Ìfúnpọ̀	Àwọn schema àkójọpọ̀ òfin JSON fún àwọn àsẹ̀ Caveman àti RTK
Àwọn Àkójọpọ̀ Èdè Ìfúnpọ̀	Ìdámọ̀ èdè àti ṣíṣe àkójọpọ̀ òfin Caveman
Ìtọ́sọ́nà Ìfaradà	Àwọn circuit breaker, àwọn àkókò ìtútù, ìlà, ìdènà ìkójọpọ̀ ìbéèrè lojijì, àti fífi TLS ṣe bí ohun mìíràn
Ẹ̀rọ Auto-Combo	Ìṣírò àmì pẹ̀lú kókó mẹ́rìndínlógún, àwọn àkójọpọ̀ ipò, àti ìtọ́jú ara-ẹni
Ìtọ́sọ́nà Proxy	Ètò proxy onípele mẹ́ta, ọjà 1proxy, àti CRUD ìforúkọsílẹ̀
Àwọn Ìpele Ọ̀fẹ́	Àkójọ tí a ṣọ̀kan: àwọn pool àtúnwá 35 tí a kọ sílẹ̀ / àwọn àkọsílẹ̀ ìpele ọ̀fẹ́ 489 tí a tò sínú àkójọ
Àwòrán Àwọn Ẹ̀ya	Ìrìnàjò dashboard aláwòrán pẹ̀lú àwọn àwòrán ojú-iboju
Àkọsílẹ̀ Codebase	Ìtọ́kasí codebase tí ó rọrùn fún olùbẹ̀rẹ̀

### 🤖 Àwọn Protocol & API

Àkọsílẹ̀	Àpèjúwe
Ìtọ́kasí API	Gbogbo àwọn endpoint pẹ̀lú àpẹẹrẹ
Àlàyé OpenAPI	Àlàyé OpenAPI 3.0
Olùpèsè MCP	Àwọn irinṣẹ́ MCP 110, àwọn àtòpọ̀ IDE, àti àwọn client Python/TS/Go
Ìtọ́sọ́nà Olùpèsè MCP	Ìfiṣètò MCP, àwọn ọ̀nà ìgbékalẹ̀ dátà, àti ìtọ́kasí irinṣẹ́
Olùpèsè A2A	Protocol JSON-RPC 2.0, àwọn ọgbọ́n, ìṣànwọ́ dátà, àti ìṣàkóso iṣẹ́
Ìtọ́sọ́nà Olùpèsè A2A	Káàdì aṣojú A2A, àwọn iṣẹ́, àwọn ọgbọ́n, àti ìṣànwọ́ dátà

### 📋 Iṣẹ́ Àkànṣe & Didára

Ìwé	Àpèjúwe
Ìkópa	Ìṣètò àti àwọn ìlànà fún ìdàgbàsókè
Àwoṣe Ẹ̀ka & Ìtújáde	Ibi tí àwọn PR ń tọ́ka sí (`release/*`), àti ohun tí `main` àti àwọn táàgì túmọ̀ sí
Àkọsílẹ̀ Àwọn Àyípadà	Ìtàn ìtújáde kíkún fún ẹ̀yà kọ̀ọ̀kan
Ìlànà Ààbò	Ìjábọ̀ àwọn àìlera àti àwọn ìṣe ààbò
Ìtọ́sọ́nà i18n	Àtìlẹ́yìn fún èdè 42, ìṣàn iṣẹ́ ìtumọ̀, RTL
Àtòjọ Àyẹ̀wò Ìtújáde	Àwọn ìgbésẹ̀ ìfọwọ́sí ṣáájú ìtújáde
Ètò Ìborí	Ọgbọ́n ìborí ìdánwò fún àwọn ìkéde ìdánwò aláìyípadà 39,000+ káàkiri àwọn fáìlì ìdánwò 5,100+ tí a ń tọpinpin

# ⭐ Àwọn Olùkópa Tó Ga Jù > Àwùjọ orísun-ṣíṣí tó ní ìtara ló ń ṣe àgbékalẹ̀ OmniRoute. Àwọn ènìyàn wọ̀nyí ti ṣe àwọn àfikún tó tayọ, tí ó ní ipa tààrà lórí dídára, ìdúróṣinṣin, àti ìtànkálẹ̀ iṣẹ́ náà. **Ẹ ṣéun.** ### Àwọn olùkópa láti òde gẹ́gẹ́ bí iye àwọn pull request tí a dapọ̀

Ipò	Olùkópa	Àwọn PR tí a Dapọ̀	~Àwọn ìlà tí a yí padà
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

_{A dí èyí dúró ní orí ìpẹ̀kun dafb4ae808 ti release/v3.8.50 tó wà láàyè, pẹ̀lú àwọn ìdàpọ̀ títí dé 2026-08-24 05:26:03 UTC. Ìkànìyàn GitHub GraphQL tí a pín sí ojú-ìwé ní àwọn PR 5,911 tí a dapọ̀: 2,707 láti ọ̀dọ̀ olówó ibi ìpamọ́ náà, 179 láti ọ̀dọ̀ Dependabot, àti àwọn PR 3,025 láti òde, láti ọ̀dọ̀ àwọn olùkópa ọ̀tọ̀ọ̀tọ̀ 535. “Àwọn ìlà tí a yí padà” ni àwọn àfikún + àwọn ìyọkúrò GitHub, ó sì ní àwọn fáìlì tí a ṣẹ̀dá, àwọn lockfile, àwọn àkójọ, àwọn ìtumọ̀ àti ìwé àkọsílẹ̀ nínú; ìyípadà léraléra ni, kì í ṣe LOC tí a kọ. A pa àwọn tó ní àmì kan náà mọ́ ní ibi tí ààlà náà wà.} ### Àwọn commit tí GitHub dá mọ̀ sí olùkópa

backryun _{🥇 Àwọn àtúnṣe 220 tí a dá mọ́ GitHub}	Paijo _{🥈 Àwọn àtúnṣe 219 tí a dá mọ́ GitHub}	Randi _{🥉 Àwọn àtúnṣe 108 tí a dá mọ́ GitHub}	Ravi Tharuma _{🏅 Àwọn àtúnṣe 81 tí a dá mọ́ GitHub}	Chris _{🏅 Àwọn àtúnṣe 70 tí a dá mọ́ GitHub}	Markus Hartung _{🏅 Àwọn àtúnṣe 69 tí a dá mọ́ GitHub · wọ́n dọ́gba ní ipò #6}
Dizzle _{🏅 Àwọn àtúnṣe 69 tí a dá mọ́ GitHub · wọ́n dọ́gba ní ipò #6}	Jan Leon _{🏅 Àwọn àtúnṣe 64 tí a dá mọ́ GitHub}	zenobit _{🏅 Àwọn àtúnṣe 62 tí a dá mọ́ GitHub}	Bob.Hou _{🏅 Àwọn àtúnṣe 51 tí a dá mọ́ GitHub · wọ́n dọ́gba ní ipò #10}	Xiangzhe _{🏅 Àwọn àtúnṣe 51 tí a dá mọ́ GitHub · wọ́n dọ́gba ní ipò #10}

_{A tún ṣàyẹ̀wò ní 2026-08-24 06:14:31 UTC: Àwọn àtúnṣe tí a dá mọ́ GitHub gẹ́gẹ́ bí API Contributors ibi ìpamọ́ náà ṣe ròyìn fún ẹ̀ka àìrípò release/v3.8.50. API náà dá àwọn ìdánimọ̀ 525 padà (àwọn aṣàmúlò 415, àwọn bot 2, àwọn aláìlórúkọ 108); tábìlì yìí yọ olùtọ́jú, àwọn bot àti àwọn ìdánimọ̀ aláìlórúkọ kúrò, ó sì dá àwọn tó dọ́gba nínú ìdíje dúró. Ó yàtọ̀ sí ìṣètò ipò PR tí a dapọ̀ lókè àti ìkànìyàn metadata Git ti ènìyàn 639 ní ìsàlẹ̀.} > 🙏 Àwọn ẹ̀yà iṣẹ́, àtúnṣe àṣìṣe, àti àwọn ìmúdára amáyédẹrùn ti àwọn olùdásíwọlé wọ̀nyí jẹ́ **apá pàtàkì** ti ohun tó mú kí OmniRoute ṣeé gbẹ́kẹ̀lé, tó sì ní àwọn ẹ̀yà iṣẹ́ lọ́pọ̀. Gbogbo pull request, gbogbo ọ̀ràn ìdánwò, àti gbogbo fáìlì ìtumọ̀ i18n ṣe pàtàkì. Àwọn ènìyàn bíi tiwọn ni wọ́n ń kọ́ open source.

---
## 💖 Àwọn Olùgbọ́wọ́

Ọpẹ́ àtọkànwá sí àwọn ènìyàn tí wọ́n ń fi owó ara wọn ṣe ìnáwó fún OmniRoute — gbogbo àfikún ń jẹ́ kí iṣẹ́ náà wà lọ́fẹ̀ẹ́, ní òmìnira, kí ó sì máa tẹ̀ síwájú.

Andrew
_{💛 Olùgbọ́wọ́ oṣooṣù tó ṣì ń ṣiṣẹ́}

Vlad I
_{💛 Olùgbọ́wọ́ oṣooṣù tó ṣì ń ṣiṣẹ́}

Paco Cartones
_{💛 Olùgbọ́wọ́ ìgbà kan tó ṣì ń ṣiṣẹ́}

Prof. Igor Morais
_{💛 Olùtìlẹ́yìn ìgbà kan tẹ́lẹ̀ rí}

longtao
_{💛 Olùtìlẹ́yìn ìgbà kan tẹ́lẹ̀ rí}

_{… àti àwọn mìíràn tí wọ́n fẹ́ kí ìdánimọ̀ wọn wà ní ìkọ̀kọ̀ 💛} _{A tún fìdí àwọn GitHub Sponsors ti gbangba múlẹ̀ ní 2026-08-24. Ipò activeOnly ti GitHub ló ń pinnu àwọn àmì aláṣiṣẹ́ lókè; a ṣì ń dúpẹ́ lọ́wọ́ àwọn olùtìlẹ́yìn ìgbà kan ti gbangba tí a ti sọ̀rọ̀ nípa wọn tẹ́lẹ̀, àwọn olùgbọ́wọ́ aládàáni sì ṣì wà láìlórúkọ.} 💖 Di olùgbọ́wọ́ → — gbogbo dọ́là ń jẹ́ kí OmniRoute wà lọ́fẹ̀ẹ́ àti ní òmìnira.

## 👥 Àwọn Olùkópa 600+

[![Àwọn Olùkópa](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{A ṣe àyẹ̀wò ní 2026-08-24 lórí ìpìlẹ̀ tí a dì mọ́ ac02c5b42f, a sì tún ṣàyẹ̀wò ní orí tuntun ti release/v3.8.50 tó jẹ́ dafb4ae808: àwọn ìdánimọ̀ Git ènìyàn 639 tí a ti ṣe déédé — 407 fara hàn gẹ́gẹ́ bí àwọn olùkọ àtúnṣe (pẹ̀lú olùtọ́jú), 232 sì fara hàn nínú àwọn àfikún Co-authored-by tí a sọ ní kedere nìkan. Ìkànìyàn náà ń ṣe àwọn orúkọ-ìdánimọ̀ noreply GitHub déédé, kò ka àwọn ìdánimọ̀ bot/aṣojú/iṣẹ́/àfikún-pò 26 sí, kò sì dapọ̀ àwọn àdírẹ́sì ímeèlì lasán nítorí pé àwọn orúkọ ìfihàn wọn bá ara wọn mu.} ### Bí A Ṣe Lè Kópa 1. Ṣe fork ibi ìpamọ́ náà 2. Ṣẹ̀dá ẹ̀ka láti orí **aláṣiṣẹ́** `release/vX.Y.Z` (kì í ṣe `main`) — wo [Àwòṣe Ẹ̀ka àti Ìtújáde](docs/ops/BRANCHING_MODEL.md) 3. Ṣẹ̀dá ẹ̀ka àfikún rẹ (`git checkout -b feat/amazing-feature`) 4. Ṣe commit àwọn àyípadà rẹ (`git commit -m 'feat: add amazing feature'`) 5. Ṣe push sí ẹ̀ka náà (`git push origin feat/amazing-feature`) 6. Ṣí Pull Request kan pẹ̀lú **base = ẹ̀ka `release/vX.Y.Z` yẹn** Wo [CONTRIBUTING.md](CONTRIBUTING.md) fún àwọn ìlànà ẹ̀kúnrẹ́rẹ́. ### Ṣíṣe Ìtújáde Ẹ̀yà Tuntun ```bash # Ṣẹ̀dá ìtújáde kan — npm publish máa ṣẹlẹ̀ láìfọwọ́ṣe VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Àwọn Ìràwọ̀

## 🌍 StarMapper

## 🙏 Ọ̀pẹ́

OmniRoute dúró lórí èjìká àwọn òmìrán. Ó bẹ̀rẹ̀ gẹ́gẹ́ bí ẹ̀ka kan láti inú **[9router](https://github.com/decolua/9router)** àti àtúnkọ iṣẹ́ akanṣe Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** sí TypeScript — láti ibẹ̀ sì ni gbogbo ẹ̀ka-ètò tó wà nísàlẹ̀ ti gba ìmísí láti inú iṣẹ́ akanṣe orísun-ṣíṣí kan tó ti kọ́kọ́ ṣe é. Ọ̀kọ̀ọ̀kan wọn ló ṣe àgbékalẹ̀ apá pàtó kan nínú OmniRoute. Èyí ni ọ̀nà wa láti dúpẹ́ lọ́wọ́ gbogbo wọn. 🙏 > ⭐ a ṣàyẹ̀wò iye àwọn ìràwọ̀ nípasẹ̀ GitHub REST API ní August 24, 2026 — ẹ lọ fún àwọn iṣẹ́ akanṣe wọ̀nyí ní ìràwọ̀. Àwọn iye náà jẹ́ àwòrán pàtó tí a mú ní ọjọ́ yẹn, wọ́n sì máa yí padà bí ó ṣe yẹ. ### 🧬 Ìran & ẹnu-ọ̀nà

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
9router	26,161	Àkànṣe ìpilẹ̀ṣẹ̀ tí a kọ fork yìí lé lórí — tí a sì mú gbòòrò sí i níbí pẹ̀lú àwọn API oníṣọ̀nà-púpọ̀ àti àtúnkọ TypeScript ní kíkún.
CLIProxyAPI	48,497	Ìmúṣẹ Go tí ó fún ìṣípò JavaScript / TypeScript yìí ní ìmísí.
LiteLLM	57,100	Ẹnubodè AI tí àkójọpọ̀ dátà ìdíyelé gbogbogbò rẹ̀ ń pèsè fún ìmúdójúìwọ̀n ìtọ́pasẹ̀ iye owó wa, tí àwòṣe ìṣọ̀kan olùpèsè rẹ̀ sì ṣe ìtọ́sọ́nà fún ìrìnàjò wa.
codex-chatgpt-web	1,410	Orísun MIT tí a ṣàmúlò sínú afárá ChatGPT Web → Codex Responses tí a ṣàkójọ mọ́ inú rẹ̀, pẹ̀lú àwọn ohun ìbámu fún ìgbà aṣàwákiri, ìṣètò férémù ìdáhùn, ìlò àti ìṣàwárí wẹ́ẹ̀bù.
free-claude-code	48,112	Àwọn àpẹẹrẹ tí a ṣí lọ sínú ìmúpadàbọ̀ ṣiṣàn, àwọn orúkọ-àpèjúwe tí kò ní ìrònú, ìṣàwárí wẹ́ẹ̀bù àfẹ́yinti, àwọn ààlà fèrèsé-asunwọ̀n, ìbòmọ́lẹ̀ àkọsílẹ̀ àti àwọn ìṣàn olùpilẹ̀ṣẹ̀ tí a mú lágbára.
composer-api	322	Àwọn àpẹẹrẹ yíyan irinṣẹ́ Cursor Composer, ìdíwọ̀n àbájáde àti ìfọwọ́sowọ́pọ̀ irinṣẹ́ tí a ṣàmúlò sínú olùṣiṣẹ́ Cursor abinibi.
codex-multi-auth	457	Àwọn àpẹẹrẹ ìwọlé tuntun àti yíyí refresh-token tí a ṣí lọ sínú ìfàṣẹsí OAuth Codex lẹ́ẹ̀kansi.
opencode-anthropic-auth	510	Àwọn àiyípadà àtúnṣe àìyẹsẹ̀ tó bá Claude Code mu àti ìhùwàsí àkọlé ìdíyelé tí a sọ di gbogbogbò sínú afárá OmniRoute tí ìṣètò ń darí.
grok2api-merged	2	Àwọn ìbámu àwòṣe Grok rẹ̀, olùṣẹ̀dá Statsig fake-TypeError, àwọn àiyípadà àìyẹsẹ̀ fún ìbéèrè àti ẹ̀rọ, àti olùṣàkóso ìdáhùn NDJSON ni a ṣàmúlò ní kíkún sínú olùṣiṣẹ́ Grok Web ti OmniRoute.
TQZHR/grok2api	705	Orísun kóòdù àpapọ̀ pàtàkì lẹ́yìn grok2api-merged; àwọn ìmúṣẹ àwòṣe, àkọlé, payload, Statsig àti olùṣàkóso rẹ̀ ni a dáàbò bò nínú ìran Grok Web.
chenyme/grok2api	7,520	Orísun MIT ìpìlẹ̀ fún payload Grok àti àwọn àiyípadà àìyẹsẹ̀ ẹ̀rọ, olùṣẹ̀dá Statsig, àti olùṣàkóso `result.response` tí a gbé kọjá nípasẹ̀ TQZHR àti grok2api-merged.
grok2api-pro	27	Orísun àpapọ̀ tí grok2api-merged fún ní ìyìn fún fẹ́lẹ́fẹ́lẹ́ àkójọpọ̀ aṣojú rẹ̀; OmniRoute pa àkọsílẹ̀ ìran náà mọ́ ṣùgbọ́n kò sọ pé ó ṣí àkójọpọ̀ aṣojú náà wá sínú olùṣiṣẹ́ Grok Web rẹ̀ tí ó ní ààlà.
GrokProxy	50	Aṣojú Grok rẹ̀ tí kúkì ti fìdí rẹ̀ múlẹ̀ àti àpẹẹrẹ ṣiṣàn `result.response.token` ṣe ìtọ́sọ́nà fún ọ̀nà ìgbékalẹ̀ Grok Web ti OmniRoute.
GrokBridge	5	Ìmúṣẹ Grok Web ìpilẹ̀ṣẹ̀ ṣàyẹ̀wò àpẹrẹ upstream HTTP/aṣàwákiri rẹ̀; ọ̀nà HTTP tààrà rẹ̀ wá láti GrokProxy, nítorí náà a kò sọ pé a ṣe ìṣípò kóòdù olómìnira kankan.
grok-web-api	14	Àwọn schema Rust `ChatOptions` àti àpò-ìdáhùn rẹ̀ ṣe ìtọ́sọ́nà fún àwọn irú ìbéèrè Grok TypeScript àti ìdáhùn ṣiṣàn ti OmniRoute.

### 🗜️ Àyíká-ọ̀rọ̀ & ìfúnpọ̀ token — àwọn ẹ̀rọ ìṣiṣẹ́

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
Caveman	100,538	Àkànṣe “kí ló dé tí a fi ń lo token púpọ̀ nígbà tí token díẹ̀ lè ṣe iṣẹ́ náà” tó gbajúgbajà — ìmọ̀ràn ọ̀rọ̀-àpáta rẹ̀ ló ń ṣe agbára fún ipò ìfúnpọ̀ boṣewa wa àti àwọn òfin 30+ fún yíyọ ọ̀rọ̀-àfikún kúrò/ìṣókí.
RTK – Rust Token Killer	77,185	Ìfúnpọ̀ àbájáde àṣẹ tó ní iṣẹ́-gíga — ó fún ẹ́ńjìnnì RTK wa, JSON filter DSL, ìmúpadàbọ̀ àbájáde àìṣe àti ọ̀nà ìṣiṣẹ́ alápele RTK → Caveman ní ìmísí.
headroom	67,310	Ìfúnpọ̀ àyíká-ọ̀rọ̀ tí a lè yí padà sípò (SmartCrusher) — ó fún ẹ́ńjìnnì `headroom` wa àti àpẹẹrẹ àmì-ìmúpadàbọ̀ `ccr` ní ìmísí.
LLMLingua	6,598	Ìwádìí ìfúnpọ̀ prompt (LLMLingua / LLMLingua-2) — ó fún ẹ́ńjìnnì `llmlingua` wa tó jẹ́ async, tó dáàbò bo kóòdù, tí ó sì ń bá a lọ bí ìṣòro bá ṣẹlẹ̀ ní ìmísí.
llmlingua-2-js	31	Ìyípadà JS/ONNX (MobileBERT / XLM-RoBERTa) tí a lò gẹ́gẹ́ bí ẹ̀yìn-iṣẹ́ worker-thread fún ẹ́ńjìnnì LLMLingua wa.
Troglodita	40	Ìfúnpọ̀ token PT-BR — ó ń ṣe agbára fún àkójọpọ̀ èdè pt-BR wa: dídín àtúnsọ kù àti yíyọ ọ̀rọ̀-àfikún kúrò tí a ṣètò fún gírámà Pọ́túgí-Brasil.
ponytail	108,957	Ọgbọ́n YAGNI-coder “olùgbéejáde àgbà ọ̀lẹ” tó gbajúgbajà — ó fún Àṣà Àbájáde less-code wa ní ìmísí: ìdarí sí ìyípadà tó kéré jù tí ó sì ń ṣiṣẹ́, tó ń dín _kóòdù tí a ṣẹ̀dá_ kù (ẹgbẹ́ ojú-ìwọ̀n àbájáde fún ọ̀rọ̀ ṣókí Caveman).
i-have-adhd	23,526	A mú àṣà ìdáhùn rẹ̀ tó fi ìgbésẹ̀ síwájú, tó sì rọrùn fún àwọn tó ní ADHD, wá sínú àṣà àbájáde ṣókí OmniRoute ní èdè márùn-ún.

### 🧩 Àwọn fọ́ọ̀mù ṣókí, ìwádìí token àti irinṣẹ́ tó mọ kóòdù

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
TOON	25,233	Token-Oriented Object Notation — àwòṣe rẹ̀ tó jẹ́ ti àwọn ọ̀wọ̀n, pẹ̀lú àkọlé-àti-àwọn-ìlà, ló ṣe àgbékalẹ̀ ìpele ìṣókí tábìlì wa.
GCF – Graph Compact Format	41	Fọ́ọ̀mù gíràfù ṣókí àti àpẹrẹ ìṣòro-gbogbogbòò rẹ̀ ló ṣe ìtọ́sọ́nà fún ìṣókí tábìlì OmniRoute àti fọ́ọ̀mù codec Headroom.
gcf-typescript	4	Ìmúṣẹ MIT TypeScript tí a fi kún iṣẹ́ náà ní tààrà, tí a sì mú gbòòrò gẹ́gẹ́ bí codec ìṣòro-gbogbogbòò Headroom.
token-optimizer-mcp	494	Kaṣe Brotli/SQLite + ìyàtọ̀ àyíká-ọ̀rọ̀ fún sáà kọ̀ọ̀kan — ó fún ẹ́ńjìnnì `session-dedup` wa ní ìmísí.
token-savior	1,122	Ìṣókí àbájáde Bash + àwọn àpẹrẹ MCP — ó fún ìlànà dídáwọ́ ìfúnpọ̀ wa àti dídín àtòjọ irinṣẹ́ MCP kù ní ìmísí.
token-saver	138	Ìfúnpọ̀ àbájáde tó mọ àkóónú, fún irú fáìlì kọ̀ọ̀kan, pẹ̀lú dídáwọ́ tó mọ ìkùnà — ó fìdí ìtọ́ka wa fún irú kọ̀ọ̀kan àti fífo ìjèrè tó kéré jù sílẹ̀ múlẹ̀.
token-optimizer	1,951	“Wá àwọn token iwin” — àpẹẹrẹ rẹ̀ fún gbígbé iṣẹ́ lọ sí ibòmíràn + handle tí a lè mú padà ló ṣe ìtọ́sọ́nà fún èrò ìgbéjáde CCR wa.
TokenMizer	28	Àwòrán ìlànà gíràfù-sáà + yíyọ ìlà àdáwòkọ kúrò láàárín àwọn ìyípadà, tó ṣe ìtọ́sọ́nà fún àpẹrẹ session-dedup wa.
OmniCompress	3	Rust JSON oníwọ̀n + ìmúpadàbọ̀ tó dá lórí àkóónú + yíyọ àdáwòkọ kúrò láàárín àwọn ìfiránṣẹ́ — ó fìdí àpẹrẹ ẹ́ńjìnnì `headroom`/`ccr`/`session-dedup` wa àti òfin àìyípadà tó dúró ṣinṣin fún kaṣe pé “fọ́ọ̀mù tí a fún pọ̀ kò gbára lé ipò” múlẹ̀.
mcp-compressor	113	Ìfúnpọ̀ schema/àpèjúwe irinṣẹ́ MCP — ó ṣe ìtọ́sọ́nà fún dídín iye àwọn àtòjọ irinṣẹ́ MCP wa kù.
RepoMapper	197	Ìṣètò ipò máàpù repo ní àṣà Aider — ó ṣe ìtọ́sọ́nà fún àyẹ̀wò máàpù repo / ìṣètò ipò ìmúpadàbọ̀ wa.
quiet-shell-mcp	4	Dídín àbájáde shell kù ní ọ̀nà àsọyé lórí MCP — ó fìdí ìṣókí àbájáde bash wa tó jẹ́ àsọyé múlẹ̀.
ts-morph	6,162	Àkójọpọ̀ irinṣẹ́ TypeScript Compiler API — ó fún yíyọ comment kúrò tó dá lórí parser wa, tí ó ń pa string, template àti regex literals mọ́, ní ìmísí.

### 🧠 Ìrántí & RAG

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
Mem0	63,902	Ìpele ìrántí àgbáyé — àwòṣe aṣojú-gẹ́gẹ́-bí-ààlà-kíkọ/kíkà rẹ̀ ló ṣe ìtọ́sọ́nà ìṣètò ìrántí wa.
Letta (MemGPT)	24,382	Àwọn aṣojú tí wọ́n ní ipò pẹ̀lú ìrántí onípele — ó fún àwòṣe onípele Context Control & Recovery (CCR) wa ní ìmísí.
WFGY	1,781	Ìsọ̀rí ProblemMap ti àwọn ọ̀nà ìkùnà RAG/LLM mẹ́rìndínlógún tí ń tún ṣẹlẹ̀ — àwọn ọ̀rọ̀ àpapọ̀ nínú ìtọ́sọ́nà ìṣàwárí àti àtúnṣe ìṣòro wa.

### 🛰️ Àyẹ̀wò ìrìnàjò dátà, MITM & aṣojú aláìhàn

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
llm-interceptor	66	Ìdásẹ́wọ̀n/ìtúpalẹ̀ MITM ti ìrìnàjò dátà olùrànlọ́wọ́-kóòdù ↔ LLM ló ṣe ìtọ́sọ́nà àwọn àìní ìbẹ̀rẹ̀ fún Traffic Inspector. Àwọn módù mẹ́rin tí a ti ṣe àwárí rẹ̀ tẹ́lẹ̀ — ìṣọ̀kan SSE, ìṣọ̀kan ìjíròrò, ìbòmọ́lẹ̀ àṣírí àti ìmọ́tótó àkọlé — ni a ti fi àwọn ìmúlò clean-room olómìnira tí a gbé karí àwọn òṣùwọ̀n ìlànà gbogbogbò rọ́pò. Àwọn ojú-ìṣiṣẹ́ host-passthrough méjì (`passthrough.ts` àti `_internal/bypass.cjs`) ṣì jẹ́ àwọn ìmúlò abẹ́nú OmniRoute tí a pín sí ẹ̀ka lọ́nà olómìnira; a kò tún wọn kọ gẹ́gẹ́ bí apá kan ìrọ́pò náà.
ProxyBridge	5,995	Ìdarí aṣojú aláìhàn fún ìlànà-ìṣiṣẹ́ kọ̀ọ̀kan — ó fún ìfopin sí MITM wa tí ìkọlù kò lè bà jẹ́, àwọn àsìkò-ipari àìṣiṣẹ́ socket, ìdánimọ̀ ìlànà-ìṣiṣẹ́ `/proc` àti ìmúdá TPROXY ní ìmísí.

### 📚 Dátà àwòṣe, àkíyèsí & UI

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
models.dev	6,555	Àkójọpọ̀ dátà ṣíṣí ti àwọn àlàyé, iye owó àti agbára àwòṣe AI — tí a ń múṣiṣẹ́pọ̀ lọ́nà abinibi sínú àkójọ àwòṣe wa.
React Flow / xyflow	38,108	Ilé-ìkàwé àwòrán onípò-ọ̀nà tí ń fún Compression Studio àti Combo/Routing Studio wa tó ń ṣiṣẹ́ ní àkókò gidi ní agbára.
LangGraph	40,314	Ìfihàn àwòrán ìṣàn-iṣẹ́ alààyè ti LangGraph Studio fún àwòrán kasikedi àkókò-gidi ti àwọn Studio wa ní ìmísí.
Langfuse	33,592	Àwòṣe àkíyèsí trace → span → generation rẹ̀ ló ṣe ìtọ́sọ́nà àwòrán waterfall Compression Studio wa.
Kiali	3,631	Àkíyèsí àwọ̀n-iṣẹ́ Istio — ó fún àwọn àmì circuit-breaker wa àti àwọn àwòrán etí-àṣìṣe nínú Routing/Combo Studio ní ìmísí.
lobe-icons	2,428	Àwọn àmì ìdámọ̀ oníṣòwò AI/LLM tí ń ṣàfihàn àwọn àwòrán aṣojú olùpèsè jákèjádò pánẹ́ẹ̀lì wa.
flag-icons	12,354	Ó pèsè àwọn àsìá SVG tí ìwé-àṣẹ MIT bò, tí olùyan èdè README ń lò.

### 🛡️ Ààbò

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
awesome-secure-defaults	721	Àkójọ tí a fara balẹ̀ ṣàkójọ ti àwọn ilé-ìkàwé tó ní ààbò látìpilẹ̀, èyí tó ń darí àwọn yíyàn ààbò wa (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Àwọn irinṣẹ́ àfikún

Àkànṣe	⭐	Bí ó ṣe fún OmniRoute ní ìmísí
ClawRouter	6,564	Ó fún ìmúkúrò àwọn ìbéèrè àdáwòkọ, ìyípadà-padà pàjáwìrì tí kò ná owó, àwọn ọgbọ́n Auto-Combo tí a lè so mọ́ ọn, àti ìpínsọ̀rí èrò inú onírúurú èdè ní ìmísí.
Antigravity-Manager	30,652	Ìṣàtúnṣe àwòṣe tó mọ àkọọ́lẹ̀, ìfọwọ́sí ipa-ọ̀nà fáìlì ìṣiṣẹ́, àti ìhùwàsí àmì ètò rẹ̀ ló ṣe ìtọ́sọ́nà àsìkò-ìṣiṣẹ́ Antigravity ti OmniRoute.
vscode-antigravity-cockpit	4,817	Ọ̀nà ìṣàfihàn ìkà-sẹ́yìn ìtúnṣètò ìwọ̀n tó ṣókí rẹ̀ ló fún ìṣàfihàn ààlà olùpèsè tó bá a mu nínú OmniRoute ní ìmísí.
AionUi	32,230	Àwọn ìsopọ̀ ACP rẹ̀ ló fún ìṣàwárí aládàáṣiṣẹ́ ti OmniRoute fún àwọn aṣojú CLI tí a ti fi sí ẹrọ ní ìmísí.
CodexBar	20,507	Ó ṣe ìdánimọ̀ ojú-ìṣiṣẹ́ ìwọ̀n Grok Build; lẹ́yìn náà, OmniRoute fìdí ọ̀nà-kíkó dátà alààyè múlẹ̀, ó sì ṣe àtúnṣe rẹ̀ lọ́nà olómìnira.

## 📄 Ìwé-àṣẹ Ìwé-àṣẹ MIT - wo [LICENSE](LICENSE) fún àlàyé. ---

**[⬆ Padà sí òkè](#-omniroute)** · A kọ́ ọ pẹ̀lú ❤️ fún àwùjọ AI orísun-ṣíṣí. _{OmniRoute v3.8.52 · Node ≥22.22.2 · Ìwé-àṣẹ MIT · omniroute.online}