# README (Kiswahili) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---
Dashibodi ya OmniRoute

# 🚀 OmniRoute — Lango la AI Lisilolipishwa OmniRoute — Usiache kamwe kuandika msimbo. Kila zana ya AI → watoa huduma 375 — 150+ bila malipo — kupitia kituo kimoja. Claude Code, Codex, Cursor, Cline, Copilot na Antigravity kwenda kwenye Claude / GPT / Gemini BILA MALIPO kwa uhamishaji kiotomatiki inaposhindikana. Mfinyazo wa tabaka wa RTK + Caveman huokoa 15–95% ya tokeni (~89% kwa wastani) — usifikie kamwe vikomo. Watoa huduma 375 wa AI · viwango 150+ visivyolipishwa · ~tokeni bilioni 1.62 bila malipo kwa mwezi · mikakati 20 ya uelekezaji · $0 kuanza.
## 💰 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`). Kadi ya bajeti ya kiwango cha bure cha OmniRoute: takriban tokeni bilioni 1.62 za bure kwa mwezi kwa kawaida, hadi takriban bilioni 2.22 katika mwezi wa kwanza pamoja na salio la kujisajili, kutoka kwa funguo 34 zilizorekodiwa za vikundi vinavyojirudia zinazojumuisha maingizo 467 yaliyoorodheshwa ya viwango vya bure kupitia sehemu moja ya ufikiaji. Hesabu ya uwazi iliyondoa urudufu wa vikundi — kila kikundi kinachoshirikiwa kinahesabiwa mara moja, ikijumuisha vikundi 17 vinavyojirudia vyenye bajeti chanya ya kila mwezi ya tokeni iliyochapishwa pamoja na vikomo vitano vya Groq kwa kila modeli; watoa huduma 12 wametiwa alama ya kuepukwa katika orodha ya hatari za masharti ili uamue mwenyewe. Upau wa bajeti unajumuisha Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (vikomo vitano kwa kila modeli) na vikundi vidogo zaidi, pamoja na salio la kujisajili la mwezi wa kwanza na watoa huduma wa bure daima wasio na kikomo cha tokeni wanaoonyeshwa kando ili kamwe wasiongeze jumla kuu isivyo halali. Matumizi na salio la moja kwa moja kwenye /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.

[![Nyota](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![Nafasi katika Historia ya Nyota](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Jiunge na jumuiya **👋 Mfuate msimamizi — pata kwanza watoa huduma wapya, matoleo na vidokezo:** [![Mfuate Diego kwenye LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Mfuate @diegosouzapw kwenye GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp ya Kimataifa](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp ya Brazili](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Tovuti](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](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 [![toleo la npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Upakuaji wa NPM kwa Mwezi](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Leseni: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Upakuaji wa Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Upakuaji wa Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)
🚀 Anza 🚀 Anza Haraka 📦 Sakinisha 🆓 Unganisha mtoa huduma
💡 Jifunze 💥 Ahadi 🤔 Kwa Nini OmniRoute 🏆 Kinachoitofautisha
⚙️ Vipengele 🎯 Mchanganyiko 🌐 Watoa huduma 🔌 CLI & MCP
🗜️ Mfinyazo 🖥️ Inapoendeshwa 🔒 Faragha
👀 Ione 🎬 Ikifanya Kazi ✨ Nini Kipya 🤖 CLI Zinazooana
💚 Usaidizi 💚 Saidia / Changia 💬 Jumuiya 💖 Wafadhili
📦 Mradi 🛠️ Teknolojia Zinazotumika 📖 Nyaraka 👥 Wachangiaji
🌐 Katika lugha 67

English (en) Português — Brasil (pt-BR) Português (pt) Español (es) Français (fr) Italiano (it) Deutsch (de) Nederlands (nl) Русский (ru) Українська (uk-UA) Polski (pl) Čeština (cs) Slovenčina (sk) Română (ro) Magyar (hu) Български (bg) Dansk (da) Suomi (fi) Norsk (no) Svenska (sv) 中文 — 简体 (zh-CN) 中文 — 繁體 (zh-TW) 日本語 (ja) 한국어 (ko) ไทย (th) Tiếng Việt (vi) Bahasa Indonesia (id) Bahasa Melayu (ms) Filipino (phi) हिन्दी (hi) ગુજરાતી (gu) मराठी (mr) தமிழ் (ta) తెలుగు (te) বাংলা (bn) اردو (ur) فارسی (fa) العربية (ar) עברית (he) Türkçe (tr) Azərbaycan (az) Kiswahili (sw) Ελληνικά (el) Hrvatski (hr) Српски (sr) Lietuvių (lt) Eesti (et) Latviešu (lv) Slovenščina (sl) Malti (mt) Gaeilge (ga) ಕನ್ನಡ (kn) മലയാളം (ml) ଓଡ଼ିଆ (or) ਪੰਜਾਬੀ (pa) नेपाली (ne) සිංහල (si) မြန်မာ (my) ខ្មែរ (km) Hausa (ha) Yorùbá (yo) Igbo (ig) አማርኛ (am) Oʻzbekcha (uz) ქართული (ka) Հայերեն (hy) Bosanski (bs)


## 🆓 Sakinisha, unganisha mtoa huduma, kisha elekeza kupitia endpoint moja
Hatua tatu: sakinisha na uanzishe OmniRoute, unganisha mtoa huduma anayefaa kwa akaunti yako mwenyewe au API key, kisha elekeza chombo chako kwenye localhost:20128/v1 ukitumia OmniRoute API key na model auto. Uelekezaji hutegemea miunganisho inayofaa inayopatikana na mipaka ya mtoa huduma. ```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
Ahadi — Endpoint moja na watoa huduma 375. Urejeshaji wa kiotomatiki huendelea kuelekeza wakati lengo lingine lenye afya linapatikana. Nguzo sita: urejeshaji thabiti katika watoa huduma 375 · hadi 95% ya uokoaji wa token kwenye kazi zinazofaa · $0 kuanza na ngazi 150+ za bure na watoa huduma 51 wa bure-milele wanaorudia/bila key · miunganisho 37 ya CLI/agent kupitia config moja · uoanifu wa OpenAI, Claude, Gemini na Responses API kwenye /v1 · vidhibiti vya uzalishaji ikiwa ni pamoja na circuit breakers, TLS stealth, zana 110 za MCP, A2A, kumbukumbu, guardrails, evals na maazimio 56,000+ ya majaribio tuli katika faili 7,800+ za majaribio zinazofuatiliwa.

# 🤔 Kwa Nini OmniRoute?
Kwa Nini OmniRoute — acha kujongea na dashboards 10, API keys zilizokufa na bili za ghafla. Vikero kumi vya kila siku dhidi ya marekebisho: quota inayoisha bila kutumika → ongeza usajili; mipaka ya kasi katikati ya uandishi wa code → urejeshaji wa kiotomatiki wa ngazi 4 (Usajili → API → Nafuu → Bure); matokeo ya zana yanayoteketeza token → ukandamizaji wa RTK + Caveman (15–95%); API za bei ghali → uelekezaji ulioboreshwa kwa gharama; kila chombo na usanidi wake → endpoint moja, dashboard moja; AI imezuiwa → proxy ya ngazi 3 + TLS stealth; keys zilizokufa → ustahimilivu wa tabaka 3 (circuit breakers, upunguzaji joto wa key, kufungiwa kwa model); timu inashiriki usajili mmoja → madimbwi ya key yenye quota za mgawo wa haki; prompts kupitia cloud ya mtu mwingine → kwanza-karibu na keys zilizosimbwa kwa AES-256-GCM; hakuna uonekano wa matumizi → uchanganuzi wa moja kwa moja (matumizi, quota, uokoaji, p95 latency).
Mtiririko wa maombi ya OmniRoute: IDE au CLI yako (Claude Code, Cursor, Cline…) inaita endpoint moja ya ndani (http://localhost:20128/v1); OmniRoute Smart Router (ukandamizaji wa RTK + Caveman, mikakati 20 ya uelekezaji, circuit breakers, TLS stealth, MCP, A2A, guardrails) inaweza kurejea katika ngazi 4 za watoa huduma wakati lengo linalofaa lenye afya linabaki — Ngazi 1 Usajili, Ngazi 2 API Key, Ngazi 3 Nafuu na Ngazi 4 Bure.

## 🤝 Inaungwa mkono na Marafiki wetu wa Chanzo Huria

Kimi K3 — Akili ya Mipaka Huria · Vigezo 2.8T · Muktadha wa Tokeni 1M

> **Je, unataka kujiunga kama Rafiki wa Chanzo Huria?** Hizi ni kampuni zinazou ## 🎯 Combo — Kipengele Kikuu Mifano iliyohuishwa ya mikakati 18 kati ya 20 ya uelekezaji wa combo — kisanduku kimoja kwa kila mkakati: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized na quota-weighted hazijahuishwa; jedwali lililo hapa chini linafafanua mikakati yote 20. > **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 ModeliInachoboresha
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) Ustahimilivu wa OmniRoute — tabaka 3 huru zinazojirekebisha, huku tabaka sahihi likishughulikia hitilafu husika. Tabaka la 1 ni kikata mzunguko cha mtoa huduma (mtoa huduma mzima): huamilishwa tu kwa 408/5xx, vizingiti ni OAuth 8× / API-key 12× / local 2×, huwekwa upya baada ya 60s/30s/15s na kuingia kwenye jaribio la HALF-OPEN, urejeshaji unapohitajika; likiwa OPEN, combo huelekeza upya kwa mtoa huduma anayefuata. Tabaka la 2 ni kipindi cha kusubiri cha muunganisho (ufunguo/akaunti moja): msingi ni 5s kwa OAuth / 3s kwa API-key, ongezeko la muda la kielelezo ×2 lenye kinga dhidi ya maombi mengi ya wakati mmoja, 429 huzingatia Retry-After, mafanikio huondoa hali zote za hitilafu; ufunguo mmoja ulio katika kipindi cha kusubiri hurukwa huku funguo nyingine zikiendelea kutoa huduma. Tabaka la 3 ni kufungiwa kwa modeli (modeli moja): 429 ya modeli husika, 404 ya local au kukataliwa kwa modi hufungia modeli hiyo pekee — kamwe si muunganisho mzima. Hali za mwisho (kupigwa marufuku, muda kuisha, salio kuisha) hushughulikiwa na mwendeshaji, si vipindi vya kusubiri. 📖 [Injini ya Auto-Combo](docs/routing/AUTO-COMBO.md) · [Mwongozo wa Ustahimilivu](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Kinachofanya OmniRoute Kuwa Tofauti
Kinachofanya OmniRoute kuwa tofauti — muhtasari wa vipengele wa tarehe maalumu ukilinganisha na 9router, OpenRouter, CLIProxyAPI na LiteLLM katika uwezo 13. OmniRoute: watoa huduma 375, viwango 150+ vya bure vilivyojengewa ndani, mikakati 20 ya uelekezaji, ufinyazaji wa tokeni kwa injini 12, seva ya MCP iliyojengewa ndani yenye zana 110, itifaki ya mawakala ya A2A, kumbukumbu endelevu, vizuizi vya usalama, mawakala wa wingu, ufichaji wa alama za utambulisho za TLS, Desktop/Termux/PWA na lugha 67 za kiolesura cha i18n. OmniRoute ina leseni ya MIT na inaweza kupangishwa binafsi. Uwezo na idadi za washindani zinaweza kubadilika; angalia mbinu iliyounganishwa. 📊 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.
⭐ Weka nyota kwenye hazinaBure — husaidia sana kuongeza mwonekanoWeka nyota kwa OmniRoute
🐙 GitHub SponsorsMara moja au kila mwezi · hakuna ada ya jukwaagithub.com/sponsors/diegosouzapw
☕ Ko-fiBakshishi ya haraka ya mara moja, mfadhili hahitaji kujisajiliko-fi.com/diegosouzapw
🧋 Buy Me a CoffeeIshara ndogo, isiyo rasmibuymeacoffee.com/diegosouzapw
🖐 LiberapayInayojirudia · isiyo ya faida · chanzo hurialiberapay.com/diegosouzapw
🇧🇷 PIX (Brazili)Papo hapo, bila adaufunguo & QR hapa chini
₿ Sarafu za kidijitaliBTC · ETH · USDT-TRC20 · USDC-Solanaanwani hapa chini
**🇧🇷 PIX** — papo hapo, bila ada (Brazili) Msimbo wa QR wa PIX wa OmniRoute 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)
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ 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.
Claude Code
Claude Code
                           
Codex CLI
Codex CLI
                           
Cline
Cline
                           
Kilo Code
Kilo Code
Zoo Code
Zoo Code
Continue
Continue
                           
Aider
Aider
                           
ForgeCode
ForgeCode
                           
jcode
jcode
                           
DeepSeek TUI
DeepSeek TUI
                           
CodeWhale
CodeWhale
                           
OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           
GitHub Copilot CLI
Copilot CLI
                           
Cursor CLI
Cursor CLI
                           
Smelt
Smelt
                           
Pi (pi-coding-agent)
Pi
                           
Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           
OpenClaw
OpenClaw
                           
Goose
Goose
                           
Open Interpreter
Open Interpreter
                           
Warp AI
Warp AI
                           
deyin.ai
deyin.ai
                           
+ 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
OpenAI
                           
Anthropic
Anthropic
                           
Gemini
Gemini
                           
xAI Grok
xAI Grok
                           
DeepSeek
DeepSeek
                           
Mistral
Mistral
                           
Qwen
Qwen
                           
Meta Llama
Meta Llama
                           
Groq
Groq
                           
NVIDIA
NVIDIA
                           
MiniMax
MiniMax
                           
Cohere
Cohere
                           
Perplexity
Perplexity
                           
Hugging Face
HuggingFace
                           
Together
Together
                           
Fireworks
Fireworks
                           
Cloudflare
Cloudflare
                           
Baidu
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
OpenCode Zen
DeepSeek V4, Nemotron 3
Hakuna kikomo cha tokeni
Kilo Code
Kilo Code
Kipanga njia kiotomatiki, Tencent Hy3
Bure milele
Requesty
Requesty
GPT-OSS 120B, Nemotron
Bure milele
SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
Kiwango cha bure
Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
Bure milele
Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
Bure milele
Qoder AI
Qoder AI
Qwen3-Max, Kimi-K2
BURE BILA KIKOMO
Pollinations
Pollinations
GPT, Llama, Claude
Hakuna ufunguo unaohitajika
Cloudflare AI
Cloudflare AI
Modeli 50+
Neuroni 10K/siku
NVIDIA NIM
NVIDIA NIM
GLM, MiniMax
~40 RPM bure
Cerebras
Cerebras
GLM 4.7, GPT-OSS
Krediti ya $5 ya mara moja; kadi inahitajika
OpenRouter
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.
JukwaaUsakinishajiVipengele muhimu
📦 npm (kimataifa)npm install -g omnirouteAmri moja, mfumo wowote wa uendeshaji
🐳 Dockerdocker run … diegosouzapw/omnirouteMiundio mingi AMD64 + ARM64
🖥️ Kompyuta ya mezani (Electron)npm run electron:buildDirisha asilia + trei ya mfumo — Windows / macOS / Linux
🎩 Upau wa menyu (OmniRouteTray)brew install --cask zoispag/tap/omniroute-trayHusimamia & kusasisha seva kiotomatiki — macOS
💪 ARMasilia arm64Raspberry Pi, seva za ARM, Apple Silicon
📱 Android (Termux)pkg install nodejs && npx -y omnirouteHuendeshwa 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-providerMuunganisho asilia wa OpenCode
🤖 VS Code Copilot Chatsakinisha kiendelezi cha OmniCopilotKila modeli ya OmniRoute katika kiteuzi asilia cha Copilot Chat — toleo thabiti & Insiders
🛠️ Kutoka kwenye msimbo chanzonpm install && npm run devIfanyie 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**.
DukaKiungoHufanya kazi na
🧩 VS Code MarketplaceSakinisha →VS Code — toleo thabiti & Insiders
🔓 Open VSX RegistrySakinisha →Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…
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. 🎩
InachofanyaJinsi inavyofanya
🟢 Husimamia sevaHuanzisha omniroute serve, hutumia instansi ambayo tayari inaendeshwa badala ya kuiunda mara mbili
📊 Matumizi ya moja kwa moja kwa muhtasariPau 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 hapoUsakinishaji wa hatua kwa hatua, ubadilishaji atomiki, kurejesha toleo la awali ikishindikana — daima kwenye toleo jipya zaidi
🚀 Anza wakati wa kuingiaUzinduzi wa hiari wakati wa kuingia; trei pekee, hakuna ikoni ya dock
🩺 Uchunguzi & kumbukumbuUchunguzi 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
Faragha na inayotanguliza uendeshaji wa ndani — lango na sehemu ya udhibiti ya OmniRoute huendeshwa kwenye mashine yako. Maagizo hutumwa kwa mtoa huduma wa juu aliyechaguliwa kwa kila ombi; OmniRoute haiongezi hatua yoyote ya kuchakata maagizo inayopangishwa na ukusanyaji wa data za matumizi umezimwa kwa chaguo-msingi. Vitambulisho vimesimbwa kwa AES-256-GCM vinapohifadhiwa; vidhibiti vinajumuisha kuweka mawanda ya funguo za API, uchujaji wa IP, vikomo vya kiwango, vizuizi vya udukuzi wa maagizo, uondoaji wa vichwa vya mtoa huduma wa juu, ufichaji wa PII unaowashwa kwa hiari, hitilafu zilizosafishwa na rekodi ya ukaguzi ya SQLite ya ndani. OmniRoute ina leseni ya MIT na inaweza kupangishwa binafsi. 📖 [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)
Onyesho la terminal lililohuishwa likionyesha CLI ya OmniRoute — omniroute providers list, omniroute combo list na omniroute health — likipitia kiolesura cha kiwango cha juu chenye amri 89: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …
### 🤝 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`.
KiolesuraEndpoint / amriKitumie kwa
🧰 MCP (stdio)omniroute --mcpUnganisha na Claude Desktop, Cursor au kiteja chochote cha MCP
🌊 MCP (HTTP)/api/mcp/streamMCP ya mbali — zana 110, wigo 33 (utekelezaji wa hiari), kumbukumbu kamili ya ukaguzi
📡 MCP (SSE)/api/mcp/sseUsafirishaji wa MCP wa kutiririsha
🤝 A2A/.well-known/agent.jsonWakala-kwa-wakala, JSON-RPC 2.0 + SSE, ujuzi 6
🌐 REST API/v1/*Inayooana na OpenAI — gumzo, embeddings, picha, sauti, OCR
🔔 Webhooks/api/webhooksTuma matukio ya maombi / quota kwenda Slack, Discord, Telegram au URL yoyote
🛰️ CLI ya mbaliomniroute 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 Bomba la ukandamizaji la OmniRoute: ombi la mfano la tokeni 10,000 la mteja hupitia injini 12 zinazoweza kuunganishwa — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra na OmniGlyph — na linaweza kufika kwa mtoa huduma likiwa na takriban tokeni 10,000 katika mfano uliorundikwa ulioandikwa. Maudhui yaliyopangwa hulindwa na walinzi wa uhifadhi na malango ya uaminifu kwa kila hatua; hali za upotezaji dhahiri au za majaribio zinaweza kubadilisha maudhui yanayostahiki. 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:
#InjiniInafanya nini
1Session-DedupHuondoa maudhui yanayorudiwa kati ya zamu (yanayoelekezwa kwa maudhui, kati ya zamu)
2CCRHuhifadhi vitalu vikubwa nyuma ya alama za kurejesha, zinazochukuliwa inapohitajika
3LiteKupunguza nafasi zisizo na maana + URL za picha (msingi mwepesi wa ucheleweshaji)
4RTKUchujaji mahiri wa matokeo ya zana, uondoaji wa marudio na upunguzaji (unaozingatia amri)
5Responses Tool OutputJSON isiyo na upotezaji kwanza + ukandamizaji wa uchunguzi wenye mipaka kwa matokeo ya shell/patch/search/build (Responses API)
6HeadroomUfinyazwaji wa jedwali bila upotezaji wa safu za JSON (~30%) kupitia codec ya GCF iliyowekwa ndani ya mradi
7RelevanceUkadiriaji wa sentensi kwa uchimbaji dhidi ya swali la mwisho la mtumiaji
8CavemanUkandamizaji wa nathari kwa kanuni (~65–75% kwenye matokeo)
9AggressiveUfupishaji + uzeekevu wa taratibu wa zamu za zamani
10LLMLingua-2Upunguzaji wa kimantiki wa ML kupitia MobileBERT ONNX — salama kwa msimbo, async
11UltraUpunguzaji wa tokeni kwa heuristiki ukiwa na tabaka la hiari la modeli ndogo (SLM)
12OmniGlyphUsimbaji 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:
HaliUokoajiBora 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
🧰 RTK60–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
Instagram Reel — nick_saraev
🎬 #1 — Instagram
nick_saraev — mara 3,042,474 za kutazamwa
Instagram Reel — nnapier7
🎬 #2 — Instagram
nnapier7 — mara 1,454,535 za kutazamwa
YouTube — Amidia AI & Tech
🎬 #3 — YouTube
Amidia AI & Tech — mara 794,974 za kutazamwa
Instagram Reel — theopenstack
🎬 #4 — Instagram
theopenstack — mara 692,419 za kutazamwa
TikTok — migue.baena
🎬 #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) |
---
## 🛠️ Teknolojia Zinazotumika
TabakaTeknolojia
Mazingira ya utekelezajiNode.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
LughaTypeScript 6.0 — 100% TypeScript katika src/ na open-sse/ (hakuna any katika msingi tangu v2.0)
MfumoNext.js 16 + React 19 + Tailwind CSS 4
Hifadhidatabetter-sqlite3 (SQLite, uandishi wa kumbukumbu wa WAL) + LowDB (urithi wa JSON) — moduli 147 za kikoa, uhamishaji 209
KumbukumbuUtafutaji wa maandishi kamili wa SQLite FTS5 + upachikaji wa vekta uliokadiriwa kwa int8, upunguzaji wenye aina maalum
SkimaZod 4 — uthibitishaji wa I/O wa zana za MCP + mikataba ya API
ItifakiMCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
UtiririshajiServer-Sent Events (SSE) + daraja la WebSocket (/v1/ws)
MfinyazoMtiririko wa injini 12 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Uthibitishaji & usalamaOAuth 2.0 (PKCE) + JWT + API Keys + uthibitishaji wenye mawanda wa MCP · AES-256-GCM kwa data iliyohifadhiwa · DOMPurify
Ufichajiwreq-js — uigaji wa alama za vidole za JA3 / JA4 TLS, proksi ya ngazi 3
UstahimilivuKikatiza saketi, ucheleweshaji unaoongezeka kwa kasi, uzuiaji wa msongamano wa maombi ya wakati mmoja, kujirekebisha kiotomatiki kwa michanganyiko
Uwekaji kumbukumbupino — kumbukumbu za JSON zilizopangwa zenye muktadha wa ombi
MajaribioKiendeshaji 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)
MajukwaaKompyuta ya mezani (Electron) · Android (Termux) · PWA (kivinjari chochote)
CI/CDGitHub Actions — uchapishaji wa npm kiotomatiki + Docker Hub wakati wa toleo
ViungoTovuti · npm · Docker Hub

## 📖 Nyaraka
### 📘 Kuanza
HatiMaelezo
Mwongozo wa MtumiajiWatoa huduma, michanganyiko, ujumuishaji wa CLI, usambazaji
Mwongozo wa UsanidiMbinu kamili za usakinishaji, usanidi wa zana za CLI, usanidi wa itifaki, urekebishaji wa muda wa kusubiri
Mwongozo wa Zana za CLIUsanidi kwa kila zana kwa Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Hali ya MbaliEndesha OmniRoute ya mbali (VPS) kutoka CLI ya kompyuta yako ya mkononi kupitia tokeni za ufikiaji zenye wigo
Usanidi wa Claude CodeElekeza Claude Code kwenye OmniRoute (ya ndani/mbali) kwa launch + wasifu kwa kila modeli
Uanzishaji wa HarakaHatua 3 sakinisha → unganisha → sanidi
### 🔧 Uendeshaji na Usambazaji
HatiMaelezo
Mwongozo wa DockerDocker run, wasifu wa Compose, Caddy HTTPS, vichuguu, lebo za image
Mwongozo wa PodmanUjumuishaji wa Quadlet systemd, podman-compose, SELinux
Usambazaji wa VMMwongozo kamili: usanidi wa VM + nginx + Cloudflare
Usambazaji wa Fly.ioSambaza kwenye Fly.io kwa hifadhi ya kudumu
Mwongozo wa TermuxEndesha OmniRoute kwenye Android kupitia Termux
Mwongozo wa PWAUsakinishaji wa Progressive Web App, uhifadhi wa akiba, usanifu
Mwongozo wa KuondoaUondoaji safi kwa mbinu zote za usakinishaji
Usanidi wa MazingiraVigezo kamili vya .env na marejeleo
### 🧠 Vipengele na Usanifu
HatiMaelezo
UsanifuUsanifu wa mfumo, mtiririko wa data, na mambo ya ndani
Mwongozo wa UkandamizajiMstari wa uchakataji wa chaguo 7: off / lite / standard / aggressive / ultra / RTK / stacked
Ukandamizaji wa RTKUkandamizaji wa matokeo ya amri, vichujio, uaminifu, uthibitishaji, urejeshaji wa matokeo ghafi
Injini za UkandamizajiCaveman, RTK, mistari iliyopangwa, nyuso za dashboard/API/MCP
Muundo wa Kanuni za UkandamizajiSkema za pakiti za kanuni za JSON kwa vichujio vya Caveman na RTK
Pakiti za Lugha za UkandamizajiUtambuzi wa lugha na uandishi wa pakiti za kanuni za Caveman
Mwongozo wa UstahimilivuVizima-mzunguko, vipindi vya kupoa, foleni, kinga dhidi ya kundi la radi, ughushi wa TLS
Injini ya Auto-ComboUkadiriaji wa vipengele 16, pakiti za hali, kujiponya
Mwongozo wa ProxyMfumo wa proxy wa ngazi 3, soko la 1proxy, CRUD ya rejista
Viwango vya BureOrodha iliyounganishwa: hifadhi 34 zilizoandikwa zinazorudiwa / maingizo 467 ya viwango vya bure yaliyoorodheshwa
Ghala la VipengeleZiara ya dashboard ya kuona na picha za skrini
Nyaraka za Msingi wa MsimboMchanganuo wa msingi wa msimbo rafiki kwa mwanzo
### 🤖 Itifaki na API
HatiMaelezo
Marejeleo ya APIVituo vyote vya mwisho na mifano
Vipimo vya OpenAPIVipimo vya OpenAPI 3.0
Seva ya MCPZana 110 za MCP, usanidi wa IDE, wateja wa Python/TS/Go
Mwongozo wa Seva ya MCPUsakinishaji wa MCP, usafirishaji, na marejeleo ya zana
Seva ya A2AItifaki ya JSON-RPC 2.0, ujuzi, utiririshaji, usimamizi wa kazi
Mwongozo wa Seva ya A2AKadi ya wakala wa A2A, kazi, ujuzi, na utiririshaji
### 📋 Mradi na Ubora
HatiMaelezo
KuchangiaUsanidi wa maendeleo na miongozo
Mfumo wa Matawi na UtoajiPR zinalenga wapi (release/*), main na lebo zinamaanisha nini
Kumbukumbu ya MabadilikoHistoria kamili ya matoleo kwa kila toleo
Sera ya UsalamaUripoti wa udhaifu na taratibu za usalama
Mwongozo wa i18nMsaada wa lugha 67, mtiririko wa tafsiri, RTL
Orodha Hakiki ya UtoajiHatua za uthibitishaji kabla ya utoaji
Mpango wa Ufunikaji wa MajaribioMkakati 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
NafasiMchangiajiPR zilizounganishwa~Mistari iliyobadilishwa
1maxmad64bis37125,326,561
2HouMinXi26913,456,272
3backryun210270,562
4oyi77190411,243
5pacocartones17478,276
6JxnLexn1513,562,936
6KooshaPari1515,972,314
8rdself14580,663
9RaviTharuma123500,065
10herjarsa88230,872
11hartmark842,849,554
12jonlwheat2-gif6768,548
13artickc6243,502
14chirag127526,661
15xz-dev50245,976
16xiaoyaner02014733,626
17woodsonl46809,391
18rqzbeh44147,896
19QuangBlue4313,112
20MumuTW4026,093
Sensa ilifanyika 2026-10-18 15:09:09 UTC ikiwa na ncha hai ya release/v3.8.52 656f01cb43. 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
Dizzle
Dizzle

🥇 commits 367 zinazohusishwa na GitHub
Bob.Hou
Bob.Hou

🥈 commits 269 zinazohusishwa na GitHub
Paijo
Paijo

🥉 commits 229 zinazohusishwa na GitHub
backryun
backryun

🏅 commits 202 zinazohusishwa na GitHub
Paco Cartones
Paco Cartones

🏅 commits 174 zinazohusishwa na GitHub
Ravi Tharuma
Ravi Tharuma

🏅 commits 126 zinazohusishwa na GitHub
Markus Hartung
Markus Hartung

🏅 commits 114 zinazohusishwa na GitHub
Randi
Randi

🏅 commits 108 zinazohusishwa na GitHub
Jan Leon
Jan Leon

🏅 commits 87 zinazohusishwa na GitHub
Chris
Chris

🏅 commits 70 zinazohusishwa na GitHub
Koosha Paridehpour
Koosha Paridehpour

🏅 commits 68 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.
Andrew
Andrew

💛 Mfadhili hai wa kila mwezi
Vlad I
Vlad I

💛 Mfadhili hai wa kila mwezi
小妍儿
小妍儿

💛 Mfadhili hai wa kila mwezi
Guilherme Costa
Guilherme Costa

💛 Mfadhili hai wa mara moja
Henrique Triches Iurkiv
Henrique Iurkiv

💛 Mfadhili hai wa mara moja
Somesh Ghaturle
Somesh Ghaturle

💛 Mfadhili hai wa mara moja
Kolonie AI
Kolonie AI

💛 Mchangiaji wa zamani wa mara moja
Professor Igor Morais Vasconcelos
Prof. Igor Morais

💛 Mchangiaji wa zamani wa mara moja
Pixma
Pixma

💛 Mchangiaji wa zamani wa mara moja
Paco Cartones
Paco Cartones

💛 Mchangiaji wa zamani wa mara moja
longtao
longtao

💛 Mchangiaji wa zamani wa mara moja
… 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+
[![Wachangiaji](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](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 Chati ya Historia ya Nyota
## 🌍 StarMapper 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
Mradi⭐Jinsi ulivyoitia moyo OmniRoute
9router31,004Mradi asili ambao fork hii imejengwa juu yake — umepanuliwa hapa kwa API za modi nyingi na uandishi upya kamili katika TypeScript.
CLIProxyAPI55,591Utekelezaji wa Go uliotia moyo uhamishaji huu kwenda JavaScript / TypeScript.
LiteLLM61,482Lango 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.
codex-chatgpt-web14,526Chanzo 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.
free-claude-code61,430Miundo 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.
composer-api346Miundo ya Cursor Composer ya uteuzi wa zana, vizuizi vya matokeo na uthibitishaji wa zana iliyorekebishwa katika kitekelezaji asilia cha Cursor.
codex-multi-auth553Miundo ya kuingia upya na mzunguko wa tokeni za kuonyesha upya iliyohamishwa katika uthibitishaji upya wa Codex OAuth.
opencode-anthropic-auth558Chaguo-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.
grok2api-merged2Ulinganishaji 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.
TQZHR/grok2api706Chanzo 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.
chenyme/grok2api7,819Chanzo 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.
grok2api-pro27Chanzo 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.
GrokProxy51Proksi yake ya Grok inayothibitishwa kwa cookie na muundo wa utiririshaji wa result.response.token ilisaidia kubuni usafirishaji wa Grok Web wa OmniRoute.
GrokBridge5Utekelezaji 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.
### 🗜️ Muktadha na ubanaji wa tokeni — injini
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
Caveman113,396Mradi 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.
RTK – Rust Token Killer83,835Ubanaji 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.
headroom75,741Ubanaji wa muktadha unaoweza kutenduliwa (SmartCrusher) — ulihamasisha injini yetu ya headroom na muundo wa alama ya urejeshaji ya ccr.
LLMLingua6,757Utafiti wa ubanaji wa vidokezo (LLMLingua / LLMLingua-2) — ulihamasisha injini yetu ya llmlingua isiyosawazishwa, salama kwa msimbo na inayoruhusu mwendelezo ikishindwa.
llmlingua-2-js32Toleo la JS/ONNX (MobileBERT / XLM-RoBERTa) linalotumika kama mfumo wa nyuma wa uzi-tekelezi kwa injini yetu ya LLMLingua.
Troglodita50Ubanaji 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.
ponytail166,731Ujuzi 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).
i-have-adhd57,628Mtindo wake wa majibu unaotanguliza vitendo na unaowafaa watu wenye ADHD ulirekebishwa kuwa mtindo mfupi wa matokeo wa OmniRoute katika lugha tano.
### 🧩 Miundo iliyobanwa, utafiti wa tokeni na zana zinazotambua msimbo
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
TOON25,509Uakilishaji wa Vitu Unaoelekezwa kwa Tokeni — modeli yake ya kisafu yenye kichwa pamoja na safu iliunda hatua yetu ya ubanaji wa data ya kijedwali.
GCF – Graph Compact Format59Muundo wake uliobanwa wa grafu na usanifu wa wasifu wa jumla uliongoza ubanaji wa data ya kijedwali wa OmniRoute na muundo wa kodeki ya Headroom.
gcf-typescript4Utekelezaji wa MIT wa TypeScript uliojumuishwa moja kwa moja na kupanuliwa kama kodeki ya wasifu wa jumla ya Headroom.
token-optimizer-mcp551Akiba ya Brotli/SQLite pamoja na tofauti ya muktadha kwa kila kipindi — ulihamasisha injini yetu ya session-dedup.
token-savior1,182Ubanaji wa matokeo ya Bash pamoja na wasifu wa MCP — ulihamasisha kanuni yetu ya kusitisha ubanaji inapobidi na upunguzaji wa orodha ya zana za MCP.
token-saver154Ubanaji 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.
token-optimizer2,595"Tafuta tokeni hewa" — muundo wake wa kuhamishia mzigo kwingine pamoja na kishikio kinachoweza kurejeshwa uliongoza fikra zetu kuhusu kuhamishia CCR kwingine.
TokenMizer33Mchoro wa awali wa grafu ya kipindi pamoja na uondoaji wa mistari inayojirudia katika zamu tofauti, ulioongoza usanifu wetu wa session-dedup.
OmniCompress3JSON 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".
mcp-compressor133Ubanaji wa skima/maelezo ya zana za MCP — uliongoza upunguzaji wetu wa idadi ya vipengee katika orodha ya zana za MCP.
RepoMapper217Upangaji wa viwango wa ramani ya hazina kwa mtindo wa Aider — uliongoza uchunguzi wetu wa ramani ya hazina/upangaji wa viwango vya urejeshaji.
quiet-shell-mcp4Upunguzaji tangazifu wa matokeo ya shell kupitia MCP — ulithibitisha ubanaji wetu tangazifu wa matokeo ya bash.
ts-morph6,205Zana za TypeScript Compiler API — zilihamasisha uondoaji wetu wa maoni unaotegemea kichanganuzi na unaohifadhi literali za tungo, violezo na regex.
### 🧠 Kumbukumbu na RAG
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
Mem067,385Safu ya kumbukumbu ya jumla — muundo wake wa proksi kama mpaka wa kuandika/kusoma uliunda usanifu wetu wa kumbukumbu.
Letta (MemGPT)25,179Mawakala wenye hali na kumbukumbu yenye viwango — ilihamasisha muundo wetu wenye viwango wa Udhibiti na Urejeshaji wa Muktadha (CCR).
WFGY1,800Taksonomia ya ProblemMap ya hali 16 zinazojirudia za kushindwa kwa RAG/LLM — msamiati wa pamoja katika mwongozo wetu wa utatuzi.
### 🛰️ Ukaguzi wa trafiki, MITM na proksi ya uwazi
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
llm-interceptor79Ukamataji/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.
ProxyBridge6,814Uelekezaji 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.
### 📚 Data ya modeli, uangalizi na UI
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
models.dev7,286Hifadhidata wazi ya vipimo, bei na uwezo wa modeli za AI — imesawazishwa kiasili katika katalogi yetu ya modeli.
React Flow / xyflow38,705Maktaba ya grafu inayotegemea nodi ambayo inaendesha Studio yetu ya Mfinyazo na Studio ya Combo/Uelekezaji kwa wakati halisi.
LangGraph43,443Uonyeshaji wa moja kwa moja wa grafu ya mtiririko wa kazi wa LangGraph Studio ulihamasisha mwonekano wa wakati halisi wa mfululizo katika Studio zetu.
Langfuse35,990Muundo wake wa uangalizi wa ufuatiliaji → kipindi → uzalishaji uliunda mwonekano wetu wa mtiririko katika Studio ya Mfinyazo.
Kiali3,645Uangalizi wa matundu ya huduma ya Istio — ulihamasisha beji zetu za vivunja saketi na taswira za kingo za hitilafu katika Studio ya Uelekezaji/Combo.
lobe-icons2,615Nembo za chapa za AI/LLM zinazoonyesha ikoni za watoa huduma kwenye dashibodi yetu.
flag-icons12,473Hutoa bendera za SVG zilizo chini ya leseni ya MIT zinazotumiwa na kiteuzi cha lugha cha README.
### 🛡️ Usalama
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
awesome-secure-defaults722Orodha iliyoratibiwa ya maktaba zilizo salama kwa chaguo-msingi ambayo inaongoza maamuzi yetu ya usalama (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
### 🧭 Zana zinazokamilishana
Mradi⭐Jinsi ulivyoihamasisha OmniRoute
ClawRouter6,628Ilihamasisha uondoaji wa maombi yanayojirudia, njia mbadala ya dharura isiyo na gharama, mikakati inayoweza kuunganishwa ya Auto-Combo na uainishaji wa nia kwa lugha nyingi.
Antigravity-Manager32,333Urekebishaji 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.
vscode-antigravity-cockpit4,850Muundo wake mfupi wa kuhesabu muda uliosalia hadi uwekaji upya wa mgao ulihamasisha onyesho husika la kikomo cha mtoa huduma katika OmniRoute.
AionUi33,611Miunganisho yake ya ACP ilihamasisha ugunduzi wa kiotomatiki wa OmniRoute wa mawakala wa CLI waliosakinishwa.
CodexBar22,616Ilitambua 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