# 🚀 OmniRoute — Ẹnu-ọ̀nà AI Ọ̀fẹ́
**Ẹ̀dá [Diego Souza](https://github.com/diegosouzapw)**
## 💰 ~1.62B Àwọn Token / Oṣù Kọọkan Kọjá Àwọn Free Tier Ẹni-kẹta
> **Mú àkáǹtì olupèsè tirẹ wá.** Èyí jẹ́ ìṣírò àpapọ̀ tí a fojú díwọ̀n láàárín àwọn free tier ẹni-kẹta tí ó yẹ lọ́tọ̀ọ̀tọ̀, kì í ṣe ẹ̀bùn token láti ọ̀dọ̀ OmniRoute. Forúkọsílẹ̀, gba àwọn ìwé-ẹ̀rí àṣẹ níbi tí ó bá ṣe pàtàkì, kí o sì so àwọn olupèsè tí o lè lò pọ̀; olupèsè kọ̀ọ̀kan ló ń ṣàkóso àwọn ààlà, ìwàláàyè, àti àwọn òfin rẹ̀.
>
> Kíkó àwọn free tier jọ pẹ̀lú ọwọ́ máa ń dùn ún — ọ̀pọ̀ SDK, ọ̀pọ̀ ààlà oṣuwọn, àti àìmọ̀ iye tí o ní gan-an. OmniRoute ṣe àkójọpọ̀ **àkọsílẹ̀ free-tier 465 káàkiri àwọn bọ́ọ̀lù adágún tí ń tún ara wọn ṣe 34** ó sì ń ṣírò àkótán token láti inú **àwọn adágún 17 tí ó ní ìṣúná oṣù rere tí a tẹ̀jáde, pẹ̀lú ààlà Groq márùn-ún fún model kọ̀ọ̀kan**, tí a sì yọ àtúnsọ̀rọ̀ kúrò nípasẹ̀ adágún tí wọ́n jọ pín. Àwọn quota tí ó máa ń ṣí lẹ́yìn ìwádìí ìdánimọ̀ agbègbè kan (lónìí: ModelScope) ni a fi hàn lọ́tọ̀, +~6M lẹ́yìn ìmúdájú ìdánimọ̀ agbègbè, a kò sì kà wọ́n sínú àkótán náà láéláé. Àbájáde náà máa ń hàn lórí dashboard (`/dashboard/free-tiers`).
> Àkótán alágbèéká ti ojú-ìwé `/dashboard/free-tiers` tó ń ṣiṣẹ́ ní àkókò gidi. Ọ̀nà àṣàyẹ̀wò kíkún (yíyọ àtúnsọ̀rọ̀ adágún, àwọn ipele kírẹ́dì, àwọn òfin olupèsè): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> A tún ń ṣàyẹ̀wò àwọn nọ́mbà wọ̀nyí ní gbogbo ọ̀sẹ̀ méjì lòdì sí àkójọpọ̀ tó ń ṣiṣẹ́, wọ́n sì **le lọ sókè tàbí sọ̀kalẹ̀** — tí olupèsè bá dá free tier dúró, nọ́mbà náà a dín kù; tí tuntun bá dé, yóò pọ̀ sí i. A ń tẹ̀jáde ohun tí àkójọpọ̀ náà ṣe ìṣírò gan-an, a kì í ṣe àfikún nọ́mbà síi láti ṣe àfihàn ìṣàǹfààní tó dára jù.
⭐ Fún repo ní ìràwọ̀ bí OMNIROUTE bá ràn ọ́ lọ́wọ́ láti fi owó pamọ́ à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)
### 💬 Darapọ̀ mọ́ àwùjọ
**👋 Tẹ̀lé ẹni tó ń bójú tó iṣẹ́ náà — gba àwọn olupèsè tuntun, àwọn ìtújáde àti àwọn ìmọ̀ràn kíákíá:**
[](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è, ìmọ̀ràn nípa olupèsè, ètò ọ̀nà iwájú àti ìrànlọ́wọ́ → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Agbègbè Gbogbo](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)**
## 📈 Ẹnubodè náà ń tẹ̀síwájú láti dàgbà
## 🆓 Fi sori ẹrọ, so olupese kan pọ̀, lẹ́yìn náà darí nipasẹ endpoint kan
```bash
# Lẹ́yìn tí o bá so olupese 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ẹ. Fifi sori ẹrọ tuntun lè má ní àwọn ibi-afẹ́fẹ́ keyless tó yẹ, àti pé olupese keyless lè kọ́ àwọn oníbàárà ẹni-kẹta. Àwọn olupese tí a samì sí `tos: avoid`, pẹ̀lú Kiro, ni a yọ kúrò nínú ìdarí aládàáṣiṣẹ́ ní àìpẹ̀yà; so àkọọ́lẹ̀ pọ̀ kò lè yí ìṣètò yẹn padà. Wo [Àkọsílẹ̀ Àwọn Ìpele Ọ̀fẹ́](docs/getting-started/FREE-TIERS-GUIDE.md) kí o tó yan olupese kan.📦 Àwọn script quickstart tí o lè da síbi kí o sì ṣiṣẹ́ fún **Python, Node.js, PHP, àti cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Àdéhùn náà
# 🤔 Kí ló dé 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ó Yà OmniRoute Sótọ̀
📊 Ìlànà kíkún àti àlàyé ẹ̀yà kọ̀ọ̀kan ní ìfiwéra pẹ̀lú 9router, OpenRouter, CLIProxyAPI àti 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)**.
## ✨ Kí ni Tuntun
> Àwọn àkótán tuntun láti **v3.8.20 → v3.8.54**. Wo gbogbo ìtàn nínú [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Ìtọ́jú `quota-weighted`** — ìlànà combo ogún máa ń fo àwọn àkántì tí quota wọn ti tán, lẹ́yìn náà ó yan láàárín àwọn tó kù ní ìbámu pẹ̀lú leftover quota ÷ in-flight load, nípa bẹ́ẹ̀ àwọn ìjíròrò tó wà tẹ́lẹ̀ á dúró mọ́ ibi wọn. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Ipo Headless** — `omniroute serve --headless` (tàbí `OMNIROUTE_HEADLESS=1`) máa ń ṣiṣẹ́ engine aṣojú `/v1/*` nìkan, pẹ̀lú dashboard àti àwọn subsystems tó jẹ́ ti dashboard nìkan tí a pa. → [Ipo Headless](docs/guides/HEADLESS.md)
- **🔎 Ìwádìí model** — `/v1/models` máa ń ṣe àlẹ̀mọ́ nípa agbára, context, irú àti ọ̀rọ̀, àti `POST /v1/models/query` máa ń dá shortlist kúkúrú tó ní ìpinnu kan náà padà, pẹ̀lú ìríran per-key kan náà. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🔑 Ìṣàkóso routing fún kọ́kọ́rọ́ kọ̀ọ̀kan** — so API key kan mọ́ model kan tàbí combo kan pẹ̀lú `forcedModel`, kí o sì fi models àti combos kọ́kọ́rọ́ kan kún un tàbí yọ wọ́n kúrò ní ẹ̀ẹ̀kan (`/api/keys/{id}/access`). → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Àwọn ìṣàkóso PII tó túbọ̀ rọrùn** — yíyan nípa irú, títí dé àwọn àpẹẹrẹ masking àṣà 20 tí a fìdí rẹ̀ múlẹ̀, àti àwọn counter ìṣàwárí fún irú kọ̀ọ̀kan; masking fúnra rẹ̀ ṣì jẹ́ ohun tí a gbọ́dọ̀ yàn. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 Àwọn èdè 67** — dashboard, àwọn àfihàn docs à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** — A2A delegation tó ń wọlé sí fleet agent rẹ, àwọn ọgbọ́n Conductor lórí Agent Card, àti panel dashboard kan pẹ̀lú Faro push-to-talk voice chat. → [Olùpèsè A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Gbigba wọlé tó bá ara mu àti ìdènà overload** — àwọn ìbéèrè chat tó wuwo máa ń dúró ní queue dípò kí wọ́n máa dá 503 padà, pẹ̀lú àwọn atomic RPM rolling leases fún connection kọ̀ọ̀kan. → [Ìtọ́sọ́nà Resilience](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Ìtòlẹ́sẹẹsẹ `/v1/models` tó jẹ́ canonical** — block kan ṣoṣo tó tẹ̀lé ara rẹ̀ fún provider kọ̀ọ̀kan (àwọn combos pinned ní àkọ́kọ́), tó dúró ṣinṣin káàkiri gbogbo catalog source. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🗜️ Ìmúgbòrò compression** — inflation guard tó wà nípasẹ̀ àìpẹ̀yà, Caveman packs fún DE / FR / JA àti Chinese (wényán), àti RTK filters fún Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Iye flat-rate tó jẹ́ òtítọ́** — àwọn provider subscription / coding-plan máa ń kà sí **$0** nínú ìtúpalẹ̀ iye owó; budget, quota àti routing ṣì ń ṣe ìṣírò. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **⚖️ Ìtọ́jú Quota-Share** — pín quota account tí a pín fún àwọn pooled keys ní òdodo, ó sì ń lo gbogbo agbára tó wà nípa yíyan àwọn slices tí kò ṣiṣẹ́ fún àwọn míì. → [Ìtọ́sọ́nà Resilience](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Ìṣètò CLI/agent pẹ̀lú àṣẹ kan** — àwọn àṣẹ `setup-*` 15 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 targets 11 pẹ̀lú yíyan provider+model ìbánisọ̀rọ̀ àti àwọn favorites fún context kọ̀ọ̀kan. → [Àwọn Ìṣọ̀kan CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Ipo Remote** — ṣàkóso OmniRoute remote kan pẹ̀lú àwọn token tó ní ààlà (`connect` / `contexts` / `tokens`) + olùrànlọ́wọ́ OAuth `antigravity` fún àwọn ìfìsí VPS. → [Ipo Remote](docs/guides/REMOTE-MODE.md)
- **🧭 Auto-routing tó lóye jù** — `auto/:` combos, **Fusion** (model panel + judge), routing tó mọ 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è fi engine kún** — engines 12 tó lè darapọ̀ + Compression Studios: LLMLingua-2, Ultra tier méjì, omniglyph, per-step fidelity gate, GCF v3.2, àti drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ MITM decrypt (TPROXY) tó hàn gbangba** — capture CLIs tí ń fo àwọn proxy env vars, pẹ̀lú CA fún SNI kọ̀ọ̀kan + installer trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Àwọn ìwífún iye owó ní gbogbo ibi** — àwọn headers iye owó/lílò `X-OmniRoute-*` lórí endpoint kọ̀ọ̀kan, header savings fún cache-HIT, àti àwọn quota ìná USD fún key kọ̀ọ̀kan. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🧠 Memory tí ìwọ ń ṣàkóso** — ó wà ni pipa ní ìbẹ̀rẹ̀, opt-in int8 vector quantization + 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 LLM route (red-team suite), credential-masking guardrail tí a lè yàn (ó ń bo àwọn API key/secret tí ó bá jo ní àwọn ìtọ́sọ́nà méjèèjì), ìwádìí wẹẹbù DuckDuckGo ọ̀fẹ́ fún ìgbà ìkẹyìn, àti OIDC login gate àṣàyàn fún dashboard (password login máa ń wà ní gbogbo ìgbà). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Àwọn endpoint tuntun** — `/v1/ocr` (Mistral OCR) àti `/v1/audio/translations` (irú Whisper) ń mú àgbègbè media pé. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🎨 Ṣíṣẹ̀dá image / video / audio** — API kan fún media: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, àti àwọn provider speech bí ElevenLabs. → [Ìtọ́kasí API](docs/reference/API_REFERENCE.md)
- **🌍 Deployment àti ops** — reverse-proxy `basePath`, ìṣàwárí browser-language aládàáṣe, device tracking fún key kọ̀ọ̀kan, MITM trust tí kò nílò root, àti ìtumọ̀ zh-TW. → [Ayíká](docs/reference/ENVIRONMENT.md)
- **🤝 Àwọn provider àti agent míì** — cloud agents (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) pẹ̀lú browser + OAuth login, kaadi Ollama tó ní àtìlẹ́yìn kíkún, Claude Opus 5 & Sonnet 5, ìfọwọ́sowọ́pọ̀ Kimi tó jẹ́ official (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… àti **catalog provider 388** tí a tún ṣe. → [Àwọn Provider](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Ìhàn gbangba routing** — gbogbo ìdáhùn ní header `X-OmniRoute-Decision` tó ń sọ strategy/provider/latency tó pèsè rẹ̀, combo strategy `cache-optimized` tuntun + factor `cacheAffinity` Auto-Combo máa ń darí àwọn ìbéèrè tí a tún ṣe padà sí connection tó ń di prefix tí a cache mọ́, àti endpoint `/v1/auto-combo/{channel}/candidates` tí a kà nìkan ń ṣí pool candidate gidi ti channel `auto/*` hàn. → [Auto-Combo](docs/routing/AUTO-COMBO.md).
- **⚡ Ìṣiṣẹ́ agbègbè tó yára & amáyédẹrùn** — Redis agbègbè pẹ̀lú títẹ bọtìnì kan, àwọn olùgbékalẹ̀ relay Cloudflare Workers / Deno Deploy, àti Bifrost & Mux gẹ́gẹ́ bí àwọn iṣẹ́ tí a fi sínú tí a ń bójú tó. → [Àwọn Iṣẹ́ Tí A Fi Sínú](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Àwọn míì nínú àpótí** — ìlànà plugin + ọjà, àwọn ìlànà ọgbọ́n Omni/Agent/GitHub, ìṣọ̀kan Obsidian vault (àwọn irinṣẹ́ MCP 22), àwọn API Batch & Files tó bá OpenAI mu, kásì ìdáhùn ọgbọ́n, ìṣeré pẹ̀lú àwọn tábìlì aṣáájú, ìwádìí aṣojú ACP (àwọn aṣojú tí a ṣe sínú 15), ìtajà log tí a ṣètò sí BigQuery, `auto/chaos` ìfìtẹ́lẹ̀ ọ̀pọ̀ àwòṣe ní ìfarawé, afárá bot Telegram, olùṣàkóso ẹ̀dà nínú ìṣàfilọ́lẹ̀ àti àwọn ìṣàyẹ̀wò àwọn olùpèsè ọ̀fẹ́ LMArena-ELO. → [Àkọsílẹ̀](docs/README.md)
## 🤖 Àwọn CLI àti Aṣojú Kóòdù Tó Bá Mu
> Ìṣètò kan — `http://localhost:20128/v1` — àti **gbogbo** IDE tàbí CLI AI máa ń ṣiṣẹ́ lórí àwọn modelu ọ̀fẹ́ àti iye owó kékeré.
+ ó tún ń ṣiṣẹ́ pẹ̀lú · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ohun èlò OpenAI-compatible èyíkéyìí
📖 Ìṣètò fún irinṣẹ́ kọ̀ọ̀kan nínú gbogbo irinṣẹ́ 39 (28 CLI Code's + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Ṣí CLI èyíkéyìí tí a ṣe àtìlẹ́yìn fún nípasẹ̀ OmniRoute pẹ̀lú àṣẹ kan** — kò sí fáìlì ìṣètò tí a kọ,
a máa fi àwọn ẹ̀rí ìwọlé sílẹ̀ fún ìlànà kọ̀ọ̀kan, Qwen/Gemini sì máa gba ilé àdádó 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 pèsè+àwòṣe ní ìbáṣepọ̀ kí o sì kọ ìṣètò tirẹ̀ ti irinṣẹ́:
omniroute configure codex # pẹ̀lú: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Gbogbo àṣẹ máa bọ̀wọ̀ fún àyíká àgbègbè tó ń ṣiṣẹ́ (`omniroute connect `), `--dry-run`
máa ṣàfihàn env/args gangan láìṣe ìmúṣẹ́, `--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)
## 🌐 Àwọn Olùpèsè AI 388 — 153 Ti A Samisi Nínú Kátálógù Gẹ́gẹ́ Bí Ọ̀fẹ́
> **Àwọn olùpèsè 388 tí a forúkọsílẹ̀** káàkiri àwọn àkójọpọ̀ chat, media, search, local, cloud-agent àti system tó jẹ́ àkọ́kọ́, pẹ̀lú **153 tí ó ní metadata ìwádìí `hasFree: true`**. Àkọsílẹ̀ àwọn chat model bo **àwọn olùpèsè 239 / àwọn ìbáṣepọ̀ provider-model ọ̀tọ̀ọ̀tọ̀ 3,059 / àwọn ID model aise 1,475**; kátálógù ìná ọ̀fẹ́ tó yàtọ̀ ní **àwọn ìlà fún model 471**, **àwọn adágún tó ń tún ara wọn ṣe 34** àti **àwọn olùpèsè ọ̀fẹ́ títí láé 52 tí ó ń tún ara wọn ṣe/tí kò nílò kọ́kọ́rọ́**. Àwọn iye ìpín wọ̀nyí yàtọ̀ ní ìmọ̀lára; àwọn ìtumọ̀ àti ìṣirò tí a ti yọ ìdàpọ̀ adágún 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á ńlá — nípasẹ̀ endpoint kan
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…àti àwọn míì tó ju 350 lọ — gbogbo àmì àwòrán máa ń ṣí láìsí ìṣòro láti inú kátálógù olùpèsè dashboard. 📖 [Ìtọ́kasí Olùpèsè](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Ọ̀fẹ́ Títí Láé — $0, kò sí káàdì mootummaa
OpenCode Zen DeepSeek V4, Nemotron 3 Kò sí ààlà token
Kilo Code Olùdarí aládàáṣiṣẹ́, 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+ Neurons 10K/ọjọ́
NVIDIA NIM GLM, MiniMax RPM ọ̀fẹ́ ~40
Cerebras GLM 4.7, GPT-OSS Kirẹ́ẹ̀dítì $5 lẹ́ẹ̀kan; káàdì jẹ́ dandan
OpenRouter :free models +$10 → RPM tó ga jù
📖 Kátálógì kíkún tí ẹ̀rọ lè kà → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Ibi OmniRoute nṣiṣẹ - nibikibi
> Ohun elo kanna, ẹrọ rẹ, awọn ofin rẹ. Lati fi sori ẹrọ npm agbaye si** foonu rẹ** nipasẹ Termux.
Platform
Fi sori ẹrọ
Awọn ifojusi
📦 npm (agbaye)
npm fi sori ẹrọ -g omniroute
Aṣẹ kan, eyikeyi OS
⚡ Bun (agbaye)
bun fi -g omniroute
Tarball iforukọsilẹ kanna, fifi sori ẹrọ ni kiakia
🐳 Docker
docker run … diegosouzapw/omniroute
Olona-arch AMD64 + ARM64
🖥️ Desktop (Electron)
npm ṣiṣe elekitironi:
Native window + eto atẹ — Windows / macOS / Linux
🎩 Akojọ aṣyn-bar (OmniRouteTray)
pọnti fi sori ẹrọ --cask zoispag/tap/omniroute-tray
Abojuto & adaṣe imudojuiwọn olupin — macOS
💪 ARM
abinibi arm64
Rasipibẹri Pi, ARM olupin, Apple Silicon
📱 Android (Termux)
pkg fi sori ẹrọ nodejs && npx -y omniroute
Ṣiṣe lori foonu rẹ , 24/7, ko si root
📲 PWA
"Fikun-un si Iboju ile"
Iboju ni kikun, offline, fifi sori ẹrọ lati aṣawakiri
🧩 OpenCode itanna
@omniroute/opencode-provider
OpenCode zqn isọpọ
🤖 VS Code Copilot Wiregbe
fi sori ẹrọ OmniCopilot itẹsiwaju
Gbogbo OmniRoute awoṣe ni abinibi Copilot Awo picker — idurosinsin & Insiders
> Ko si titun legbe, ko si titun iwiregbe UI - gbogbo awoṣe OmniRoute sìn fihan soke ọtun ninu awọn**Copilot Chat awoṣe picker ti o ti lo tẹlẹ** . Lati koodu VS 1.122, awọn awoṣe olupese n ṣiṣẹ laisi iwọle GitHub tabi ṣiṣe alabapin Copilot — ipo aṣoju, pipe irinṣẹ ati iran, fun ọfẹ.
Fi sori ẹrọ naa** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** itẹsiwaju, tọka si olupin OmniRoute rẹ (aiyipada si `localhost:20128`), lẹhinna ṣii Copilot Chat → awoṣe picker →** Ṣakoso Awọn awoṣe…** →**OmniRoute** .
Lati inu olootu: ṣii** Awọn amugbooro** wo, àwárí** "OmniRoute"** , tẹ** Fi sori ẹrọ** - ṣiṣẹ ni ọna kanna lori awọn ile itaja mejeeji. Orisun, awọn ọran ati iwe ṣiṣe titẹjade n gbe ni [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Koodu Copilot Itọsọna Wiregbe](docs/guides/VSCODE-COPILOT.md) - iṣeto, kini oluyan fihan, dasibodu-in-a-tab, laasigbotitusita
> `omniroute serve` ni idunnu julọ nigbati o ba wa nigbagbogbo.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** yi iyẹn pada si eto-ati-gbagbe mẹnu-bar app fun macOS: o bẹrẹ olupin naa, jẹ ki o wa laaye kọja awọn atunbere, ṣe imudojuiwọn rẹ ni aaye, ati fi eto-inawo tokini laaye laaye ni titẹ kan kuro -** ko si ferese ebute oko ti o wa ni sisi, ko si `npm install -g omniroute` si ibi omo.**
Ti a ṣe pẹlu [Tauri v2](https://v2.tauri.app/) (ikọkọ Rust kan ti o jẹ iwọn aṣiṣe iyipo), o firanṣẹ akoko asiko Node 24 ti o fowo si ati ṣakoso fifi sori OmniRoute ti ohun elo kan, nitorinaa ko ja `node`/`bun` agbaye rẹ rara. O** pin atunto `~/.omniroute/` ti o wa tẹlẹ ati data data** - nitorina o jẹ OmniRoute kanna ti o ti ṣiṣe tẹlẹ, o kan pẹlu ijanilaya lori. 🎩
Ohun ti o ṣe
Bawo ni
🟢 Abojuto olupin
Spawns omniroute serve , gba apẹẹrẹ ti nṣiṣẹ tẹlẹ dipo ṣiṣe ẹda
Ti ṣeto fifi sori ẹrọ, atomiki swap, yiyi pada lori ikuna - nigbagbogbo lori itusilẹ tuntun
🚀 Bẹrẹ ni iwọle
Ifilọlẹ iyan ni wiwọle; atẹ-nikan, ko si aami ibi iduro
🩺 Dókítà & àkọọlẹ
Awọn ayẹwo-ọkan-ọkan ati wiwọle wiwọle olupin
```sh
brew install --cask zoispag/tap/omniroute-tray
```
o fẹ igbasilẹ kan? Ja gba tuntun .dmg lati
Tu silẹ. Orisun, awọn oran ati kọ
docs gbe ni zoispag/omniroute-tray.
💛 Ise agbese agbegbe kan nipasẹ @zoispag - kii ṣe idasilẹ OmniRoute osise kan.
> 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% Àmi — Lọ́wọ́ọ̀wọ́
### 📖 Bí ó ṣe ń ṣiṣẹ́ — pipeline, ìṣètò àti ìṣirò ìfipamọ́
Àkópọ̀ àiyípadà àìpẹ̀yà máa ń ṣiṣẹ́ `RTK → Caveman`. Nígbà tí àwọn méjèèjì bá ṣiṣẹ́ lórí payload irinṣẹ́/àyíká kan náà, ìfipamọ́ máa ń kóra jọ:
```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 àkọsílẹ̀ kóòdù, URLs, JSON àti dátà tó ní ìṣètò jẹ́ **ìdáàbòbò ní gbogbo ìgbà** pẹ̀lú engine ìpamọ́.
> **Kí ló dé tí a fi máa lo àmi púpọ̀ nígbà tí díẹ̀ bá tó?** Gbogbo ìbéèrè máa ń kọjá nínú pipeline ìfúnkù OmniRoute **láìfarahàn** — kò sí ìyípadà oníbàárà. Ó ti di **àkójọpọ̀ àwọn engine 12 tí a lè ṣàkópọ̀** tí wọ́n ń ṣiṣẹ́ létòlétò, tí a sì lè dàpọ̀ àti yàn gẹ́gẹ́ bí àkópọ̀ ìtọ́sọ́nà kọ̀ọ̀kan — tí wọ́n sì ń gbé lórí à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ọ̀ engine 12
Àwọn engine ń ṣiṣẹ́ létòlétò pipeline; a lè tan tàbí pa ọkọ̀ọ̀kan, a sì lè ṣètò ọkọ̀ọ̀kan fún àkópọ̀:
#
Engine
Ohun tí ó ń ṣe
1
Session-Dedup
Ó ń yọ àkóónú tí ó tún ń farahàn kọjá àwọn ìyípadà (tí àkóónú ń tọ́ka sí, kọjá ìyípadà)
2
CCR
Ó ń fi àwọn bulọ́ọ̀kì ńlá pamọ́ lẹ́yìn àwọn àmì ìmúpadàbọ̀, tí a ń gbà nígbà tí ó bá nílò
3
Lite
Ó ń gé ààyè òfo + URL àwòrán (ìpele ìpilẹ̀ tí kò wuwo fún ìdádúró)
Ìṣèkóòdù àyíká-ọ̀rọ̀-gẹ́gẹ́-bí-àwòrán fún Claude Fable 5 tí a dánwò lórí okun Anthropic tààrà; GPT 5.6 transformers ṣì wà ní fail-closed títí a ó fi rí ẹ̀rí olùpèsè. Àwọn profaili ìfúnkù mẹ́rin (àiyípadà líle jùlọ ní àìpẹ̀yà, balanced, coding-safe, passthrough) (líle jùlọ; opt-in)
Àwọn àkọsílẹ̀ kóòdù, URLs àti dátà tó ní ìṣètò jẹ́ **ìpamọ́ pátápátá ní gbogbo ìgbà**. **Àwọn àkọ́kọ́ṣàṣàyàn tẹ̀ kan** ń ṣàkópọ̀ àwọn engine:
Mode
Ìfipamọ́
Ó dára jù fún
🪶 Lite
~15%
Àṣàyàn àìyípadà tó ní ààbò, tí ó máa ń ṣiṣẹ́ ní gbogbo ìgbà
🪨 Standard (Caveman)
~30%
Kóòdù ojoojúmọ́
⚡ Aggressive
~50%
Àwọn ìpàdé gígùn tí irinṣẹ́ pọ̀ sí
🔥 Ultra
~75%
Ìfipamọ́ tó pọ̀ jù
🧰 RTK
60–90%
Àbájáde shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Àwọn ìbéèrè adalu + àwọn àkọsílẹ̀ irinṣẹ́
**Àpẹẹrẹ gidi — mode Standard:**
> **Ṣáájú (àmi 69):** _"Ìdí tí React component rẹ fi ń ṣe re-render ṣeé ṣe kó jẹ́ pé o ń dá object reference tuntun sílẹ̀ ní gbogbo ìyípadà render. Nígbà tí o bá fi object inline ránṣẹ́ gẹ́gẹ́ bí prop, ìfihàn shallow ti React máa rí i gẹ́gẹ́ bí object mìíràn ní gbogbo ìgbà, èyí sì ń fa re-render. Mo máa ṣàbẹ̀wò pé kí o lo useMemo láti memoize object náà."_
>
> **Lẹ́yìn (àmi 19):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_
>
> **Ìdáhùn kan náà. Àmi kéré sí 72%. Kò sí àdánù ìpéye.** ✅
**Àpẹẹrẹ PT-BR — mode [Troglodita](https://github.com/leninejunior/troglodita):**
> **Ṣáájú (àmi 42):** _"Ìṣòro náà ni pé ẹ̀ka náà ń ṣe àtúnṣe-rírọ̀nìkànsí nítorí pé ìtọ́kasí ohun tuntun kan ń ṣẹ̀dá ní gbogbo yíyí ìṣàfihàn. Èmi yóò ṣàgbékalẹ̀ lílo useMemo."_
>
> **Lẹ́yìn (àmi 12):** _"Àtúnṣe-rírọ̀nìkànsí: ìtọ́kasí tuntun ní gbogbo yíyí (ohun inline tún ṣẹ̀dá). Lo `useMemo`."_
>
> **Ìdáhùn kan náà. Àwọn àmi kéré ní ìwọ̀n 70%. Ìpéye ọ̀nà ìmọ̀ kò yí padà.** ✅
### 🎚️ Kọjá àwọn ẹ́ńjìnì — àwọn àṣàyàn àbájáde, àyípadà ìmúdọ́gba àti ìṣàkóso fún ìbéèrè kọ̀ọ̀kan
Àwọn ẹ́ńjìnì 12 tó wà lókè dín ohun tó ń **wọlé** kù. Àwọn ìpele mẹ́ta míì ló ń dá **bí**, **ìgbà wo**, àti ohun tó ń **jáde** sílẹ̀:
- **🪄 Àwọn Àṣà Àbájáde** _(ìdarí lórí àbájáde)_ — wọ́n ń fi àwọn ìtọ́ni tó ṣeé pinnu, tó sì bójú mu fún kásì, ṣe àkópọ̀ ìrísí ìdáhùn; wọ́n lè darapọ̀, ọ̀kọ̀ọ̀kan sì wà ní agbára `lite` / `full` / `ultra`. Fífi àṣà kan kún un jẹ́ ìforúkọsílẹ̀ laini kan:
- **Ọ̀rọ̀ ṣókí** — yọ ọ̀rọ̀ àfikún / àwọn àpilẹ̀kọ / ìṣiyèméjì kúrò; pa ohun pàtàkì ìmọ̀ ẹ̀rọ mọ́ ní pípé.
- **Kóòdù díẹ̀** — YAGNI “olùgbékalẹ̀ agba tó ń ṣe ọ̀lẹ”: àyípadà kékeré tó ń ṣiṣẹ́, láìsí ètò àfikún tí a kò béèrè fún.
- **Ìrù ẹṣin (olùgbékalẹ̀ agba tó ń ṣe ọ̀lẹ)** — gòkè àkàbà YAGNI, ṣàtúnṣe ohun tó fa ìṣòro náà, kí ìyípadà tó ń ṣiṣẹ́ jẹ́ kékeré jù.
- **Mo ní ADHD (ìṣe-akọ́kọ́)** — ìṣe tó kàn ń bọ̀ ló máa kọ́kọ́ wá, àwọn ìgbésẹ̀ ní nọ́mbà, ìgbésẹ̀ kan pàtó tó kàn, láìsí ọ̀rọ̀ ìṣáájú.
- **CJK ṣókí (文言)** — àṣà Ṣáínà ayé àtijọ́ tó kéré gan-an (a máa ṣàkóso rẹ̀ gẹ́gẹ́ bí èdè sí `zh`).
- **🎯 Bọ́jétì àyíká ọ̀rọ̀ ìmúdọ́gba** _(àyípadà)_ — dípò ààlà àmi kan tó máa ń wà tàbí kò sí, ó máa ń gbé àwọn ẹ́ńjìnì tó ná kéré jù, tó sì ń pàdánù díẹ̀ jù lọ, sókè díẹ̀díẹ̀ títí tí ohun tó nílò fi **wọ inú fèrèsé àyíká ọ̀rọ̀ àwòṣe**. Ìlànà: `reserve-output` (àìkùnà, ó mọ àwòṣe) · `percentage` · `absolute`. Àyè: `floor` (ṣe ìdánilójú pé ó bá a mu) · `replace-autotrigger` (àṣàyàn rẹ ní àṣẹ) · `off` (ààlà àtijọ́).
- **🎛️ Ibi tí a ti ń pinnu ìfúnpọ̀** _(àṣẹ, gíga → kékeré)_ — àkọsílẹ̀ `x-omniroute-compression` fún ìbéèrè kọ̀ọ̀kan › àyípadà routing-combo › profaili tí a dárúkọ tó ń ṣiṣẹ́ › adaptive / auto-trigger › àṣàyàn paneli àìpẹ̀yà › off. Ètò tí a lò máa ń padà nínú àkọsílẹ̀ ìdáhùn `X-OmniRoute-Compression: ; source=`.
Ṣètò auto-trigger pẹ̀lú ààlà àmi, yí àyípadà ìmúdọ́gba sílẹ̀, so profaili tí a dárúkọ mọ́ ọn, ṣètò rẹ̀ lẹ́ẹ̀kan fún ìbéèrè kan, tàbí yan pipeline fún routing combo kọ̀ọ̀kan — èyíkéyìí tó bá iṣẹ́ náà mu. **eval harness** offline tí a yan láti fẹ́ràn (`npm run eval:compression`) máa ń díwọ̀n ìdúróṣinṣin sí àwọn àǹfààní ìfipamọ́ lórí àkójọpọ̀ tí a dì mọ́, kí o tó gbé àyípadà kan lárugẹ.
📖 [`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 sori ẹrọ kí o sì ṣiṣẹ́**
```bash
npm install -g omniroute
omniroute
```
> 💡 Ṣé o rí `npm warn ERESOLVE` tàbí ì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 jù bẹ́ẹ̀ lọ?** npm lè dí àwọn script ìgbésí-ayé package dúró bí a kò bá fún wọn ní àṣẹ. `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) ṣe pàtàkì láti pèsè àwọn fáìlì runtime abinibi rẹ̀. Fún àwọn package tí a dárúkọ nínú ìkìlọ̀ npm ní àṣẹ nígbà tí o bá ń fi OmniRoute sílẹ̀ ní gbogbogbòò. Fún àkójọpọ̀ package tí OmniRoute 3.8.54 ròyìn:
>
> ```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 ìfìsílẹ̀ gbogbogbòò ọjọ́ iwájú, ṣètò rẹ̀ lẹ́ẹ̀kan, lẹ́yìn náà fi sílẹ̀ lọ́nà àṣà:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Àtòjọ dependencies lè yí padà láàárín àwọn ìtújáde; bí npm bá ròyìn àtòjọ míì, lo àwọn orúkọ package tó wà nínú ìkìlọ̀ náà. Fífún package ní àṣẹ máa ń jẹ́ kí àwọn script ìfìsílẹ̀ rẹ̀ ṣiṣẹ́.
> **Ṣé o ń lo Gemini Web tàbí olùpèsè cookie wẹẹbù míì?** Package npm ní
> Playwright nínú, ṣùgbọ́n kò ní binary Chromium rẹ̀. Wo
> [ìṣètò Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> kí o tó ṣe ìbéèrè olùpèsè wẹẹbù àkọ́kọ́.
Dashboard wà ní `http://localhost:20128` · API wà ní `http://localhost:20128/v1`.
**2) So olùpèsè tó yẹ pọ̀ pẹ̀lú àkáǹtì tirẹ**
Dashboard → **Providers** → yan olùpèsè tí àwọn òfin àti quota rẹ̀ lọ́wọ́lọ́wọ́ bá ohun tí o fẹ́ ṣe mu → fi API key rẹ̀ kún un tàbí parí ìṣàn àkáǹtì rẹ̀. Àwọn free tiers lè béèrè ìforúkọsílẹ̀, ìfọwọ́sí, tàbí ọ̀nà ìsanwó kan. Ṣàyẹ̀wò [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md); kò sí ìdánilójú pé ààyè láìsí key wà, àwọn olùpèsè tí a samisi `tos: avoid` sì wà láìsí nínú `auto` ní àkọ́kọ́.
**3) Tọ́ka ohun èlò kóòdù rẹ**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) Ṣàyẹ̀wò pé ó ń ṣiṣẹ́**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
O yẹ kí o rí àwọn àwòṣe tí o so pọ̀ tí a ṣe àtòjọ. 🎉 Ìyẹn ni gbogbo rẹ̀ — bẹ̀rẹ̀ sí í kọ́ kóòdù, OmniRoute yóò sì yan ọ̀nà àti padà sí aṣàyàn míì fún ọ láìsí ìsapá.
Bí client rẹ kò bá lè rán àwọn akọsílẹ̀ àṣà, OmniRoute tún ń pèsè àwọn aliases ìbámu tó ní token:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Lo àwọn wọ̀nyí nìkan fún àwọn client tí kò lè so `Authorization: Bearer ...` mọ́. Àṣẹ akọsílẹ̀ ṣì ni ọ̀nà 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 ì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 tí a ṣètò pẹ̀lú àyíká ìbéèrè
Ìdánwò
Olùṣàkóso ìdánwò Node.js + Vitest — àwọn ìkéde ìdánwò aláìlásọ̀tẹ́lẹ̀ tó ju 60,000 lọ káàkiri àwọn fáìlì ìdánwò tó lé ní 8,400 (unit, integration, E2E, ààbò, ecosystem)
Ọgbọ́n ibora ìdánwò fún àwọn ìkéde ìdánwò aimi tó ju 60,000 lọ káàkiri àwọn fáìlì ìdánwò tó lé ní 8,400 tí a ń tọ́pa
# ⭐ Àwọn Olùkópa Àgbà
> Àwùjọ orísun-ìmọ̀ tó ní ìfẹ́ ńlá ló ń ṣe àkóso OmniRoute. Àwọn ẹni wọ̀nyí ti ṣe àwọn àfikún àrà ọ̀tọ̀ tí ó kan dídára, ìdúróṣinṣin, àti ìtànkálẹ̀ iṣẹ́ náà ní tààrà. **Ẹ ṣé.**
### Àwọn olùkópa òde nípasẹ̀ àwọn pull request tí a ti dapọ̀
A ṣe ìkànìyàn ní 2026-11-03 03:01:19 UTC pẹ̀lú ìpẹ̀yà ìgbàlódé release/v3.8.5305bc048d6c. Ìkànìyàn GitHub GraphQL tí a pín sí ojúewé ní àwọn PRs 9,947 tí a ti dapọ̀: 4,130 láti ọ̀dọ̀ olùní iṣẹ́ ibi ìpamọ́ náà, 240 láti ọ̀dọ̀ Dependabot, 6 láti ọ̀dọ̀ àwọn bot/app mìíràn, àti 5,571 PRs òde láti ọ̀dọ̀ àwọn olùkópa 883 ọ̀tọ̀ọ̀tọ̀. “Àwọn ìlà tí a yí padà” jẹ́ àfikún + ìkópadà GitHub, ó sì ní àwọn fáìlì tí a ṣe jáde, lockfiles, àwọn kàtàlógì, àwọn ìtumọ̀ àti ìwé ìmúlò nínú; ó jẹ́ ìyípadà iṣẹ́, kì í ṣe LOC tí a kọ. Àwọn PRs 53 ròyìn àwọn ìyàtọ̀ GitHub tó ju 500,000 ìlà lọ (fún àpẹẹrẹ #13399, àfikún olùpèsè kan ṣoṣo, ṣe àkójọ àwọn fáìlì 2,347 tí a yí padà), èyí tó ń gbé ọ̀pọ̀ àpapọ̀ tó wà lókè ga. A pín àwọn tó dọ́gba sí ipò kan náà.
### Àwọn commit tí GitHub so mọ́ àwọn olùkópa
A tún ṣàyẹ̀wò rẹ̀ ní 2026-11-03 02:09:16 UTC: Àwọn commit tí GitHub fi sílẹ̀ tí API Contributors ti ibi ìpamọ́ náà ròyìn fún ẹ̀ka àìyípadà release/v3.8.53. API náà dá àwọn ìdánimọ̀ 903 padà (àwọn olumulo 429, àwọn bot 2, àti àwọn aláìlórúkọ 472); tábìlì yìí kò kà olùtọ́jú, àwọn bot àti àwọn ìdánimọ̀ aláìlórúkọ sí, ó sì tún pa àwọn ìdíje tí iye wọn dọ́gba mọ́. Ó yàtọ̀ sí mejeeji ìpín àwọn PR tí a ti ṣàpapọ̀ lókè àti ìkànìyàn metadata Git tó wà nísàlẹ̀.
> 🙏 Àwọn àfikún àwọn olùkópa wọ̀nyí, àwọn àtúnṣe aṣìṣe, àti àwọn ìmúgbòrò amáyédẹrùn jẹ́ **apá pàtàkì** nínú ohun tí ń jẹ́ kí OmniRoute jẹ́ alágbẹ̀kẹ̀lé tí ó sì ní ọ̀pọ̀ àfidámọ̀. Gbogbo ìbéèrè ìfàṣẹ́pọ̀, gbogbo àpẹẹrẹ ìdánwò, àti gbogbo fáìlì ìtumọ̀ i18n ṣe pàtàkì. Àwọn ènìyàn bíi wọ́n ni ó ń kọ́ orísun-ìmọ̀.
---
## 💖 À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ùkópa 1,000+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Wọ́n ṣe àyẹ̀wò rẹ̀ ní 2026-11-02 ní orí ìpẹ̀yà live release/v3.8.531c7135e0fb (commit 7,972): àwọn ìdánimọ̀ Git ènìyàn tí a ṣe ìṣọ̀kan 1,074 — 759 farahàn gẹ́gẹ́ bí àwọn olùkọ̀wé commit (pẹ̀lú olùtọ́jú náà), 315 sì farahàn nìkan nínú àwọn trailer Co-authored-by tí a ṣàlàyé. Ìkànìyàn náà máa ń lo .mailmap, ó sì máa ń fi àwọn àdírẹ́sì e-mail wé ara wọn láìka ìyàtọ̀ lẹ́tà ńlá àti kékeré; ó máa ń so àwọn àdírẹ́sì GitHub noreply tó ní nọ́ńbà àti àwọn tó rọrùn pọ̀ nìkan nígbà tí wọ́n bá ń ṣàpèjúwe handle kan náà; ó máa ń yọ àwọn ìdánimọ̀ bot/agent/service/placeholder 29 kúrò; kò sì máa ń so àwọn àdírẹ́sì e-mail déédé pọ̀ nítorí pé àwọn orúkọ ìfihàn wọn jọra. Àyẹ̀wò 2026-08-24 tẹ̀jáde 639; ṣùgbọ́n tí a bá tún ọ̀nà yìí ṣe lórí ìpìlẹ̀ àyẹ̀wò yẹn ac02c5b42f, ó ń fún wa ní 619, nítorí náà ìlọsíwájú náà wá láti ọ̀dọ̀ àwọn olùkópa tuntun, kì í ṣe láti ọ̀nà tí ó rọrùn síi.
### Bí A Ṣe Lè Kópa
1. Ṣẹ̀dá fork ti repository náà
2. Ṣẹ̀dá ẹ̀ka láti orí ìpẹ̀yà **ṣiṣẹ́** `release/vX.Y.Z` (kì í ṣe `main`) — wo [Àwòkọ Ẹ̀ka àti Ìtúsílẹ̀](docs/ops/BRANCHING_MODEL.md)
3. Ṣẹ̀dá ẹ̀ka àfidámọ̀ rẹ (`git checkout -b feat/amazing-feature`)
4. Ṣe commit àwọn àyípadà rẹ (`git commit -m 'feat: add amazing feature'`)
5. Fì 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úlẹ̀kúlẹ̀.
### Ìtúsílẹ̀ Ẹ̀yà Tuntun
```bash
# Ṣẹ̀dá ìtúsílẹ̀ kan — npm publish máa ń ṣẹlẹ̀ láìfọwọ́wọ́
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Àwọn Ìràwọ̀
## 🌍 StarMapper
## 🙏 Àwọn ìdúpẹ́
OmniRoute dúró lórí àyà àwọn òmìrán. Ó bẹ̀rẹ̀ gẹ́gẹ́ bí ẹ̀ka kan ti **[9router](https://github.com/decolua/9router)** àti ìyípadà TypeScript ti iṣẹ́ Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — láti ibẹ̀, gbogbo ẹ̀ka-iṣẹ́ tó wà ní isàlẹ̀ ni iṣẹ́ orísun-ìmọ̀ kan tí ó dé ibẹ̀ ṣáájú ló fún ní ìmísí. Ọ̀kọ̀ọ̀kan wọn ló ṣe àgbékalẹ̀ apá pàtàkì kan ti OmniRoute. Èyí ni ọpẹ́ wa sí gbogbo wọn. 🙏
> ⭐ Àwọn iye irawọ̀ ni a fìdí rẹ̀ múlẹ̀ láti API REST GitHub ní ọjọ́ 3 Oṣù kọ́kànlá, 2026 — ẹ lọ fún àwọn iṣẹ́ wọ̀nyí ní irawọ̀. Àwọn iye náà jẹ́ àwòrán pàtó ti ọjọ́ náà, wọ́n sì máa yí padà ní ti ẹ̀dá.
### 🧬 Ìran àti ẹnu-ọ̀nà
Ẹnu-ọ̀nà AI tí àkójọpọ̀ iye owó rẹ̀ fún gbogbo ènìyàn ń pèsè dátà fún ìmúdójúìwọ̀n títọ́ka iye owó wa, tí àwòṣe ìṣọ̀kan olùpèsè rẹ̀ sì nípa lórí ìtọ́sọ́nà wa.
Orísun MIT tí a mú bá a mu sínú afárá ChatGPT Web → Codex Responses tí a kó sínú àpamọ́, pẹ̀lú àwọn ohun amúnisìn ìgbà-àbẹ̀wò aṣàwákiri, ìtọ́kasí ìdáhùn, lílo àti ìwádìí wẹ́ẹ̀bù.
Àwọn àwòṣe tí a gbé wọlé sínú ìmúpadàbọ̀ stream, àwọn alias no-thinking, ìwádìí wẹ́ẹ̀bù àfidípò, àwọn ààlà fèrèsé tí ń yí, ìpamọ́ àkọsílẹ̀ àti àwọn ìṣàn ifilọlẹ̀ tí a mú le.
Àwọn ìyàwòrán àwòṣe Grok rẹ̀, oníṣẹ́lẹ̀ Statsig fake-TypeError, àwọn àiyípadà àìyípadà ìbéèrè àti ẹ̀rọ, àti olùṣètò ìdáhùn NDJSON ni a mú bá a mu lọ́nà pàtàkì sínú executor Grok Web ti OmniRoute.
Orísun kóòdù transitive pàtàkì tó wà lẹ́yìn grok2api-merged; àwọn ìmúṣẹ́ àwòṣe, header, payload, Statsig àti processor rẹ̀ ni a ti pa mọ́ nínú ìran Grok Web.
Orísun MIT tó wà ní ìpìlẹ̀ fún payload àti àwọn àiyípadà ẹ̀rọ Grok, oníṣẹ́lẹ̀ Statsig, àti olùṣètò result.response tí ó kọjá lọ́nà TQZHR àti grok2api-merged.
Orísun transitive tí grok2api-merged yọ̀nda fún ẹ̀ka proxy-pool rẹ̀; OmniRoute pa àkíyèsí ìran yẹn mọ́ ṣùgbọ́n kò sọ pé ó ti gbé proxy-pool wọlé sínú executor Grok Web rẹ̀ tí a fi ààlà dè.
A kàn sí ìmúṣẹ́ Grok Web àkọ́kọ́ rẹ̀ fún àgbékalẹ̀ upstream HTTP/aṣàwákiri rẹ̀; ọ̀nà HTTP tààrà rẹ̀ wá láti GrokProxy, nítorí náà a kò sọ pé a ti gbé kóòdù rẹ̀ wọlé lọ́tọ̀.
Iṣẹ́ akanṣe tó gbajúmọ̀ náà “why use many token when few token do trick” — ìmọ̀ ọ̀rọ̀ caveman rẹ̀ ló ń mú kí a lo ìpo ìdínkù boṣewa wa àti àwọn òfin àfikún/ìkópọ̀ tó ju 30 lọ.
Ìdínkù àbájáde àṣẹ tó ní iṣẹ́-gíga — ó fún wa ní ìmísí fún ẹ́ńjìnì RTK wa, JSON filter DSL, ìmúpadàbọ̀ àbájáde àìlò àti pipeline RTK → Caveman tí a ṣàkópọ̀.
Iwadi ìdínkù prompt (LLMLingua / LLMLingua-2) — ó fún wa ní ìmísí fún ẹ́ńjìnì llmlingua wa tó ń ṣiṣẹ́ lọ́kànsí, tó dáàbò bo kóòdù, tí ó sì máa ń jẹ́ kí àṣìṣe kọjá láì dá iṣẹ́ dúró.
Ìdínkù token PT-BR — ó ń fún package èdè pt-BR wa ní agbára: ìdínkù ọ̀rọ̀ àtún sọ́ àti ìyọkúrò ọ̀rọ̀ àfikún tí a ṣe àtúnṣe fún gírámà Portuguese-Brazil.
Ìmọ̀ ọgbọ́n YAGNI-coder “lazy senior dev” tó gbajúmọ̀ — ó fún wa ní ìmísí fún Output Style less-code wa: ìtọ́sọ́nà ìyípadà kékeré tó ń ṣiṣẹ́, tí ó ń gé kóòdù _tí a ṣe jáde_ kù (arákùnrin output-axis sí ọ̀rọ̀ ṣókí Caveman).
Ìkópọ̀ àbájáde tó mọ̀ nípa àkóónú, tó yàtọ̀ sí irú fáìlì kọ̀ọ̀kan, pẹ̀lú dídáwọ́ tó mọ̀ nípa àṣìṣe — ó jẹ́rìí sí dispatch fún irú kọ̀ọ̀kan àti fífi ìgbà tó kéré jù sílẹ̀.
Rust columnar-JSON + retrieve tó dá lórí àkóónú + ìyọkúrò àtúnwá kọjá-message — ó jẹ́rìí sí àgbékalẹ̀ ẹ́ńjìnì headroom/ccr/session-dedup wa àti invariant cache-stable “fọ́ọ̀mù tí a kópọ̀ kò gbẹ́kẹ̀ lé ipò”.
Àkójọpọ̀ irinṣẹ́ TypeScript Compiler API — ó fún ìyọkúrò àlàyé tó dá lórí parser wa ní ìmísí, nígbà tí ó ń dáàbò bo àwọn string, template àti regex literals.
Ìdásílẹ̀/ìtúpalẹ̀ MITM ti ọkọ̀ọ̀nà coding-assistant ↔ LLM ló jẹ́ ìpìlẹ̀ fún àwọn ohun tí Traffic Inspector nílò ní ìbẹ̀rẹ̀. Àwọn module mẹ́rin tí a ti yọ jáde tẹ́lẹ̀ — ìṣọ̀kan SSE, ìmúṣọ̀kan ìjíròrò, ìbòmọ́lẹ̀ àṣírí àti ìmótótó akọsórí — ti jẹ́ rọ́pò pẹ̀lú àwọn ìmúlò clean-room olómìnira tí a gbé karí àwọn ìlànà protocol tí gbogbo ènìyàn lè rí. Àwọn ojú-ọ̀nà host-passthrough méjì (passthrough.ts àti _internal/bypass.cjs) ṣì jẹ́ àwọn ìmúlò inú OmniRoute tí a pín lọ́tọ̀; a kò tún kọ́ wọn gẹ́gẹ́ bí ara ìrọ́pò yẹn.
Ìtọ́sọ́nà proxy tí ó hàn gbangba fún ìlànà kọ̀ọ̀kan — ó ṣe ìmísí ìparí MITM wa tó dáàbò bo ìṣẹ̀lẹ̀ ìparun, àwọn àkókò ìdákẹ́jẹ̀ socket, ìdánimọ̀ ilana /proc àti ìmúkọ̀ TPROXY.
Àkójọ tí a ṣètò dáadáa ti àwọn ìkàwé tó ní ààbò gẹ́gẹ́ bí ìṣètò àkọ́kọ́, tó ń darí àwọn ìpinnu ààbò wa (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ó ṣe ìdámọ̀ oju quota Grok Build; OmniRoute sì ṣàyẹ̀wò ó, ó sì ṣe àtúnṣe wire format alààyè ní òmìnira.
## 📄 Ìwé-aṣẹ
Ìwé-aṣẹ MIT - wo [LICENSE](LICENSE) fún àwọn àlàyé.
---
**[⬆ Padà sí òkè](#-omniroute)** · A fi ❤️ kọ́ ọ́ fún àwùjọ AI orísun-ìmọ̀.
Ẹni tó dá a sílẹ̀ ni Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Ìwé-aṣẹ MIT · omniroute.online