# 🚀 OmniRoute — Lango Huria ya AI
**Imeundwa na [Diego Souza](https://github.com/diegosouzapw)**
## 💰 Takriban Tokeni Bilioni 1.62 kwa Mwezi Katika Ngazi za Bure za Watoa Huduma Wengine
> **Tumia akaunti zako mwenyewe za watoa huduma.** Hii ni jumla ya makadirio kutoka kwenye ngazi za bure za watoa huduma wengine zinazostahiki kila moja kivyake, si mgao wa tokeni kutoka OmniRoute. Jisajili, pata vitambulisho vinapohitajika, na unganisha watoa huduma unaoweza kutumia; kila mtoa huduma hudhibiti vikomo, upatikanaji na masharti yake.
>
> Kukusanya ngazi za bure kwa mkono ni kazi ngumu — SDK nyingi, vikomo vingi vya viwango, na hakuna njia ya kujua una kiasi gani hasa. OmniRoute huorodhesha **maingizo 465 ya ngazi za bure katika funguo 34 za marudio ya mabwawa** na hukokotoa kichwa cha tokeni kutoka kwenye **mabwawa 17 yenye bajeti chanya ya kila mwezi iliyochapishwa pamoja na vikomo vitano vya Groq kwa kila modeli**, vilivyoondoa marudio kulingana na bwawa linaloshirikiwa. Kiasi kinachofunguka tu baada ya ukaguzi wa utambulisho wa eneo (leo: ModelScope) huonyeshwa kando, +takriban 6M baada ya uthibitishaji wa utambulisho wa eneo, na hakijumuishwi kamwe kwenye kichwa cha jumla. Matokeo yanaendelea kuonekana kwenye dashibodi (`/dashboard/free-tiers`).
> Muhtasari wa uhuishaji wa ukurasa wa moja kwa moja wa `/dashboard/free-tiers`. Mbinu kamili (uondoaji wa marudio ya mabwawa, viwango vya salio, masharti ya watoa huduma): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Takwimu hizi hukaguliwa upya kila baada ya wiki mbili dhidi ya katalogi ya moja kwa moja na **hubadilika pande zote mbili** — mtoa huduma anasitisha ngazi ya bure na namba hushuka; mpya inaongezwa na inapanda. Tunachapisha kile katalogi inachokokotoa hasa, kamwe si hali bora iliyozungushwa kwenda juu.
⭐ Ipe repo nyota ikiwa OMNIROUTE imekusaidia kuokoa pesa na kurahisisha kazi yako.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Jiunge na jumuiya
**👋 Mfuate msimamizi — pata watoa huduma wapya, matoleo na vidokezo kwanza:**
[](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)
**Maswali, vidokezo kuhusu watoa huduma, ramani ya maendeleo na usaidizi → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Kimataifa](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)**
## 📈 Gateway Inaendelea Kukua
| | v3.8.50 | **v3.8.51** | `v3.8.54+` |
| ---------------------------------------------------- | :----------------------: | :---------: | :-------------------: |
| 🌐 Watoa huduma | 352 | **358** | 388 |
| 🧠 Vitambulisho vya kipekee vya miundo ya mazungumzo | 1320 | **1374** | 1491 |
| 🖼️ Daraja la modali | 🆕 kuona + sauti + video | ✓ | ✓ |
| 📡 Katalogi ya bure ya Radar | 🆕 kujiunga kwa hiari | ✓ | ✓ |
| ⚖️ Upangaji unaozingatia mgao | 🆕 Quota-Share | ✓ | ✓ |
| 📊 Telemetria ya mgao | 🆕 ya moja kwa moja | ✓ | ✓ |
| 🧰 Hali isiyo na kiolesura | — | — | 🆕 `serve --headless` |
| 🛤️ Miundombinu ya reli ya LTS | — | — | 🆕 njia za matoleo |
| 🔎 API ya ugunduzi wa miundo | — | — | 🆕 `/v1/models/query` |
**→ [Ratiba ya utekelezaji](ROADMAP.md) — tukisafiri kwenye reli kuelekea `v3.9.0 LTS`**
## 🧩 Inapatikana
[](https://www.npmjs.com/package/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
](LICENSE)
## 🆓 Sakinisha, unganisha mtoa huduma, kisha elekeza kupitia endpoint moja
```bash
# Baada ya kuunganisha mtoa huduma, nakili ufunguo wako wa OmniRoute kutoka Dashibodi → 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` inahitaji route inayostahiki. Usakinishaji mpya unaweza usiwe na walengwa wowote wa keyless wanaostahiki, na mtoa huduma wa keyless anaweza kukataa wateja wa wahusika wengine. Watoa huduma waliowekwa alama `tos: avoid`, wakiwemo Kiro, huondolewa kwenye uelekezaji wa kiotomatiki kwa chaguo-msingi; kuunganisha akaunti hakubadilishi mpangilio huo. Angalia [Mwongozo wa Viwango vya Bure](docs/getting-started/FREE-TIERS-GUIDE.md) kabla ya kuchagua mtoa huduma.📦 Nakili-bandike hati za kuanza haraka kwa **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Ahadi
# 🤔 Kwa nini OmniRoute?
## 🤝 Inaungwa mkono na Marafiki wetu wa Chanzo Huria
> **Je, unataka kujiunga kama Rafiki wa Chanzo Huria?** Hizi ni kampuni zinazou
## 🎯 Combo — Kipengele Kikuu
> **Combo** ni mnyororo wa modeli ambao OmniRoute huelekeza maombi kati yake **kiotomatiki**. Ikiwa kiwango kinachoruhusiwa kitaisha, mtoa huduma atashindwa, au gharama zitapanda ghafla, combo inaweza kuhamia kwenye modeli inayofuata inayostahiki na yenye afya nzuri. 🛡️
### ⚡ Bila usanidi — tumia tu `auto`
Hakuna combo ya kuunda. Weka modeli yako kuwa `auto` (au mojawapo ya vibadala vyake) na OmniRoute itaunda combo pepe kutoka kwa watoa huduma wako waliounganishwa, huku ikizipatia alama moja kwa moja:
Kitambulisho cha Modeli
Inachoboresha
auto
🎯 Chaguo-msingi lenye uwiano (LKGP — hubaki kwa mtoa huduma wako wa mwisho aliyefanya kazi vizuri)
auto/coding
🧑💻 Uzito unaotanguliza ubora kwa uzalishaji wa msimbo
auto/fast
⚡ Muda wa chini zaidi wa kusubiri kwanza
auto/cheap
💰 Gharama nafuu zaidi kwa tokeni kwanza
auto/subscription
🎟️ Kiwango kinachoruhusiwa cha usajili ambacho tayari unalipia pekee — hufungwa inaposhindwa, bila kamwe kutumia chaguo mbadala linalotozwa (mwongozo)
auto/thrifty
🪜 Kiwango kinachoruhusiwa cha mpango kwanza, kisha hatua moja baada ya nyingine hadi kwenye chaguo za kulipia zilizo nafuu zaidi — hurudi kwenye mpango baada ya kuwekwa upya (mwongozo)
auto/offline
🔋 Nafasi kubwa zaidi ya kiwango kinachoruhusiwa / kikomo cha matumizi kwanza
auto/smart
🔭 Ubora kwanza + uchunguzi wa 10% ili kugundua modeli bora zaidi
auto/lkgp
📌 Kushikamana dhahiri na mtoa huduma wa mwisho aliyejulikana kufanya kazi vizuri
auto/chaos
🧪 Husambaza maombi sambamba kwa jopo la modeli (moja kwa kila mtoa huduma, 5 kwa chaguo-msingi), na kurudisha jibu moja; mwito mmoja wa chanzo kwa kila modeli ya jopo, si uingizaji wa hitilafu
##
### 🔀 Au unda yako mwenyewe — mikakati 20 ya uelekezaji
Mikakati yote **20** — changanya na kulinganisha kwa kila hatua ya combo:
#
Mkakati
Inachofanya
1
priority
Orodha iliyopangwa inayotanguliza lengo la kwanza — tumia kila moja hadi likamilike kabla ya linalofuata 🥇
2
fill-first
Tumia kikamilifu kiwango kinachoruhusiwa cha kila lengo kabla ya kuendelea
3
weighted
Uteuzi nasibu wenye uzito kulingana na uzito wa kila lengo
4
round-robin
Zunguka kwenye malengo kwa mpangilio
5
p2c
Usawazishaji nasibu wa mzigo kwa kuchagua kati ya chaguo mbili
6
least-used
Chagua lengo lenye mzigo mdogo zaidi kwa sasa
7
random
Uteuzi nasibu wenye uwezekano sawa (nakala zinazojirudia huondolewa)
8
strict-random
Uteuzi nasibu bila kuondoa marudio 🎲
9
cost-optimized
Punguza $ kwa kila ombi kwa kutumia bei za moja kwa moja za katalogi 💸
10
headroom
Chagua lengo lenye kiwango kikubwa zaidi kilichosalia
11
quota-weighted
Ruka akaunti zilizoishiwa, kisha chagua kwa uwiano wa kiwango kilichosalia ÷ mzigo unaoendelea — mazungumzo yaliyopo hubaki yamefungwa kwenye lengo lake ⚖️
12
reset-window
Pendelea lengo ambalo kipindi chake cha kiwango kinachoruhusiwa kitawekwa upya mapema zaidi
13
reset-aware
Panga kwa muda wa kuweka upya kiwango kinachoruhusiwa — vipindi vifupi kwanza 📊
14
context-relay
Kabidhi muktadha kati ya malengo kwa mazungumzo marefu 🧠
15
context-optimized
Chagua linalofaa zaidi kwa ukubwa wa sasa wa muktadha
16
cache-optimized
Funga kila kiambishi awali cha kidokezo kinachoweza kutumika tena kwenye akaunti ileile — ongeza kiwango cha kupata matokeo kutoka akiba ya vidokezo 🎯
17
lkgp
Njia ya Mwisho Iliyojulikana Kufanya Kazi Vizuri — hufunga kwa mtoa huduma wa mwisho aliyefanikiwa, kisha hutumia sheria kama chaguo mbadala
18
auto
Upangaji wa moja kwa moja wa alama kwa vipengele 16 kwenye kila muunganisho 🤖
19
fusion
Sambaza kwa jopo la modeli + mwamuzi huunganisha jibu moja 🧬
20
pipeline
Unganisha hatua — matokeo ya kila lengo hutumika kama ingizo la linalofuata 🔗
Injini ya Auto-Combo hutathmini kila chaguo kwa kutumia **vipengele 16** (afya, kiwango kinachoruhusiwa, gharama, muda wa kusubiri, ufaafu wa jukumu, ubora, upatikanaji wa kipindi…) — tazama [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Ustahimilivu umejengewa ndani (tabaka 3 huru)
📖 [Injini ya Auto-Combo](docs/routing/AUTO-COMBO.md) · [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Kinachoitofautisha OmniRoute
📊 Mbinu kamili & maelezo ya kila kipengele dhidi ya 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Saidia OmniRoute
OmniRoute ina leseni ya MIT na inadumishwa kwa uwazi. Ikiwa inakuokoa muda au pesa, hivi ndivyo unavyoweza kuisaidia ibaki huru — chagua chochote kinachokufaa. Ufadhili hauathiri kamwe kipaumbele cha uelekezaji; unanunua mwonekano, si nafasi katika orodha.
**🇧🇷 PIX** — papo hapo, bila ada (Brazili)
Ufunguo (nasibu): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix ya kunakili na kubandika:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ Sarafu za kidijitali — BTC · ETH · USDT-TRC20 · USDC-Solana (bofya ili kupanua)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Tuma kila sarafu kwenye mtandao ulioonyeshwa pekee — kutuma kwenye mtandao usio sahihi kunaweza kusababisha fedha kupotea.
🐛 Umepata hitilafu au una maoni? Fungua [Mjadala](https://github.com/diegosouzapw/OmniRoute/discussions).
Maelezo kwa wasanidi: Mradi unaweza kutengeneza faili ya ndani ya .env wakati wa npm install/postinstall kwa urahisi wa msanidi. Faili hii inapuuzwa kimakusudi kupitia .gitignore (angalia .gitignore) na haipaswi kamwe kuwekwa kwenye hazina — ikiwa imewekwa kwa bahati mbaya, badilisha siri zozote zilizofichuliwa na uondoe faili hiyo kwenye historia. Angalia docs/DEVELOPER-ENVIRONMENT.md kwa mwongozo kuhusu kudhibiti faili za mazingira ya ndani na siri.
## 📡 Rada ya OmniRoute
Kichwa kikuu cha kiwango kisicholipishwa kinaendelea kuwa **~1.62B tokeni/mwezi** kutoka kwenye katalogi iliyoelezwa hapo juu, iliyopunguzwa marudio kulingana na hifadhi ya pamoja. Salio la muda la kujisajili kwa watoa huduma linaweza kuongeza kiasi cha mwezi wa kwanza kando hadi **~2.22B**. Radar ni safu ya hiari ya katalogi iliyotiwa saini kwa watu wanaotaka taarifa mpya zaidi kuhusu upatikanaji wa modeli zisizolipishwa kati ya matoleo ya OmniRoute; katalogi ya jumuiya na kila kipengele kilichopo kisicholipishwa vitaendelea kuwa bila malipo.
Waungaji mkono wanaweza kupokea katalogi ya moja kwa moja na fursa za ziada kutoka kwa watoa huduma. Kikomo chake tofauti, kinachoweza kubadilika, ni **takribani tokeni 3B/mwezi kwa kiwango cha juu**, kulingana na upatikanaji wa watoa huduma. Kikomo hicho si hakikisho: watoa huduma wanaweza kubadilisha viwango vya matumizi, masharti ya kustahiki, modeli, au maeneo wakati wowote.
Radar ni ya kujiunga kwa hiari na hutumia GET pekee. Kiteja cha OmniRoute hakipakii vidokezo, trafiki, usanidi wa watoa huduma, data ya telemetria ya matumizi, au hali ya ndani ya kufuta matangazo. Jifunze kuhusu ustahiki na katalogi ya sasa kwenye **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Nini Kipya
> Muhtasari wa hivi karibuni kutoka **v3.8.20 → v3.8.54**. Historia kamili katika [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Uelekezaji wa `quota-weighted`** — mkakati wa 20 wa mseto huruka akaunti zilizoishiwa, kisha huchagua kati ya zilizosalia kwa uwiano wa quota iliyobaki ÷ mzigo unaoendelea, huku mazungumzo yaliyopo yakiendelea kubaki kwenye akaunti zao. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Hali ya bila kiolesura** — `omniroute serve --headless` (au `OMNIROUTE_HEADLESS=1`) huendesha injini ya proksi ya `/v1/*` pekee, huku dashibodi na mifumo midogo inayohusu dashibodi pekee ikiwa imezimwa. → [Hali ya Bila Kiolesura](docs/guides/HEADLESS.md)
- **🔎 Ugunduzi wa modeli** — `/v1/models` huchuja kulingana na uwezo, muktadha, aina na maandishi, na `POST /v1/models/query` hurejesha orodha fupi thabiti ya chaguo kwa njia bainifu, ikiwa na mwonekano uleule kwa kila ufunguo. → [Marejeo ya API](docs/reference/API_REFERENCE.md)
- **🔑 Udhibiti wa uelekezaji kwa kila ufunguo** — bandika ufunguo wa API kwenye modeli au mseto mmoja ukitumia `forcedModel`, na uongeze au uondoe modeli na mseto wa ufunguo kwa operesheni ya atomiki (`/api/keys/{id}/access`). → [Marejeo ya API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Udhibiti bora zaidi wa PII** — uteuzi kwa kila aina, hadi mifumo 20 maalum ya ufichaji iliyothibitishwa na vihesabu vya ugunduzi kwa kila aina; ufichaji wenyewe bado unawashwa kwa hiari. → [Vizuizi vya Ulinzi](docs/security/GUARDRAILS.md)
- **🌍 Lugha 67** — dashibodi, nakala za hati na CLI, huku `npm run i18n:add-locale` ikiongeza lugha kila mahali kwa amri moja. → [Mwongozo wa i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ugawaji wa A2A unaoingia kwa kundi lako la mawakala, ujuzi wa Conductor kwenye Kadi ya Wakala, na paneli ya dashibodi yenye mawasiliano ya sauti ya Faro ya kubonyeza ili kuzungumza. → [Seva ya A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Udahili unaobadilika na ulinzi dhidi ya mzigo kupita kiasi** — maombi mazito ya mazungumzo huwekwa kwenye foleni badala ya kutoa 503, yakiwa na ukodishaji wa RPM unaozunguka na wa atomiki kwa kila muunganisho. → [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Mpangilio rasmi wa `/v1/models`** — kizuizi kimoja kinachofuatana na kupangwa kwa mtoa huduma kwa kila mtoa huduma (michanganyiko ikiwa imebandikwa kwanza), thabiti katika kila chanzo cha katalogi. → [Marejeo ya API](docs/reference/API_REFERENCE.md)
- **🗜️ Uimarishaji wa ukandamizaji** — kinga ya upanuzi iliyowashwa kwa chaguo-msingi, vifurushi vya Caveman kwa DE / FR / JA + Kichina (wényán), na vichujio vya RTK kwa Gradle na .NET. → [Ukandamizaji](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Gharama ya viwango tambarare iliyo halisi** — watoa huduma wa usajili / mipango ya usimbaji huonyeshwa kama **$0** katika uchanganuzi wa gharama; bajeti, quota na uelekezaji huendelea kukadiria. → [Marejeo ya API](docs/reference/API_REFERENCE.md)
- **⚖️ Uelekezaji wa Quota-Share** — gawanya quota ya akaunti iliyoshirikiwa kwa haki kati ya funguo zilizokusanywa, kwa kutumia rasilimali kikamilifu ili vipande vilivyo bila shughuli vikopeshwe. → [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Usanidi wa CLI/wakala kwa amri moja** — amri 15 za `setup-*` zilizosajiliwa; `omniroute run` huzindua CLIs 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` hutumia malengo 11 pamoja na kichagua mtoa huduma+modeli shirikishi na vipendwa kwa kila muktadha. → [Miunganisho ya CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Hali ya mbali** — dhibiti OmniRoute ya mbali kwa tokeni zenye mipaka (`connect` / `contexts` / `tokens`) + msaidizi wa OAuth wa `antigravity` kwa usakinishaji wa VPS. → [Hali ya Mbali](docs/guides/REMOTE-MODE.md)
- **🧭 Uelekezaji otomatiki wenye akili zaidi** — michanganyiko ya `auto/:`, **Fusion** (jopo la modeli + mwamuzi), uelekezaji unaozingatia kazi, na ubatilishaji wa modeli / hali / bajeti ya USD kwa kila ombi. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Ukandamizaji unaoweza kuchomekwa** — injini 12 zinazoweza kutungwa + Compression Studios: LLMLingua-2, Ultra ya viwango viwili, omniglyph, lango la uaminifu kwa kila hatua, GCF v3.2, na kihariri cha kupanga upya kwa kuburuta. → [Ukandamizaji](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Usimbuaji wa MITM ulio wazi (TPROXY)** — CLIs za kunasa zinazopuuza vigezo vya mazingira vya proksi, zikiwa na CA kwa kila SNI + kisakinishi cha hifadhi ya uaminifu. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Taarifa za gharama kila mahali** — vichwa vya gharama/matumizi vya `X-OmniRoute-*` kwenye kila endpoint, kichwa cha akiba kutokana na HIT za akiba, na quota za matumizi ya USD kwa kila ufunguo. → [Marejeo ya API](docs/reference/API_REFERENCE.md)
- **🧠 Kumbukumbu unayodhibiti** — imezimwa kwa chaguo-msingi, quantization ya vekta ya int8 inayowashwa kwa hiari + kupungua kwa aina, na `x-omniroute-no-memory` kwa kila ombi. → [Kumbukumbu](docs/frameworks/MEMORY.md)
- **🛡️ Usalama** — kinga dhidi ya sindikizo la maelekezo kwenye kila njia ya LLM (seti ya majaribio ya red-team), kinga ya kuficha vitambulisho inayowashwa kwa hiari (huficha funguo/siri za API zilizovuja katika pande zote mbili), utafutaji wa wavuti wa DuckDuckGo wa mwisho usiolipishwa, na lango la hiari la kuingia la OIDC kwa dashibodi (kuingia kwa nenosiri hubaki kupatikana kila wakati). → [Vizuizi vya Ulinzi](docs/security/GUARDRAILS.md)
- **🖼️ Endpoint mpya** — `/v1/ocr` (Mistral OCR) na `/v1/audio/translations` (ya mtindo wa Whisper) hukamilisha safu ya midia. → [Marejeo ya API](docs/reference/API_REFERENCE.md)
- **🎨 Uzalishaji wa picha / video / sauti** — API moja ya midia: xAI Grok Imagine na video ya Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, na watoa huduma wa sauti kama vile ElevenLabs. → [Marejeo ya API](docs/reference/API_REFERENCE.md)
- **🌍 Usambazaji na uendeshaji** — `basePath` ya proksi kinyume, utambuzi otomatiki wa lugha ya kivinjari, ufuatiliaji wa kifaa kwa kila ufunguo, uaminifu wa MITM bila haki za mzizi, na ujanibishaji wa zh-TW. → [Mazingira](docs/reference/ENVIRONMENT.md)
- **🤝 Watoa huduma na mawakala zaidi** — mawakala wa wingu (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) yenye kivinjari + kuingia kwa OAuth, kadi ya kiwango cha kwanza ya Ollama, Claude Opus 5 na Sonnet 5, ushirikiano rasmi wa Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… na **katalogi ya watoa huduma 388** iliyoboreshwa. → [Watoa Huduma](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Uwazi wa uelekezaji** — kila jibu hubeba kichwa cha `X-OmniRoute-Decision` kinachotaja mkakati/mtoa huduma/ucheleweshaji uliolihudumia, mkakati mpya wa mseto wa `cache-optimized` + kipengele cha `cacheAffinity` cha Auto-Combo huelekeza maombi yanayorudiwa kwenye muunganisho unaoshikilia kiambishi awali kilichowekwa kwenye akiba, na endpoint ya kusoma pekee ya `/v1/auto-combo/{channel}/candidates` hufichua kundi hai la wagombea la kituo cha `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md).
- **⚡ Utendaji wa ndani & miundombinu** — Redis ya ndani kwa kubofya mara moja, zana za kupeleka relay za Cloudflare Workers / Deno Deploy, Bifrost & Mux kama huduma zilizopachikwa zinazosimamiwa. → [Huduma Zilizopachikwa](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Pia ndani ya kifurushi** — mfumo wa plugin + soko, mifumo ya ujuzi ya Omni/Agent/GitHub, ujumuishaji wa hazina ya Obsidian (zana 22 za MCP), API za Batch & Files zinazooana na OpenAI, akiba ya majibu ya kisemantiki, uchezeshaji wenye bao za nafasi, ugunduzi wa mawakala wa ACP (mawakala 15 waliojengewa ndani), uhamishaji uliopangwa wa kumbukumbu kwenda BigQuery, usambazaji sambamba wa miundo mingi kupitia `auto/chaos`, daraja la roboti ya Telegram, kidhibiti cha matoleo ndani ya programu na viwango vya watoa huduma bila malipo vya LMArena-ELO. → [Nyaraka](docs/README.md)
## 🤖 CLI Zinazolingana & Mawakala wa Uandishi wa Nambari
> Mpangilio mmoja — `http://localhost:20128/v1` — na **kila** IDE ya AI au CLI inaendeshwa kwenye miundo ya bure & ya gharama nafuu.
＋ pia inafanya kazi na · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · chombo chochote kinacholingana na OpenAI
📖 Usanidi wa kila zana kati ya zana zote 39 (CLI Code 28 + CLI Agents 11) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Kiongezi cha OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Zindua CLI yoyote inayoungwa mkono kupitia OmniRoute kwa amri moja** — hakuna faili za usanidi zinazoandikwa,
vitambulisho vinaingizwa kwa kila mchakato, Qwen/Gemini hupata mazingira ya nyumbani yaliyotengwa kwa muda mfupi:
```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"
# Au chagua mtoa huduma+mfano kwa njia ya mwingiliano na andika usanidi wa zana husika:
omniroute configure codex # pia: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Kila amri inaheshimu muktadha wa mbali uliopo (`omniroute connect `), `--dry-run`
inaonyesha hakikisho la mazingira/hoja halisi bila kutekeleza, na `--api-key-env NAME` huweka siri nje
ya historia ya shell yako. → [Muunganiko wa CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 Watoa huduma wa AI 388 — 153 Waliowekwa Alama kuwa Bure kwenye Katalogi
> **Watoa huduma 388 waliosajiliwa** katika mikusanyo ya kikanoni ya gumzo, midia, utafutaji, ya ndani, mawakala wa wingu na mfumo, wakiwemo **153 wenye metadata ya ugunduzi ya `hasFree: true`**. Sajili ya miundo ya gumzo inashughulikia **watoa huduma 239 / jozi 3,059 tofauti za mtoa huduma-modeli / vitambulisho 1,475 ghafi vya miundo**; katalogi tofauti ya bajeti bila malipo ina **mistari 471 kwa kila modeli**, **madimbwi 34 yanayojirudia** na **watoa huduma 52 wa bila malipo milele wanaojirudia/wasiohitaji ufunguo**. Hivi ni vigezo tofauti kwa makusudi; fasili na hesabu zilizopunguzwa marudio ya madimbwi ziko katika [Marejeleo ya Watoa Huduma](docs/reference/PROVIDER_REFERENCE.md) na [Viwango vya Bure](docs/reference/FREE_TIERS.md).
### 🏢 Maabara zote kuu — kupitia endpoint moja
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…na wengine zaidi ya 350 — kila ikoni hupatikana moja kwa moja kutoka kwenye katalogi ya watoa huduma ya dashibodi. 📖 [Marejeleo ya Watoa Huduma](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Bure Milele — $0, hakuna kadi inayohitajika
OpenCode Zen DeepSeek V4, Nemotron 3 Hakuna kikomo cha tokeni
Kilo Code Kielekeza kiotomatiki, Tencent Hy3 Bure milele
Requesty GPT-OSS 120B, Nemotron Bure milele
SiliconFlow DeepSeek V3.2 / R1 Kiwango cha bure
Z.AI GLM GLM-4.7 / 4.5-Flash Bure milele
Baidu ERNIE ERNIE 4.0 Bure milele
Qoder AI Qwen3-Max, Kimi-K2 BURE bila kikomo
Pollinations GPT, Llama, Claude Hakuna ufunguo unaohitajika
Cloudflare AI Miundo 50+ Neuroni 10K kwa siku
NVIDIA NIM GLM, MiniMax Takriban RPM 40 bila malipo
Cerebras GLM 4.7, GPT-OSS Salio la $5 la matumizi ya mara moja; kadi inahitajika
OpenRouter miundo ya :free +$10 → RPM ya juu zaidi
📖 Katalogi kamili inayoweza kusomeka na mashine → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Ambapo OmniRoute Inaendeshwa - Popote
> Programu sawa, mashine yako, sheria zako. Kutoka kwa usakinishaji wa npm wa kimataifa hadi** simu yako** kupitia Termux.
Sakinisha
Vivutio
📦 npm (kimataifa)
npm install -g omniroute
Amri moja, OS yoyote
⚡ Bun (kimataifa)
bun ongeza -g omniroute
Usajili ule ule, usakinishaji haraka
🐳 Docker
docker kukimbia … diegosouzapw/omniroute
Multi-arch AMD64 + ARM64
🖥️ Eneo-kazi (Electron)
npm endesha elektroni:jenga
Dirisha la asili trei ya mfumo + — Windows / macOS / Linux
🎩 menyu (OmniRouteTray)
brew sakinisha --cask zoispag/tap/omniroute-tray
Inasimamia & kusasisha seva kiotomatiki — macOS
💪 ARM
asili arm64
Raspberry Pi, ARM za zqm, Apple Silicon
📱 Android (Termux)
pkg sakinisha nodejs && npx -y omniroute
Inaendesha kwenye simu yako , 24/7, hakuna mizizi
📲 PWA
"Ongeza kwenye Skrini ya Nyumbani"
Skrini nzima, nje ya mtandao, inaweza kusakinishwa kutoka kwa kivinjari
🧩 OpenCode programu-jalizi
@omniroute/opencode-provider
Ujumuishaji wa asili OpenCode
🤖 VS Msimbo Copilot
sakinisha OmniCopilot kiendelezi
Kila modeli OmniRoute katika kichagua gumzo Copilot asili - & Insiders
🛠️ Kutoka chanzo
npm kufunga && npm run dev
Hack juu yake, kuchangia
📖 [Docker Mwongozo](docs/guides/DOCKER_GUIDE.md) · [Eneo-kazi](electron/README.md) · [Trei ya menyu ya upau](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)
### 🧩 Mpya: OmniRoute ndani ya VS Code ya Copilot Gumzo
> Hakuna utepe mpya, hakuna gumzo UI mpya - kila muundo OmniRoute unaotumika huonekana moja kwa moja**Copilot Kiteuzi cha kielelezo cha Gumzo ambacho tayari unatumia** . Tangu Msimbo wa VS 1.122, miundo ya watoa huduma hufanya kazi bila kuingia kwa GitHub au usajili wa Copilot - hali ya wakala, kupiga simu kwa zana na kuona, bila malipo.
Sakinisha** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** kiendelezi, kielekeze kwenye seva yako OmniRoute (chaguo-msingi hadi `localhost:20128`), kisha ufungue Copilot Chat → kichagua mfano →** Dhibiti Miundo...** →**OmniRoute** .
Kutoka ndani ya mhariri: fungua faili ya** Viendelezi** tazama, tafuta** "OmniRoute"** , bofya** Sakinisha** - inafanya kazi kwa njia sawa kwenye duka zote mbili. Chanzo, matoleo na kijitabu cha uchapishaji cha moja kwa moja [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Msimbo wa Copilot Mwongozo wa gumzo](docs/guides/VSCODE-COPILOT.md) — sanidi, kile kichagua kinaonyesha, dashibodi-katika-kichupo, utatuzi wa
### 🎩 Mpya: OmniRouteTray - lango lako, unaishi katika upau wa menyu
> `omniroute serve` huwa na furaha zaidi inapowashwa kila wakati.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** hugeuza hiyo kuwa programu ya upau wa menyu ya kuweka-na-kusahau kwa macOS: huanzisha seva, huiweka hai katika kuwashwa upya, kuisasisha mahali pake, na kuweka bajeti yako ya tokeni ya moja kwa moja kwa mbofyo mmoja tu -** hakuna dirisha la mwisho lililoachwa wazi, hakuna `npm install -g omniroute` ya kumtunza mtoto.**
Imeundwa kwa [Tauri v2](https://v2.tauri.app/) (Kiini cha kutu chenye ukubwa wa hitilafu ya kuzungusha), husafirisha muda wake wa utekelezaji wa Node 24 na kudhibiti usakinishaji OmniRoute unaomilikiwa na programu, kwa hivyo haitapigana kamwe na `node`/`bun` yako ya kimataifa. Ni** inashiriki usanidi wako wa `~/.omniroute/` na hifadhidata** - kwa hivyo ni OmniRoute sawa tayari kukimbia, tu na kofia. 🎩
Inafanya nini
Jinsi
🟢 Inasimamia seva
Spawns omniroute serve , inachukua mfano unaoendeshwa tayari badala ya kuiga nakala
📊 Matumizi ya moja kwa moja kwa muhtasari
pau za upendeleo wa watoa huduma, Claude session/weekly mipaka na vihesabu vilivyowekwa upya, uchanganuzi wa gharama ya siku 30
🔄 Usasishaji otomatiki umewekwa
Usakinishaji kwa hatua, ubadilishanaji wa atomiki, urejeshaji wa kushindwa - kila mara kwenye toleo jipya zaidi
🚀 Anza kwa kuingia
Uzinduzi wa hiari wakati wa kuingia; trei pekee, hakuna ikoni ya kizimbani
🩺 Daktari & kumbukumbu
uchunguzi wa bofya moja na ufikiaji wa kumbukumbu ya seva
```sh
brew install --cask zoispag/tap/omniroute-tray
```
unapendelea upakuaji? Pata toleo jipya zaidi .dmg kutoka
Imetolewa . Chanzo, masuala na kujenga
hati zinaishi zoispag/omniroute-tray.
💛 Mradi wa jumuiya wa @zoispag - sio toleo rasmi OmniRoute.
## 🔒 Faragha na Inayotanguliza Uendeshaji wa Ndani
📖 [Uidhinishaji](docs/architecture/AUTHZ_GUIDE.md) · [Vizuizi vya Usalama](docs/security/GUARDRAILS.md) · [Uzingatiaji](docs/security/COMPLIANCE.md)
## 🔌 CLI Kamili + A2A & MCP
> Zaidi ya seva, OmniRoute ni **kituo kamili cha udhibiti cha mstari wa amri** chenye **amri 80+**, pamoja na itifaki huria za mawakala ili wakala wa AI aweze kukiendesha **mwenyewe**.
### ⌨️ CLI halisi (si `start` pekee)
```bash
omniroute # anzisha gateway + dashibodi (port 20128)
omniroute chat # kiteja shirikishi cha gumzo cha TUI (slash: /model /combo /skill /memory)
omniroute setup # mwongozo wa hatua kwa hatua wa uendeshaji wa kwanza
omniroute doctor # tambua matatizo ya providers, ports, native deps
```
### 🛰️ Hali ya mbali — endesha CLI hapa, OmniRoute kwenye VPS
OmniRoute iko kwenye seva? Iendeshe kutoka kwenye laptop yako kwa kutumia **CLI ileile**. Ingia mara moja
kwa tokeni ya ufikiaji yenye wigo; baada ya hapo kila amri itaelekezwa kwenye seva ya mbali.
```bash
omniroute connect 192.168.0.15 # nenosiri → tokeni yenye wigo, imehifadhiwa kama muktadha
omniroute models # ← inaendeshwa dhidi ya seva ya MBALI
omniroute configure codex # ← huchagua modeli ya mbali, huandika wasifu wa ndani wa Codex
omniroute tokens create --name ci --scope read # tengeneza tokeni zenye wigo finyu zaidi kwa mashine nyingine
omniroute contexts use default # ← rudi kwenye seva ya ndani
```
Tokeni zina wigo wa `read` / `write` / `admin`; njia zinazoanzisha michakato hubaki kwa loopback pekee.
📖 [Hali ya Mbali](docs/guides/REMOTE-MODE.md)
### 🤝 Unganisha wakala — naye adhibiti OmniRoute yenyewe
Fichua OmniRoute kupitia **MCP**, **A2A**, **REST API**, **webhooks** au **CLI ya mbali** — wakala yeyote mwenye uwezo (au msimbo wako mwenyewe) atapata uwezo wa kudhibiti gateway nzima: uelekezaji, providers, combos, cache, compression, memory — kwa uhuru. Endpoint za HTTP zilizo hapa chini zinapatikana chini ya `http://localhost:20128`.
Kiolesura
Endpoint / amri
Kitumie kwa
🧰 MCP (stdio)
omniroute --mcp
Unganisha na Claude Desktop, Cursor au kiteja chochote cha MCP
🌊 MCP (HTTP)
/api/mcp/stream
MCP ya mbali — zana 110, wigo 33 (utekelezaji wa hiari), kumbukumbu kamili ya ukaguzi
📡 MCP (SSE)
/api/mcp/sse
Usafirishaji wa MCP wa kutiririsha
🤝 A2A
/.well-known/agent.json
Wakala-kwa-wakala, JSON-RPC 2.0 + SSE, ujuzi 6
🌐 REST API
/v1/*
Inayooana na OpenAI — gumzo, embeddings, picha, sauti, OCR
🔔 Webhooks
/api/webhooks
Tuma matukio ya maombi / quota kwenda Slack, Discord, Telegram au URL yoyote
🛰️ CLI ya mbali
omniroute connect
Dhibiti instance ya mbali kwa tokeni za ufikiaji zenye wigo
```bash
# Ipe Claude Code seti kamili ya zana za OmniRoute kupitia MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [Seva ya MCP](docs/frameworks/MCP-SERVER.md) · [Seva ya A2A](docs/frameworks/A2A-SERVER.md) · [Itifaki za Mawakala](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Hifadhi 15–95% ya Tokeni — Kiotomatiki
### 📖 Jinsi inavyofanya kazi — mkondo wa uchakataji, usanifu na hesabu za uokoaji
Mchanganyiko wa chaguomsingi uliowekwa kwa safu huendesha `RTK → Caveman`. Zote zinapotenda kwenye mzigo uleule wa zana/muktadha, uokoaji hujumuishwa:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Vizuizi vya msimbo, URL, JSON na data iliyopangwa **hulindwa kila wakati** na injini ya uhifadhi.
> **Kwa nini utumie tokeni nyingi wakati tokeni chache zinatosha?** Kila ombi hupitia kwenye mkondo wa kubana wa OmniRoute **kwa uwazi** — bila mabadiliko kwa mteja. Sasa ni **mkusanyiko wa injini 12 zinazoweza kuunganishwa** zinazoendeshwa kwa mpangilio na kuchanganywa kulingana na mchanganyiko wa uelekezaji — ukijengwa juu ya mawazo kutoka kwa [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), na [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Mkusanyiko wa injini 12
Injini huendeshwa kwa mpangilio wa mkondo wa uchakataji; kila moja inaweza kuwashwa/kuzimwa na kusanidiwa kivyake kwa kila mchanganyiko:
#
Injini
Inachofanya
1
Session-Dedup
Huondoa maudhui yaliyorudiwa katika mizunguko tofauti (yanayotambuliwa kwa maudhui, kati ya mizunguko)
2
CCR
Huhifadhi vizuizi vikubwa nyuma ya alama za urejeshaji, vinavyopatikana vinapohitajika
3
Lite
Hubana nafasi zisizo za lazima + hupunguza URL za picha (msingi wenye ucheleweshaji mdogo)
4
RTK
Uchujaji mahiri wa matokeo ya zana, uondoaji wa marudio na ufupishaji (unaotambua amri)
5
Responses Tool Output
JSON unaoanza bila upotezaji wa taarifa + mbano wa uchunguzi wenye mipaka kwa matokeo ya shell/patch/search/build (Responses API)
6
Headroom
Mbano wa safu za JSON wa jedwali bila upotezaji wa taarifa (~30%) kupitia kodeki ya GCF iliyojumuishwa
7
Relevance
Hukadiria sentensi zinazohusiana zaidi dhidi ya swali la mwisho la mtumiaji
8
Caveman
Mbano wa nathari unaotegemea kanuni (~65–75% kwenye matokeo)
9
Aggressive
Muhtasari + kuzeeka kwa awamu kwa mizunguko ya zamani
10
LLMLingua-2
Upunguzaji wa kisemantiki wa ML kupitia MobileBERT ONNX — salama kwa msimbo, usiozuia utekelezaji
11
Ultra
Upunguzaji wa tokeni kwa heuristiki wenye kiwango cha hiari cha modeli ndogo (SLM)
12
OmniGlyph
Usimbaji wa majaribio wa muktadha kama picha kwa Claude Fable 5 iliyopimwa kwenye waya wa moja kwa moja wa Anthropic; vigeuzi vya GPT 5.6 hubaki vimefungwa kwa usalama zikisubiri risiti za mtoa huduma. Wasifu minne ya mbano (chaguo-msingi ya ukali, iliyosawazishwa, salama kwa usimbaji, pitisha bila kubadilisha) (mkali zaidi; huwashwa kwa hiari)
Vizuizi vya msimbo, URL na data iliyopangwa **huhifadhiwa kila wakati** bila kubadilisha hata baiti moja. **Mipangilio ya mbofyo mmoja** huunganisha injini:
Hali
Uokoaji
Inafaa zaidi kwa
🪶 Lite
~15%
Chaguo-msingi salama la kuwashwa kila wakati
🪨 Standard (Caveman)
~30%
Uandishi wa msimbo wa kila siku
⚡ Aggressive
~50%
Vipindi virefu vyenye zana nyingi
🔥 Ultra
~75%
Uokoaji wa kiwango cha juu
🧰 RTK
60–90%
Matokeo ya Shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Maagizo mchanganyiko + kumbukumbu za zana
**Mfano halisi — hali ya Standard:**
> **Kabla (tokeni 69):** _"Sababu ya kipengele chako cha React kutoa render tena huenda ni kwa sababu unatengeneza rejeleo jipya la kitu katika kila mzunguko wa render. Unapopitisha kitu kilichowekwa moja kwa moja kama prop, ulinganishaji wa juu juu wa React hukiona kama kitu tofauti kila wakati, jambo linalosababisha render nyingine. Ningependekeza utumie useMemo kuweka kitu hicho kwenye kumbukumbu."_
>
> **Baada (tokeni 19):** _"Rejeleo jipya la kitu katika kila render. Prop ya kitu cha moja kwa moja = rejeleo jipya = render tena. Funga kwa useMemo."_
>
> **Jibu lilelile. Tokeni chache kwa 72%. Hakuna upotezaji wa usahihi.** ✅
**Mfano wa PT-BR — hali ya [Troglodita](https://github.com/leninejunior/troglodita):**
> **Kabla (tokeni 42):** _"Tatizo ni kwamba kijenzi kinafanya uwasilishaji upya kwa sababu rejeleo jipya la kitu linaundwa katika kila mzunguko wa uwasilishaji. Ningependekeza kutumia useMemo."_
>
> **Baada (tokeni 12):** _"Uwasilishaji upya: rejeleo jipya kila mzunguko (kitu cha ndani kinaundwa upya). Tumia `useMemo`."_
>
> **Jibu lilelile. Takriban tokeni 70% chache. Usahihi wa kiufundi umebaki uleule.** ✅
### 🎚️ Zaidi ya injini — mitindo ya matokeo, kidhibiti kinachobadilika & udhibiti kwa kila ombi
Injini 12 zilizo hapo juu hupunguza kinachoenda **ndani**. Tabaka tatu zaidi huunda **jinsi**, **lini**, na kinachotoka **nje**:
- **🪄 Mitindo ya Matokeo** _(uongozi wa mhimili wa matokeo)_ — huingiza maagizo thabiti, salama kwa akiba, ya kuunda majibu; yanaweza kuunganishwa, kila moja ikiwa na kiwango cha `lite` / `full` / `ultra`. Kuongeza mtindo ni ingizo la mstari mmoja kwenye sajili:
- **Nathari fupi** — ondoa vijazaji / vifungu / maneno ya kusitasita; dumisha maudhui ya kiufundi kwa usahihi.
- **Msimbo mchache** — YAGNI ya "msanidi mkuu mvivu": badiliko dogo zaidi linalofanya kazi, bila miundombinu ambayo haijaombwa.
- **Mkia wa farasi (msanidi mkuu mvivu)** — panda ngazi ya YAGNI, rekebisha chanzo halisi cha tatizo, na tumia tofauti ndogo zaidi inayofanya kazi.
- **Nina ADHD (kitendo kwanza)** — kitendo kinachofuata kiwe mwanzoni, hatua ziwe na nambari, hatua moja mahususi inayofuata, bila utangulizi.
- **CJK fupi (文言)** — mtindo mfupi kupita kiasi wa Kichina cha kale (umewekewa eneo la `zh` pekee).
- **🎯 Bajeti ya muktadha inayobadilika** _(kidhibiti)_ — badala ya kizingiti kimoja cha tokeni cha kuwasha/kuzima, ongeza injini za bei nafuu na zenye upotevu mdogo hatua kwa hatua, kadiri inavyohitajika ili **kutoshea dirisha la muktadha la modeli**. Sera: `reserve-output` (chaguo-msingi, inayotambua modeli) · `percentage` · `absolute`. Hali: `floor` (inahakikisha kutoshea) · `replace-autotrigger` (chaguo lako bayana hutangulia) · `off` (kizingiti cha zamani).
- **🎛️ Mahali ambapo mbano huamuliwa** _(utangulizi, juu → chini)_ — kichwa cha ombi cha `x-omniroute-compression` › ubatilishaji wa mseto wa uelekezaji › wasifu amilifu wenye jina › kichochezi kinachobadilika / kiotomatiki › chaguo-msingi la paneli › off. Mpango uliotumika hurudishwa katika kichwa cha jibu `X-OmniRoute-Compression: ; source=`.
Washa kichochezi kiotomatiki kwa kizingiti cha tokeni, geuza kidhibiti kinachobadilika, weka wasifu wenye jina, weka mpangilio wa mara moja kwa kila ombi, au teua mfuatano kwa kila mseto wa uelekezaji — chochote kinachofaa mzigo wa kazi. **Mfumo wa tathmini** wa hiari na wa nje ya mtandao (`npm run eval:compression`) hupima uaminifu dhidi ya akiba kwenye mkusanyiko uliowekwa kabla ya kuidhinisha badiliko.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Mwanzo wa Haraka
**1) Sakinisha na uendeshe**
```bash
npm install -g omniroute
omniroute
```
> 💡 Unaona `npm warn ERESOLVE` au maonyo ya utegemezi rika? [Hayana madhara](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Unatumia npm 11 au toleo la baadaye?** npm inaweza kuzuia hati za mzunguko wa maisha wa vifurushi isipokuwa ziruhusiwe. `postinstall` ya OmniRoute (`node scripts/build/postinstall.mjs`) inahitajika kuandaa faili zake za asili za wakati wa utekelezaji. Ruhusu vifurushi vilivyopewa majina kwenye onyo la npm unaposakinisha kimataifa. Kwa seti ya vifurushi iliyoripotiwa na OmniRoute 3.8.54:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Ili kutumia tena orodha hii ya ruhusa kwa usakinishaji wa baadaye wa kimataifa, isanidi mara moja, kisha usakinishe kwa kawaida:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Orodha ya utegemezi inaweza kubadilika kati ya matoleo; ikiwa npm itaripoti orodha tofauti, tumia majina ya vifurushi kutoka kwenye onyo hilo. Kuruhusu kifurushi huwezesha hati zake za usakinishaji kuendeshwa.
> **Unatumia Gemini Web au mtoa huduma mwingine wa vidakuzi vya wavuti?** Kifurushi cha npm kinajumuisha
> Playwright lakini si faili yake ya binary ya Chromium. Tazama
> [usanidi wa Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> kabla ya kutuma ombi la kwanza kwa mtoa huduma wa wavuti.
Dashibodi iko kwenye `http://localhost:20128` · API iko kwenye `http://localhost:20128/v1`.
**2) Unganisha mtoa huduma anayestahili ukitumia akaunti yako mwenyewe**
Dashibodi → **Watoa huduma** → chagua mtoa huduma ambaye masharti na kiwango chake cha sasa vinafaa matumizi yako → ongeza ufunguo wake wa API au kamilisha mchakato wa akaunti. Viwango visivyolipishwa vinaweza kuhitaji kujisajili, kuidhinishwa, au njia ya malipo. Kagua [Mwongozo wa Viwango Visivyolipishwa](docs/getting-started/FREE-TIERS-GUIDE.md); upatikanaji bila ufunguo haujahakikishwa, na watoa huduma waliowekwa alama ya `tos: avoid` huondolewa kwenye `auto` kwa chaguo-msingi.
**3) Elekeza zana yako ya uandishi wa msimbo**
```txt
URL ya Msingi: http://localhost:20128/v1
Ufunguo wa API: [nakili kutoka Dashibodi → Vituo vya Mwisho]
Modeli: auto (huelekeza kati ya miunganisho inayostahili — au chagua mtoa huduma/modeli)
```
**4) Thibitisha kuwa inafanya kazi**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Unapaswa kuona modeli zako zilizounganishwa zikiorodheshwa. 🎉 Ndivyo tu — anza kuandika msimbo, na OmniRoute itakuelekezea na kubadilisha kiotomatiki kwa niaba yako.
Ikiwa mteja wako hawezi kutuma vichwa maalum, OmniRoute pia hutoa lakabu za uoanifu zenye tokeni:
```txt
Katalogi ya OpenAI: http://localhost:20128/vscode/YOUR_KEY/
Modeli za OpenAI: http://localhost:20128/vscode/YOUR_KEY/models
Soga ya OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions
Majibu ya OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses
Soga ya Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
Lebo za Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Tumia hizi tu kwa wateja ambao hawawezi kuambatisha `Authorization: Bearer ...`. Uthibitishaji wa kichwa bado ndiyo hali inayopendekezwa.
## 📦 Mbinu zaidi za usakinishaji — Docker, msimbo chanzo, 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` hufuata toleo thabiti la juu zaidi la SemVer **lililochapishwa**. Haifuatilii `main` ya git. Bandika `:X.Y.Z` kwa GitOps. Tazama [Vituo vya Matoleo ya Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Image hubandika **`OMNIROUTE_MEMORY_MB=1024`**. Hiyo inatosha kwa dashibodi na gumzo jepesi. **Mawakala wa uandishi wa msimbo** (`POST /v1/responses` kutoka Claude Code, Codex, Grok, …) wanahitaji heap kubwa zaidi ya V8, la sivyo mchakato hupata `FATAL ERROR` unapofikia takriban GiB 12 chini ya miktadha miwili mirefu inayopishana. Weka ukubwa wa kontena juu ya heap (bafa asilia huwa nje ya V8):
| Mzigo wa kazi | Heap (`-e OMNIROUTE_MEMORY_MB`) | Kontena (`--memory`) |
| -------------------------------------------- | ------------------------------- | -------------------- |
| Dashibodi / gumzo jepesi | `1024` (chaguo-msingi la image) | ≥2 g |
| Wakala mmoja wa uandishi wa msimbo | `8192` | ≥10 g |
| `/v1/responses` mbili ndefu kwa wakati mmoja | `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
```
Jedwali kamili: [Mwongozo wa Docker — RAM ya wakati wa utekelezaji](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Kituo cha Docker cha matoleo ya awali:** `diegosouzapw/omniroute:next` na
> `diegosouzapw/omniroute:next-web` hufuata tawi la sasa la chaguo-msingi `release/v*`.
> Lebo hizi zinazoweza kubadilika zimekusudiwa tu kwa kujaribu marekebisho ambayo bado hayajatolewa na
> **hazitumiki katika mazingira ya uzalishaji**. Tazama
> [Vituo vya Matoleo ya Docker](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
`bun install` ya kawaida na usakinishaji wa kimataifa (`bun install -g omniroute`) vinaweza kutumika kupitia utambuzi wa mazingira ya utekelezaji ya Bun:
- **`bun:sqlite` iliyojengewa ndani**: OmniRoute hutumia kiendeshaji cha Bun cha `bun:sqlite` kilichojengewa ndani inapoendeshwa chini ya Bun, na kurejea kwenye `better-sqlite3` katika Node.js au `sql.js`.
- **Uteuzi otomatiki wa kifungashaji cha Webpack wakati wa usanidi**: Mazingira ya usanidi (`bun run dev`) hutambua Bun kiotomatiki na kuzima Turbopack ili kutumia Webpack, kwa lengo la kuzuia kutooana kwa vifungo asilia vya V8. Miundo ya uzalishaji (`bun run build`) hufuata `OMNIROUTE_USE_TURBOPACK` sawasawa na ilivyo kwenye Node: Turbopack kwa chaguo-msingi, `OMNIROUTE_USE_TURBOPACK=0` ili kujenga kwa Webpack (`Dockerfile.bun` huiwasilisha kama `--build-arg`).
- **Dockerfile maalumu ya Bun**: `Dockerfile.bun` ya hatua nyingi kwa ajili ya upelekaji asilia wa uzalishaji wa Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Sakinisha na uendeshe kwa Bun
bun install
bun run dev
```
**🛠️ Kutoka kwenye msimbo chanzo**
```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
# Kwa kutumia Nix flakes
nix develop
npm run dev
# Au kwa kutumia devbox
devbox run npm run dev
```
📖 [Mwongozo wa Docker](docs/guides/DOCKER_GUIDE.md) — Wasifu wa Compose, Caddy HTTPS, vichuguu vya Cloudflare.
**🦭 Podman**
```bash
# 1. Andaa saraka ya data iliyounganishwa kwa bind mount
mkdir -p data
# 2. Kwa Linux + Podman ya ndani isiyo na root pekee (kamwe si kiteja cha mbali cha Podman Machine):
podman unshare chown 1000:1000 ./data
# 3. Weka kidokezo cha mazingira ya utekelezaji, jenga image ya ndani ya Compose, kisha uanzishe
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
Kwenye macOS au Windows, Podman hutumia Podman Machine ya mbali: ruka `podman unshare` na
ufuate [mwongozo wa saraka ya data unaolingana na topolojia](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Mwongozo wa Podman](contrib/podman/README.md) — Miundo ya Compose, Podman Machine, na
usanidi wa Quadlet wa Linux/systemd.
**⚡ Usakinishaji wa haraka zaidi / mwepesi zaidi (ruka ujenzi asilia)**
Injini asilia ya SQLite (`better-sqlite3`) ni tegemezi la **hiari**, kwa hivyo usakinishaji wa
kimataifa haukwami kamwe ukisubiri utungaji kutoka kwenye msimbo chanzo: hutumia faili jozi iliyojengwa tayari inapolingana
na mfumo wako/Node, na vinginevyo hubadilika kwa uwazi hadi injini ya JavaScript safi
(`node:sqlite` kwenye Node 22+, au `sql.js` WASM iliyofungashwa) — hakuna zana za ujenzi zinazohitajika.
Ili kuruka kabisa uanzishaji asilia wa baada ya usakinishaji (CI, bila kiolesura cha picha, au mashine za polepole):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 pia huiruka
```
Kwa usakinishaji wa haraka zaidi, pendelea **pnpm** (hifadhi inayotegemea maudhui + viungo vigumu — tazama hapo juu).
Kwa mazingira ya utekelezaji yasiyo na dashibodi wala kiolesura cha picha, tumia wasifu wa Docker wa `base` (hapo juu) au
[mwongozo wa Termux](docs/guides/TERMUX_GUIDE.md). CLI na dashibodi ya wavuti huhudumiwa na
mchakato uleule kwenye port moja, kwa hivyo kwa sasa hakuna package tofauti ya CLI pekee.
# 🎬 OmniRoute Ikifanya Kazi
## 📹 Miongozo ya Video
Picha ya paneli mnamo 2026-10-18 · Katalogi ghafi: YT 1.352 | TT 334 | IG 290 · Usasishaji (siku): YT 5 | TT 48 | IG 49
🎬 #1 — Instagram nick_saraev — mara 3,042,474 za kutazamwa
🎬 #2 — Instagram nnapier7 — mara 1,454,535 za kutazamwa
🎬 #3 — YouTube Amidia AI & Tech — mara 794,974 za kutazamwa
🎬 #4 — Instagram theopenstack — mara 692,419 za kutazamwa
🎬 #5 — TikTok migue.baena — mara 685,788 za kutazamwa
**Orodha kamili ya viwango (URL kanoniki zilizoondolewa nakala, `v > 0`, ufikiaji mkubwa zaidi):**
| #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** |
Vipimo kanoniki mnamo 2026-10-18: **video 1.976 za kipekee** · **mara 20.220.289 zinazojulikana za kutazamwa** (`v > 0`) · **chaneli/wasifu 1.210 kwa kila mtandao**. Paneli ghafi ina mistari 1.976 (YouTube 1.352 = video ndefu 740 + Shorts 612 · TikTok 334 · Instagram 290); hakuna nakala iliyobaki baada ya urekebishaji kwa kutumia URL kanoniki, ambao huhifadhi idadi kubwa zaidi kwa kila video. Ukusanyaji wa data kutoka YouTube umesitishwa tangu 2026-10-13 (kiasi cha API kilikwisha kutoka 14 hadi 18/10), na ule wa TikTok/Instagram tangu 2026-09-02 (hakuna salio la ukusanyaji); video 76 bado hazina idadi ya mara zilizotazamwa.
> 🎬 **Umetengeneza video kuhusu OmniRoute?** Fungua [suala](https://github.com/diegosouzapw/OmniRoute/issues/new) au [mjadala](https://github.com/diegosouzapw/OmniRoute/discussions) ukiwa na kiungo — tutaiangazia hapa.
# 📧 Jumuiya na Usaidizi
> Kila kitu mahali pamoja — mfuate msimamizi, zungumza na jumuiya, au fungua suala.
| Kituo | Wapi / jinsi |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| 💼 **LinkedIn** — mfuate msimamizi | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) |
| 🐙 **GitHub** — fuata kwa matoleo na vidokezo | [@diegosouzapw](https://github.com/diegosouzapw) |
| 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) |
| ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) |
| 🟢 **WhatsApp — 🌍 Kimataifa** | [jiunge na kikundi](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) |
| 🟢 **WhatsApp — 🇧🇷 Brazili** | [jiunge na kikundi](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) |
| 🌍 **Tovuti** | [omniroute.online](https://omniroute.online) |
| 🌍 **🌍Jumuiya ya StHub OmniRoute (bila malipo)** | [tovuti ya StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) |
| 📦 **Msimbo chanzo** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) |
| 🐛 **Ripoti hitilafu** | [fungua suala](https://github.com/diegosouzapw/OmniRoute/issues) — ambatisha matokeo ya `npm run system-info` |
| 🤝 **Changia** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Muundo wa Matawi na Matoleo](docs/ops/BRANCHING_MODEL.md) · chagua `good first issue` |
| 💚 **Saidia mradi** | [Njia za kusaidia ↑](#-support-omniroute) · [Wafadhili wa GitHub](https://github.com/sponsors/diegosouzapw) |
OAuth 2.0 (PKCE) + JWT + API Keys + uthibitishaji wa MCP wenye upeo · AES-256-GCM wakati wa kuhifadhi · DOMPurify
Ufichaji
wreq-js — uigaji wa alama za vidole za JA3 / JA4 TLS, proksi ya viwango 3
Ustahimilivu
Kikata mzunguko, kusubiri kwa ongezeko la kielelezo, kuzuia msongamano wa maombi mengi kwa wakati mmoja, kujiponya kiotomatiki kwa mchanganyiko
Uwekaji kumbukumbu
pino — kumbukumbu za JSON zilizoundwa zenye muktadha wa ombi
Upimaji
Kikimbiza majaribio cha Node.js + Vitest — matangazo tuli ya majaribio zaidi ya 60,000 katika faili za majaribio zinazofuatiliwa zaidi ya 8,400 (kitengo, ujumuishaji, E2E, usalama, mfumo ikolojia)
Mbinu ya ufikiwaji wa majaribio kwa matamko tuli ya majaribio zaidi ya 60,000 katika faili za majaribio zaidi ya 8,400 zinazofuatiliwa
# ⭐ Wachangiaji Wakuu
> OmniRoute imejengwa na jumuiya yenye shauku ya programu huria. Watu hawa wametoa michango ya kipekee inayoathiri moja kwa moja ubora, uthabiti na ufikiaji wa mradi. **Asanteni.**
### Wachangiaji wa nje kwa kuzingatia pull requests zilizounganishwa
Sensa ilifanywa 2026-11-03 03:01:19 UTC kwa kutumia ncha hai ya release/v3.8.5305bc048d6c. Sensa iliyopaginated ya GitHub GraphQL ina PRs zilizounganishwa 9,947: 4,130 na mmiliki wa hazina, 240 na Dependabot, 6 na roboti/programu nyingine, na PRs 5,571 za nje kutoka kwa wachangiaji 883 tofauti. “Mistari iliyobadilishwa” ni jumla ya nyongeza + ufutaji za GitHub na inajumuisha faili zilizozalishwa, lockfiles, katalogi, tafsiri na nyaraka; ni mabadiliko ya jumla, si LOC zilizoandikwa. PRs 53 zinaripoti tofauti za GitHub zilizo juu ya mistari 500,000 (kwa mfano #13399, nyongeza moja ya mtoa huduma, inaorodhesha faili 2,347 zilizobadilishwa), jambo linaloongeza baadhi ya jumla zilizo hapo juu. Nafasi zinazolingana zimewekwa pamoja.
### Commits zilizohusishwa na GitHub
Imekaguliwa tena 2026-11-03 02:09:16 UTC: Commiti zilizohusishwa na GitHub zilizoripotiwa na API ya Contributors ya hazina kwa tawi chaguo-msingi la release/v3.8.53. API ilirudisha vitambulisho 903 (watumiaji 429, roboti 2, wasiojulikana 472); jedwali hili halijumuishi msimamizi, roboti na vitambulisho visivyojulikana, na linahifadhi sare za ushindani. Ni tofauti na orodha ya PR zilizounganishwa hapo juu na sensa ya metadata ya Git iliyo hapa chini.
> 🙏 Vipengele, marekebisho ya hitilafu na maboresho ya miundombinu ya wachangiaji hawa ni **sehemu ya msingi** ya kinachoifanya OmniRoute iwe thabiti na yenye vipengele vingi. Kila ombi la kuvuta, kila kisa cha majaribio na kila faili ya tafsiri ya i18n ni muhimu. Programu huria hujengwa na watu kama wao.
---
## 💖 Wafadhili
Shukrani za dhati kwa watu wanaofadhili OmniRoute kutoka mifukoni mwao — kila mchango husaidia mradi uendelee kuwa bila malipo, huru na kusonga mbele.
… na wengine wanaopendelea kubaki faraghani 💛Wafadhili wa umma wa GitHub walithibitishwa upya tarehe 2026-10-18 kupitia GitHub Sponsors GraphQL API: ufadhili 11 wa umma (6 hai, 5 wa zamani) kati ya 14 kwa jumla. Hali ya GitHub ya isActive huamua lebo za walio hai zilizo hapo juu; wachangiaji wa zamani wa umma wa mara moja wanaendelea kushukuriwa, na wafadhili wa faragha wanaendelea kutotambulishwa. Michango kupitia Ko-fi, Buy Me a Coffee, Liberapay, PIX na sarafu za kidijitali haijaorodheshwa kwa sababu haina rekodi ya mfadhili ya umma.💖 Kuwa mfadhili → — kila dola husaidia OmniRoute iendelee kuwa bila malipo na huru.
## 👥 Wachangiaji 1,000+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Imekaguliwa tarehe 2026-11-02 kwenye ncha ya moja kwa moja ya release/v3.8.531c7135e0fb (commiti 7,972): utambulisho 1,074 wa binadamu uliosanifishwa wa Git — 759 wanaonekana kama waandishi wa commit (akiwemo msimamizi) na 315 wanaonekana tu katika viongezi vya wazi vya Co-authored-by. Sensa inatumia .mailmap, inalinganisha anwani za barua pepe bila kujali herufi kubwa au ndogo, inaunganisha anwani za GitHub noreply za nambari na za kawaida tu zinapoweka msimbo wa jina lilelile, inaondoa utambulisho 29 wa roboti/agent/huduma/vishikilia-mahali, na haiunganishi anwani za kawaida za barua pepe kwa sababu tu majina yao ya kuonyeshwa yanafanana. Ukaguzi wa 2026-08-24 ulichapisha 639; kuendesha tena mbinu hii kwenye msingi wa ukaguzi huo ac02c5b42f kunatoa 619, kwa hiyo ongezeko limetokana na wachangiaji wapya, si mbinu iliyolegezwa.
### Jinsi ya Kuchangia
1. Fanya fork ya hazina
2. Unda branch kutoka kwenye ncha **amilifu** ya `release/vX.Y.Z` (si `main`) — tazama [Muundo wa Branch na Utoaji](docs/ops/BRANCHING_MODEL.md)
3. Unda branch yako ya kipengele (`git checkout -b feat/amazing-feature`)
4. Fanya commit ya mabadiliko yako (`git commit -m 'feat: add amazing feature'`)
5. Push kwenye branch (`git push origin feat/amazing-feature`)
6. Fungua Pull Request yenye **base = branch hiyo ya** `release/vX.Y.Z`
Tazama [CONTRIBUTING.md](CONTRIBUTING.md) kwa miongozo ya kina.
### Kutoa Toleo Jipya
```bash
# Unda toleo — npm publish hufanyika kiotomatiki
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Nyota
## 🌍 StarMapper
## 🙏 Shukrani
OmniRoute imejengwa kwa msingi wa kazi za watangulizi mahiri. Ilianza kama fork ya **[9router](https://github.com/decolua/9router)** na port ya TypeScript ya mradi wa Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — na tangu hapo, kila mfumo mdogo hapa chini ulipata msukumo kutoka kwa mradi wa open-source uliowahi kufanikisha hilo kwanza. Kila mmoja uliunda sehemu mahususi ya OmniRoute. Hii ndiyo shukrani yetu kwao wote. 🙏
> ⭐ Idadi za nyota zimethibitishwa kupitia GitHub's REST API tarehe 3 Novemba 2026 — nenda ukazipatie miradi hii nyota. Idadi hizi ni picha sahihi ya tarehe hiyo na kwa kawaida zitabadilika.
### 🧬 Asili na lango
Lango la AI ambalo seti yake ya data ya bei za umma hutumika kulisha usawazishaji wetu wa ufuatiliaji wa gharama, na ambalo modeli yake ya usanifishaji wa watoa huduma ilitoa mwongozo kwa uelekezaji wetu.
Chanzo cha MIT kilichorekebishwa kuwa daraja la ChatGPT Web → Codex Responses lililowekwa ndani, likijumuisha adapta za kipindi cha kivinjari, upangaji wa fremu za majibu, matumizi na utafutaji wa wavuti.
Mifumo iliyohamishwa katika urejeshaji wa mtiririko, lakabu za no-thinking, utafutaji wa wavuti wa fallback, vikomo vya dirisha linaloteleza, ufichaji wa data kwenye kumbukumbu na mtiririko wa uanzishaji ulioimarishwa.
Mipangilio chaguo-msingi ya mabadiliko inayooana na Claude Code na tabia ya vichwa vya malipo ilipanuliwa kuwa daraja la OmniRoute linaloendeshwa na usanidi.
Uchoraji wake wa modeli za Grok, jenereta bandia ya TypeError ya Statsig, chaguo-msingi za maombi na kifaa, pamoja na kichakataji cha majibu cha NDJSON, vilibadilishwa kwa kiasi kikubwa kuwa executor ya Grok Web ya OmniRoute.
Chanzo kikuu cha msimbo wa mpito nyuma ya grok2api-merged; utekelezaji wake wa modeli, vichwa, mzigo wa data, Statsig na kichakataji umehifadhiwa katika mfululizo wa Grok Web.
Chanzo cha msingi cha MIT cha mipangilio chaguo-msingi ya mzigo wa data na kifaa cha Grok, jenereta ya Statsig, na kichakataji cha result.response kilichopitishwa kupitia TQZHR na grok2api-merged.
Chanzo cha mpito kilichotajwa na grok2api-merged kwa safu yake ya proxy-pool; OmniRoute inahifadhi taarifa hiyo ya asili lakini haidai kuwa imehamisha proxy-pool katika executor yake yenye mipaka ya Grok Web.
Proxy yake ya Grok inayothibitisha kwa cookie na mfumo wake wa utiririshaji wa result.response.token vilitoa mwongozo kwa usafirishaji wa Grok Web wa OmniRoute.
Utekelezaji wake wa awali wa Grok Web ulitusaidia kuelewa muundo wa HTTP/browser upstream; njia yake ya HTTP ya moja kwa moja inatokana na GrokProxy, kwa hiyo hakuna port huru ya msimbo inayodaiwa.
### 🗜️ Mfinyazo wa muktadha na tokeni — injini sautiેણ
Mradi maarufu wa "kwa nini utumie tokeni nyingi wakati tokeni chache zinatosha" — falsafa yake ya lugha ya caveman inaendesha hali yetu ya kawaida ya kubana na kanuni zaidi ya 30 za kuondoa maneno ya kujaza/kufupisha.
Ubanaji wa utendaji wa juu wa matokeo ya amri — uliupa msukumo injini yetu ya RTK, DSL ya kuchuja JSON, urejeshaji wa matokeo ghafi na mchakato uliopangwa wa RTK → Caveman.
Ubanaji wa muktadha unaoweza kubadilishwa kurudi katika hali ya awali (SmartCrusher) — uliupa msukumo injini yetu ya headroom na muundo wa alama ya urejeshaji wa ccr.
Utafiti wa kubana vidokezo (LLMLingua / LLMLingua-2) — uliupa msukumo injini yetu ya llmlingua isiyosawazisha, salama kwa msimbo na inayofunguka inaposhindwa.
Ubanaji wa tokeni za PT-BR — unaendesha kifurushi chetu cha lugha ya pt-BR: kupunguza pleonasm na kuondoa maneno ya kujaza yaliyoboreshwa kwa sarufi ya Kireno cha Brazili.
Ustadi maarufu wa mtindo wa msimbo wa YAGNI wa "msanidi mkuu mvivu" — uliupa msukumo less-code Output Style yetu: uelekezaji wa mabadiliko madogo zaidi yanayofanya kazi, unaopunguza msimbo _unaozalishwa_ (mwenzake wa mhimili wa matokeo kwa nathari fupi ya Caveman).
Ubanaji wa matokeo ya Bash pamoja na wasifu wa MCP — uliupa msukumo nidhamu yetu ya kusitisha ubanaji inapokuwa haina faida na kupunguza manifesti ya zana za MCP.
Ubanaji wa matokeo unaotambua maudhui na unaotofautiana kwa kila aina ya faili, pamoja na kusitisha unapokumbana na hitilafu — ulithibitisha utumaji wetu kwa kila aina na kuruka pale faida inapokuwa ndogo kuliko kiwango cha chini.
JSON ya Rust ya safu wima pamoja na urejeshaji unaotegemea anwani ya maudhui na kuondoa nakala katika jumbe mbalimbali — ulithibitisha usanifu wa injini zetu za headroom/ccr/session-dedup na kanuni thabiti ya akiba kwamba "muundo uliobanwa hautegemei nafasi".
Uingiliaji/uchanganuzi wa MITM wa trafiki kati ya msaidizi wa uandishi wa programu ↔ LLM uliwezesha mahitaji ya awali ya Traffic Inspector. Moduli nne zilizotokana hapo awali — uunganishaji wa SSE, usanifishaji wa mazungumzo, ufichaji wa siri na usafishaji wa vichwa — zimebadilishwa na utekelezaji huru wa clean-room unaotegemea viwango vya itifaki vya umma. Nyuso mbili za host-passthrough (passthrough.ts na _internal/bypass.cjs) zinasalia kuwa utekelezaji wa ndani wa OmniRoute uliowekwa katika kundi kwa kujitegemea; hazikuandikwa upya kama sehemu ya uingizwaji huo.
Uelekezaji wa proksi wa uwazi kwa kila mchakato — ulihamasisha uondoaji salama wa MITM wakati wa hitilafu, muda wa kusubiri wa soketi zisizotumika, uhusishaji wa mchakato kupitia /proc na kunasa kwa TPROXY.
Orodha iliyoratibiwa ya maktaba zilizo salama kwa chaguo-msingi inayotuongoza katika chaguo zetu za usalama (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ulihamasisha uondoaji wa nakala za maombi, njia mbadala ya dharura isiyogharimu chochote, mikakati inayoweza kuchomekwa ya Auto-Combo na uainishaji wa dhamira katika lugha nyingi.
Uchoraji upya wa modeli unaozingatia akaunti, uthibitishaji wa njia za utekelezaji na tabia ya lebo za mipango uliwezesha runtime ya Antigravity ya OmniRoute.
Ulibainisha eneo la mgao la Grok Build; OmniRoute kisha ikathibitisha na kurekebisha muundo halisi wa waya kwa kujitegemea.
## 📄 Leseni
Leseni ya MIT - angalia [LICENSE](LICENSE) kwa maelezo zaidi.
---
**[⬆ Rudi juu](#-omniroute)** · Imetengenezwa kwa ❤️ kwa ajili ya jumuiya ya AI ya chanzo huria.
Imeundwa na Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Leseni ya MIT · omniroute.online
> Muhtasari wa uhuishaji wa ukurasa wa moja kwa moja wa `/dashboard/free-tiers`. Mbinu kamili (uondoaji wa marudio ya mabwawa, viwango vya salio, masharti ya watoa huduma): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Takwimu hizi hukaguliwa upya kila baada ya wiki mbili dhidi ya katalogi ya moja kwa moja na **hubadilika pande zote mbili** — mtoa huduma anasitisha ngazi ya bure na namba hushuka; mpya inaongezwa na inapanda. Tunachapisha kile katalogi inachokokotoa hasa, kamwe si hali bora iliyozungushwa kwenda juu.
```bash
# Baada ya kuunganisha mtoa huduma, nakili ufunguo wako wa OmniRoute kutoka Dashibodi → 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` inahitaji route inayostahiki. Usakinishaji mpya unaweza usiwe na walengwa wowote wa keyless wanaostahiki, na mtoa huduma wa keyless anaweza kukataa wateja wa wahusika wengine. Watoa huduma waliowekwa alama `tos: avoid`, wakiwemo Kiro, huondolewa kwenye uelekezaji wa kiotomatiki kwa chaguo-msingi; kuunganisha akaunti hakubadilishi mpangilio huo. Angalia [Mwongozo wa Viwango vya Bure](docs/getting-started/FREE-TIERS-GUIDE.md) kabla ya kuchagua mtoa huduma.
📦 Nakili-bandike hati za kuanza haraka kwa **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Combo** ni mnyororo wa modeli ambao OmniRoute huelekeza maombi kati yake **kiotomatiki**. Ikiwa kiwango kinachoruhusiwa kitaisha, mtoa huduma atashindwa, au gharama zitapanda ghafla, combo inaweza kuhamia kwenye modeli inayofuata inayostahiki na yenye afya nzuri. 🛡️
### ⚡ Bila usanidi — tumia tu `auto`
Hakuna combo ya kuunda. Weka modeli yako kuwa `auto` (au mojawapo ya vibadala vyake) na OmniRoute itaunda combo pepe kutoka kwa watoa huduma wako waliounganishwa, huku ikizipatia alama moja kwa moja:
📖 [Injini ya Auto-Combo](docs/routing/AUTO-COMBO.md) · [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
📊 Mbinu kamili & maelezo ya kila kipengele dhidi ya 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Ufunguo (nasibu): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix ya kunakili na kubandika:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Uidhinishaji](docs/architecture/AUTHZ_GUIDE.md) · [Vizuizi vya Usalama](docs/security/GUARDRAILS.md) · [Uzingatiaji](docs/security/COMPLIANCE.md)
Mchanganyiko wa chaguomsingi uliowekwa kwa safu huendesha `RTK → Caveman`. Zote zinapotenda kwenye mzigo uleule wa zana/muktadha, uokoaji hujumuishwa:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Vizuizi vya msimbo, URL, JSON na data iliyopangwa **hulindwa kila wakati** na injini ya uhifadhi.
> **Kwa nini utumie tokeni nyingi wakati tokeni chache zinatosha?** Kila ombi hupitia kwenye mkondo wa kubana wa OmniRoute **kwa uwazi** — bila mabadiliko kwa mteja. Sasa ni **mkusanyiko wa injini 12 zinazoweza kuunganishwa** zinazoendeshwa kwa mpangilio na kuchanganywa kulingana na mchanganyiko wa uelekezaji — ukijengwa juu ya mawazo kutoka kwa [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), na [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Mkusanyiko wa injini 12
Injini huendeshwa kwa mpangilio wa mkondo wa uchakataji; kila moja inaweza kuwashwa/kuzimwa na kusanidiwa kivyake kwa kila mchanganyiko:
