## 💰 ~1.62B Àwọn Token / Oṣù Lórí Àwọn Ìpele Ọ̀fẹ́ Ẹlẹta
> **Mu àwọn àkáǹtì olùpèsè tirẹ wá.** Èyí jẹ́ àpapọ̀ ìṣirò lórí àwọn ìpele ọ̀fẹ́ ẹlẹta tí ó yẹ ní ẹ̀yà, kì í ṣe ẹ̀bùn token láti ọ̀dọ̀ OmniRoute. Forúkọsílẹ̀, gba àwọn ìfàṣẹsí (credentials) níbi tí ó ṣe pàtàkì, kí o sì so àwọn olùpèsè tí o lè lò pọ̀; olùpèsè kọ̀ọ̀kan ni ó ń ṣàkóso àwọn òpin rẹ̀, ìwàláàyè rẹ̀, àti àwọn òfin rẹ̀.
>
> Kíkó àwọn ìpele ọ̀fẹ́ pọ̀ pẹ̀lú ọwọ́ jẹ́ iṣẹ́ tí ń láya — ọ̀pọ̀ jọ àwọn SDK, ọ̀pọ̀ jọ àwọn òpin iyara, àti àìmọ̀ iye ohun tí o ní tóòótọ́. OmniRoute ṣe àtòjọ **467 àwọn ìkọsílẹ̀ ìpele ọ̀fẹ́ lórí 34 àwọn kọ́kọ́rọ́ pool àtúnwáyé** ó sì ń ṣe ìṣirò àkòtán token láti **17 àwọn pool pẹ̀lú ìnawó oṣù rere tí a ti kẹ́jádé àti àádọ́ta òpin Groq fún àwọ̀ṣe kọ̀ọ̀kan**, tí a yọ àwẹ̀lẹ̀dàlẹ̀ kúrò nípasẹ̀ pool àpínlọ́pọ̀. Àwọn ìpín (quota) tí ó ṣí ṣí nìkan lẹ́yìn ìṣàyẹ̀wò ìdánimọ̀ agbègbè (lónìí: ModelScope) ni a fi hàn ní ẹ̀yà, +~6M lẹ́yìn ìfàṣẹsí ìdánimọ̀ agbègbè, kò sì jẹ́ dídípapọ̀ mọ́ àkòtán rárá. Àbájáde náà máa wà ní híhàn lórí dashboard (`/dashboard/free-tiers`).
> Àkótán ere-ìdàrà ti ojú-ìwé `/dashboard/free-tiers` lọ́wọ́lọ́wọ́. Ọ̀nà ìṣirò kíkún (yíyọ àwẹ̀lẹ̀dàlẹ̀ pool, àwọn ìpele kírèdìtì, àwọn òfin olùpèsè): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Àwọn nọ́ńbà wọ̀nyí ni a ń ṣe àtúnṣe àyẹ̀wò wọn ní gbogbo ọ̀sẹ̀ méjì lórí àtòjọ lọ́wọ́lọ́wọ́, wọ́n sì ń **rìn ní ìgbà méjèèjì** — olùpèsè kan parí ìpele ọ̀fẹ́ rẹ̀, nọ́ńbà náà sì dínkù; ohun tuntun kan sì dé, ó gòkè. A ń kẹ́jádé ohun tí àtòjọ náà ṣe ìṣirò rẹ̀ ní tóòótọ́, kì í ṣe ìṣirò tó dára jù tí a yí ká jọ.
⭐ Fún repo náà ní ìràwọ̀ tí OMNIROUTE bá ràn ọ́ lọ́wọ́ láti fipamọ́ owó àti láti mú iṣẹ́ rẹ rọrùn.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Dára pọ̀ mọ́ àwùjọ náà
**👋 Tẹ̀ lé olùtọ́jú — kí o jẹ́ ẹni àkọ́kọ́ láti gba àwọn olùpèsè tuntun, àwọn ìtúpalẹ̀ àti àwọn ìmọ̀ràn:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Àwọn ìbéèrè, àwọn ìmọ̀ràn nípa olùpèsè, àtèlúwọ́ iṣẹ́ àti ìrànlọ́wọ́ → [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) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Ẹnù-Ọ̀nà Ń Tẹ̀síwájú Láti Dàgbàsókè
## 🆓 Ṣàgbékalẹ̀, so ọlùpèsè kan pọ̀, lẹ́yìn náà darí àwọn ìbéèrè nípasẹ̀ òpin kan ṣoṣo
```bash
# Lẹ́yìn tí o bá so ọlùpèsè kan pọ̀, da kọ́kọ́rọ́ OmniRoute rẹ kọ̀ 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ẹ. Ìṣàgbékalẹ̀ tuntun lè má ní àwọn àfọ̀nàmọ̀ láìsí-kọ́kọ́rọ́ tó yẹ rárá, ọlùpèsè láìsí-kọ́kọ́rọ́ sì lè kọ̀ àwọn oníbàárà láti òde. Àwọn ọlùpèsè tí a ṣàmì sí `tos: avoid`, pẹ̀lú Kiro, ti yọ wọ́n kúrò nínú afọmọ àdàṣe ní àtìbẹ̀rẹ̀; sisopọ̀ àkáùntì kò ṣe àtẹ́lẹwọ́n ètò yẹn. Wo [Ìtọ́nisọ́nà Àwọn Ipele Ọ̀fẹ́](docs/getting-started/FREE-TIERS-GUIDE.md) kí o tó yan ọlùpèsè kan.📦 Àwọn skíríìpùtì ìbẹ̀rẹ̀ kíákíá dàkọ-fírà fún **Python, Node.js, PHP, àti cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Ìlérí Náà
# 🤔 Kí ló dé tí OmniRoute?
## 🤝 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 — Ọjà Àkọ́kọ́
> **Combo** jẹ́ ẹ̀wọ̀n àwọn model tí OmniRoute ń darí kọjá lórí **láìfọwọ́ṣe**. Bí quota bá tán, provider kan bá kùnà, tàbí iye owó bá fò sókè, combo náà lè lọ sí model tó péye àti tó ń ṣiṣẹ́ dáadáa lẹ́yìn náà. 🛡️
### ⚡ Kò nílò àtúnṣe — kan lo `auto`
Kò sí combo 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 láti inú àwọn provider tí o ti sopọ̀, pẹ̀lú ìṣírò àmì ní àsìkò gidi:
ID Model
Ohun tí ó ń mú kí ó dára jù
auto
🎯 Ìṣètò àìyípadà tó ní ìwọ̀ntúnwọ̀nsì (LKGP — ó dúró mọ́ provider rere tó lò kẹ́yìn)
auto/coding
🧑💻 Àwọn ìwọ̀n tó fi dídára ṣáájú fún ṣíṣẹ̀dá code
auto/fast
⚡ Àkókò ìdádúró tó kéré jù ni àkọ́kọ́
auto/cheap
💰 Èyí tó din owó jù fún token kọ̀ọ̀kan ni àkọ́kọ́
auto/subscription
🎟️ Quota subscription tí o ti ń sanwó fún nìkan — ó máa dáwọ́ dúró tí kò bá sí, kò sì ní lo àṣàyàn ìpẹ̀yìndà tó máa fa owó rárá (ìtọ́sọ́nà)
auto/thrifty
🪜 Quota ètò náà ni àkọ́kọ́, lẹ́yìn náà ìpele kan lẹ́ẹ̀kan sí àwọn àṣàyàn tí a ń sanwó fún tó din owó jù — padà sórí ètò náà lẹ́yìn tí ó bá tún bẹ̀rẹ̀ (ìtọ́sọ́nà)
auto/offline
🔋 Èyí tó ní àyè quota / rate-limit tó pọ̀ jù ni àkọ́kọ́
auto/smart
🔭 Dídára ni àkọ́kọ́ + ìṣàwárí 10% láti ṣàwárí àwọn model tó dára jù
auto/lkgp
📌 Dídúró mọ́ provider rere tó mọ̀ kẹ́yìn ní kedere
auto/chaos
🧪 Pínpín lọ́pọ̀ ìtọ́sọ́nà ní ìgbà kan sí àkójọpọ̀ àwọn model (ọ̀kan fún provider kọ̀ọ̀kan, 5 ní ìṣètò àìyípadà), ó dá ìdáhùn kan padà; ìpè upstream kan fún model kọ̀ọ̀kan nínú àkójọpọ̀ náà, kì í ṣe fífi àṣìṣe sínú ètò
##
### 🔀 Tàbí kọ́ tìrẹ — ọgbọ́n ìdarí 20
Gbogbo ọgbọ́n **20** náà — parapọ̀ wọn bí o ṣe fẹ́ fún ìgbésẹ̀ combo kọ̀ọ̀kan:
#
Ọgbọ́n
Ohun tí ó ń ṣe
1
priority
Àtòjọ tó tẹ̀lé ètò ibi-àfojúsùn-àkọ́kọ́ — lo ọ̀kọ̀ọ̀kan títí yóò fi tán kí o tó lọ sí èkejì 🥇
2
fill-first
Kún quota ibi-àfojúsùn kọ̀ọ̀kan pátápátá kí o tó tẹ̀síwájú
3
weighted
Àṣàyàn láìlétò tó dá lórí ìwọ̀n ibi-àfojúsùn kọ̀ọ̀kan
4
round-robin
Yí ká àwọn ibi-àfojúsùn ní ìtòlẹ́sẹẹsẹ
5
p2c
Pínpín ẹrù láìlétò pẹ̀lú agbára-àṣàyàn-méjì
6
least-used
Yan ibi-àfojúsùn tó ní ẹrù lọ́wọ́lọ́wọ́ tó kéré jù
7
random
Àṣàyàn láìlétò tó dọ́gba (pẹ̀lú yiyọ àwọn àdáwòkọ kúrò)
8
strict-random
Àṣàyàn láìlétò láìyọ àwọn àtúnṣe kúrò 🎲
9
cost-optimized
Dín $ fún request kọ̀ọ̀kan kù ní lílo iye owó catalog àsìkò gidi 💸
10
headroom
Yan ibi-àfojúsùn tó ní quota tó kù jù
11
quota-weighted
Foju kọ àwọn account tí quota wọn ti tán, lẹ́yìn náà yan ní ìbámu pẹ̀lú quota tó kù ÷ ẹrù tó ń lọ lọ́wọ́ — àwọn ìjíròrò tó ti wà yóò dúró mọ́ ibi tí a so wọ́n mọ́ ⚖️
12
reset-window
Fi ibi-àfojúsùn tí àkókò quota rẹ̀ yóò tún bẹ̀rẹ̀ láìpẹ́ jù lọ síwájú
13
reset-aware
Ṣètò ipò nípasẹ̀ àkókò tí quota yóò tún bẹ̀rẹ̀ — àwọn àkókò kúkúrú ni àkọ́kọ́ 📊
14
context-relay
Gbé context kọjá láàárín àwọn ibi-àfojúsùn fún àwọn ìjíròrò gígùn 🧠
15
context-optimized
Yan èyí tó bá ìwọ̀n context lọ́wọ́lọ́wọ́ mu jù
16
cache-optimized
So ìbẹ̀rẹ̀ prompt kọ̀ọ̀kan tí a lè tún lò mọ́ account kan náà — mú kí ìlù prompt-cache pọ̀ jù 🎯
17
lkgp
Ọ̀nà Rere Tí A Mọ̀ Kẹ́yìn — so mọ́ provider tó ṣàṣeyọrí kẹ́yìn, lẹ́yìn náà lo àwọn òfin gẹ́gẹ́ bí àṣàyàn ìpẹ̀yìndà
18
auto
Ìṣírò àmì àsìkò gidi onífókítà 16 kọjá gbogbo connection 🤖
19
fusion
Pín sí àkójọpọ̀ àwọn model + adájọ́ kan ṣàkójọpọ̀ ìdáhùn kan 🧬
20
pipeline
So àwọn ìgbésẹ̀ pọ̀ — àbájáde ibi-àfojúsùn kọ̀ọ̀kan ni a máa fi wọ èkejì 🔗
Ẹ́ńjìnnì Auto-Combo máa ń fún olùdíje kọ̀ọ̀kan ní ààmì lórí **àwọn kókó 16** (ìlera, ìwọ̀n-ààyè, iye owó, ìdádúró, ìbámu iṣẹ́, dídára, wíwà nílẹ̀ ìpàdé…) — wo [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 A ti kọ́ agbára ìfaradà sínú rẹ̀ (àwọn ìpele olómìnira 3)
📖 [Ẹ́ńjìnnì Auto-Combo](docs/routing/AUTO-COMBO.md) · [Ìtọ́sọ́nà Ìfaradà](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Ohun Tó Mú Kí OmniRoute Yàtọ̀
📊 Ẹ̀kúnrẹ́rẹ́ ìlànà iṣẹ́ & à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ò.
**🇧🇷 PIX** — lẹ́sẹ̀kẹsẹ̀, kò sí owó iṣẹ́ (Brazil)
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)**.
## ✨ Ohun Tuntun
> Àwọn kókó pàtàkì láìpẹ́ yìí láti **v3.8.20 → v3.8.53**. Ìtàn kíkún wà nínú [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Ìtọ́nisọna `quota-weighted`** — ilana combo kẹrùndínlógún ń kọjá àwọn àkántì tí wọ́n ti parẹ́, lẹ́yìn náà ó ń yàn láàrin àwọn tókù ní ìbámu pẹ̀lú quota tó kù ÷ ẹrù tó ń lọ lọ́wọ́, ó sì ń pa àwọn ìjíròrò tó wà tẹ́lẹ̀ mọ́ ibi wọn. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Ipo Headless** — `omniroute serve --headless` (tàbí `OMNIROUTE_HEADLESS=1`) ń ṣí ẹ̀rọ proxy `/v1/*` nìkan lẹ́yìn náà, pẹ̀lú dashboard àti àwọn subsystem tí ó jẹ́ ti dashboard-nìkan tí ó pa. → [Ipo Headless](docs/guides/HEADLESS.md)
- **🔎 Ìwárí àwọn model** — `/v1/models` ń ṣàlẹ̀mọ́ gẹ́gẹ́ bí agbára, àyíká, irú àti ọ̀rọ̀, `POST /v1/models/query` sì ń dá àtòkọ ṣókí kékeré kan padà pẹ̀lú ìfarahàn per-key kannáá. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🔑 Ìṣàkóso ìtọ́nisọna per-key** — fi kókó API kan mọ́ model tàbí combo kan ṣoṣo pẹ̀lú `forcedModel`, kí o sì fi kún tàbí yọ àwọn model àti combo ti kókó kan kúrò ní ọ̀nà atomiki (`/api/keys/{id}/access`). → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Àwọn ìṣàkóso PII tó jinlẹ̀** — àṣàyàn gẹ́gẹ́ bí irú, títí dé àwọn àpẹẹrẹ ìbòjú àdáni 20 tí wọ́n ti fọwọ́ sí, àti àwọn àkóópọ̀ ìwárí gẹ́gẹ́ bí irú; ìbòjú fúnra rẹ̀ ṣì wà gẹ́gẹ́ bí ohun tí ẹni gbọ́dọ̀ yan fúnra rẹ̀ (opt-in). → [Ààbò](docs/security/GUARDRAILS.md)
- **🌍 Àwọn èdè 67** — dashboard, àwọn digi àkọsílẹ̀ àti CLI, pẹ̀lú `npm run i18n:add-locale` tó ń fi èdè kan kún gbogbo ibi ní àṣẹ kan ṣoṣo. → [Ìtọ́sọ́nà i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ìfi àṣẹ fún àwọn agent rẹ (A2A) tó ń wọlé, àwọn ọgbọ́n Conductor lórí Káàdì Agent, àti pánéélì dashboard kan pẹ̀lú ìjíròrò ohùn Faro push-to-talk. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Ìgbaniláàyè àti ààbò kó ti ẹ̀rù** — àwọn ìbéèrè ìjíròrò tó lewu ń lọ sínú ìlà ìdúró dípò kí wọ́n máa dáhùn 503, pẹ̀lú àwọn àyọ̀yí RPM atomiki (rolling leases) fún ìsopọ̀ kọ̀ọ̀kan. → [Ìtọ́sọ́nà Ìfaradà](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Ètò àṣẹyẹsílẹ̀ ti `/v1/models`** — àkótán kan ṣoṣo tó tẹ̀ lé ara rẹ̀ tí wọ́n ṣàkójọpọ̀ gẹ́gẹ́ bí olupese fún olupese kọ̀ọ̀kan (àwọn combo ni wọ́n fi kọ́kọ́ síwájú), tó dúró dájú ní gbogbo orísun àtòkọ. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🗜️ Ìmúdúró ìdínkù (compression)** — ààbò ìfúwẹ̀ tó wà láìsí ìtọ́ka, àwọn ìdì Caveman fún DE / FR / JA + èdè Ṣáínà (wényán), àti àwọn àlẹ̀mọ́ RTK fún Gradle àti .NET. → [Ìdínkù](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Iye owó alápatapọ̀ tó ṣòótọ́** — àwọn olupese subscription / coding-plan ń ka **$0** nínú ìtúpalẹ̀ iye owó; ètò ìnáwó, quota àti ìtọ́nisọna ń tẹ̀síwájú láti ṣe ìṣirò àfihàn. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **⚖️ Ìtọ́nisọna Quota-Share** — pín quota àkántì tí wọ́n pínpín dájú láàrin àwọn kókó tó wà nínú pool, ó sì ń lo iṣẹ́ dájú (work-conserving) níwọ̀n ìgbà tí àwọn apá tó ṣìnkùn ń jẹ́ fíyànsílẹ̀ fún àwọn mìíràn. → [Ìtọ́sọ́nà Ìfaradà](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Ìṣètò CLI/agent pẹ̀lú àṣẹ kan ṣoṣo** — àwọn àṣẹ `setup-*` 15 tí wọ́n ti forúkọsílẹ̀; `omniroute run` ń ṣí àwọn CLI 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` ń ṣe àtìyìn fún àwọn target 11 pẹ̀lú ohun èlò àṣàyàn olupese+model alápapọ̀mẹ́rìn àti àwọn ayanfẹ fún context kọ̀ọ̀kan. → [Ìsopọ̀ CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Ipo latọ̀kàtọ̀kà (Remote)** — darí OmniRoute latọ̀kàtọ̀kà pẹ̀lú àwọn token tí wọ́n dín kù (`connect` / `contexts` / `tokens`) + olùrànlọ́wọ́ OAuth `antigravity` fún ìfisílẹ̀ lórí VPS. → [Ipo Latọ̀kàtọ̀kà](docs/guides/REMOTE-MODE.md)
- **🧭 Ìtọ́nisọna aifọwọyi tó gbọ́n jù** — àwọn combo `auto/:`, **Fusion** (pánéélì model + adájọ́), ìtọ́nisọna tó mọ̀ nípa iṣẹ́, àti àwọn ìkọjá model / ipo / ètò ìnáwó-USD fún ìbéèrè kọ̀ọ̀kan. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Ìdínkù tó gba ohun èlò àfikún** — àwọn ẹ̀rọ 12 tí wọ́n lè dára pọ̀ + Compression Studios: LLMLingua-2, Ultra ilẹ̀wà méjì, omniglyph, ìlẹ̀kùn ìdájọ́dé (fidelity gate) fún ìgbésẹ̀ kọ̀ọ̀kan, GCF v3.2, àti òwe ìtúnṣètò fáa-kójá (drag-reorder). → [Ìdínkù](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Ìyọ àṣírí MITM kedere (TPROXY)** — mú àwọn CLI tí wọ́n kọjá àwọn variable ayika proxy lọ́wọ́, pẹ̀lú CA per-SNI + ohun èlò ìfisílẹ̀ trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Ìtànkálẹ̀ ìwọn iye owó ní gbogbo ibi** — àwọn àkọlé iye owó/ìlò `X-OmniRoute-*` lórí gbogbo endpoint, àkọlé ìfipamọ́ cache-HIT, àti àwọn quota ìnáwó USD per-key. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🧠 Ìrántí tí o lè darí** — wọ́n pa á láìsí ìtọ́ka, ìdínkù vector int8 àti ìrúlẹ̀ tó ṣàyèwò irú (typed decay) tí ẹni gbọ́dọ̀ yan fúnra rẹ̀, àti `x-omniroute-no-memory` fún ìbéèrè kọ̀ọ̀kan. → [Ìrántí](docs/frameworks/MEMORY.md)
- **🛡️ Ààbò** — olùṣọ́ prompt-injection lórí gbogbo ọ̀nà LLM (ìdánwò red-team), ààbò ìbòjú ìfìwèránṣẹ̀ (credential-masking) tí ẹni gbọ́dọ̀ yan (ó ń bò àwọn kókó API/àṣírí tí ó jáńjáń kúlẹ̀ ní ìtọ́sọ́nà méjèèjì), ìwárí wẹ́ẹ̀bù DuckDuckGo ọ̀fẹ́ gẹ́gẹ́ bí ìpinnu tó kẹ́yìn, àti ìlẹ̀kùn ìwọlé OIDC àṣàyàn fún dashboard (ìwọlé pẹ̀lú ọ̀rọ̀-ìmúlẹ̀ máa wà ní gbogbo ìgbà). → [Ààbò](docs/security/GUARDRAILS.md)
- **🖼️ Àwọn endpoint tuntun** — `/v1/ocr` (Mistral OCR) àti `/v1/audio/translations` (bí ti Whisper) ń parí ojú-ìṣàkóso mídíà náà. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🎨 Ìṣẹ̀dá àwòrán / fídíò / ohùn** — API kan ṣoṣo fún mídíà: fídíò xAI Grok Imagine àti Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, àti àwọn olupese ọ̀rọ̀ bíi ElevenLabs. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🌍 Ìfisílẹ̀ àti ìṣiṣẹ́** — `basePath` reverse-proxy, ìwárí èdè browser fúnra rẹ̀, ìtọ́pa ẹ̀rọ per-key, ìgbẹ́kẹ̀lé MITM láìní root, àti ìsọdọ̀kan zh-TW. → [Ayika](docs/reference/ENVIRONMENT.md)
- **🤝 Àwọn olupese àti agent sí i** — àwọn agent awọ̀sánmà (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) pẹ̀lú ìwọlé browser + OAuth, káàdì Ollama àkọ́kọ́, Claude Opus 5 àti Sonnet 5, ìbáṣepọ̀ ọ̀ṣọ́fíìsìàlì Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… àti àtòkọ **olupese 375** tí wọ́n tún ṣe. → [Àwọn Olupese](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Ìkedere ìtọ́nisọna** — gbogbo ìdáhùn ń gba àkọlé `X-OmniRoute-Decision` kan tó ń darúkọ ilana/olupese/latency tó ṣe é, ilana combo `cache-optimized` tuntun + àkíyèsí `cacheAffinity` ti Auto-Combo ń darí àwọn ìbéèrè àtúnṣe padà sí ìsopọ̀ tó ń pa prefix tó wà nínú cache mọ́, àti endpoint tí ó jẹ́ kíkà-nìkan `/v1/auto-combo/{channel}/candidates` ń ṣí pool àwọn olùdíje tó wà láààyè ti ikanni `auto/*` kan sílẹ̀. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Ìdáradà agbegbe & ìlà abẹrẹ̀** — Redis agbegbe pẹ̀lú títẹ-kan, àwọn olùgbéjáde relay Cloudflare Workers / Deno Deploy, Bifrost àti Mux gẹ́gẹ́ bí àwọn iṣẹ́ tí a fi sínú ètò tí wọ́n ń ṣàkíyèsí. → [Àwọn Iṣẹ́ Tí A Fi Sínú Ètò](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Àwọn ohun mìíràn nínú àpò** — ìlò plugin + ọjà, àwọn ìlò ọgbọn Omni/Agent/GitHub, ìsopọ̀ vault Obsidian (àwọn ohun èlò MCP 22), àwọn API Batch & Files tó bá OpenAI mu, cache ìdáhùn itumọ̀, gamification pẹ̀lú àwọn leaderboard, ìṣàwárí agent ACP (àwọn agent 15 tí wọ́n kọ́ sínú rẹ̀), ìgbéjáde log tí a pèsè àkókò sí BigQuery, `auto/chaos` fan-out ọ̀pọ̀-àpẹẹrẹ farapa, afárá bot Telegram kan, olùdárí ẹ̀yà inú ètò kan àti ìpò àwọn olùpèsè ọfẹ́ LMArena-ELO. → [Àwọn Ìwé Ìtọ́sọ́nà](docs/README.md)
## 🤖 Àwọn CLI àti Aṣojú Kóòdù Tó Bá A Mu
> Ìṣètò kan — `http://localhost:20128/v1` — àti **gbogbo** IDE tàbí CLI AI máa ń ṣiṣẹ́ lórí àwọn módẹ́lì ọ̀fẹ́ àti ti iye owó kékeré.
**Ṣí 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 máa fi àwọn ìwé-ẹ̀rí sínú process kọ̀ọ̀kan, Qwen/Gemini sì máa gba home àdáwà fún ì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 provider+model ní ìbánisọ̀rọ̀, kí o sì kọ ìṣètò ti irinṣẹ́ náà fúnra rẹ̀:
omniroute configure codex # bẹ́ẹ̀ náà: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Gbogbo àṣẹ máa ń tẹ̀lé remote context tó ń ṣiṣẹ́ (`omniroute connect `), `--dry-run`
máa ń ṣàfihàn env/args gangan láìṣiṣẹ́ wọn, `--api-key-env NAME` sì máa ń pa àwọn àṣírí mọ́ kúrò
nínú ìtàn shell rẹ. → [Àwọn Ìṣọ̀kan CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 Àwọn Olùpèsè AI — 153 Tí Kàtálógù Sàmì Sí Frée
> **375 àwọn olùpèsè tí a fòrúkọsílẹ̀** káàkiri àwọn ìṣàkójọpọ̀ canonical chat, media, search, local, cloud-agent àti system, pẹ̀lú **153 tó ní metadata ìṣàwárí `hasFree: true`**. Ìforúkọsílẹ̀ awoṣe chat bo **239 àwọn olùpèsè / 3,059 àwọn ìpò olùpèsè-awoṣe tó yàtọ̀ síra / 1,475 àwọn ID awoṣe kankan**; kàtálógù free-budget tó ya sọ́tọ̀ sì ní **467 àwọn ìlà fún awoṣe-kọ̀ọ̀kan**, **34 àwọn adágún àtúnwáyé** àti **51 àwọn olùpèsè frée-láé àtúnwáyé/láìsí kọ́kọ́rọ́**. Àwọn denominator wọ̀nyí yàtọ̀ ní èròjà; àwọn ìtumọ̀ àti àwọn ìṣirò tí a ti yọ àdàmọ̀ adágún kúrò wà nínú [Ìtọ́kasí Olùpèsè](docs/reference/PROVIDER_REFERENCE.md) àti [Àwọn Ipele Frée](docs/reference/FREE_TIERS.md).
### 🏢 Gbogbo ilé-ìwádìí ńlá — 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 350+ sí i — gbogbo àwòrán ń resolve láàyè láti inú kàtálógù olùpèsè ti dashboard. 📖 [Ìtọ́kasí Olùpèsè](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Frée Láé — $0, kò sí káádì
OpenCode Zen DeepSeek V4, Nemotron 3 Àìsí òpìn token
Kilo Code Auto-router, 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ó (key)
Cloudflare AI Àwọn awoṣe 50+ 10K neurons lójoojúmọ́
### 🧩 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**.
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.
> Yàtọ̀ sí olupin náà, OmniRoute jẹ́ **ibùdó ìṣàkóso laini-àṣẹ tó pé** pẹ̀lú **àwọn àṣẹ 80+**, ó sì tún ní àwọn ìlànà aṣojú tó ṣí sílẹ̀ kí aṣojú AI lè darí rẹ̀ **fúnra rẹ̀**.
### ⌨️ CLI gidi kan (kì í ṣe `start` nìkan)
```bash
omniroute # pèsè ẹnu-ọ̀nà + pánẹ́ẹ̀lì ìṣàkóso (port 20128)
omniroute chat # oníbàárà ìfọ̀rọ̀wérọ̀ TUI aláṣepọ̀ (slash: /model /combo /skill /memory)
omniroute setup # olùrànlọ́wọ́ ìṣètò ìgbà-àkọ́kọ́ tó ń tọ́ ọ sọ́nà
omniroute doctor # ṣàyẹ̀wò àwọn olupèsè, ports, àti àwọn native deps
```
### 🛰️ Ipò jíjìnnà — ṣiṣẹ́ CLI níbí, kí OmniRoute sì wà lórí VPS
OmniRoute wà lórí olupin kan? Darí rẹ̀ láti kọ̀ǹpútà alágbèéká rẹ pẹ̀lú **CLI kan náà**. Wọlé lẹ́ẹ̀kan
pẹ̀lú token ìráyè tó ní ààlà; lẹ́yìn náà, gbogbo àṣẹ yóò tọ́ka sí olupin jíjìnnà náà.
```bash
omniroute connect 192.168.0.15 # ọ̀rọ̀ aṣínà → token tó ní ààlà, a fipamọ́ gẹ́gẹ́ bí àyíká
omniroute models # ← ń ṣiṣẹ́ lòdì sí olupin JÍJÌNNÀ
omniroute configure codex # ← yan model jíjìnnà kan, kọ profaili Codex agbègbè kan
omniroute tokens create --name ci --scope read # ṣẹ̀dá àwọn token tó ní ààlà díẹ̀ sí i fún àwọn ẹ̀rọ míì
omniroute contexts use default # ← padà sí olupin agbègbè
```
Àwọn token ní ààlà `read` / `write` / `admin`; àwọn ipa-ọ̀nà tó ń dá process sílẹ̀ wà fún loopback nìkan.
📖 [Ipò Jíjìnnà](docs/guides/REMOTE-MODE.md)
### 🤝 So aṣojú 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ìnnà** — aṣojú èyíkéyìí tó lágbára (tàbí code tirẹ) yóò ní kọ́kọ́rọ́ sí gbogbo ẹnu-ọ̀nà náà: ìtọ́sọ́nà, àwọn olupèsè, àwọn àkójọpọ̀, cache, ìfúnpọ̀, ìrántí — láìsí ìdarí ènìyàn. Àwọn endpoint HTTP tó wà nísàlẹ̀ ni a pèsè lábẹ́ `http://localhost:20128`.
Ìbánisọ̀rọ̀
Endpoint / àṣẹ
Lò ó fún
🧰 MCP (stdio)
omniroute --mcp
So pọ̀ mọ́ Claude Desktop, Cursor, tàbí oníbàárà MCP èyíkéyìí
Ó bá OpenAI mu — ìfọ̀rọ̀wérọ̀, embeddings, àwọn à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ìnnà
omniroute connect
Darí instance jíjìnnà kan pẹ̀lú àwọn token ìráyè tó ní ààlà
```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
```
📖 [Olupin MCP](docs/frameworks/MCP-SERVER.md) · [Olupin A2A](docs/frameworks/A2A-SERVER.md) · [Àwọn Ìlànà Aṣojú](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Fipamọ́ 15–95% Àwọn Token — Lọ́nà Aífòwọ́yí
### 📖 Bí ó ṣe ń ṣiṣẹ́ — pipeline, ìkọ́-ètò àti ìṣirò ìfipamọ́
Ìsopọ̀ stacked àtìbòwá ń ṣe `RTK → Caveman`. Nígbà tí ẹ̀yìn méjèèjì bá ṣiṣẹ́ lórí payload irinṣẹ́/context kannáà, ìfipamọ́ máa ń papọ̀ mọ́ ara wọn:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Àwọn ìbulọọkì kóòdù, URLs, JSON àti dátà tó ní ìṣètò ni engine ìtọju **ń dáàbò bo ní gbogbo ìgbà**.
> **Kí ló dé tí a fi ń lo ọ̀pọ̀ token nígbà tí díẹ̀ token ṣe é?** Gbogbo ìbéèrè ń kọjá nínú pipeline ìdínkù token ti OmniRoute **láìfarahàn** — kò sí àyípadà oníbàrà kankan. Ó ti di **àwọ̀sí àwọn engine méjìlá tí a lè ṣàpéjọ** tí ó ń ṣiṣẹ́ lẹ́sẹ̀sẹ̀lẹ, tó sì ń darapọ̀ àti bámu fún combo ìtọ́sọ́nà kọ̀ọ̀kan — ó ń gbé lórí àwọn èròjà láti ọ̀dọ̀ [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).
### 🧱 Àwọ̀sí àwọn engine méjìlá
Àwọn engine ń ṣiṣẹ́ lẹ́sẹ̀sẹ̀lẹ pipeline; a lè tan tàbí pa kọ̀ọ̀kan lódukọ̀, a sì lè ṣètò rẹ̀ fún combo kọ̀ọ̀kan:
#
Engine
Ohun tí ó ń ṣe
1
Session-Dedup
Ó ń yọ àkóónú tí a tún lò lẹ́ẹ̀kejì kúrò ní kálẹ̀ àwọn ìyí ọ̀rọ̀ (content-addressed, kálẹ̀-ìyí)
2
CCR
Ó ń fi àwọn ìbulọọkì ńlá pamọ́ sẹ́yìn àwọn àmì retrieve, tí a máa ń mú wá nígbà tí a béèrè fún wọn
3
Lite
Ìgẹ́ whitespace + image-URL kúrò (ìpilẹ̀sẹ̀ tó fẹ́rẹ̀ ní latency)
JSON lossless-jọ́kọ́ọ́ + ìdínkù ìwádìí tó ní ààlà fún àwọn èsì shell/patch/search/build (Responses API)
6
Headroom
Ìtíjú tábìlì JSON arrays láìsí ìpadánù (~30%) nípasẹ̀ codec GCF tí a fi sínú
7
Relevance
Ìṣirò àwọn gbolóhùn yíyọ-jáde lódì sí ìbéèrè olùlò tó gbẹ̀yìn
8
Caveman
Ìdínkù prose tó dá lórí òfin (~65–75% lórí èsì)
9
Aggressive
Àkótán ọ̀rọ̀ + aging àwọn ìyí ọ̀rọ̀ àtijọ́ lọ́nà díẹ̀díẹ̀
10
LLMLingua-2
Ìyíyọ ìtumọ̀ kúrò nípasẹ̀ ML MobileBERT ONNX — ààbò-kóòdù, async
11
Ultra
Ìyíyọ token kúrò nípasẹ̀ heuristic pẹ̀lú ìpele awoṣe kékeré (SLM) tí kò ṣe dandan
12
OmniGlyph
Ìkọ̀dẹ̀ context-gẹ́gẹ́-bí-àwòrán ìdánwò fún Claude Fable 5 tí a wọn lórí okùn Anthropic tààrà; àwọn transformers GPT 5.6 ṣì wà ní fail-closed títí àwọn ìrìsí olùpèsè yóò fi dé. Àwọn pròfáìlì ìdínkù mẹ́rìn (aggressive àtìbòwá, balanced, coding-safe, passthrough) (tó buru jùlọ; opt-in)
Àwọn ìbulọọkì kóòdù, URLs àti dátà tó ní ìṣètò ni a **máa ń tọju ní gbogbo ìgbà** byte-perfect. **Àwọn preset tẹ́-lẹ́ẹ̀kan** ń ṣàpéjọ àwọn engine:
Ìpo
Ìfipamọ́
Ó dára jùlọ fún
🪶 Lite
~15%
Àtìbòwá ààbò tó ń ṣiṣẹ́ ní gbogbo ìgbà
🪨 Standard (Caveman)
~30%
Ìkọ́ kóòdù ojoojúmọ́
⚡ Aggressive
~50%
Àwọn ìjoko gígùn tó kún fún irinṣẹ́
🔥 Ultra
~75%
Ìfipamọ́ tó pọ̀ jùlọ
🧰 RTK
60–90%
Èsì shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Àwọn prompt àpèjọ + àkọsílẹ̀ irinṣẹ́
**Àpèjúwe gidi — Ìpo Standard:**
> **Ṣáájú (69 tokens):** _"Ìdí tí component React rẹ fi ń render lẹ́ẹ̀kejì lè jẹ́ pé o ń dá àtọ́ka ohun-èlò tuntun sílẹ̀ ní gbogbo ìyí render. Nígbà tí o bá rán ohun-èlò inline lọ gẹ́gẹ́ bí prop, ìfiwéra eékèlé React máa ń rí i bí ohun-èlò mìíràn ní gbogbo ìgbà, èyí sì ń mú kí ó render lẹ́ẹ̀kejì. Èmi yóò ṣe ìmọ̀ràn pé kí o lo useMemo láti fi ohun-èlò náà pamọ́."_
>
> **Lẹ́yìn (19 tokens):** _"Àtọ́ka ohun-èlò tuntun ní render kọ̀ọ̀kan. Prop ohun-èlò inline = àtọ́ka tuntun = render lẹ́ẹ̀kejì. Kó o nínú useMemo."_
>
> **Ìdáhùn kannáà. 72% díẹ̀ token. Kò sí ìpadánù ì péye rárá.** ✅
**Àpèjúwe PT-BR — ìpo [Troglodita](https://github.com/leninejunior/troglodita):**
> **Ṣáájú (42 token):** _"Ìṣòro ni pé ẹyaarọ náà ń túnṣe àwòrán nítorí pé a ń dá ìtọ́ka ohun tuntun sílẹ̀ lórí àgbélébùú àwòrán kọ̀ọ̀kan. Mo máa ṣàǹfàní láti lò `useMemo`."_
>
> **Lẹ́yìn (12 token):** _"Túnṣe àwòrán: ref tuntun lórí àgbélébùú kọ̀ọ̀kan (ohun inline tí a dá tuntun). Lò `useMemo`."_
>
> **Ìdáhùn kan náà.** ~70% díẹ̀ sí i nínú àwọn token. **Ìṣọ́kan ìmọ̀-ẹ̀rọ kò yàgàn.** ✅
### 🎚️ Lẹ́yìn àwọn ọ̀rọ̀ìwòyé — àwọn àrà ìjáde, àmì ìyè ìforígbárí àti ìṣàkóso fún ìbéèrè kọ̀ọ̀kan
Àwọn ọ̀rọ̀ìwòyé 12 lókè fi ohun tí ó wọ inú ní kéré. Àwọn ìpele mẹ́ta mìíràn ṣàlàyé **bí**, **ìgbà**, àti ohun tí ó jáde:
- **🪄 Àwọn Àrà Ìjáde** _(ìtọ́sọ́nà ààyìn ìjáde)_ — fi àwọn ìtọ́sọ́nà tó dájú, tó sì wá láààbò fún cache sílẹ̀ láti yẹ àwọn ìdáhùn; a lè fi wọ́n papọ̀, olúkúlùkù ní ọ̀nà `lite` / `full` / `ultra`. Láti fi àrà kan kún un, kíkọ ìwọ̀n ọ̀rọ̀ kan ló yẹ:
- **Ìwásẹ̀n Tí Kò Ní Ọ̀pọ̀lọpọ̀ Ọ̀rọ̀** — yọ àwọn ọ̀rọ̀ tí kò ní ìtumọ̀ / àwọn apá-ọ̀rọ̀ / ìdákẹ́-jẹ́; fi ohun ìmọ̀-ẹ̀rọ náà múlẹ̀ dáadáa.
- **Kódù Díẹ̀ sí i** — "oníṣẹ́ àgbà tí ó lẹ́yìn" YAGNI: àyípadà kékeré tó ń ṣiṣẹ́, kò sí àwọn àtìlẹ́yìn tí a kò béèrè fún.
- **Ponytail (oníṣẹ́ àgbà tí ó lẹ́yìn)** — gòkè lórí àpáànlẹ́ YAGNI, títunṣe ìdí ìṣòro náà, àyípadà kékeré jùlọ tó ń ṣiṣẹ́.
- **Mo ní ADHD (ìgbésẹ̀ àkọ́kọ́)** — ìgbésẹ̀ tó kàn kọjá, àwọn ìgbésẹ̀ ní nọ́mbà, ìgbésẹ̀ kan tó dájú tó tẹ̀lé, kò sí ìfihàn síwájú.
- **Àrà Kíákíá CJK (文言)** — àrà CJK tó kéré gan-an bíi ọ̀rọ̀ àtijọ́ Ṣáìná (tí a fi àyè sílẹ̀ fún `zh` nìkan).
- **🎯 Ìwújù Ààyè Ìforígbárí láti Máa Yípadà** _(àmì ìyè)_ — dípò òpó ìtumọ̀ kan ìbéèrè on/off, fa àwọn ọ̀rọ̀ìwòyé tó rẹ́jẹ̀ jùlọ, tó sì dín ìpàdánù kùnà sí i bí ó tilẹ̀ jẹ́ pé ó yẹ kí **wọ inú fèrèsé àkóónú àwose náà**. Òfin: `reserve-output` (àtẹ̀jáde, tí ó mọ̀n nípa àwose) · `percentage` · `absolute`. Ìgbésẹ̀: `floor` (rí i dájú pé ó wọ inú) · `replace-autotrigger` (àṣàyàn rẹ tó hàn kedere lóborí) · `off` (ìyẹn àtijọ́).
- **🎛️ Ibi tí a ṣe Ìdínkù** _(àkókò, gíga → kéré)_ — fún ìbéèrè kọ̀ọ̀kan `x-omniroute-compression` header › àtúnṣe ìṣọ̀kan ìtọsọna › àwòrán orúkọ tó ń ṣiṣẹ́ › ìforígbárí láti máa yípadà / ìbéèrè tí ó yẹ kí ó tó kùnà › àtẹ̀jáde pánẹ́lì › off. Ètò tí a lò máa padà sọ́dọ̀ rẹ nínú `X-OmniRoute-Compression: ; source=` àkọlé ìdáhùn.
Fa ìbéèrè láìfọwọ́yí nípasẹ̀ àmì ìtumọ̀ token, yí àmì ìyè ìforígbárí padà, fi àwòrán orúkọ kan múlẹ̀, ṣàyẹ̀wò kan fún ìbéèrè kan, tàbí yà pipeline kan sílẹ̀ fún ìṣọ̀kan ìtọsọna kan — ohun tí ó yẹ fún iṣẹ́ náà. Ohun èlò ìdánwò tí a yàn láti máa lò lọ́fílàì (`npm run eval:compression`) máa ṣàyẹ̀wò ìṣọ́kan àti ìṣàfikún lórí corpus tó jẹ́ ìdíkan kí o tó gbé àyípadà kan lọ sí i.
📖 [`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ẹ̀ ní Kíákíá
**1) Ṣàyẹ̀wò & Mú Kí Ó Ṣiṣẹ́**
```bash
npm install -g omniroute
omniroute
```
> 💡 Rí i `npm warn ERESOLVE` tàbí ìkìlọ̀ peer-dep? [Wọ́n jẹ́ àlàáfíà](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Ṣe o ń lò npm 11 tàbí tó tẹ̀lé e?** npm lè dá àwọn ìwà-ọgbọ́n ìgbé-ìṣàkóso àpò dúró àyàfi tí a bá fọwọ́sí wọn. `postinstall` ti OmniRoute (`node scripts/build/postinstall.mjs`) pọn dandan láti mú kí àwọn fáìlì ìṣiṣẹ́ àdábàbà rẹ̀ ṣeédájú. Fọwọ́sí àwọn àpò tí orúkọ wọn wà nínú ìkìlọ̀ npm náà nígbà tí o bá ń fi wọ́n sílẹ̀ láàárín àwọn ìlú. Fún àṣẹ àpò tí OmniRoute 3.8.53 sọ̀rọ̀:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Láti lò àtòyé ìyọ̀nda yìí lẹ́ẹ̀kan mìíràn fún àwọn ìgbé-ìṣàkóso ààrin ìlú, ṣàlàyó rẹ̀ lẹ́ẹ̀kan kan, lẹ́yìn náà fi sílẹ̀ bí ó ti wù kí ó rí:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Àtòyé àwọn ohun tí ó dá lórí lè yípadà láàárín àwọn ìdáhùn; tí npm bá sọ àtòyé mìíràn, lò orúkọ àwọn àpò tí ó wà nínú ìkìlọ̀ náà. Gbà láàyè fún àpò kan jẹ́ kí àwọn ìwà-ọgbọ́n ìgbé-ìṣàkóso rẹ̀ lè ṣiṣẹ́.
> **Ṣe o ń lò Gemini Web tàbí olùpèsè kúkì wẹ́bì mìíràn?** Àpò npm náà ní
> Playwright nínú ṣùgbọ́n kì í ṣe àkójọpọ̀ binary Chromium rẹ̀. Ka
> [ètò Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> àkíyèsí kí o tó ṣe ìbéèrè àkọ́kọ́ fún olùpèsè wẹ́bì.
Dashboard ní `http://localhost:20128` · API ní `http://localhost:20128/v1`.
**2) So olùpèsè tó yẹ pẹ̀lú àkánṣe rẹ**
Dashboard → **Providers** → yan olùpèsè tí àwọn òfin àti ìpín rẹ̀ lọ́wọ́lọ́wọ́ yẹ fún ìlò rẹ → fi API key rẹ̀ kún un tàbí parí ìlọsíwájú àkánṣe rẹ̀. Àwọn ìpele òfẹ́ lè nílò ìforúkọsílẹ̀, ìfọwọ́sí, tàbí ọ̀nà ìsanwó. Ṣàyẹ̀wọ [Ìtọ́sọ́nà Àwọn Ìpele Òfẹ́](docs/getting-started/FREE-TIERS-GUIDE.md); a kì í ṣe àdáni àìló kíí fún gbogbo ìgbà, àwọn olùpèsè tí wọ́n fa àmì `tos: avoid` kò wà nínú `auto` látìbẹ̀rẹ̀.
**3) Tọ́ka ohun èlò kódì rẹ sí**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) Rí i dájú pé ó ń ṣiṣẹ́**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Ó yẹ kí o rí àwọn àwose rẹ tí a so pọ̀ wà nínú àtòyé. 🎉 Ìyẹn ni yẹn — bẹ̀rẹ̀ kíkọ kóòdù, OmniRoute yóò tọ́ka ọ̀nà fún ọ àti pé yóò yípadà fún ọ.
Tí kọ́láìntì rẹ kò le fi àwọn àkọlé àṣà ránṣẹ́, OmniRoute tún fi àwọn orúkè mìíràn tí ó yẹ fún ìbáṣepọ̀ hàn:
```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
```
Lò àwọn wọ̀nyí fún àwọn kọ́láìntì tí kò le fi `Authorization: Bearer ...` kún un. Ìfọwọ́sí àkọlé jẹ́ ọ̀nà tó yẹkàyẹkà.
## 📦 À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 ìgbà kan ti pánẹ́ẹ̀lì ní 2026-10-18 · Àkójọ àìṣàtúnṣe: YT 1.352 | TT 334 | IG 290 · Bí ó ṣe jẹ́ tuntun (ọjọ́): YT 5 | TT 48 | IG 49
🎬 #1 — Instagram nick_saraev — àwọn ìwòran 3,042,474
🎬 #2 — Instagram nnapier7 — àwọn ìwòran 1,454,535
🎬 #3 — YouTube Amidia AI & Tech — àwọn ìwòran 794,974
🎬 #4 — Instagram theopenstack — àwọn ìwòran 692,419
🎬 #5 — TikTok migue.baena — àwọn ìwòran 685,788
**Àtòjọ ipò kíkún (àwọn URL àṣẹ tí a ti yọ àdáwòkọ wọn kúrò, `v > 0`, ìwọ̀n àṣeyọrí tó ga jù):**
| #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** |
Àwọn ìwọ̀n àṣẹ ní 2026-10-18: **àwọn fídíò aláìlẹ́ẹ̀kejì 1.976** · **àwọn ìwòran tí a mọ̀ 20.220.289** (`v > 0`) · **àwọn ikanni/prófáìlì 1.210 ní ìbámu pẹ̀lú nẹ́tíwọ́ọ̀kì**. Pánẹ́ẹ̀lì àìṣàtúnṣe ní àwọn ìlà 1.976 (YouTube 1.352 = àwọn fídíò gígùn 740 + Shorts 612 · TikTok 334 · Instagram 290); kò sí àdáwòkọ kankan tó ṣẹ́ kù lẹ́yìn ìṣètò sí ìwọ̀n kan nípasẹ̀ URL àṣẹ, èyí tó ń pa iye tó ga jù mọ́ fún fídíò kọ̀ọ̀kan. A ti dá ìkórè dátà YouTube dúró sí 2026-10-13 (ìpín API ti tán láti 14 sí 18/10), àti ti TikTok/Instagram láti 2026-09-02 (kò sí kirẹ́díìtì ìkórè dátà); àwọn fídíò 76 kò tíì ní iye ìwòran.
> 🎬 **Ṣé o ṣe fídíò kan nípa OmniRoute?** Ṣí [ọ̀ràn](https://github.com/diegosouzapw/OmniRoute/issues/new) tàbí [ìjíròrò](https://github.com/diegosouzapw/OmniRoute/discussions) pẹ̀lú líńkì náà — a ó gbé e 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í ṣí ọ̀ràn kan.
| Ikànnì | Ibi / bí a ṣe lè lò ó |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 💼 **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 — 🇧🇷 Brazil** | [darapọ̀ mọ́ ẹgbẹ́ náà](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) |
| 🌍 **Ààyè ayélujára** | [omniroute.online](https://omniroute.online) |
| 🌍 **🌍Àwùjọ StHub OmniRoute (ọ̀fẹ́)** | [ojú-ọ̀nà 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 `ìṣòro àkọ́kọ́ tó dára` |
| 💚 **Ṣ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) |
pino — àwọn àkọsílẹ̀ JSON oní-ìlànà pẹ̀lú àyíká ìbéèrè
Ìdánwò
Node.js test runner + Vitest — àwọn ìkéde ìdánwò ìdúró 56,000+ káàkiri àwọn fáìlì ìdánwò tí wọ́n ń tọpinpin 7,800+ (unit, integration, E2E, ààbò, àyíká-ìbáṣepọ̀)
Ìlànà ìboṣúwọ̀n ìdánwò fún àwọn ìkéde ìdánwò dúró 56,000+ káàkiri àwọn fáìlì ìdánwò tí a ń tọ́pasẹ 7,800+
# ⭐ Àwọn Olùkópa Gígajù
> Àwùjọ orísun-ṣíṣí tí ó gbóná fẹ́rẹ̀ ni ó ṣe àpẹẹrẹ OmniRoute. Àwọn ará kọ̀ọ̀kan wọ̀nyí ti ṣe àwọn ìkópa pàtàkì tí ó ní ipa tààrà lórí dídára, ìdúróṣinṣin, àti ìtẹ̀le ètò náà. **Ẹ ṣeun.**
### Àwọn olùkópa òde gẹ́gẹ́ bí àwọn ìbéèrè pull tí a dàpọ̀ ṣe rí
A ṣe ìkàwọ́ ní 2026-10-18 15:09:09 UTC pẹ̀lú ìparí release/v3.8.52 tó ṣiṣẹ́ lọ́wọ́ 656f01cb43. Ìkàwọ́ GitHub GraphQL tó ní ojú-ìwé púpọ̀ ní 9,191 PR tí a dàpọ̀: 3,834 lọ́wọ́ oní ipamọ́ ìwé ìkọsílẹ̀, 229 lọ́wọ́ Dependabot, 6 lọ́wọ́ àwọn bot/èròjà mìíràn, àti 5,122 PR òde láti ọwọ́ 835 olùkópa oríṣí. "Àwọn ila tí a yí" jẹ́ àfikún + ìyọkú GitHub, ó sì ní àwọn fáìlì tí a ṣe àdàdaṣe, àwọn fáìlì títa, àwọn àkàtá, àwọn ògbufọ̀ àti àwọn ìwé àkọsílẹ̀ lẹ́yìn tó; ìríṣì rẹ̀ ni, kì í ṣe LOC tí olùkọ́ kọ pàápàá. 49 PR ń jábọ̀ GitHub diffs tó ga ju ila 500,000 lọ (fún àpẹẹrẹ #13399, àfikún olùpèsè kan ṣoṣo, ṣe àkọsílẹ̀ 2,347 fáìlì tí a yípadà), èyí tó sọ̀kan ọ̀pọ̀ nínú àwọn àpapọ̀ òke. Àwọn tí wọ́n bá ní iye kan ṣoṣo ni a fi ipò kan ṣoṣo fún.
### Àwọn commit tí GitHub ṣe àkíyèsí
A tún ṣàyẹ̀wò rẹ̀ ní 2026-10-18 14:44:45 UTC: àwọn commit tí GitHub ṣe àtìlọ́pà tí Contributors API ti ibi ìpamọ́ kóòdù ròyìn fún ẹ̀ka àtìpàtàkò release/v3.8.52. API náà dá àwọn ìdánimọ̀ 849 padà (àwọn olùmúlò 429, àwọn bot 2, àwọn aláìlórúkọ 418); tábìlì yìí yọ ẹni tí ń ṣàkóso àtúnṣe (maintainer), àwọn bot àti àwọn ìdánimọ̀ aláìlórúkọ kúrò, ó sì dá àwọn tí wọ́n bára wọn gba nǹkan bàjẹ́ nínú ìdíje dúró. Ó yàtọ́ sí ìtòlẹ́sẹ̀sẹ̀ àwọn PR tí a darapọ̀ tí ó wà lókè àti ìṣìró Git-metadata tí ó wà nísàlẹ̀.
> 🙏 Àwọn ẹ̀yà ara, àwọn àtúnṣe àsìṣe, àti àwọn ìlòsíwájú ìpilẹ̀ṣẹ́ ìṣẹ́ ti àwọn olùkópa wọ̀nyí jẹ́ **apá pàtàkì** nínú ohun tí ó jẹ́ kí OmniRoute gbẹ́kẹ̀lé, kí ó sì kún fún àwọn ẹ̀yà ara lọ́pọ̀lọpọ̀. Gbogbo pull request, gbogbo ìdánwò, àti gbogbo fáìlì ìtumọ̀ i18n ṣe pàtàkì. Àwọn ènìyàn bí wọn ni wọ́n fi ń 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 ṣètìlẹ́yìn fún OmniRoute — gbogbo àfikún ń jẹ́ kí iṣẹ́ náà wà lọ́fẹ̀ẹ́, dúró lórí ẹsẹ̀ ara rẹ̀, kí ó sì máa tẹ̀ síwájú.
Andrew 💛 Olùgbọ́wọ́ oṣooṣù tó ń ṣiṣẹ́ lọ́wọ́lọ́wọ́
Vlad I 💛 Olùgbọ́wọ́ oṣooṣù tó ń ṣiṣẹ́ lọ́wọ́lọ́wọ́
… àti àwọn mìíràn tí wọ́n fẹ́ láti jẹ́ àṣírí 💛A tún fìdí àwọn GitHub Sponsors ti gbogbo ènìyàn lè rí múlẹ̀ ní 2026-10-18 nípasẹ̀ GitHub Sponsors GraphQL API: ìgbọ́wọ́ ti gbogbo ènìyàn lè rí jẹ́ 11 (6 ń ṣiṣẹ́ lọ́wọ́lọ́wọ́, 5 sì jẹ́ ti tẹ́lẹ̀ rí) nínú àpapọ̀ 14. Ipò isActive ti GitHub ló ń pinnu àwọn àmì tó ń ṣiṣẹ́ lọ́wọ́lọ́wọ́ lókè; a ṣì ń dúpẹ́ lọ́wọ́ àwọn alátìlẹ́yìn ẹ̀ẹ̀kan ṣoṣo ti gbogbo ènìyàn lè rí láti ìgbà àtijọ́, àwọn olùgbọ́wọ́ àṣírí sì ń jẹ́ aláìlórúkọ. A kò ṣe àkójọ àwọn ọrẹ Ko-fi, Buy Me a Coffee, Liberapay, PIX àti crypto nítorí wọn kò ní àkọsílẹ̀ olùgbọ́wọ́ tí gbogbo ènìyàn lè rí.💖 Di olùgbọ́wọ́ → — gbogbo dọ́là ń jẹ́ kí OmniRoute wà lọ́fẹ̀ẹ́, kí ó sì dúró lórí ẹsẹ̀ ara rẹ̀.
## 👥 Àwọn Olùdásí 900+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
A ṣe àyẹ̀wò rẹ̀ ní 2026-10-18 ní orí ẹ̀ka release/v3.8.52 tó wà lọ́wọ́lọ́wọ́, ní ad160ab2d1 (àwọn commit 6,826): àwọn ìdánimọ̀ Git ènìyàn 993 tí a ti mú wá sí ìlànà kan náà — 707 farahàn gẹ́gẹ́ bí àwọn olùkọ̀wé commit (pẹ̀lú olùtọ́jú náà), 286 sì wà nìkan nínú àwọn àfikún Co-authored-by tí a sọ ní kedere. Ìṣirò náà lo .mailmap, ó fi àwọn àdírẹ́sì e-mail wéra láìka bí lẹ́tà ṣe tóbi tàbí kékeré sí, ó so àwọn àdírẹ́sì GitHub noreply onínọ́mbà àti ti ọ̀rọ̀ lásán pọ̀ kìkì nígbà tí wọ́n bá ṣàfihàn orúkọ ìdánimọ̀ kan náà, ó yọ àwọn ìdánimọ̀ bot/aṣojú/iṣẹ́/àfikún-ààyè 26 kúrò, kò sì dapọ̀ àwọn àdírẹ́sì e-mail lasán nítorí pé àwọn orúkọ àfihàn wọn bá ara wọn mu. Àyẹ̀wò 2026-08-24 ṣe àtẹ̀jáde 639; nígbà tí a tún lo ọ̀nà yìí lórí ìpìlẹ̀ àyẹ̀wò náà, ac02c5b42f, ó fún wa ní 619, nítorí náà ìbísí náà wá láti ọ̀dọ̀ àwọn olùdásí tuntun, kì í ṣe láti ọ̀nà tí a mú rọrùn sí i.
### Bí O Ṣe Lè Dá Sí I
1. Ṣẹ̀dá fork ibi ìpamọ́ náà
2. Ṣẹ̀dá ẹ̀ka láti orí ẹ̀ka **tó ń ṣiṣẹ́** `release/vX.Y.Z` (kì í ṣe `main`) — wo [Àwòṣe Ẹ̀ka & Ìtújáde](docs/ops/BRANCHING_MODEL.md)
3. Ṣẹ̀dá ẹ̀ka ẹ̀yà 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 ìtọ́sọ́nà alálàyé.
### Títú Ẹ̀yà Tuntun Jáde
```bash
# Ṣẹ̀dá ìtújáde kan — npm publish máa ṣẹlẹ̀ fúnra rẹ̀
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Àwọn Ìràwọ̀
## 🌍 StarMapper
## 🙏 Ìdúpẹ́
OmniRoute dúró lórí èjìká àwọn òmìrán. Ó bẹ̀rẹ̀ gẹ́gẹ́ bí fork ti **[9router](https://github.com/decolua/9router)** àti ìṣípò TypeScript ti àkànṣe Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — láti ibẹ̀ sì ni gbogbo subsystem tó wà nísàlẹ̀ ti gba ìmísí láti inú àkànṣe open-source kan tó ti kọ́kọ́ ṣe é. Ọ̀kọ̀ọ̀kan wọn ló ṣe àkóso apá pàtó kan nínú OmniRoute. Èyí ni ọ̀rọ̀ ọpẹ́ wa sí gbogbo wọn. 🙏
> ⭐ a ṣàyẹ̀wò iye star láti GitHub REST API ní October 18, 2026 — ẹ lọ fún àwọn àkànṣe wọ̀nyí ní star. Àwọn iye náà jẹ́ àwòrán gangan ní ọjọ́ tí a sọ, wọ́n á sì yí padà lọ́nà àdánidá.
### 🧬 Ìran & ẹnu-ọ̀nà
Ẹnu-ọ̀nà AI tí àkójọpọ̀ dátà ìdíyelé gbogbogbò rẹ̀ ń pèsè fún ìbámu títọpinpin ìnáwó wa, tí àwòṣe rẹ̀ fún mímú àwọn provider wá sí ìlànà kan náà sì ṣe ìtọ́sọ́nà routing wa.
Orísun MIT tí a ṣàtúnṣe sínú afárá ChatGPT Web → Codex Responses tí a vendored, pẹ̀lú àwọn adapter fún browser-session, response-framing, usage àti web-search.
Àwọn pattern tí a ṣí lọ sínú ìmúpadàbọ̀ stream, àwọn alias no-thinking, web search àfidípò, àwọn ààlà sliding-window, fífi àṣírí bo log àti àwọn ìṣàn launcher tí a mú le.
Àwọn ìbáramu model Grok rẹ̀, generator Statsig fake-TypeError, àwọn default request àti device, àti processor response NDJSON ni a ṣàtúnṣe lọ́nà pàtàkì sínú executor Grok Web ti OmniRoute.
Orísun code transitive pàtàkì tó wà lẹ́yìn grok2api-merged; àwọn ìmúṣẹ model, header, payload, Statsig àti processor rẹ̀ ni a pa mọ́ nínú ìran Grok Web.
Orísun MIT ìpìlẹ̀ fún àwọn default Grok payload àti device, generator Statsig, àti processor result.response tí a gbé kọjá láti TQZHR àti grok2api-merged.
Orísun transitive tí grok2api-merged jẹ́wọ́ fún layer proxy-pool rẹ̀; OmniRoute pa àkíyèsí ìran yẹn mọ́, ṣùgbọ́n kò sọ pé ó ṣí proxy-pool wá sínú executor Grok Web rẹ̀ tí a fi ààlà sí.
Ìmúṣẹ Grok Web ìpilẹ̀ṣẹ̀ náà tọ́ka sí àpẹrẹ upstream HTTP/browser rẹ̀; ipa-ọ̀nà HTTP tààrà rẹ̀ wá láti GrokProxy, nítorí náà a kò sọ pé a ṣe ìṣípò code olómìnira.
Àkànṣe tó gbajúmọ̀ náà, "kí ló dé tí a fi ń lo token púpọ̀ nígbà tí token díẹ̀ lè ṣe iṣẹ́ náà" — ìmọ̀ ọgbọ́n èdè caveman rẹ̀ ló ń ṣe agbára fún ipò ìfúnpọ̀ boṣewa wa àti àwọn òfin ìyọkúrò-ọ̀rọ̀-àfikún/ìsọdipúpọ̀ tó lé ní 30.
Ọgbọ́n kíkó-kóòdù YAGNI “olùgbéejáde àgbà ọ̀lẹ” tó gbajúmọ̀ — ó fún Ìrísí Àbájáde less-code wa ní ìmísí: ìdarí sí ìyípadà tó kéré jù tí ó sì ń ṣiṣẹ́, èyí tó ń dín kóòdù tí a _ṣẹ̀dá_ kù (ẹgbẹ́ àbájáde tó bá ọ̀rọ̀ ṣókí Caveman mu).
Ìfúnpọ̀ àbájáde tó mọ àkóónú, fún irú fáìlì kọ̀ọ̀kan, pẹ̀lú ìjáde-kúrò tó mọ ìkùnà — ó fìdí fífiṣẹ́ gẹ́gẹ́ bí irú àti fífoju ìfúnpọ̀ tí èrè rẹ̀ kéré jù sílẹ̀ múlẹ̀.
JSON ọ̀wọ̀n Rust + ìmúpadà tó dá lórí àkóónú + yíyọ àdáwòkọ kọjá àwọn ìfiránṣẹ́ — ó fìdí àpẹẹrẹ ẹ̀rọ headroom/ccr/session-dedup wa àti òfin àìyípadà kaṣe “fọ́ọ̀mù tí a fún pọ̀ kò sinmi lórí ipò” múlẹ̀.
Ìdádúró/ìtúpalẹ̀ MITM lórí ìṣàn-ọ̀nà olùrànlọ́wọ́-kóòdù ↔ LLM ló ṣe ìtọ́sọ́nà àwọn ohun tí Traffic Inspector nílò ní ìbẹ̀rẹ̀. Àwọn módù mẹ́rin tí a ti mú jáde tẹ́lẹ̀ — ìṣọ̀kan SSE, ìṣọ̀kan ìjíròrò, ìbòmọ́lẹ̀ àṣírí àti ìsọdimímọ́ àkọlé — ni a ti fi àwọn ìmúṣẹ̀ clean-room olómìnira tí ó dá lórí àwọn ìlànà pròtókólù gbogbogbò rọ́pò. Àwọn ojú-òpó host-passthrough méjì náà (passthrough.ts àti _internal/bypass.cjs) ṣì jẹ́ àwọn ìmúṣẹ̀ inú OmniRoute tí a pín sí ẹ̀ka lọ́tọ̀; a kò tún wọn kọ gẹ́gẹ́ bí ara ìrọ́pò yẹn.
Ìdarí proxy aláìfojúrí fún ìlànà kọ̀ọ̀kan — ó fún ìtúpalẹ̀ MITM tí kò ní bàjẹ́ nígbà ìkọlù, àwọn àkókò-ìparí socket nígbà àìṣiṣẹ́, ìdámọ̀ ìlànà /proc àti ìgbàsílẹ̀ TPROXY wa ní ìmísí.
Àkójọ tí a fara balẹ̀ yàn ti àwọn ilé-ìkàwé tó ní ààbò nípa àìyẹsẹ̀, èyí tó ń darí àwọn àṣàyàn ààbò wa (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
> Àkótán ere-ìdàrà ti ojú-ìwé `/dashboard/free-tiers` lọ́wọ́lọ́wọ́. Ọ̀nà ìṣirò kíkún (yíyọ àwẹ̀lẹ̀dàlẹ̀ pool, àwọn ìpele kírèdìtì, àwọn òfin olùpèsè): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Àwọn nọ́ńbà wọ̀nyí ni a ń ṣe àtúnṣe àyẹ̀wò wọn ní gbogbo ọ̀sẹ̀ méjì lórí àtòjọ lọ́wọ́lọ́wọ́, wọ́n sì ń **rìn ní ìgbà méjèèjì** — olùpèsè kan parí ìpele ọ̀fẹ́ rẹ̀, nọ́ńbà náà sì dínkù; ohun tuntun kan sì dé, ó gòkè. A ń kẹ́jádé ohun tí àtòjọ náà ṣe ìṣirò rẹ̀ ní tóòótọ́, kì í ṣe ìṣirò tó dára jù tí a yí ká jọ.
```bash
# Lẹ́yìn tí o bá so ọlùpèsè kan pọ̀, da kọ́kọ́rọ́ OmniRoute rẹ kọ̀ 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ẹ. Ìṣàgbékalẹ̀ tuntun lè má ní àwọn àfọ̀nàmọ̀ láìsí-kọ́kọ́rọ́ tó yẹ rárá, ọlùpèsè láìsí-kọ́kọ́rọ́ sì lè kọ̀ àwọn oníbàárà láti òde. Àwọn ọlùpèsè tí a ṣàmì sí `tos: avoid`, pẹ̀lú Kiro, ti yọ wọ́n kúrò nínú afọmọ àdàṣe ní àtìbẹ̀rẹ̀; sisopọ̀ àkáùntì kò ṣe àtẹ́lẹwọ́n ètò yẹn. Wo [Ìtọ́nisọ́nà Àwọn Ipele Ọ̀fẹ́](docs/getting-started/FREE-TIERS-GUIDE.md) kí o tó yan ọlùpèsè kan.
📦 Àwọn skíríìpùtì ìbẹ̀rẹ̀ kíákíá dàkọ-fírà fún **Python, Node.js, PHP, àti cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Combo** jẹ́ ẹ̀wọ̀n àwọn model tí OmniRoute ń darí kọjá lórí **láìfọwọ́ṣe**. Bí quota bá tán, provider kan bá kùnà, tàbí iye owó bá fò sókè, combo náà lè lọ sí model tó péye àti tó ń ṣiṣẹ́ dáadáa lẹ́yìn náà. 🛡️
### ⚡ Kò nílò àtúnṣe — kan lo `auto`
Kò sí combo 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 láti inú àwọn provider tí o ti sopọ̀, pẹ̀lú ìṣírò àmì ní àsìkò gidi:
📖 [Ẹ́ńjìnnì Auto-Combo](docs/routing/AUTO-COMBO.md) · [Ìtọ́sọ́nà Ìfaradà](docs/architecture/RESILIENCE_GUIDE.md)
📊 Ẹ̀kúnrẹ́rẹ́ ìlànà iṣẹ́ & à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)
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
```
📖 [Ìfúnni Láṣẹ](docs/architecture/AUTHZ_GUIDE.md) · [Àwọn Ààbò](docs/security/GUARDRAILS.md) · [Ìbámu](docs/security/COMPLIANCE.md)
Ìsopọ̀ stacked àtìbòwá ń ṣe `RTK → Caveman`. Nígbà tí ẹ̀yìn méjèèjì bá ṣiṣẹ́ lórí payload irinṣẹ́/context kannáà, ìfipamọ́ máa ń papọ̀ mọ́ ara wọn:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Àwọn ìbulọọkì kóòdù, URLs, JSON àti dátà tó ní ìṣètò ni engine ìtọju **ń dáàbò bo ní gbogbo ìgbà**.
> **Kí ló dé tí a fi ń lo ọ̀pọ̀ token nígbà tí díẹ̀ token ṣe é?** Gbogbo ìbéèrè ń kọjá nínú pipeline ìdínkù token ti OmniRoute **láìfarahàn** — kò sí àyípadà oníbàrà kankan. Ó ti di **àwọ̀sí àwọn engine méjìlá tí a lè ṣàpéjọ** tí ó ń ṣiṣẹ́ lẹ́sẹ̀sẹ̀lẹ, tó sì ń darapọ̀ àti bámu fún combo ìtọ́sọ́nà kọ̀ọ̀kan — ó ń gbé lórí àwọn èròjà láti ọ̀dọ̀ [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).
### 🧱 Àwọ̀sí àwọn engine méjìlá
Àwọn engine ń ṣiṣẹ́ lẹ́sẹ̀sẹ̀lẹ pipeline; a lè tan tàbí pa kọ̀ọ̀kan lódukọ̀, a sì lè ṣètò rẹ̀ fún combo kọ̀ọ̀kan:
