## 💰 ~Tokeni Bilioni 1.62 / Mwezi Kupitia Viwango vya Bila Malipo vya Watoa Huduma Wengine
> **Tumia akaunti zako mwenyewe za watoa huduma.** Haya ni makadirio ya jumla ya viwango vya bila malipo vya watoa huduma wengine ambavyo kila kimoja kina masharti yake ya ustahiki, si mgao wa tokeni kutoka OmniRoute. Jisajili, pata vitambulisho inapohitajika, na uunganishe watoa huduma unaoweza kutumia; kila mtoa huduma hudhibiti vikomo, upatikanaji na masharti yake.
>
> Kuunganisha viwango vya bila malipo mwenyewe ni kazi ngumu — SDK nyingi, vikomo vingi vya kasi, na hujui una kiasi gani kwa hakika. OmniRoute inaorodhesha **vipengee 489 vya viwango vya bila malipo katika funguo 35 za hifadhi zinazojirudia** na hukokotoa jumla ya tokeni kutoka kwenye **hifadhi 17 zenye bajeti chanya ya kila mwezi iliyochapishwa pamoja na vikomo vitano vya Groq vya kila modeli**, huku ikiondoa marudio kulingana na hifadhi inayoshirikiwa. Mgao unaofunguliwa tu baada ya ukaguzi wa utambulisho wa kikanda (kwa sasa: ModelScope) unaonyeshwa kando, +~6M baada ya uthibitishaji wa utambulisho wa kikanda, na kamwe haujumuishwi 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 (kuondoa marudio ya hifadhi, 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 kwa pande zote mbili** — mtoa huduma akisitisha kiwango cha bila malipo, idadi hushuka; kipya kikiongezwa, idadi hupanda. Tunachapisha kile ambacho katalogi hukokotoa kwa hakika, kamwe si makadirio bora yaliyoongezwa.
⭐ Weka nyota kwenye repo 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 — uwe wa kwanza kupata 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)**
## 📈 Lango Linaendelea Kukua
| | v3.8.50 | **v3.8.51** | `v3.8.52+` |
| ----------------------------------------------- | :----------------------: | :---------: | :-------------------: |
| 🌐 Watoa huduma | 352 | **358** | 372 |
| 🧠 Vitambulisho vya kipekee vya modeli za gumzo | 1320 | **1374** | 1443 |
| 🖼️ Daraja la Aina za Data | 🆕 kuona + sauti + video | ✓ | ✓ |
| 📡 Katalogi ya bure ya Radar | 🆕 hiari | ✓ | ✓ |
| ⚖️ Upangaji unaozingatia mgao | 🆕 Quota-Share | ✓ | ✓ |
| 📊 Telemetria ya mgao | 🆕 moja kwa moja | ✓ | ✓ |
| 🧰 Modi isiyo na kiolesura | — | — | 🆕 `serve --headless` |
| 🛤️ Miundombinu ya mkondo wa LTS | — | — | 🆕 njia za matoleo |
**→ [Ramani ya Maendeleo](ROADMAP.md) — tukisafiri kwenye mkondo kuelekea `v3.9.0 LTS`**
## 🧩 Inapatikana
[](https://www.npmjs.com/package/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](LICENSE)
```bash
# Baada ya kuunganisha mtoa huduma, nakili ufunguo wako wa OmniRoute 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 inayostahiki. Usakinishaji mpya unaweza kukosa malengo yanayostahiki yasiyohitaji ufunguo, na mtoa huduma asiyehitaji ufunguo anaweza kukataa kiteja cha mhusika mwingine. Watoa huduma waliotiwa alama `tos: avoid`, ikiwemo OpenCode Free na Kiro, huondolewa kwenye uelekezaji otomatiki kwa chaguo-msingi; kuunganisha akaunti hakubatilishi mpangilio huo. Angalia [Mwongozo wa Viwango vya Bila Malipo](docs/getting-started/FREE-TIERS-GUIDE.md) kabla ya kuchagua mtoa huduma.📦 Hati za kuanza haraka 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 msururu wa modeli ambao OmniRoute huelekeza maombi kupitia modeli hizo **kiotomatiki**. Kiwango kinachoruhusiwa kikiisha, mtoa huduma akishindwa, au gharama zikipanda ghafla, combo inaweza kuhamia kwenye modeli inayofuata inayostahiki na inayofanya kazi vizuri. 🛡️
### ⚡ Hakuna usanidi — tumia tu `auto`
Hakuna combo ya kuunda. Weka modeli yako kuwa `auto` (au lahaja yake), na OmniRoute itaunda combo pepe kutoka kwa watoa huduma uliounganisha, huku ikikokotoa alama papo hapo:
Kitambulisho cha Modeli
Kile inachoboresha
auto
🎯 Chaguo-msingi lenye uwiano (LKGP — hubaki kwa mtoa huduma wako wa mwisho aliyefanya kazi vizuri)
auto/coding
🧑💻 Uzani unaotanguliza ubora kwa ajili ya kutengeneza msimbo
auto/fast
⚡ Huanzia kwa muda wa chini zaidi wa kusubiri
auto/cheap
💰 Huanzia kwa gharama ya chini zaidi kwa tokeni
auto/offline
🔋 Huanzia kwa nafasi kubwa zaidi ya kiwango kinachoruhusiwa / kikomo cha kasi
auto/smart
🔭 Hutanguliza ubora + uchunguzi wa 10% ili kugundua modeli bora zaidi
auto/lkgp
📌 Kushikamana waziwazi na mtoa huduma wa mwisho aliyejulikana kufanya kazi vizuri
auto/chaos
🧪 Husambaza kwa sambamba kwa jopo la modeli (moja kwa kila mtoa huduma, 5 kwa chaguo-msingi), kisha hurejesha jibu moja; ombi moja la upstream kwa kila modeli ya jopo, si uingizaji wa hitilafu
##
### 🔀 Au unda yako mwenyewe — mikakati 19 ya uelekezaji
Mikakati yote **19** — changanya na kuoanisha kwa kila hatua ya combo:
#
Mkakati
Kile inachofanya
1
priority
Orodha iliyopangwa kwa lengo la kwanza — tumia kila moja hadi iishe kabla ya inayofuata 🥇
2
fill-first
Tumia kiwango chote kinachoruhusiwa cha kila lengo kabla ya kuendelea
3
weighted
Uteuzi nasibu wenye uzani kulingana na uzani wa kila lengo
4
round-robin
Pitia malengo kwa zamu 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 sawia (marudio yameondolewa)
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
reset-window
Pendelea lengo ambalo dirisha lake la kiwango kinachoruhusiwa litawekwa upya mapema zaidi
12
reset-aware
Panga kwa muda wa kuweka upya kiwango kinachoruhusiwa — madirisha mafupi kwanza 📊
13
context-relay
Hamisha muktadha kati ya malengo kwa mazungumzo marefu 🧠
14
context-optimized
Chagua lengo linalofaa zaidi kwa ukubwa wa sasa wa muktadha
15
cache-optimized
Unganisha kila kiambishi awali cha kidokezo kinachoweza kutumika tena na akaunti ileile — ongeza kwa kiwango cha juu mafanikio ya akiba ya vidokezo 🎯
16
lkgp
Njia ya Mwisho Iliyojulikana Kufanya Kazi Vizuri — hushikamana na mtoa huduma wa mwisho aliyefanikiwa, kisha hutumia kanuni mbadala ikishindwa
17
auto
Ukokotoaji wa alama wa moja kwa moja kwa kutumia vipengele 16 katika kila muunganisho 🤖
18
fusion
Sambaza kwa jopo la modeli + mwamuzi huunganisha jibu moja 🧬
19
pipeline
Unganisha hatua — matokeo ya kila lengo huingizwa kwenye linalofuata 🔗
Injini ya Auto-Combo hukokotoa alama za kila mtahiniwa kwa kutumia **vipengele 16** (hali ya utendaji, kiwango kinachoruhusiwa, gharama, muda wa kusubiri, ufaafu kwa kazi, ubora, upatikanaji wa kipindi…) — tazama [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Ustahimilivu umejengewa ndani (tabaka 3 huru)
📖 [Injini ya Mseto Otomatiki](docs/routing/AUTO-COMBO.md) · [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Kinachoitofautisha OmniRoute
📊 Mbinu kamili & maelezo ya kila kipengele yakilinganishwa 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)**.
## ✨ Mambo Mapya
> Muhtasari wa hivi karibuni kutoka **v3.8.20 → v3.8.50**. Historia kamili ipo katika [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — ugawaji wa A2A unaoingia kwa kundi lako la mawakala, ujuzi wa Conductor kwenye Kadi ya Wakala, na paneli ya dashibodi yenye gumzo la sauti la Faro la bonyeza-ili-kuongea. → [Seva ya A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Udhibiti unaobadilika wa upokeaji na ulinzi dhidi ya mzigo kupita kiasi** — maombi mazito ya gumzo huwekwa kwenye foleni badala ya kurudisha 503, yakitumia ukodishaji atomiki wa RPM unaosogea kwa kila muunganisho. → [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Mpangilio sanifu wa `/v1/models`** — bloku moja mfululizo iliyopangwa kwa mtoa huduma kwa kila mtoa huduma (michanganyiko ikiwekwa kwanza), thabiti katika kila chanzo cha katalogi. → [Rejeleo la API](docs/reference/API_REFERENCE.md)
- **🗜️ Uimarishaji wa mfinyazo** — kinga dhidi ya upanuzi iliyowashwa kwa chaguo-msingi, vifurushi vya Caveman vya DE / FR / JA + Kichina (wényán), vichujio vya RTK vya Gradle na .NET. → [Mfinyazo](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Gharama ya kiwango kisichobadilika iliyo wazi** — watoa huduma wa usajili / mpango wa uandishi wa msimbo huonyesha **$0** katika uchanganuzi wa gharama; bajeti, mgao na uelekezaji huendelea kufanya makadirio. → [Rejeleo la API](docs/reference/API_REFERENCE.md)
- **⚖️ Uelekezaji wa Quota-Share** — gawanya mgao wa akaunti iliyoshirikiwa kwa haki kati ya funguo zilizowekwa pamoja, huku rasilimali zikiendelea kutumika kwa kukopesha sehemu zisizotumika. → [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Usanidi wa CLI/wakala kwa amri moja** — amri 13 za `setup-*` zilizosajiliwa; `omniroute run` huanzisha CLI 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` hutumia malengo 10 yenye kiteua shirikishi cha mtoa huduma+modeli na vipendwa kwa kila muktadha. → [Miunganisho ya CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Hali ya mbali** — dhibiti OmniRoute ya mbali kwa tokeni zenye upeo (`connect` / `contexts` / `tokens`) pamoja na kisaidizi cha OAuth cha `antigravity` kwa usakinishaji wa VPS. → [Hali ya Mbali](docs/guides/REMOTE-MODE.md)
- **🧭 Uelekezaji otomatiki wenye akili zaidi** — michanganyiko ya `auto/:`, **Fusion** (paneli ya modeli + mwamuzi), uelekezaji unaozingatia jukumu, na ubatilishaji wa modeli / hali / bajeti ya USD kwa kila ombi. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Mfinyazo unaoweza kupachikwa** — injini 12 zinazoweza kuunganishwa + Compression Studios: LLMLingua-2, Ultra ya ngazi mbili, omniglyph, lango la uaminifu kwa kila hatua, GCF v3.2, na kihariri cha kuburuta ili kupanga upya. → [Mfinyazo](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Usimbuaji fiche wa uwazi wa MITM (TPROXY)** — nasa CLI zinazopuuza vigeu vya mazingira vya proksi, kwa kutumia CA ya kila SNI pamoja na kisakinishaji 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 kutokana na cache-HIT, na mgao wa matumizi wa USD kwa kila ufunguo. → [Rejeleo la API](docs/reference/API_REFERENCE.md)
- **🧠 Kumbukumbu unayoidhibiti** — imezimwa kwa chaguo-msingi, ukadiriaji wa vekta wa int8 wa kujijumuisha + upunguzaji uliowekewa aina, na `x-omniroute-no-memory` kwa kila ombi. → [Kumbukumbu](docs/frameworks/MEMORY.md)
- **🛡️ Usalama** — kinga dhidi ya udungaji wa prompt kwenye kila njia ya LLM (mkusanyiko wa majaribio ya red-team), kinga ya hiari ya kuficha vitambulisho (huficha funguo/siri za API zilizovuja katika pande zote mbili), utafutaji wa wavuti wa bure wa DuckDuckGo kama suluhisho la mwisho, na lango la hiari la kuingia kwa OIDC kwa dashibodi (uingiaji kwa nenosiri hubaki ukipatikana kila wakati). → [Vizuizi vya Usalama](docs/security/GUARDRAILS.md)
- **🖼️ Endpoint mpya** — `/v1/ocr` (Mistral OCR) na `/v1/audio/translations` (mtindo wa Whisper) hukamilisha huduma za media. → [Rejeleo la API](docs/reference/API_REFERENCE.md)
- **🎨 Uzalishaji wa picha / video / sauti** — API moja ya media: video za xAI Grok Imagine na Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, na watoa huduma za sauti kama ElevenLabs. → [Rejeleo la API](docs/reference/API_REFERENCE.md)
- **🌍 Utekelezaji na uendeshaji** — `basePath` ya proksi ya nyuma, utambuzi otomatiki wa lugha ya kivinjari, ufuatiliaji wa vifaa kwa kila ufunguo, uaminifu wa MITM usiohitaji root, 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 + uingiaji wa OAuth, kadi asilia ya Ollama, Claude Opus 5 na Sonnet 5, ushirikiano rasmi na Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… pamoja na **katalogi ya watoa huduma 352** iliyosasishwa. → [Watoa Huduma](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Uwazi wa uelekezaji** — kila jibu huwa na kichwa cha `X-OmniRoute-Decision` kinachotaja mkakati/mtoa huduma/ucheleweshaji uliolitumikia, mkakati mpya wa mchanganyiko wa `cache-optimized` pamoja na kipengele cha Auto-Combo cha `cacheAffinity` huelekeza maombi yanayorudiwa kwenye muunganisho unaohifadhi kiambishi awali kwenye kache, na endpoint ya kusoma pekee ya `/v1/auto-combo/{channel}/candidates` huonyesha kundi la sasa la wagombea la chaneli ya `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Utendaji na miundombinu ya ndani** — Redis ya ndani kwa mbofyo mmoja, vitekelezaji vya relay vya Cloudflare Workers / Deno Deploy, na Bifrost pamoja na Mux kama huduma zilizopachikwa na kusimamiwa. → [Huduma Zilizopachikwa](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Pia ndani ya kifurushi** — mfumo wa programu-jalizi + soko, mifumo ya ujuzi ya Omni/Agent/GitHub, muunganisho wa hazina ya Obsidian (zana 22 za MCP), API za Batch na Files zinazooana na OpenAI, kache ya kisemantiki ya majibu, uchezeshaji wenye bao za wanaoongoza, ugunduzi wa mawakala wa ACP (mawakala 15 waliojengewa ndani), uhamishaji wa kumbukumbu ulioratibiwa kwenda BigQuery, usambazaji sambamba kwa modeli nyingi wa `auto/chaos`, daraja la boti ya Telegram, kidhibiti cha matoleo 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 hufanya kazi kwa kutumia modeli za bure 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 36 (CLI Code 26 + 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 vinawekwa kwa kila mchakato, Qwen/Gemini hupata saraka ya nyumbani iliyotengwa na ya muda:
```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 maingiliano na uandike usanidi wa zana yenyewe:
omniroute configure codex # pia: claude opencode qwen aider goose gemini cline continue kilo
```
Kila amri huheshimu muktadha amilifu wa mbali (`omniroute connect `), `--dry-run`
huonyesha mapema env/args halisi bila kuzitekeleza, na `--api-key-env NAME` huzuia siri zisiingie
kwenye historia ya shell yako. → [Miunganisho ya CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 Watoa Huduma 372 wa AI — 154 Wametambulishwa kwenye Katalogi kuwa Bila Malipo
> **Watoa huduma 372 waliosajiliwa** katika mikusanyiko rasmi ya gumzo, midia, utafutaji, ya ndani, mawakala wa wingu na mfumo, ikijumuisha **154 wenye metadata ya ugunduzi ya `hasFree: true`**. Sajili ya modeli za gumzo inajumuisha **watoa huduma 237 / jozi 3,009 tofauti za mtoa huduma na modeli / vitambulisho 1,443 ghafi vya modeli**; katalogi tofauti ya bajeti isiyolipishwa ina **safu 491 kwa kila modeli**, **makundi 35 yanayojirudia** na **watoa huduma 54 wa kudumu bila malipo, wenye mgao unaojirudia/wasiohitaji ufunguo**. Hizi ni denomineta tofauti kimakusudi; ufafanuzi na hesabu zilizoondolewa urudufu wa makundi zinapatikana katika [Marejeleo ya Watoa Huduma](docs/reference/PROVIDER_REFERENCE.md) na [Viwango vya Matumizi Bila Malipo](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 wengine 330+ — kila ikoni hupatikana moja kwa moja kutoka kwenye katalogi ya watoa huduma ya dashibodi. 📖 [Marejeleo ya Watoa Huduma](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 Miundo 50+ Neuroni 10K kwa siku
NVIDIA NIM GLM, MiniMax Takriban RPM 40 bila malipo
Cerebras GLM 4.7, GPT-OSS Salio la mara moja la $5; kadi inahitajika
OpenRouter Miundo ya :free +$10 → RPM ya juu 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 na MCP
> Zaidi ya seva, OmniRoute ni **kituo kamili cha udhibiti cha mstari wa amri** chenye **amri 80+**, pamoja na itifaki wazi za mawakala ili wakala wa AI aweze kuiendesha **peke yake**.
### ⌨️ CLI halisi (si `start` pekee)
```bash
omniroute # endesha lango + dashibodi (porti 20128)
omniroute chat # kiteja shirikishi cha gumzo cha TUI (mikato: /model /combo /skill /memory)
omniroute setup # kiratibu kinachoongozwa cha matumizi ya kwanza
omniroute doctor # tambua matatizo ya watoa huduma, porti na vitegemezi asilia
```
### 🛰️ Hali ya mbali — endesha CLI hapa, OmniRoute kwenye VPS
OmniRoute iko kwenye seva? Iendeshe kutoka kwenye kompyuta yako mpakato kwa **CLI ileile**. Ingia mara moja
kwa tokeni ya ufikiaji yenye mawanda; baada ya hapo kila amri inalenga seva ya mbali.
```bash
omniroute connect 192.168.0.15 # nenosiri → tokeni yenye mawanda, imehifadhiwa kama muktadha
omniroute models list # ← huendeshwa 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 mawanda finyu zaidi kwa mashine nyingine
omniroute contexts use default # ← rudi kwenye seva ya ndani
```
Tokeni zina mawanda ya `read` / `write` / `admin`; njia zinazoanzisha michakato hubaki kwenye loopback pekee.
📖 [Hali ya Mbali](docs/guides/REMOTE-MODE.md)
### 🤝 Unganisha wakala — naye atadhibiti OmniRoute yenyewe
Fichua OmniRoute kupitia **MCP**, **A2A**, **REST API**, **webhooks** au **CLI ya mbali** — wakala yeyote mwenye uwezo (au msimbo wako mwenyewe) anapata udhibiti wa lango zima: uelekezaji, watoa huduma, michanganyiko, kache, ubanaji, kumbukumbu — kwa kujitegemea. Vituo vya HTTP vilivyo hapa chini vinapatikana chini ya `http://localhost:20128`.
Kiolesura
Kituo / 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, mawanda 33 (utekelezaji huwashwa kwa hiari), rekodi kamili ya ukaguzi
📡 MCP (SSE)
/api/mcp/sse
Usafirishaji wa MCP kwa mtiririko
🤝 A2A
/.well-known/agent.json
Wakala-kwa-wakala, JSON-RPC 2.0 + SSE, ujuzi 6
🌐 REST API
/v1/*
Inayooana na OpenAI — gumzo, upachikaji, picha, sauti, OCR
🔔 Webhooks
/api/webhooks
Sukuma matukio ya maombi / mgao kwenda Slack, Discord, Telegram au URL yoyote
🛰️ CLI ya Mbali
omniroute connect
Endesha mfumo wa mbali kwa tokeni za ufikiaji zenye mawanda
```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 Tokeni 15–95% — Kiotomatiki
### 📖 Jinsi inavyofanya kazi — mchakato, usanifu na hesabu za uokoaji
Mchanganyiko chaguomsingi uliopangwa kwa mfuatano huendesha `RTK → Caveman`. Zote mbili zinapofanya kazi kwenye mzigo uleule wa zana/muktadha, uokoaji huongezeka kwa pamoja:
```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 yenye muundo **hulindwa kila wakati** na injini ya uhifadhi.
> **Kwa nini utumie tokeni nyingi wakati chache zinatosha?** Kila ombi hupitia mchakato wa ukandamizaji wa OmniRoute **kwa uwazi** — hakuna mabadiliko kwa mteja. Sasa ni **mkusanyiko wa injini 12 zinazoweza kuunganishwa** ambazo huendeshwa kwa mpangilio na kuchanganywa kulingana na kila 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).
### 🧱 Mkusanyiko wa injini 12
Injini huendeshwa kwa mpangilio wa mchakato; kila moja inaweza kuwashwa au kuzimwa na kusanidiwa kivyake kwa kila mchanganyiko:
#
Injini
Inachofanya
1
Session-Dedup
Huondoa maudhui yanayorudiwa katika zamu mbalimbali (yanayotambuliwa kwa maudhui, baina ya zamu)
2
CCR
Huhifadhi vizuizi vikubwa nyuma ya alama za urejeshaji, na kuvileta vinapohitajika
3
Lite
Upunguzaji wa nafasi tupu + URL za picha (msingi wenye ucheleweshaji mdogo)
4
RTK
Uchujaji mahiri, uondoaji wa nakala na ufupishaji wa matokeo ya zana (unaotambua amri)
5
Responses Tool Output
JSON isiyopoteza data kwanza + ukandamizaji wenye mipaka wa taarifa za uchunguzi kwa matokeo ya shell/patch/search/build (Responses API)
6
Headroom
Ubanaji wa kijedwali usiopoteza data wa safu za JSON (~30%) kupitia kodeki iliyojumuishwa ya GCF
7
Relevance
Upangaji wa alama wa sentensi zilizotolewa kulingana na hoja ya mwisho ya mtumiaji
8
Caveman
Ukandamizaji wa nathari unaotegemea kanuni (~65–75% kwenye matokeo)
9
Aggressive
Ufupishaji + uchakavu wa hatua kwa hatua wa zamu za zamani
10
LLMLingua-2
Upogoaji wa kisemantiki wa ML kupitia MobileBERT ONNX — salama kwa msimbo, usawazishaji-huru
11
Ultra
Upogoaji wa tokeni wa kiheuristiki wenye kiwango cha hiari cha modeli ndogo (SLM)
12
OmniGlyph
Usimbaji wa majaribio wa muktadha-kama-picha kwa Claude Fable 5 iliyopimwa kwenye muunganisho wa moja kwa moja wa Anthropic; vibadilishaji vya GPT 5.6 hubaki vikiwa vimefungwa kwa usalama vikisubiri stakabadhi za mtoa huduma. Wasifu wanne wa ukandamizaji (aggressive chaguomsingi, balanced, coding-safe, passthrough) (mkali zaidi; huwashwa kwa hiari)
Vizuizi vya msimbo, URL na data yenye muundo **huhifadhiwa kila wakati** bila kubadilisha hata baiti moja. **Mipangilio tayari ya mbofyo mmoja** huunganisha injini:
Modi
Uokoaji
Inafaa zaidi kwa
🪶 Lite
~15%
Chaguomsingi salama linalowashwa kila wakati
🪨 Standard (Caveman)
~30%
Uandishi wa msimbo wa kila siku
⚡ Aggressive
~50%
Vipindi virefu vinavyotumia zana kwa wingi
🔥 Ultra
~75%
Uokoaji wa kiwango cha juu zaidi
🧰 RTK
60–90%
Matokeo ya shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Vidokezo mchanganyiko + kumbukumbu za zana
**Mfano halisi — modi ya Standard:**
> **Kabla (tokeni 69):** _"Sababu inayowezekana ya kijenzi chako cha React kuonyeshwa upya ni kwamba unaunda rejeleo jipya la kipengee katika kila mzunguko wa uonyeshaji. Unapopitisha kipengee cha ndani ya mstari kama prop, ulinganisho wa juu juu wa React hukitambua kama kipengee tofauti kila wakati, jambo linalosababisha uonyeshaji upya. Ningependekeza utumie useMemo kuhifadhi kipengee hicho."_
>
> **Baada (tokeni 19):** _"Rejeleo jipya la kipengee kila uonyeshaji. Prop ya kipengee cha ndani ya mstari = rejeleo jipya = uonyeshaji upya. Kifunge kwa useMemo."_
>
> **Jibu lilelile. Tokeni chache kwa 72%. Hakuna upotevu wa usahihi.** ✅
**Mfano wa PT-BR — modi ya [Troglodita](https://github.com/leninejunior/troglodita):**
> **Kabla (tokeni 42):** _"Tatizo ni kwamba kijenzi kinafanyiwa 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 inline kinaundwa upya). Tumia `useMemo`."_
>
> **Jibu lilelile. Tokeni chache kwa ~70%. Usahihi wa kiufundi haujabadilika.** ✅
### 🎚️ Zaidi ya injini — mitindo ya matokeo, kidhibiti badilifu na udhibiti kwa kila ombi
Injini 12 zilizo hapo juu hupunguza kile kinachoingia **ndani**. Tabaka nyingine tatu huamua **jinsi**, **wakati gani**, na kile kinachotoka **nje**:
- **🪄 Mitindo ya Matokeo** _(uelekezaji wa mhimili wa matokeo)_ — huingiza maagizo bainifu na salama kwa akiba yanayounda mwonekano wa majibu; yanaweza kuunganishwa, kila moja likiwa na kiwango cha `lite` / `full` / `ultra`. Kuongeza mtindo ni ingizo la mstari mmoja kwenye sajili:
- **Maelezo mafupi** — ondoa maneno ya kujaza / vihusishi / tahadhari zisizo za lazima; hifadhi maudhui ya kiufundi kwa usahihi.
- **Msimbo mchache** — YAGNI ya "msanidi mkuu mvivu": badiliko dogo zaidi linalofanya kazi, bila miundombinu ambayo haikuombwa.
- **Ponytail (msanidi mkuu mvivu)** — panda ngazi ya YAGNI, rekebisha chanzo cha tatizo, tumia diff ndogo zaidi inayofanya kazi.
- **Nina ADHD (kitendo kwanza)** — anza na hatua inayofuata, hatua ziwe na nambari, hatua moja mahususi inayofuata, bila utangulizi.
- **CJK fupi (文言)** — mtindo mfupi sana wa Kichina cha kale (unapatikana tu kwa lugha ya `zh`).
- **🎯 Bajeti badilifu ya muktadha** _(kidhibiti)_ — badala ya kiwango kimoja cha tokeni cha kuwasha/kuzima, ongeza matumizi ya injini nafuu zaidi na zinazopoteza taarifa kwa kiwango kidogo zaidi hadi pale tu panapohitajika ili **kutoshea dirisha la muktadha la modeli**. Sera: `reserve-output` (chaguo-msingi, huzingatia modeli) · `percentage` · `absolute`. Hali: `floor` (hakikisha inatoshea) · `replace-autotrigger` (chaguo lako bayana linapewa kipaumbele) · `off` (kiwango cha zamani).
- **🎛️ Mahali ambapo ufinyazaji huamuliwa** _(kipaumbele, juu → chini)_ — kichwa cha kila ombi `x-omniroute-compression` › ubatilishaji wa mchanganyiko wa uelekezaji › wasifu amilifu wenye jina › badilifu / kichochezi otomatiki › chaguo-msingi la paneli › kuzimwa. Mpango uliotumika hurudishwa kwenye kichwa cha jibu `X-OmniRoute-Compression: ; source=`.
Tumia kichochezi otomatiki kulingana na kiwango cha tokeni, washa kidhibiti badilifu, bandika wasifu wenye jina, weka mpangilio wa mara moja kwa kila ombi, au gawia pipeline kwa kila mchanganyiko wa uelekezaji — lolote linalofaa mzigo wa kazi. **Zana ya tathmini** ya nje ya mtandao na ya hiari (`npm run eval:compression`) hupima uaminifu dhidi ya kiasi kilichookolewa kwenye mkusanyiko wa data uliobandikwa 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)
# ⚡ Anza Haraka
**1) Sakinisha na uendeshe**
```bash
npm install -g omniroute
omniroute
```
> 💡 Unaona `npm warn ERESOLVE` au maonyo ya peer-dep? [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 kwenye onyo la npm wakati wa kusakinisha kimataifa. Kwa seti ya vifurushi iliyoripotiwa na OmniRoute 3.8.51:
>
> ```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 kimataifa wa baadaye, isanidi mara moja, kisha usakinishe kwa njia ya 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 huruhusu 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 tekelezi 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 ukamilishe mchakato wake wa akaunti. Viwango vya bila malipo vinaweza kuhitaji usajili, idhini, au njia ya malipo. Kagua [Mwongozo wa Viwango vya Bila Malipo](docs/getting-started/FREE-TIERS-GUIDE.md); upatikanaji bila ufunguo haujahakikishwa, na watoa huduma waliowekwa 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 → Endpoints]
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. 🎉 Imekamilika — anza kuandika msimbo, na OmniRoute itakuelekezea kiotomatiki na kutumia mbadala inapohitajika.
Ikiwa kiteja chako hakiwezi kutuma vichwa maalum, OmniRoute pia hutoa lakabu za uoanifu zilizo na 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 ambavyo haviwezi kuambatisha `Authorization: Bearer ...` pekee. Uthibitishaji kupitia kichwa unabaki kuwa 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-08-24 · Katalogi ghafi: YT 809 | TT 137 | IG 124 · Usasisho (siku): YT 1 | TT 21 | IG 22
OAuth 2.0 (PKCE) + JWT + API Keys + uthibitishaji wenye mawanda wa MCP · AES-256-GCM wakati data imehifadhiwa · DOMPurify
Usiri
wreq-js — uigaji wa alama za utambulisho za JA3 / JA4 TLS, proksi ya ngazi 3
Ustahimilivu
Kikatiza mzunguko, ucheleweshaji unaoongezeka kwa kasi, uzuiaji wa maombi mengi kwa wakati mmoja, mchanganyiko otomatiki wa kujirekebisha
Uwekaji kumbukumbu
pino — kumbukumbu za JSON zilizopangwa zenye muktadha wa ombi
Upimaji
Kiendesha majaribio cha Node.js + Vitest — matamko 39,000+ ya majaribio tuli katika faili 5,100+ za majaribio zinazofuatiliwa (kitengo, ujumuishaji, E2E, usalama, mfumo ikolojia)
Mkakati wa ufunikaji wa majaribio kwa matamko tuli 39,000+ ya majaribio katika faili 5,100+ za majaribio zinazofuatiliwa
# ⭐ Wachangiaji Wakuu
> OmniRoute imeundwa na jumuiya yenye ari ya programu huria. Watu hawa wametoa michango ya kipekee inayoathiri moja kwa moja ubora, uthabiti na ufikiaji wa mradi. **Asanteni.**
### Wachangiaji wa nje kulingana na maombi ya kuvuta yaliyounganishwa
Ilisimamishwa kwenye kilele cha moja kwa moja cha release/v3.8.50 cha dafb4ae808, ikiwa na miunganisho hadi 2026-08-24 05:26:03 UTC. Sensa ya GitHub GraphQL yenye upangaji wa kurasa ina PR 5,911 zilizounganishwa: 2,707 za mmiliki wa hazina, 179 za Dependabot, na PR 3,025 za nje kutoka kwa wachangiaji 535 tofauti. “Mistari iliyobadilishwa” ni nyongeza + ufutaji wa GitHub na inajumuisha faili zilizozalishwa, lockfiles, katalogi, tafsiri na nyaraka; ni kiasi cha mabadiliko, si LOC iliyoandikwa. Waliofungana kwenye kikomo wamejumuishwa.
### Commit zinazohusishwa na GitHub
Bob.Hou 🏅 commit 51 zinazohusishwa na GitHub · nafasi sawa ya #10
Xiangzhe 🏅 commit 51 zinazohusishwa na GitHub · nafasi sawa ya #10
Imekaguliwa tena saa 2026-08-24 06:14:31 UTC: commit zinazohusishwa na GitHub zilizoripotiwa na API ya Wachangiaji wa hazina kwa tawi chaguo-msingi la release/v3.8.50. API ilirejesha vitambulisho 525 (watumiaji 415, boti 2, wasiojulikana 108); jedwali hili halijumuishi msimamizi, boti na vitambulisho visivyojulikana, na linahifadhi nafasi zilizofungana. Ni tofauti na upangaji wa PR zilizounganishwa hapo juu na sensa ya watu 639 ya metadata ya Git hapa chini.
> 🙏 Vipengele, marekebisho ya hitilafu na maboresho ya miundombinu ya wachangiaji hawa ni **sehemu ya msingi** ya kinachoifanya OmniRoute kuwa ya kuaminika 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 unasaidia mradi uendelee kuwa bila malipo, huru na kusonga mbele.
… na wengine wanaopendelea kutotambulika 💛Wafadhili wa umma wa GitHub walithibitishwa upya tarehe 2026-08-24. Hali ya GitHub ya activeOnly ndiyo huamua lebo za wanaofadhili hai zilizo hapo juu; wafadhili wa umma wa mara moja waliotangazwa hapo awali wanaendelea kushukuriwa, na wafadhili wa faragha wanaendelea kutotambulishwa.💖 Kuwa mfadhili → — kila dola inasaidia OmniRoute iendelee kuwa bila malipo na huru.
## 👥 Wachangiaji 600+
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Ukaguzi ulifanywa tarehe 2026-08-24 kwenye msingi usiobadilika wa ac02c5b42f na kukaguliwa tena kwenye ncha hai ya release/v3.8.50 ya dafb4ae808: vitambulisho 639 vya Git vya watu vilivyosawazishwa — 407 vinaonekana kama waandishi wa commit (ikiwemo mtunzaji) na 232 vinaonekana tu katika trela dhahiri za Co-authored-by. Sensa hii husawazisha majina ya akaunti za GitHub za noreply, huondoa vitambulisho 26 vya bot/ajenti/huduma/vishikilia nafasi, na haiunganishi anwani za kawaida za barua pepe kwa sababu tu majina yao yanayoonyeshwa yanafanana.
### Jinsi ya Kuchangia
1. Tengeneza fork ya hazina
2. Anzia kwenye ncha **hai** ya `release/vX.Y.Z` (si `main`) — angalia [Muundo wa Matawi na Matoleo](docs/ops/BRANCHING_MODEL.md)
3. Unda tawi lako la kipengele (`git checkout -b feat/amazing-feature`)
4. Weka mabadiliko yako kwenye commit (`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`**
Angalia [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 juu ya kazi kubwa za wengine. 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 ulio hapa chini ulihamasishwa na mradi wa programu huria ulioutangulia. Kila mmoja uliunda sehemu mahususi ya OmniRoute. Hii ndiyo njia yetu ya kuwashukuru wote. 🙏
> ⭐ idadi ya nyota ilithibitishwa kupitia REST API ya GitHub mnamo Agosti 24, 2026 — nenda ukaipatie miradi hii nyota. Idadi hizi ni taswira kamili ya tarehe hiyo na kwa kawaida zitabadilika.
### 🧬 Asili na lango
Lango la AI ambalo seti yake ya data ya umma ya bei huwezesha ulandanishi wetu wa ufuatiliaji wa gharama na ambalo modeli yake ya kusawazisha watoa huduma iliongoza uelekezaji wetu.
Chanzo cha MIT kilichorekebishwa kuwa daraja lililojumuishwa la ChatGPT Web → Codex Responses, likijumuisha adapta za kipindi cha kivinjari, uundaji wa fremu za majibu, matumizi na utafutaji wa wavuti.
Miundo iliyohamishwa hadi kwenye urejeshaji wa mtiririko, lakabu zisizo na fikra, utafutaji mbadala wa wavuti, vikomo vya dirisha linalosogea, ufichaji wa taarifa nyeti kwenye kumbukumbu na mitiririko iliyoimarishwa ya kizinduzi.
Chaguo-msingi za ugeuzaji zinazooana na Claude Code na tabia ya vichwa vya malipo iliyofanywa iwe ya 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, na kichakataji cha majibu cha NDJSON vilirekebishwa kwa kiasi kikubwa katika kitekelezaji cha Grok Web cha OmniRoute.
Chanzo kikuu cha msimbo tegemezi nyuma ya grok2api-merged; utekelezaji wake wa modeli, vichwa, payload, Statsig na vichakataji umehifadhiwa katika nasaba ya Grok Web.
Chanzo tegemezi kilichotambuliwa na grok2api-merged kwa safu yake ya mkusanyiko wa proksi; OmniRoute huhifadhi taarifa hiyo ya nasaba lakini haidai kuhamisha mkusanyiko wa proksi katika kitekelezaji chake chenye mipaka cha Grok Web.
Utekelezaji wa awali wa Grok Web ulitumia muundo wake wa upstream wa HTTP/kivinjari; njia yake ya moja kwa moja ya HTTP inatokana na GrokProxy, kwa hivyo hakuna dai la kuhamisha msimbo huru.
ChatOptions zake za Rust na skima za bahasha za majibu zilisaidia kuunda aina za maombi na majibu yanayotiririshwa za TypeScript Grok katika OmniRoute.
Mradi uliosambaa sana wa "kwa nini utumie tokeni nyingi wakati tokeni chache zinatosha" — falsafa yake ya lugha ya mtu wa pangoni ndiyo msingi wa modi yetu ya kawaida ya mbano na kanuni zaidi ya 30 za kuondoa maneno ya kujaza/kufupisha.
Mbano 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 mbano wa vidokezo (LLMLingua / LLMLingua-2) — ulihamasisha injini yetu ya llmlingua isawazishaji, salama kwa msimbo na inayoendelea kufanya kazi hata ikishindwa.
Mbano wa tokeni za pt-BR — unaendesha kifurushi chetu cha lugha cha pt-BR: upunguzaji wa uradidi na uondoaji wa maneno ya kujaza ulioboreshwa kwa sarufi ya Kireno cha Brazili.
Ujuzi uliosambaa sana wa msimbo wa "msanidi mwandamizi mvivu" wa YAGNI — ulihamasisha Mtindo wetu wa Matokeo wa less-code: uelekezaji wa mabadiliko madogo zaidi yanayofanya kazi ambao hupunguza msimbo _unaozalishwa_ (sambamba katika mhimili wa matokeo na nathari fupi ya Caveman).
Mbano wa matokeo unaotambua maudhui kwa kila aina ya faili, pamoja na usitishaji unaotambua hitilafu — ulithibitisha uelekezaji wetu kulingana na aina na kuruka pale ambapo faida ya chini zaidi haijafikiwa.
"Tafuta tokeni zisizoonekana" — muundo wake wa kuhamisha mzigo pamoja na kishikio kinachoweza kurejeshwa ulitoa mwongozo kwa fikra zetu kuhusu uhamishaji wa CCR.
Ramani ya usanifu ya grafu ya kipindi pamoja na uondoaji wa mistari inayojirudia katika zamu mbalimbali ambayo ilitoa mwongozo kwa usanifu wetu wa session-dedup.
JSON ya safu-wima ya Rust pamoja na urejeshaji unaotegemea anwani ya maudhui na uondoaji wa nakala katika ujumbe mbalimbali — ulithibitisha usanifu wa injini zetu za headroom/ccr/session-dedup na kanuni thabiti ya akiba kwamba "muundo uliobanwa hautegemei nafasi".
Zana ya TypeScript Compiler API — ilihamasisha uondoaji wetu wa maoni unaotegemea kichanganuzi ambao huhifadhi literali za mifuatano, violezo na semi za kawaida.
Ukamataji/uchanganuzi wa MITM wa trafiki kati ya msaidizi wa usimbaji ↔ LLM ulitoa mwongozo kwa mahitaji ya awali ya Kikaguzi cha Trafiki. Moduli nne zilizotokana nayo hapo awali — uunganishaji wa SSE, usanifishaji wa mazungumzo, ufichaji wa siri na usafishaji wa vichwa — zimebadilishwa na utekelezaji huru wa kuanzia mwanzo 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 ulioainishwa kivyake; hazikuandikwa upya kama sehemu ya ubadilishaji huo.
Uelekezaji angavu wa proksi kwa kila mchakato — ulihamasisha usitishaji wetu wa MITM ulio salama dhidi ya hitilafu, muda wa kuisha kwa soketi zisizotumika, uhusishaji wa michakato ya /proc na ukamataji wa TPROXY.
Uangalizi wa matundu ya huduma ya Istio — ulihamasisha beji zetu za kivunja saketi na vielelezo vya kingo za hitilafu katika Studio ya Uelekezaji/Mchanganyiko.
Orodha iliyochaguliwa kwa makini ya maktaba salama kwa chaguo-msingi inayoongoza maamuzi yetu ya usalama (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ilihamasisha uondoaji wa maombi yanayojirudia, chaguo la dharura lisilo na gharama, mikakati ya Auto-Combo inayoweza kuchomekwa na uainishaji wa dhamira wa lugha nyingi.
Ubadilishaji wake wa modeli unaozingatia akaunti, uthibitishaji wa njia ya faili tekelezi na tabia ya lebo za mipango ulitoa mwongozo kwa mazingira ya utekelezaji ya Antigravity ya OmniRoute.
Muundo wake mfupi wa kuhesabu muda uliosalia hadi uwekaji upya wa kikomo ulihamasisha onyesho linalolingana la kikomo cha mtoa huduma katika OmniRoute.
Ilitambua eneo la mgao la Grok Build; kisha OmniRoute ilithibitisha na kusahihisha kwa kujitegemea umbizo la moja kwa moja la data inayopitishwa.
## 📄 Leseni
Leseni ya MIT - tazama [LICENSE](LICENSE) kwa maelezo.
---
**[⬆ Rudi juu](#-omniroute)** · Imetengenezwa kwa ❤️ kwa ajili ya jumuiya ya AI ya programu huria.
OmniRoute v3.8.52 · Node ≥22.22.2 · Leseni ya MIT · omniroute.online
> Muhtasari uliohuishwa wa ukurasa wa moja kwa moja wa `/dashboard/free-tiers`. Mbinu kamili (kuondoa marudio ya hifadhi, 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 kwa pande zote mbili** — mtoa huduma akisitisha kiwango cha bila malipo, idadi hushuka; kipya kikiongezwa, idadi hupanda. Tunachapisha kile ambacho katalogi hukokotoa kwa hakika, kamwe si makadirio bora yaliyoongezwa.
```bash
# Baada ya kuunganisha mtoa huduma, nakili ufunguo wako wa OmniRoute 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 inayostahiki. Usakinishaji mpya unaweza kukosa malengo yanayostahiki yasiyohitaji ufunguo, na mtoa huduma asiyehitaji ufunguo anaweza kukataa kiteja cha mhusika mwingine. Watoa huduma waliotiwa alama `tos: avoid`, ikiwemo OpenCode Free na Kiro, huondolewa kwenye uelekezaji otomatiki kwa chaguo-msingi; kuunganisha akaunti hakubatilishi mpangilio huo. Angalia [Mwongozo wa Viwango vya Bila Malipo](docs/getting-started/FREE-TIERS-GUIDE.md) kabla ya kuchagua mtoa huduma.
📦 Hati za kuanza haraka za kunakili na kubandika kwa **Python, Node.js, PHP, na cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Combo** ni msururu wa modeli ambao OmniRoute huelekeza maombi kupitia modeli hizo **kiotomatiki**. Kiwango kinachoruhusiwa kikiisha, mtoa huduma akishindwa, au gharama zikipanda ghafla, combo inaweza kuhamia kwenye modeli inayofuata inayostahiki na inayofanya kazi vizuri. 🛡️
### ⚡ Hakuna usanidi — tumia tu `auto`
Hakuna combo ya kuunda. Weka modeli yako kuwa `auto` (au lahaja yake), na OmniRoute itaunda combo pepe kutoka kwa watoa huduma uliounganisha, huku ikikokotoa alama papo hapo:
📖 [Injini ya Mseto Otomatiki](docs/routing/AUTO-COMBO.md) · [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
📊 Mbinu kamili & maelezo ya kila kipengele yakilinganishwa na 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 chaguomsingi uliopangwa kwa mfuatano huendesha `RTK → Caveman`. Zote mbili zinapofanya kazi kwenye mzigo uleule wa zana/muktadha, uokoaji huongezeka kwa pamoja:
```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 yenye muundo **hulindwa kila wakati** na injini ya uhifadhi.
> **Kwa nini utumie tokeni nyingi wakati chache zinatosha?** Kila ombi hupitia mchakato wa ukandamizaji wa OmniRoute **kwa uwazi** — hakuna mabadiliko kwa mteja. Sasa ni **mkusanyiko wa injini 12 zinazoweza kuunganishwa** ambazo huendeshwa kwa mpangilio na kuchanganywa kulingana na kila 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).
### 🧱 Mkusanyiko wa injini 12
Injini huendeshwa kwa mpangilio wa mchakato; kila moja inaweza kuwashwa au kuzimwa na kusanidiwa kivyake kwa kila mchanganyiko:
