## 💰 Tokeni Bilioni ~1.62 / Mwezi Kupitia Viwango vya Bure vya Wahusika Wengine
> **Tumia akaunti zako mwenyewe za watoa huduma.** Haya ni makadirio ya jumla kutoka kwa viwango tofauti vya bure vya wahusika wengine ambavyo unastahiki, si mgao wa tokeni kutoka OmniRoute. Jisajili, pata vitambulisho vinapohitajika, na uunganishe watoa huduma unaoweza kutumia; kila mtoa huduma hudhibiti vikomo, upatikanaji na masharti yake.
>
> Kuunganisha viwango vya bure kwa mkono ni kazi ngumu — SDK nyingi sana, vikomo vingi sana vya kiwango cha matumizi, na hujui una kiasi gani kwa hakika. OmniRoute inaorodhesha **maingizo 467 ya viwango vya bure katika funguo 34 za vikundi vinavyojirudia** na hukokotoa jumla kuu ya tokeni kutoka kwa **vikundi 17 vyenye bajeti chanya ya kila mwezi iliyochapishwa pamoja na vikomo vitano vya Groq kwa kila modeli**, huku vikundi vinavyoshirikiwa vikiondolewa urudufu. Mgao unaopatikana tu baada ya ukaguzi wa utambulisho wa kikanda (kwa sasa: ModelScope) huonyeshwa kando, +~6M baada ya uthibitishaji wa utambulisho wa kikanda, na kamwe haujumlishwi katika jumla kuu. Matokeo hubaki yakionekana kwenye dashibodi (`/dashboard/free-tiers`).
> Muhtasari uliohuishwa wa ukurasa wa moja kwa moja wa `/dashboard/free-tiers`. Mbinu kamili (uondoaji wa urudufu wa vikundi, 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 kwa kulinganishwa na orodha ya moja kwa moja na **hubadilika kwa pande zote mbili** — mtoa huduma akisitisha kiwango cha bure, idadi hupungua; kipya kikiongezwa, idadi huongezeka. Tunachapisha kile ambacho orodha hukokotoa kwa hakika, kamwe si hali bora iliyoongezwa kwa kuzungusha namba.
⭐ Ipe hazina hii 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 kwanza watoa huduma wapya, matoleo na vidokezo:**
[](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, mpango wa 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) / [🇧🇷 Brazili](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Tovuti Kuu](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway Inaendelea Kukua
| | v3.8.50 | **v3.8.51** | `v3.8.53+` |
| ----------------------------------------------- | :----------------------: | :---------: | :-------------------: |
| 🌐 Watoa huduma | 352 | **358** | 375 |
| 🧠 Vitambulisho vya kipekee vya modeli za gumzo | 1320 | **1374** | 1475 |
| 🖼️ Daraja la Modali | 🆕 maono + sauti + video | ✓ | ✓ |
| 📡 Katalogi ya bure ya Radar | 🆕 kujiunga | ✓ | ✓ |
| ⚖️ Upangaji unaozingatia kiwango | 🆕 Quota-Share | ✓ | ✓ |
| 📊 Telemetria ya kiwango | 🆕 moja kwa moja | ✓ | ✓ |
| 🧰 Hali ya headless | — | — | 🆕 `serve --headless` |
| 🛤️ Miundombinu ya reli ya LTS | — | — | 🆕 chaneli za toleo |
| 🔎 API ya ugunduzi wa modeli | — | — | 🆕 `/v1/models/query` |
**→ [Ramani ya maendeleo](ROADMAP.md) — tukisafiri kwa 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 OmniRoute key yako kutoka 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` inahitaji njia inayofaa. Usakinishaji mpya unaweza kuwa hauna malengo yanayofaa bila key, na mtoa huduma bila key anaweza kukataa wateja wa wahusika wengine. Watoa huduma waliowekwa alama `tos: avoid`, ikiwa ni pamoja na Kiro, hutengwa na uelekezaji wa kiotomatiki kwa chaguo-msingi; kuunganisha akaunti hakubadilishi mpangilio huo. Tazama [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) kabla ya kuchagua mtoa huduma.📦 Script za quickstart za kunakili-na-kubandika 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)
## 🏆 Kinachofanya OmniRoute Kuwa Tofauti
📊 Mbinu kamili & maelezo ya kila kipengele ikilinganishwa na 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)**.
## ✨ Mpya
> Mambo muhimu ya hivi karibuni kutoka **v3.8.20 → v3.8.53**. Historia kamili katika [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Uelekezaji wa `quota-weighted`** — mkakati wa 20 wa combo huruka akaunti zilizokwisha, kisha huchagua kati ya zilizobaki kwa uwiano wa quota iliyobaki ÷ mzigo unaoendelea, huku mazungumzo yaliyopo yakibaki yamefungwa. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Hali ya headless** — `omniroute serve --headless` (au `OMNIROUTE_HEADLESS=1`) huendesha tu injini ya proxy ya `/v1/*`, huku dashibodi na mifumo inayotegemea dashibodi pekee zikiwa zimezimwa. → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 Ugunduzi wa modeli** — `/v1/models` huchuja kwa uwezo, muktadha, aina na maandishi, na `POST /v1/models/query` hurudisha orodha fupi ya kibainishi yenye uwazi sawa kwa kila ufunguo. → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 Udhibiti wa uelekezaji kwa kila ufunguo** — bamba ufunguo wa API kwa modeli moja au combo kwa `forcedModel`, na ongeza au ondoa modeli na combo za ufunguo kwa mpigo mmoja (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Vidhibiti bora vya PII** — uteuzi kwa kila aina, hadi mifumo 20 ya ufichaji maalum iliyothibitishwa na vihesabio vya utambuzi kwa kila aina; ufichaji wenyewe unabaki wa hiari. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 Lugha 67** — dashibodi, nakala za nyaraka na CLI, huku `npm run i18n:add-locale` ikiongeza lugha kila mahali kwa amri moja. → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ukabidhi wa A2A unaoingia kwa kundi lako la maajenti, ujuzi wa Conductor kwenye Kadi ya Ajenti, na paneli ya dashibodi yenye gumzo la sauti la Faro la kushinikiza-kuzungumza. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Ukubalifu adaptif na ulinzi dhidi ya mzigo kupita kiasi** — maombi mazito ya gumzo hupanga foleni badala ya kurudisha 503, na ukodishaji wa RPM unaozunguka kwa kila muunganisho. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Mpangilio wa kikanoni wa `/v1/models`** — kizuizi kimoja mfululizo kilichopangwa kwa mtoa huduma kwa kila mtoa huduma (combo zimebambwa kwanza), thabiti katika kila chanzo cha katalogi. → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Uimarishaji wa mbano** — kinga ya upanuzi iliyowashwa kwa chaguo-msingi, pakiti za Caveman kwa DE / FR / JA + Kichina (wényán), vichujio vya RTK kwa Gradle na .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Gharama ya bei tambarare iliyo wazi** — watoa huduma wa usajili / mipango ya uandishi huonyesha **$0** katika uchanganuzi wa gharama; bajeti, quota na uelekezaji huendelea kukadiria. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Uelekezaji wa Quota-Share** — gawanya quota ya akaunti inayoshirikiwa kwa haki kati ya funguo zilizowekwa pamoja, kwa kuhifadhi kazi ili vipande visivyotumika vikopeshwe. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Usanidi wa CLI/ajenti kwa amri moja** — amri 15 za `setup-*` zilizosajiliwa; `omniroute run` huzindua CLI 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` huunga mkono malengo 11 yenye kichaguzi cha mwingiliano cha mtoa huduma+modeli na vipendwa kwa kila muktadha. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Hali ya mbali** — endesha OmniRoute ya mbali kwa tokeni zenye wigo (`connect` / `contexts` / `tokens`) + msaidizi wa OAuth wa `antigravity` kwa usakinishaji wa VPS. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 Uelekezaji otomatiki wenye akili zaidi** — combo za `auto/:`, **Fusion** (paneli ya modeli + mwamuzi), uelekezaji unaozingatia kazi, na ubatilishaji wa modeli / hali / bajeti ya USD kwa kila ombi. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Mbano unaoweza kuunganishwa** — injini 12 zinazoweza kuunganishwa + Compression Studios: LLMLingua-2, Ultra ya madaraja mawili, omniglyph, lango la uaminifu kwa kila hatua, GCF v3.2, kihariri cha kuburuta-kupanga upya. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Usimbuaji wa MITM wa wazi (TPROXY)** — nasa CLI zinazopuuza vigeu vya mazingira vya proxy, kwa CA ya kila SNI + kisakinishi cha hifadhi ya uaminifu. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Telemetria ya gharama kila mahali** — vichwa vya gharama/matumizi vya `X-OmniRoute-*` kwenye kila endpoint, kichwa cha akiba ya cache-HIT, na quota za matumizi ya USD kwa kila ufunguo. → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 Kumbukumbu unayodhibiti** — imezimwa kwa chaguo-msingi, ujazo wa vekta wa int8 wa hiari + uozo wa aina, `x-omniroute-no-memory` kwa kila ombi. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Usalama** — kinga dhidi ya sindikizo la maagizo kwenye kila njia ya LLM (suite ya red-team), kizingiti cha ufichaji wa sifa za hiari (hufuta funguo/siri za API zilizovuja pande zote mbili), utafutaji wa wavuti wa mwisho wa DuckDuckGo bila malipo, na lango la hiari la kuingia la OIDC kwa dashibodi (kuingia kwa nenosiri daima kunabaki kupatikana). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Endpoints mpya** — `/v1/ocr` (Mistral OCR) na `/v1/audio/translations` (mtindo wa Whisper) hukamilisha uso wa midia. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Uzalishaji wa picha / video / sauti** — API moja kwa midia: xAI Grok Imagine na video ya Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, na watoa huduma wa usemi kama ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Usambazaji na uendeshaji** — `basePath` ya proxy-ya-nyuma, utambuzi wa kiotomatiki wa lugha ya kivinjari, ufuatiliaji wa kifaa kwa kila ufunguo, uaminifu wa MITM bila root, ujanibishaji wa zh-TW. → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 Watoa huduma na maajenti zaidi** — maajenti wa wingu (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) yenye kivinjari + kuingia kwa OAuth, kadi ya daraja la 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 375** iliyohuishwa. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Uwazi wa uelekezaji** — kila jibu hubeba kichwa cha `X-OmniRoute-Decision` kinachotaja mkakati/mtoa huduma/uwezekano wa kuchelewa ulioihudumia, mkakati mpya wa combo wa `cache-optimized` + kipengele cha `cacheAffinity` cha Auto-Combo hurudisha maombi ya kurudia kwenye muunganisho unaoshikilia kiambishi awali kilichohifadhiwa, na endpoint ya kusoma pekee ya `/v1/auto-combo/{channel}/candidates` hufichua kundi la wagombea hai la chaneli ya `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Utendaji wa ndani na miundombinu** — Redis ya ndani kwa mbofyo mmoja, wasambazaji wa relay wa Cloudflare Workers / Deno Deploy, Bifrost na Mux kama huduma zilizoingizwa zinazosimamiwa. → [Huduma Zilizoingizwa](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Pia ndani ya sanduku** — mfumo wa programu-jalizi + soko, mifumo ya ujuzi ya Omni/Agent/GitHub, uunganishaji wa vault ya Obsidian (zana 22 za MCP), APIs za Batch na Files zinazoendana na OpenAI, akiba ya majibu ya kimantiki, mchezo wa kugawanya pointi na bodi za viongozi, ugunduzi wa mawakala wa ACP (mawakala 15 waliojengwa ndani), usafirishaji wa kumbukumbu kwa ratiba kwenda BigQuery, `auto/chaos` usambazaji sambamba wa modeli nyingi, daraja la bot la Telegram, msimamizi wa toleo ndani ya programu na viwango vya watoa huduma bila malipo vya LMArena-ELO. → [Nyaraka](docs/README.md)
## 🤖 CLI na Mawakala wa Uandishi wa Msimbo Wanaooana
> Usanidi mmoja — `http://localhost:20128/v1` — na **kila** IDE au CLI ya AI hutumia modeli zisizolipishwa na za gharama nafuu.
+ pia hufanya kazi na · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · zana yoyote inayooana na OpenAI
📖 Usanidi wa kila zana kwa zana zote 37 (CLI Code 27 + CLI Agents 10) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Programu-jalizi ya OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Zindua CLI yoyote inayotumika kupitia OmniRoute kwa amri moja** — hakuna faili za usanidi zinazoandikwa,
vitambulisho vinaingizwa kwa kila mchakato, na Qwen/Gemini hupata saraka ya nyumbani ya muda iliyotengwa:
```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+modeli kwa mwingiliano na uandike usanidi wa zana yenyewe:
omniroute configure codex # pia: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Kila amri huheshimu muktadha amilifu wa mbali (`omniroute connect `), `--dry-run`
huonyesha mapema env/args kamili bila kutekeleza, na `--api-key-env NAME` huzuia siri
kuhifadhiwa katika historia ya shell yako. → [Miunganisho ya CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 Watoa Huduma 375 wa AI — 153 Waliowekwa Alama ya Bila Malipo kwenye Katalogi
> **Watoa huduma 375 waliosajiliwa** katika makusanyo halisi ya mazungumzo, midia, utafutaji, ya ndani, wakala wa wingu na ya mfumo, ikijumuisha **153 wanaobeba metadata ya ugunduzi `hasFree: true`**. Rejista ya modeli za mazungumzo inashughulikia **watoa huduma 239 / jozi 3,059 tofauti za mtoa huduma-modeli / vitambulisho 1,475 mbichi vya modeli**; katalogi tofauti ya bajeti ya bila malipo ina **safu 467 kwa kila modeli**, **madimbwi 34 ya mara kwa mara** na **watoa huduma 51 wa bila malipo milele wa mara kwa mara/wasiokuwa na ufunguo**. Haya ni madhehebu tofauti kwa muundo; fasili na hesabu zilizopunguzwa za madimbwi ziko katika [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) na [Free Tiers](docs/reference/FREE_TIERS.md).
### 🏢 Kila maabara 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 zaidi ya 350 — kila ikoni hutatuliwa moja kwa moja kutoka katalogi ya watoa huduma ya dashibodi. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Bila Malipo Milele — $0, hakuna kadi
OpenCode Zen DeepSeek V4, Nemotron 3 Hakuna kikomo cha tokeni
Kilo Code Kipanga njia 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 Modeli 50+ Neuroni 10K/siku
NVIDIA NIM GLM, MiniMax ~40 RPM bure
Cerebras GLM 4.7, GPT-OSS Krediti ya $5 ya mara moja; kadi inahitajika
OpenRouter modeli :free +$10 → RPM zaidi
📖 Katalogi kamili inayosomeka na mashine → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute Huendeshwa Wapi — Popote
> Programu ileile, mashine yako, sheria zako. Kuanzia usakinishaji wa kimataifa wa npm hadi **simu yako** kupitia Termux.
Jukwaa
Usakinishaji
Vipengele muhimu
📦 npm (kimataifa)
npm install -g omniroute
Amri moja, mfumo wowote wa uendeshaji
🐳 Docker
docker run … diegosouzapw/omniroute
Miundio mingi AMD64 + ARM64
🖥️ Kompyuta ya mezani (Electron)
npm run electron:build
Dirisha asilia + trei ya mfumo — Windows / macOS / Linux
🎩 Upau wa menyu (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Husimamia & kusasisha seva kiotomatiki — macOS
💪 ARM
asilia arm64
Raspberry Pi, seva za ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Huendeshwa kwenye simu yako, saa 24/7, bila root
📲 PWA
"Ongeza kwenye Skrini ya Mwanzo"
Skrini nzima, nje ya mtandao, inaweza kusakinishwa kutoka kwenye kivinjari
🧩 Programu-jalizi ya OpenCode
@omniroute/opencode-provider
Muunganisho asilia wa OpenCode
🤖 VS Code Copilot Chat
sakinisha kiendelezi cha OmniCopilot
Kila modeli ya OmniRoute katika kiteuzi asilia cha Copilot Chat — toleo thabiti & Insiders
🛠️ Kutoka kwenye msimbo chanzo
npm install && npm run dev
Ifanyie marekebisho, changia
📖 [Mwongozo wa Docker](docs/guides/DOCKER_GUIDE.md) · [Kompyuta ya mezani](electron/README.md) · [Trei ya upau wa menyu](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 Copilot Chat asilia ya VS Code
> Hakuna upau mpya wa pembeni, hakuna kiolesura kipya cha gumzo — kila modeli inayotolewa na OmniRoute huonekana moja kwa moja kwenye
> **kiteuzi cha modeli cha Copilot Chat ambacho tayari unatumia**. Tangu VS Code 1.122, modeli za watoa huduma hufanya kazi
> bila kuingia kwa akaunti ya GitHub au kuwa na usajili wa Copilot — hali ya ajenti, uitaji wa zana na uwezo wa kuona, bila
> malipo.
Sakinisha kiendelezi cha **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, kielekeze
kwenye seva yako ya OmniRoute (chaguo-msingi ni `localhost:20128`), kisha fungua Copilot Chat → kiteuzi cha modeli
→ **Dhibiti Modeli…** → **OmniRoute**.
Kutoka ndani ya kihariri: fungua mwonekano wa **Viendelezi**, tafuta **"OmniRoute"**, bofya **Sakinisha**
— hufanya kazi kwa njia ileile kwenye maduka yote mawili. Msimbo chanzo, masuala na mwongozo wa uchapishaji vinapatikana kwenye
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Mwongozo wa VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — usanidi, kile ambacho kiteuzi huonyesha, dashibodi ndani ya kichupo, utatuzi wa matatizo
### 🎩 Mpya: OmniRouteTray — lango lako, likiishi kwenye upau wa menyu
> `omniroute serve` hufanya kazi vyema zaidi ikiwa imewashwa kila wakati. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> hubadilisha hilo kuwa programu ya upau wa menyu ya macOS unayosanidi na kuisahau: huanzisha seva, huiweka ikiendelea kufanya kazi
> baada ya kuwasha upya, huisasisha papo hapo, na kuweka bajeti yako ya tokeni ya moja kwa moja umbali wa mbofyo mmoja — **hakuna
> dirisha la terminal linaloachwa wazi, hakuna `npm install -g omniroute` ya kuendelea kusimamia.**
Imeundwa kwa [Tauri v2](https://v2.tauri.app/) (kiini cha Rust chenye ukubwa mdogo sana), inakuja
na mazingira yake ya utekelezaji ya Node 24 yaliyotiwa sahihi na inasimamia usakinishaji wa OmniRoute unaomilikiwa na programu, kwa hivyo haigongani kamwe na
`node`/`bun` yako ya kimataifa. **Inashiriki usanidi na hifadhidata yako iliyopo ya `~/.omniroute/`** — kwa hivyo ni
OmniRoute ileile ambayo tayari unaendesha, lakini sasa ikiwa imevaa kofia. 🎩
Inachofanya
Jinsi inavyofanya
🟢 Husimamia seva
Huanzisha omniroute serve, hutumia instansi ambayo tayari inaendeshwa badala ya kuiunda mara mbili
📊 Matumizi ya moja kwa moja kwa muhtasari
Pau za mgao wa watoa huduma, vikomo vya vipindi vya Claude/kila wiki pamoja na vihesabio vya muda hadi kuwekwa upya, uchanganuzi wa gharama za siku 30
🔄 Hujisasisha kiotomatiki papo hapo
Usakinishaji wa hatua kwa hatua, ubadilishaji atomiki, kurejesha toleo la awali ikishindikana — daima kwenye toleo jipya zaidi
🚀 Anza wakati wa kuingia
Uzinduzi wa hiari wakati wa kuingia; trei pekee, hakuna ikoni ya dock
🩺 Uchunguzi & kumbukumbu
Uchunguzi kwa mbofyo mmoja na ufikiaji wa kumbukumbu za seva
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Unapendelea kupakua? Pakua .dmg ya hivi karibuni kutoka
Matoleo. Msimbo chanzo, masuala na nyaraka za
ujenzi zinapatikana katika zoispag/omniroute-tray.
💛 Mradi wa jamii ulioundwa na @zoispag — si toleo rasmi la 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)
## 🗜️ Okoa 15–95% ya Tokeni — Kiotomatiki
### 📖 Jinsi inavyofanya kazi — bomba la usindikaji, usanifu na hesabu za uokoaji
Mchanganyiko chaguo-msingi uliorundikwa huendesha `RTK → Caveman`. Wakati zote mbili zinafanya kazi kwenye mzigo sawa wa zana/muktadha, uokoaji huongezeka kwa mchanganyiko:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Vitalu vya msimbo, URL, JSON na data iliyopangwa **hulindwa kila wakati** na injini ya uhifadhi.
> **Kwa nini kutumia tokeni nyingi wakati tokeni chache zinatosha?** Kila ombi hupitia bomba la ukandamizaji la OmniRoute **kwa uwazi** — hakuna mabadiliko ya mteja. Sasa ni **msururu wa injini 12 zinazoweza kuunganishwa** zinazoendeshwa kwa mpangilio na kuchanganywa kulingana na mchanganyiko wa uelekezaji — ukijengwa juu ya mawazo kutoka [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).
### 🧱 Msururu wa injini 12
Injini huendeshwa kwa mpangilio wa bomba; kila moja inaweza kuwashwa/zimwa kivyake na kusanidiwa kwa kila mchanganyiko:
#
Injini
Inafanya nini
1
Session-Dedup
Huondoa maudhui yanayorudiwa kati ya zamu (yanayoelekezwa kwa maudhui, kati ya zamu)
2
CCR
Huhifadhi vitalu vikubwa nyuma ya alama za kurejesha, zinazochukuliwa inapohitajika
3
Lite
Kupunguza nafasi zisizo na maana + URL za picha (msingi mwepesi wa ucheleweshaji)
4
RTK
Uchujaji mahiri wa matokeo ya zana, uondoaji wa marudio na upunguzaji (unaozingatia amri)
5
Responses Tool Output
JSON isiyo na upotezaji kwanza + ukandamizaji wa uchunguzi wenye mipaka kwa matokeo ya shell/patch/search/build (Responses API)
6
Headroom
Ufinyazwaji wa jedwali bila upotezaji wa safu za JSON (~30%) kupitia codec ya GCF iliyowekwa ndani ya mradi
7
Relevance
Ukadiriaji wa sentensi kwa uchimbaji dhidi ya swali la mwisho la mtumiaji
8
Caveman
Ukandamizaji wa nathari kwa kanuni (~65–75% kwenye matokeo)
9
Aggressive
Ufupishaji + uzeekevu wa taratibu wa zamu za zamani
10
LLMLingua-2
Upunguzaji wa kimantiki wa ML kupitia MobileBERT ONNX — salama kwa msimbo, async
11
Ultra
Upunguzaji wa tokeni kwa heuristiki ukiwa na tabaka la hiari la modeli ndogo (SLM)
12
OmniGlyph
Usimbaji wa majaribio wa muktadha-kama-picha kwa Claude Fable 5 iliyopimwa kwenye waya ya moja kwa moja ya Anthropic; transfoma za GPT 5.6 zinabaki fail-closed zikisubiri risiti za mtoa huduma. Profaili nne za ukandamizaji (aggressive chaguo-msingi, balanced, coding-safe, passthrough) (mkali zaidi; kwa kuchagua)
Vitalu vya msimbo, URL na data iliyopangwa **huhifadhiwa kila wakati** bila kubadilika hata baiti moja. **Mipangilio tayari ya mbofyo mmoja** huunganisha injini:
Hali
Uokoaji
Bora kwa
🪶 Lite
~15%
Chaguo-msingi salama linaloendelea kuwaka kila wakati
🪨 Standard (Caveman)
~30%
Uandishi wa msimbo wa kila siku
⚡ Aggressive
~50%
Vikao virefu vyenye zana nyingi
🔥 Ultra
~75%
Uokoaji wa juu zaidi
🧰 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 ambayo komponenti yako ya React inajirejea upya inawezekana ni kwa sababu unaunda rejeleo jipya la kitu kila mzunguko wa uchoraji upya. Unapopitisha kitu cha ndani kama prop, ulinganishaji wa juu-juu wa React huona kama kitu tofauti kila mara, jambo linalosababisha uchoraji upya. Ningependekeza kutumia useMemo kuhifadhi kitu hicho."_
>
> **Baada (tokeni 19):** _"Rejeleo jipya la kitu kila uchoraji. Prop ya kitu cha ndani = rejeleo jipya = uchoraji upya. Ifunge kwa useMemo."_
>
> **Jibu lilelile. Tokeni 72% chache. Hakuna upotezaji wa usahihi.** ✅
**Mfano wa PT-BR — hali ya [Troglodita](https://github.com/leninejunior/troglodita):**
> **Kabla (tokeni 42):** _"Tatizo ni kwamba kijenzi kinarejeshwa upya kwa sababu rejeleo jipya la kitu linaundwa katika kila mzunguko wa uonyeshaji. Ningependekeza kutumia useMemo."_
>
> **Baada (tokeni 12):** _"Urejeshaji upya: rejeleo jipya kila mzunguko (kitu cha inline kinaundwa upya). Tumia `useMemo`."_
>
> **Jibu lilelile. Takribani tokeni 70% chache. Usahihi wa kiufundi haujabadilika.** ✅
### 🎚️ Zaidi ya injini — mitindo ya matokeo, kidhibiti kinachojirekebisha na udhibiti kwa kila ombi
Injini 12 zilizo hapo juu hupunguza kile kinachoingia **ndani**. Tabaka nyingine tatu huamua **jinsi**, **wakati**, na kile kinachotoka **nje**:
- **🪄 Mitindo ya Matokeo** _(uelekezaji wa mhimili wa matokeo)_ — huingiza maagizo thabiti, salama kwa akiba, ya kuunda umbo la majibu; yanaweza kuunganishwa, kila moja katika kiwango cha `lite` / `full` / `ultra`. Kuongeza mtindo ni ingizo la mstari mmoja kwenye sajili:
- **Nathari fupi** — ondoa maneno ya kujaza / vihisishi / lugha ya kusitasita; hifadhi maudhui ya kiufundi kwa usahihi.
- **Msimbo mchache** — YAGNI ya "msanidi mkuu mvivu": badiliko dogo zaidi linalofanya kazi, bila miundombinu ambayo haijaombwa.
- **Ponytail (msanidi mkuu mvivu)** — panda ngazi ya YAGNI, rekebisha chanzo cha tatizo, tofauti ndogo zaidi inayofanya kazi.
- **Nina ADHD (hatua kwanza)** — anza na hatua inayofuata, hatua ziwekwe nambari, hatua moja mahususi inayofuata, bila utangulizi.
- **CJK fupi (文言)** — mtindo mfupi sana wa Kichina cha kale (umewekewa kikomo cha lugha ya `zh`).
- **🎯 Bajeti ya muktadha inayojirekebisha** _(kidhibiti)_ — badala ya kiwango kimoja cha tokeni cha kuwasha/kuzima, ongeza matumizi ya injini za gharama ya chini na zisizopoteza taarifa kadiri tu inavyohitajika ili **kutoshea dirisha la muktadha la modeli**. Sera: `reserve-output` (chaguo-msingi, inayotambua modeli) · `percentage` · `absolute`. Modi: `floor` (hakikisha inatoshea) · `replace-autotrigger` (chaguo lako bayana linashinda) · `off` (kiwango cha zamani).
- **🎛️ Mahali ambapo mgandamizo huamuliwa** _(kipaumbele, juu → chini)_ — kichwa cha kila ombi cha `x-omniroute-compression` › ubatilishaji wa mchanganyiko wa uelekezaji › wasifu hai uliopewa jina › unaojirekebisha / kichochezi otomatiki › chaguo-msingi la paneli › imezimwa. Mpango uliotumika hurejeshwa katika kichwa cha jibu cha `X-OmniRoute-Compression: ; source=`.
Tumia kichochezi otomatiki kulingana na kiwango cha tokeni, washa kidhibiti kinachojirekebisha, bandika wasifu uliopewa jina, weka chaguo la mara moja kwa kila ombi, au gawa mtiririko wa hatua kwa kila mchanganyiko wa uelekezaji — lolote linalofaa mzigo wa kazi. **Zana ya tathmini** ya nje ya mtandao inayohitaji kuwashwa (`npm run eval:compression`) hupima uaminifu dhidi ya akiba kwenye mkusanyiko wa data uliobandikwa kabla hujakuza 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)
# ⚡ Kuanza 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 jipya zaidi?** npm inaweza kuzuia hati za mzunguko wa maisha wa kifurushi isipokuwa ziruhusiwe. `postinstall` ya OmniRoute (`node scripts/build/postinstall.mjs`) inahitajika ili kuandaa faili zake asilia za mazingira ya utekelezaji. Ruhusu vifurushi vilivyotajwa katika onyo la npm unaposakinisha kwa mfumo mzima. Kwa seti ya vifurushi iliyoripotiwa na OmniRoute 3.8.53:
>
> ```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 mfumo mzima, isanidi mara moja, kisha sakinisha 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 vitegemezi inaweza kubadilika kati ya matoleo; ikiwa npm itaripoti orodha tofauti, tumia majina ya vifurushi kutoka kwenye onyo hilo. Kuruhusu kifurushi kunaruhusu hati zake za usakinishaji kuendeshwa.
> **Unatumia Gemini Web au mtoa huduma mwingine wa vidakuzi vya wavuti?** Kifurushi cha npm kinajumuisha
> Playwright lakini hakijumuishi faili yake tendaji ya Chromium. Soma dokezo la
> [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 `http://localhost:20128` · API iko `http://localhost:20128/v1`.
**2) Unganisha mtoa huduma anayestahiki kwa kutumia 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 yake. Viwango visivyolipishwa vinaweza kuhitaji kujisajili, kuidhinishwa au kuweka njia ya malipo. Pitia [Mwongozo wa Viwango Visivyolipishwa](docs/getting-started/FREE-TIERS-GUIDE.md); upatikanaji bila ufunguo hauhakikishwi, na watoa huduma waliotiwa alama `tos: avoid` huondolewa kwenye `auto` kwa chaguo-msingi.
**3) Elekeza zana yako ya kuandika msimbo**
```txt
URL Msingi: http://localhost:20128/v1
Ufunguo wa API: [nakili kutoka Dashibodi → Vituo vya Muunganisho]
Modeli: auto (huelekeza kati ya miunganisho inayostahiki — 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 kwenye orodha. 🎉 Ni hayo tu — anza kuandika msimbo, na OmniRoute itakuelekezea kiotomatiki na kutumia chaguo mbadala inapohitajika.
Ikiwa kiteja chako hakiwezi kutuma vichwa maalum, OmniRoute pia hutoa majina mbadala ya uoanifu yenye tokeni:
```txt
Katalogi ya OpenAI: http://localhost:20128/vscode/YOUR_KEY/
Modeli za OpenAI: http://localhost:20128/vscode/YOUR_KEY/models
Gumzo la OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions
Majibu ya OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses
Gumzo la Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
Lebo za Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Tumia hizi kwa viteja tu ambavyo haviwezi kuambatisha `Authorization: Bearer ...`. Uthibitishaji kupitia kichwa bado ndio modi inayopendelewa.
## 📦 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 wenye mawanda wa MCP · AES-256-GCM kwa data iliyohifadhiwa · DOMPurify
Ufichaji
wreq-js — uigaji wa alama za vidole za JA3 / JA4 TLS, proksi ya ngazi 3
Ustahimilivu
Kikatiza saketi, ucheleweshaji unaoongezeka kwa kasi, uzuiaji wa msongamano wa maombi ya wakati mmoja, kujirekebisha kiotomatiki kwa michanganyiko
Uwekaji kumbukumbu
pino — kumbukumbu za JSON zilizopangwa zenye muktadha wa ombi
Majaribio
Kiendeshaji cha majaribio cha Node.js + Vitest — matamko 56,000+ ya majaribio tuli katika faili 7,800+ za majaribio zinazofuatiliwa (kitengo, ujumuishaji, E2E, usalama, mfumo-ikolojia)
Mkakati wa ufunikaji wa majaribio kwa matamko 56,000+ ya majaribio tuli katika faili 7,800+ za majaribio zinazofuatiliwa
# ⭐ Wachangiaji Wakuu
> OmniRoute inaundwa na jumuiya ya chanzo huria yenye shauku. Watu hawa wamefanya michango ya kipekee inayoathiri moja kwa moja ubora, uthabiti, na ufikiaji wa mradi. **Asanteni.**
### Wachangiaji wa nje kwa maombi ya kuvuta yaliyounganishwa
Sensa ilifanyika 2026-10-18 15:09:09 UTC ikiwa na ncha hai ya release/v3.8.52656f01cb43. Sensa ya GitHub GraphQL yenye kurasa ina PR 9,191 zilizounganishwa: 3,834 za mmiliki wa hazina, 229 za Dependabot, 6 za boti/apliketa nyingine, na PR 5,122 za nje kutoka wachangiaji 835 tofauti. “Mistari iliyobadilishwa” ni nyongeza + ufutaji wa GitHub na inajumuisha faili zilizotengenezwa, faili za lock, katalogi, tafsiri na nyaraka; ni mabadiliko mengi, si LOC zilizoandikwa. PR 49 zinaripoti tofauti za GitHub zilizo juu ya mistari 500,000 (kwa mfano #13399, nyongeza moja ya mtoa huduma, inaorodhesha faili 2,347 zilizobadilishwa), jambo linalokweza jumla kadhaa hapo juu. Walio sawa wamepangwa pamoja.
### Commits zinazohusishwa na GitHub
Imeangaliwa upya tarehe 2026-10-18 14:44:45 UTC: commits zinazohusishwa na GitHub zilizoripotiwa na API ya Contributors ya hazina kwa tawi chaguo-msingi la release/v3.8.52. API ilirudisha vitambulisho 849 (watumiaji 429, boti 2, 418 visivyojulikana); jedwali hili halijumuishi mtunza hazina, boti na vitambulisho visivyojulikana na huhifadhi nafasi zilizofungana. Ni tofauti na orodha ya nafasi ya PR zilizounganishwa iliyo juu na sensa ya metadata ya Git iliyo chini.
> 🙏 Vipengele, marekebisho ya hitilafu, na maboresho ya miundombinu ya wachangiaji hawa ni **sehemu ya msingi** ya kile kinachofanya OmniRoute kutegemewa na kuwa na vipengele vingi. Kila pull request, kila kesi ya majaribio, na kila faili ya tafsiri ya i18n ni muhimu. Chanzo 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 900+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Ilifanyiwa ukaguzi tarehe 2026-10-18 kwenye ncha ya moja kwa moja ya release/v3.8.52, ad160ab2d1 (commit 6,826): vitambulisho 993 vya kawaida vya wanadamu kwenye Git — 707 vinaonekana kama watunzi wa commit (ikiwemo mtunzaji) na 286 vinaonekana tu kwenye viambatisho dhahiri vya Co-authored-by. Sensa hutumia .mailmap, hulinganisha anwani za barua pepe bila kujali herufi kubwa au ndogo, huunganisha anwani za GitHub noreply za nambari na za kawaida ikiwa tu zinasimba jina lilelile la mtumiaji, huondoa vitambulisho 26 vya bot/ajenti/huduma/vishikilia nafasi, na haiunganishi anwani za kawaida za barua pepe kwa sababu tu majina yake yanayoonyeshwa yanafanana. Ukaguzi wa 2026-08-24 ulichapisha idadi ya 639; mbinu hii ilipoendeshwa tena kwenye msingi wa ukaguzi huo wa ac02c5b42f ilitoa 619, kwa hivyo ongezeko hilo linatokana na wachangiaji wapya, si mbinu yenye masharti mepesi zaidi.
### Jinsi ya Kuchangia
1. Tengeneza fork ya hazina
2. Unda tawi kutoka kwenye ncha **inayotumika** ya `release/vX.Y.Z` (si `main`) — tazama [Muundo wa Matawi na Matoleo](docs/ops/BRANCHING_MODEL.md)
3. Unda tawi lako la kipengele (`git checkout -b feat/amazing-feature`)
4. Wasilisha mabadiliko yako (`git commit -m 'feat: add amazing feature'`)
5. Sukuma kwenye tawi (`git push origin feat/amazing-feature`)
6. Fungua Pull Request yenye **base = tawi hilo la `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 imesimama juu ya mabega ya wabobezi. Ilianza kama fork ya **[9router](https://github.com/decolua/9router)** na uhamishaji kwenda TypeScript wa mradi wa Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — na kuanzia hapo, kila mfumo mdogo ulio hapa chini ulitiwa moyo na mradi wa programu huria uliotangulia. Kila mmoja uliunda sehemu mahususi ya OmniRoute. Hii ni shukrani yetu kwao wote. 🙏
> ⭐ idadi za nyota zilithibitishwa kupitia REST API ya GitHub mnamo Oktoba 18, 2026 — nendeni mkaipatie miradi hii nyota. Idadi hizi ni taswira kamili ya tarehe hiyo na kwa kawaida zitabadilika.
### 🧬 Chimbuko na lango
Lango la AI ambalo mkusanyiko wake wa data ya bei za umma unawezesha usawazishaji wetu wa ufuatiliaji wa gharama na ambalo muundo wake wa kusawazisha watoa huduma ulisaidia kubuni uelekezaji wetu.
Chanzo cha MIT kilichorekebishwa katika daraja lililojumuishwa la ChatGPT Web → Codex Responses, likiwemo kipindi cha kivinjari, upangaji wa fremu za majibu, matumizi na adapta za utafutaji wa wavuti.
Miundo iliyohamishwa katika urejeshaji wa mtiririko, lakabu za kutofikiri, utafutaji mbadala wa wavuti, vikomo vya dirisha linalosogea, ufichaji wa data nyeti kwenye kumbukumbu na mitiririko iliyoimarishwa ya kizindua.
Chaguo-msingi za ubadilishaji zinazooana na Claude Code pamoja na tabia ya vichwa vya malipo zilizofanywa kuwa za jumla katika daraja la OmniRoute linaloendeshwa na usanidi.
Ulinganishaji wake wa modeli za Grok, jenereta ya Statsig ya TypeError bandia, chaguo-msingi za ombi na kifaa, pamoja na kichakataji cha majibu cha NDJSON vilirekebishwa kwa kiasi kikubwa katika kitekelezaji cha Grok Web cha OmniRoute.
Chanzo kikuu cha msimbo wa mpito kilicho nyuma ya grok2api-merged; utekelezaji wake wa modeli, kichwa, payload, Statsig na kichakataji umehifadhiwa katika chimbuko la Grok Web.
Chanzo msingi cha MIT cha payload ya Grok na chaguo-msingi za kifaa, jenereta ya Statsig na kichakataji cha result.response kilichopitishwa kupitia TQZHR na grok2api-merged.
Chanzo cha mpito kilichotambuliwa na grok2api-merged kwa safu yake ya mkusanyiko wa proksi; OmniRoute inahifadhi taarifa hiyo ya chimbuko lakini haidai kuwa imehamisha mkusanyiko wa proksi katika kitekelezaji chake cha Grok Web chenye mipaka.
Proksi yake ya Grok inayothibitishwa kwa cookie na muundo wa utiririshaji wa result.response.token ilisaidia kubuni usafirishaji wa Grok Web wa OmniRoute.
Utekelezaji asili wa Grok Web ulirejelea muundo wake wa HTTP/kivinjari wa huduma ya juu; njia yake ya moja kwa moja ya HTTP inatokana na GrokProxy, kwa hivyo hakuna uhamishaji huru wa msimbo unaodaiwa.
Mradi uliosambaa sana wa "kwa nini utumie tokeni nyingi wakati chache zinatosha" — falsafa yake ya lugha ya watu wa mapangoni ndiyo msingi wa hali yetu ya kawaida ya ubanaji na kanuni zaidi ya 30 za kuondoa maneno ya ziada/kufupisha.
Ubanaji wenye utendaji wa juu wa matokeo ya amri — ulihamasisha injini yetu ya RTK, DSL ya vichujio vya JSON, urejeshaji wa matokeo ghafi na mnyororo uliopangwa wa RTK → Caveman.
Utafiti wa ubanaji wa vidokezo (LLMLingua / LLMLingua-2) — ulihamasisha injini yetu ya llmlingua isiyosawazishwa, salama kwa msimbo na inayoruhusu mwendelezo ikishindwa.
Ubanaji wa tokeni za pt-BR — huendesha kifurushi chetu cha lugha cha pt-BR: upunguzaji wa urudiaji wa maana na uondoaji wa maneno ya ziada ulioboreshwa kwa sarufi ya Kireno cha Brazili.
Ujuzi uliosambaa sana wa msanidi mkuu "mvivu" wa kuandika msimbo kwa kanuni ya YAGNI — ulihamasisha Mtindo wetu wa Matokeo wa less-code: mwongozo wa kufanya badiliko dogo zaidi linalofanya kazi, unaopunguza msimbo _unaozalishwa_ (ndugu wa mhimili wa matokeo wa nathari fupi ya Caveman).
Ubanaji wa matokeo unaotambua maudhui kulingana na kila aina ya faili, ukiwa na usitishaji unaozingatia kushindwa — ulithibitisha uelekezaji wetu kulingana na aina na urukaji pale faida inapokuwa chini ya kiwango cha chini.
"Tafuta tokeni hewa" — muundo wake wa kuhamishia mzigo kwingine pamoja na kishikio kinachoweza kurejeshwa uliongoza fikra zetu kuhusu kuhamishia CCR kwingine.
JSON ya kisafu ya Rust pamoja na urejeshaji unaotegemea anwani ya maudhui na uondoaji wa marudio katika ujumbe tofauti — ulithibitisha usanifu wa injini zetu za headroom/ccr/session-dedup na kanuni thabiti kwa akiba kwamba "umbo lililobanwa halitegemei nafasi".
Ukamataji/uchanganuzi wa MITM wa trafiki kati ya msaidizi wa uandishi wa msimbo ↔ LLM uliathiri mahitaji ya awali ya Kikaguzi cha Trafiki. Moduli nne zilizokuwa zimetoholewa hapo awali — kuunganisha SSE, kusawazisha mazungumzo, kuficha siri na kusafisha vichwa — zimebadilishwa na utekelezaji huru wa clean-room unaotegemea viwango vya itifaki vya umma. Sehemu mbili za upitishaji wa moja kwa moja kwa seva pangishi (passthrough.ts na _internal/bypass.cjs) zinasalia kuwa utekelezaji wa ndani wa OmniRoute uliowekwa katika uainishaji tofauti; hazikuandikwa upya kama sehemu ya ubadilishaji huo.
Uelekezaji wa proksi ya uwazi kwa kila mchakato — ulihamasisha uzimaji wetu wa MITM unaostahimili hitilafu, muda wa kuisha wa soketi zisizotumika, uhusishaji wa michakato kupitia /proc na ukamataji wa TPROXY.
Orodha iliyoratibiwa ya maktaba zilizo salama kwa chaguo-msingi ambayo inaongoza maamuzi yetu ya usalama (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ilihamasisha uondoaji wa maombi yanayojirudia, njia mbadala ya dharura isiyo na gharama, mikakati inayoweza kuunganishwa ya Auto-Combo na uainishaji wa nia kwa lugha nyingi.
Urekebishaji wake wa uhusishaji wa modeli unaozingatia akaunti, uthibitishaji wa njia ya faili tekelezi na tabia ya lebo za mipango viliathiri mazingira ya utekelezaji ya Antigravity ya OmniRoute.
Ilitambua sehemu ya mgao ya Grok Build; kisha OmniRoute ilithibitisha na kusahihisha kwa kujitegemea muundo wa moja kwa moja wa data inayopitishwa.
## 📄 Leseni
Leseni ya MIT - tazama [LICENSE](LICENSE) kwa maelezo.
---
**[⬆ Rudi juu](#-omniroute)** · Imeundwa kwa ❤️ kwa ajili ya jumuiya ya AI ya chanzo huria.
OmniRoute v3.8.53 · Node ≥22.22.2 · Leseni ya MIT · omniroute.online