OmniRoute/docs/i18n/sw

README (Kiswahili)

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

---

🚀 OmniRoute — Lango la AI Lisilolipishwa

💰 Tokeni ~1.47B Bila Malipo / Mwezi

Kukusanya viwango vya bure kwa mkono ni kazi ngumu — SDK nyingi, vikomo vingi vya matumizi, na hujui kwa hakika una kiasi gani. OmniRoute inaorodhesha vipengee 452 vya viwango vya bure katika funguo 34 za hifadhi zinazojirudia na hukokotoa jumla kuu ya tokeni kutoka kwenye hifadhi 16 zenye bajeti chanya ya kila mwezi iliyochapishwa pamoja na vikomo vitano vya Groq kwa kila modeli, huku hifadhi zinazoshirikiwa zikiondolewa urudufu. Viwango vinavyopatikana tu baada ya ukaguzi wa utambulisho wa kikanda (kwa sasa: ModelScope) vinaonyeshwa kando, +~6M baada ya uthibitishaji wa utambulisho wa kikanda, na havijumlishwi kamwe kwenye jumla kuu. Matokeo huendelea kuonekana kwenye dashibodi (/dashboard/free-tiers).

Muhtasari uliohuishwa wa ukurasa wa moja kwa moja wa /dashboard/free-tiers. Mbinu kamili (uondoaji wa urudufu wa hifadhi, viwango vya salio, masharti ya watoa huduma): docs/reference/FREE_TIERS.md.

_{Takwimu hizi hukaguliwa upya kila baada ya wiki mbili dhidi ya orodha inayotumika na hubadilika kwenda juu au chini — mtoa huduma akikomesha kiwango cha bure, idadi hushuka; kipya kikiongezwa, idadi hupanda. Tunachapisha kile ambacho orodha hukokotoa kwa hakika, wala si makadirio bora yaliyoongezwa kwa kuzungushia.}

⭐ Ipe repo nyota ikiwa OMNIROUTE imekusaidia kuokoa pesa na kurahisisha kazi yako.

💬 Jiunge na jumuiya

👋 Mfuate msimamizi — pata watoa huduma wapya, matoleo na vidokezo mapema:

Maswali, vidokezo kuhusu watoa huduma, mpango wa maendeleo na usaidizi → Discord · Telegram · WhatsApp 🌍 Kimataifa / 🇧🇷 Brasil / Portal

📈 Lango Linaendelea Kukua

	v3.8.49	v3.8.50	v3.8.51+
🌐 Watoa huduma	290	352	zaidi zimesubiri
🧠 Vitambulisho vya kipekee vya modeli za gumzo	1185	1312	—
🖼️ Daraja la modi	—	🆕 kuona + sauti + video	—
📡 Katalogi ya bure ya Radar	—	🆕 kwa hiari	—
⚖️ Upangaji unaozingatia mgao	—	🆕 Quota-Share	—
📊 Telemetria ya mgao	—	🆕 mubashara	—

→ Mpango wa Maendeleo — tukisonga kwenye reli kuelekea v3.9.0 LTS

🧩 Inapatikana

🚀 Anza	🚀 Anza Haraka	📦 Sakinisha	🆓 Bila usanidi
💡 Jifunze	💥 Ahadi	🤔 Kwa Nini OmniRoute	🏆 Kinachoitofautisha
⚙️ Vipengele	🎯 Mchanganyiko	🌐 Watoa huduma	🔌 CLI na MCP
	🗜️ Mfinyazo	🖥️ Inakoendeshwa	🔒 Faragha
👀 Ione	🎬 Ikifanya Kazi	✨ Mambo Mapya	🤖 CLI Zinazooana
💚 Usaidizi	💚 Saidia / Changia	💬 Jumuiya	💖 Wadhamini
📦 Mradi	🛠️ Teknolojia Zinazotumika	📖 Nyaraka	👥 Wachangiaji

🌐 Katika lugha 66

🆓 Hufanya kazi mara tu unapoisakinisha — hakuna funguo, hakuna usanidi

# Usakinishaji mpya, bila vitambulisho — `auto` tayari inafanya kazi:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{Unapendelea huduma mahususi ya nyuma isiyolipishwa? Ita oc/… (OpenCode Free) moja kwa moja. Kisha hamia kwenye auto na uiruhusu OmniRoute ichague.}

_{📦 Hati za kuanza haraka za kunakili na kubandika kwa Python, Node.js, PHP, na cURL → examples/quickstart/}

💥 Ahadi

🤔 Kwa nini OmniRoute?

🤝 Tunaungwa mkono na Marafiki wetu wa Chanzo Huria

Ungependa kujiunga kama Rafiki wa Chanzo Huria? Haya ndiyo makampuni yanayounga mkono chanzo huria na kusaidia OmniRoute kuendelea — na tunaeleza hadharani kila tokeni wanayotupatia inatumika wapi. Wasiliana nasi: diegosouza.pw@outlook.com

Kimi Moonshot AI

Shukrani kwa Kimi (Moonshot AI), Rafiki wetu mwanzilishi wa Chanzo Huria, kwa kuunga mkono mradi huu! Kimi ni maabara ya AI iliyoanzisha familia za miundo ya K2 na K3 zenye uzani huria — Kimi K3 hutoa dirisha la muktadha la tokeni milioni 1, uwezo asilia wa kuona na uandishi wa msimbo wa kiwango cha juu kwa sehemu ndogo ya bei za miundo funge, na hufanya kazi moja kwa moja na Claude Code, Codex na kila zana ya uandishi wa msimbo inayohudumiwa na OmniRoute. Msaada wa Kimi unawezesha nini: Salio la API la Kimi linawezesha mchakato wa matoleo wa OmniRoute unaothibitishwa na AI — hatua ya uthibitishaji wa kuunganisha unaowezeshwa na Kimi K3 ambayo hukagua kila ombi la kuunganisha kabla halijatolewa — pamoja na uundaji wa vipengele wa kila siku. Usaidizi wa kiwango cha kwanza wa Kimi hutolewa kupitia njia zote mbili: Kimi API ya moja kwa moja (kimi-k3) na mpango wa uandishi wa msimbo wa Kimi Code (OAuth na ufunguo wa API). OmniRoute pia ni mradi wa kwanza wa chanzo huria wa Brazil katika mpango wa usaidizi wa Kimi. Pata ufunguo wa Kimi API wenye salio la ziada la 15% →

Cheaper Inference cheaperinference.com

Shukrani kwa Cheaper Inference, Rafiki wa Chanzo Huria wa OmniRoute, kwa kuunga mkono mradi huu! Cheaper Inference ni lango lililopangwa kwa gharama ambalo huuza tena miundo 42 ya kiwango cha juu — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok na MiniMax — kupitia endpoint moja inayooana na OpenAI, likielekeza kila ombi kwa mtoa huduma anayestahiki mwenye gharama ya chini zaidi bila kutoza zaidi ya bei iliyoorodheshwa na mtengenezaji wa muundo. Usaidizi wa kiwango cha kwanza katika OmniRoute: Chat Completions, endpoint asilia ya /v1/responses, uwezo wa kuona, uitaji wa zana na miundo 3 ya picha (grok-imagine, nano-banana-pro, nano-banana-2, inayofikiwa kama cheaperinference/<model>). Pata ufunguo wa API →

_{Viungo vilivyowekewa alama ya aff=omniroute ni viungo vya washirika. Vinafadhili mradi bila gharama yoyote ya ziada kwako.}

_{🎟️ Ofa za Washirika — kuponi za kujisajili bila malipo kutoka kwa watoa huduma ambao hawatudhamini (bofya ili kupanua)}

_{Sehemu hii ni ya misimbo ya rufaa/kuponi pekee. Ushirikiano unaodhaminiwa unapatikana katika sehemu ya 🤝 Tunaungwa mkono na Marafiki wetu wa Chanzo Huria hapo juu. OmniRoute haina udhamini wala ushirikiano na watoa huduma walioorodheshwa hapa — hizi ni kuponi za umma ambazo mtu yeyote anaweza kutumia.}

AgentRouter agentrouter.org

AgentRouter — usajili wa ushirika · salio la $100 bila malipo unapojisajili (seva ya bila malipo, tarajia ucheleweshaji zaidi — inafaa zaidi kwa majaribio, si kwa uzalishaji). Usaidizi wa kiwango cha kwanza katika OmniRoute tangu v3.8.50: Chat Completions, umbizo la mawasiliano linalooana na Anthropic na njia inayooana na OpenAI. Miundo inayopatikana ni pamoja na claude-opus-4-8, claude-opus-5, gpt-5.6-sol na mingine zaidi. Jipatie $100 yako → ⚠️ Kiungo cha ushirika — OmniRoute haina udhamini wala ushirikiano na mtoa huduma huyu.

_{Unamfahamu mtoa huduma mwingine mwenye kuponi nzuri ya kujisajili bila malipo inayowanufaisha watumiaji wa OmniRoute? Fungua suala nasi tutaliongeza hapa.}

🎯 Combo — Kipengele Kikuu

Combo ni msururu wa modeli ambao OmniRoute huelekeza kupitia kwao kiotomatiki. Kiwango cha matumizi kikiisha, mtoa huduma akishindwa, au gharama zikipanda ghafla, combo inaweza kuhamia kwenye modeli inayofuata inayostahiki na iliyo katika hali nzuri. 🛡️

⚡ Hakuna usanidi — tumia tu auto

Hakuna combo ya kuunda. Weka modeli yako kuwa auto (au lahaja yake), na OmniRoute huunda combo pepe kutoka kwa watoa huduma wako waliounganishwa, huku ikiwapa alama moja kwa moja:

Kitambulisho cha modeli	Kile inachoboresha
auto	🎯 Chaguo-msingi lenye uwiano (LKGP — hushikamana na mtoa huduma wako wa mwisho aliyefanya kazi vizuri)
auto/coding	🧑💻 Uzito unaotanguliza ubora kwa ajili ya kuzalisha msimbo
auto/fast	⚡ Huanzia kwenye muda mfupi zaidi wa kusubiri
auto/cheap	💰 Huanzia kwenye gharama ndogo zaidi kwa tokeni
auto/offline	🔋 Huanzia kwenye nafasi kubwa zaidi ya kiwango cha matumizi / kikomo cha kasi
auto/smart	🔭 Hutanguliza ubora + ugunduzi wa 10% ili kutambua modeli bora zaidi
auto/lkgp	📌 Kushikamana moja kwa moja na mtoa huduma wa mwisho anayejulikana kuwa mzuri
auto/chaos	🧪 Uzito wa kuingiza hitilafu kwa ajili ya kupima ustahimilivu (uhandisi wa vurugu)

🔀 Au unda yako mwenyewe — mikakati 19 ya uelekezaji

Mikakati yote 19 — changanya na ulinganishe katika kila hatua ya combo:

#	Mkakati	Kile unachofanya
1	priority	Orodha iliyopangwa kuanzia lengwa la kwanza — tumia kila moja hadi iishe kabla ya inayofuata 🥇
2	fill-first	Tumia kikamilifu kiwango cha matumizi cha kila lengwa kabla ya kuendelea
3	weighted	Uchaguzi nasibu wenye uzito kulingana na uzito wa kila lengwa
4	round-robin	Pitia malengwa kwa mzunguko kwa mpangilio
5	p2c	Usawazishaji nasibu wa mzigo kwa kutumia chaguo mbili
6	least-used	Chagua lengwa lenye mzigo mdogo zaidi kwa sasa
7	random	Uchaguzi nasibu sawia (marudio yameondolewa)
8	strict-random	Uchaguzi nasibu bila kuondoa marudio 🎲
9	cost-optimized	Punguza $ kwa kila ombi kulingana na bei za moja kwa moja kwenye katalogi 💸
10	headroom	Chagua lengwa lenye kiwango kikubwa zaidi cha matumizi kilichosalia
11	reset-window	Pendelea lengwa ambalo kipindi chake cha kiwango cha matumizi kitawekwa upya mapema zaidi
12	reset-aware	Panga kwa muda wa kuweka upya kiwango cha matumizi — vipindi vifupi kwanza 📊
13	context-relay	Hamisha muktadha kati ya malengwa kwa mazungumzo marefu 🧠
14	context-optimized	Chagua kinachofaa zaidi kwa ukubwa wa sasa wa muktadha
15	cache-optimized	Unganisha kila kiambishi awali cha kidokezo kinachoweza kutumika tena kwenye akaunti ileile — ongeza mafanikio ya akiba ya vidokezo 🎯
16	lkgp	Njia ya Mwisho Inayojulikana Kuwa Nzuri — hushikilia mtoa huduma wa mwisho aliyefanikiwa, kisha hurudi kwenye kanuni ikishindikana
17	auto	Utoaji wa alama moja kwa moja kwa kutumia vipengele 16 kwenye kila muunganisho 🤖
18	fusion	Sambaza ombi kwa jopo la modeli + mwamuzi huunganisha jibu moja 🧬
19	pipeline	Unganisha hatua — matokeo ya kila lengwa huingizwa kwenye linalofuata 🔗

_{Injini ya Auto-Combo huipa kila kandidati alama kwa kutumia vipengele 16 (hali, kiwango cha matumizi, gharama, muda wa kusubiri, ulinganifu na jukumu, ubora, upatikanaji wa kipindi…) — tazama docs/routing/AUTO-COMBO.md.}

🧱 Ustahimilivu umejengewa ndani (tabaka 3 huru)

_{📖 Injini ya Auto-Combo · Mwongozo wa Ustahimilivu}

🏆 Kinachotofautisha OmniRoute

_{📊 Mbinu kamili & maelezo ya kila kipengele dhidi ya 9router, OpenRouter, CLIProxyAPI & LiteLLM → 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 hazina	Bure — husaidia sana kuongeza mwonekano	Weka nyota kwa OmniRoute
🐙 GitHub Sponsors	Mara moja au kila mwezi · hakuna ada ya jukwaa	github.com/sponsors/diegosouzapw
☕ Ko-fi	Bakshishi ya haraka ya mara moja, mfadhili hahitaji kujisajili	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Ishara ndogo, isiyo rasmi	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Inayojirudia · isiyo ya faida · chanzo huria	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazili)	Papo hapo, bila ada	ufunguo & QR hapa chini
₿ Sarafu za kidijitali	BTC · ETH · USDT-TRC20 · USDC-Solana	anwani hapa chini

🇧🇷 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.

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 cha bure kinasalia kuwa ~1.47B tokeni/mwezi kutoka kwenye katalogi iliyoelezwa hapo juu, iliyoondolewa marudio kulingana na kundi. Salio la muda la kujisajili kwa watoa huduma linaweza kuongeza mwezi wa kwanza hadi ~2.07B. Radar ni safu ya ziada ya hiari ya katalogi iliyotiwa saini kwa watu wanaotaka upatikanaji wa miundo ya bure uliosasishwa zaidi kati ya matoleo ya OmniRoute; katalogi ya jumuiya na kila kipengele kilichopo cha bure vinaendelea kuwa bure.

Wafadhili wanaweza kupokea katalogi ya moja kwa moja na fursa za ziada za 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, vigezo vya ustahiki, miundo, au maeneo wakati wowote.

Radar ni ya kujiunga kwa hiari na hutumia GET pekee. Kiteja cha OmniRoute hakipakii vidokezo, trafiki, usanidi wa watoa huduma, telemetria ya matumizi, au hali ya ndani ya kufutwa kwa matangazo. Jifunze kuhusu ustahiki na katalogi ya sasa kwenye radar.omniroute.online/planos.

✨ Mambo Mapya

Vivutio vya hivi karibuni kutoka v3.8.20 → v3.8.50. Historia kamili iko katika CHANGELOG.md.

• 🎛️ OmniConductor — ukabidhi wa A2A unaoingia kwa kundi lako la mawakala, ujuzi wa Conductor kwenye Agent Card, na paneli ya dashibodi yenye gumzo la sauti la kubonyeza-ili-kuzungumza la Faro. → Seva ya A2A
• 🛂 Udhibiti unaobadilika wa ruhusa za kuingia na ulinzi dhidi ya mzigo kupita kiasi — maombi mazito ya gumzo huwekwa kwenye foleni badala ya kurudisha 503, yakiwa na ukodishaji atomiki unaosogea wa RPM kwa kila muunganisho. → Mwongozo wa Ustahimilivu
• 🗂️ Mpangilio sanifu wa /v1/models — bloku moja mfululizo iliyopangwa kwa mtoa huduma kwa kila mtoa huduma (michanganyiko ikibandikwa kwanza), inayobaki thabiti katika kila chanzo cha katalogi. → Rejeleo la API
• 🗜️ Uimarishaji wa mbano — ulinzi dhidi ya upanuzi uliowashwa kwa chaguo-msingi, vifurushi vya Caveman vya DE / FR / JA + Kichina (wényán), vichujio vya RTK vya Gradle na .NET. → Mbano
• 💸 Gharama ya kweli ya kiwango kisichobadilika — watoa huduma wa usajili / mpango wa usimbaji huonyesha $0 katika uchanganuzi wa gharama; bajeti, kiasi kinachoruhusiwa na uelekezaji huendelea kufanya makadirio. → Rejeleo la API
• ⚖️ Uelekezaji wa Quota-Share — gawanya kwa haki kiasi kinachoruhusiwa cha akaunti inayoshirikiwa kati ya funguo zilizokusanywa pamoja, huku mfumo ukiendelea kutumia uwezo uliopo ili sehemu zisizotumika zikopeshwe. → Mwongozo wa Ustahimilivu
• 🤖 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 shabaha 10 zenye kiteuzi shirikishi cha mtoa huduma+modeli na vipendwa kwa kila muktadha. → Miunganisho ya CLI
• 🛰️ Hali ya mbali — endesha OmniRoute ya mbali kwa tokeni zenye wigo (connect / contexts / tokens) + kisaidizi cha OAuth cha antigravity kwa usakinishaji wa VPS. → Hali ya Mbali
• 🧭 Uelekezaji otomatiki wenye akili zaidi — michanganyiko ya auto/<category>:<tier>, Fusion (paneli ya modeli + mwamuzi), uelekezaji unaozingatia jukumu, ubatilishaji wa modeli / hali / bajeti ya USD kwa kila ombi. → Auto-Combo
• 🗜️ Mbano unaoweza kuongezewa moduli — injini 12 zinazoweza kuunganishwa + Compression Studios: LLMLingua-2, Ultra ya ngazi mbili, omniglyph, lango la uaminifu kwa kila hatua, GCF v3.2, kihariri cha kuburuta na kupanga upya. → Mbano
• 🕵️ Usimbuaji fiche wa uwazi wa MITM (TPROXY) — nasa CLI zinazopuuza vigezo vya mazingira vya proksi, kwa kutumia CA ya kila SNI + kisakinishaji cha hifadhi ya uaminifu. → MITM/TPROXY
• 💸 Telemetria ya gharama kila mahali — vichwa vya gharama/matumizi vya X-OmniRoute-* kwenye kila endpoint, kichwa cha akiba ya cache-HIT, vikomo vya matumizi ya USD kwa kila ufunguo. → Rejeleo la API
• 🧠 Kumbukumbu unayoidhibiti — imezimwa kwa chaguo-msingi, ukadiriaji wa vekta wa int8 wa kuwashwa kwa hiari + ufifiaji wenye aina, x-omniroute-no-memory kwa kila ombi. → Kumbukumbu
• 🛡️ Usalama — ulinzi dhidi ya udungaji wa prompt kwenye kila njia ya LLM (msururu wa majaribio ya red-team), ulinzi wa kuficha vitambulisho unaowashwa kwa hiari (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 la OIDC kwa dashibodi (uingiaji kwa nenosiri daima hubaki kupatikana). → Vizuizi vya Usalama
• 🖼️ Endpoint mpya — /v1/ocr (Mistral OCR) na /v1/audio/translations (kwa mtindo wa Whisper) hukamilisha huduma za midia. → Rejeleo la API
• 🎨 Utengenezaji wa picha / video / sauti — API moja ya midia: video za xAI Grok Imagine na Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, na watoa huduma za matamshi kama ElevenLabs. → Rejeleo la API
• 🌍 Usambazaji na uendeshaji — basePath ya reverse-proxy, utambuzi otomatiki wa lugha ya kivinjari, ufuatiliaji wa vifaa kwa kila ufunguo, uaminifu wa MITM usiohitaji root, ujanibishaji wa zh-TW. → Mazingira
• 🤝 Watoa huduma na mawakala zaidi — mawakala wa wingu (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) yenye kivinjari + uingiaji wa OAuth, kadi kamili ya Ollama, Claude Opus 5 na Sonnet 5, ushirikiano rasmi na Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… na katalogi ya watoa huduma 352 iliyosasishwa. → Watoa Huduma
• 📡 Uwazi wa uelekezaji — kila jibu huwa na kichwa cha X-OmniRoute-Decision kinachotaja mkakati/mtoa huduma/muda wa kusubiri uliolitumikia, mkakati mpya wa mchanganyiko wa cache-optimized + kipengele cha Auto-Combo cha cacheAffinity huelekeza maombi yanayorudiwa kwenye muunganisho ulio na kiambishi awali kilichohifadhiwa kwenye cache, na endpoint ya kusoma pekee ya /v1/auto-combo/{channel}/candidates huonyesha kundi hai la wagombea la channel ya auto/*. → Auto-Combo
• ⚡ Utendaji na miundombinu ya ndani — Redis ya ndani kwa mbofyo mmoja, visambazaji vya relay vya Cloudflare Workers / Deno Deploy, Bifrost na Mux kama huduma zilizopachikwa na kusimamiwa. → Huduma Zilizopachikwa
• 🧩 Pia ndani ya kifurushi — mfumo wa programu-jalizi + soko, mifumo ya ujuzi ya Omni/Agent/GitHub, muunganisho wa hifadhi ya Obsidian (zana 22 za MCP), API za Batch na Files zinazooana na OpenAI, cache ya kisemantiki ya majibu, uchezeshaji wenye bao za wanaoongoza, ugunduzi wa mawakala wa ACP (mawakala 15 waliojengewa ndani), uhamishaji wa kumbukumbu ulioratibiwa kwenda BigQuery, udungaji wa hitilafu wa auto/chaos, daraja la boti ya Telegram, kidhibiti cha matoleo ndani ya programu na viwango vya watoa huduma wa bure vya LMArena-ELO. → Nyaraka

🤖 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	Codex CLI	Cline	Kilo Code	Zoo Code	Continue
Aider	ForgeCode	jcode	DeepSeek TUI	CodeWhale	OpenCode
Factory Droid	Copilot CLI	Cursor CLI	Smelt	Pi	Grok Build
Hermes Agent	OpenClaw	Goose	Open Interpreter	Warp AI	Agent Deck

＋ pia hufanya kazi na · Kiro · Command Code · Antigravity · Windsurf · AMP · zana yoyote inayooana na OpenAI

_{📖 Usanidi wa kila zana kwa zana zote 36 (zana 26 za Msimbo za CLI + Mawakala 10 wa CLI) → docs/reference/CLI-TOOLS.md · 🧩 Programu-jalizi ya OpenCode → @omniroute/opencode-provider}

Zindua CLI yoyote inayotumika kupitia OmniRoute kwa amri moja — hakuna faili za usanidi zinazoandikwa, vitambulisho huingizwa kwa kila mchakato, na Qwen/Gemini hupata saraka ya nyumbani ya muda iliyotengwa:

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

Kila amri huheshimu muktadha amilifu wa mbali (omniroute connect <host>), --dry-run huonyesha mapema mazingira/hoja halisi bila kutekeleza, na --api-key-env NAME huzuia siri zisiingie kwenye historia ya shell yako. → Miunganisho ya CLI

🌐 Watoa Huduma 352 wa AI — 152 Waliowekewa Alama ya Bila Malipo kwenye Katalogi

Watoa huduma 352 waliosajiliwa katika mikusanyo rasmi ya gumzo, midia, utafutaji, ya ndani, mawakala wa wingu na mfumo, wakiwemo 152 wenye metadata ya ugunduzi ya hasFree: true. Rejesta ya modeli za gumzo inajumuisha watoa huduma 229 / jozi 2,554 tofauti za mtoa huduma na modeli / vitambulisho ghafi 1,283 vya modeli; katalogi tofauti ya bajeti isiyolipishwa ina safu 443 za kila modeli, makundi 34 yanayojirudia na watoa huduma 53 wa kudumu bila malipo wanaojirudia/wasiohitaji ufunguo. Hivi ni viashiria tofauti vya msingi kwa makusudi; ufafanuzi na hesabu zilizoondolewa marudio ya makundi zinapatikana katika Marejeleo ya Watoa Huduma na Viwango vya Matumizi Bila Malipo.

🏢 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}

🆓 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/siku	NVIDIA NIM GLM, MiniMax ~40 RPM bila malipo	Cerebras GLM 4.7, GPT-OSS Tokeni 1M/siku	OpenRouter Miundo ya :free +$10 → RPM ya juu zaidi

📖 Katalogi kamili inayoweza kusomeka na mashine → 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 · Kompyuta ya mezani · Trei ya upau wa menyu · Termux · PWA · OpenCode}

🧩 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, kielekeze kwenye seva yako ya OmniRoute (chaguo-msingi ni localhost:20128), kisha fungua Copilot Chat → kiteuzi cha modeli → Dhibiti Modeli… → OmniRoute.

Duka	Kiungo	Hufanya kazi na
🧩 VS Code Marketplace	Sakinisha →	VS Code — toleo thabiti & Insiders
🔓 Open VSX Registry	Sakinisha →	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.

_{📖 Mwongozo wa VS Code Copilot Chat — 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 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 (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

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 · Vizuizi vya Usalama · Uzingatiaji}

🔌 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)

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.

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}

🤝 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

# 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 · Seva ya A2A · Itifaki za Mawakala}

🗜️ Okoa Tokeni 15–95% — Kiotomatiki

📖 Jinsi inavyofanya kazi — mfululizo wa uchakataji, usanifu na hesabu ya uokoaji

Mchanganyiko chaguo-msingi uliopangwa kwa mfululizo huendesha RTK → Caveman. Zote mbili zinapotumika kwenye mzigo uleule wa zana/muktadha, uokoaji huongezeka kwa kuzidishana:

combined = 1 − (1 − RTK) × (1 − Caveman_input)
average  = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range    = 78.4 – 94.6%

Vizuizi vya msimbo, URL, JSON na data iliyopangwa hulindwa kila wakati na injini ya uhifadhi.

Kwa nini utumie tokeni nyingi ilhali chache zinatosha? Kila ombi hupitia mfululizo wa ubanaji wa OmniRoute kwa uwazi — hakuna mabadiliko kwa mteja. Sasa ni msururu wa injini 12 zinazoweza kuunganishwa ambazo huendeshwa kwa mpangilio na kuchanganywa kulingana na kila mchanganyiko wa uelekezaji — ukijengwa juu ya mawazo kutoka RTK, Caveman (⭐ 90K+), LLMLingua-2, na Troglodita (PT-BR).

🧱 Msururu wa injini 12

Injini huendeshwa kwa mpangilio wa mfululizo wa uchakataji; 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, kati ya zamu)
2	CCR	Huhifadhi vizuizi vikubwa nyuma ya viashirio vya urejeshaji, ambavyo huchukuliwa 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 inayotanguliza kutopoteza data + ubanaji wa uchunguzi wenye mipaka kwa matokeo ya shell/patch/search/build (Responses API)
6	Headroom	Ubanaji wa jedwali usiopoteza data wa safu za JSON (~30%) kupitia kodeki ya GCF iliyojumuishwa
7	Relevance	Upangaji wa alama za sentensi kwa uchimbaji dhidi ya hoja ya mwisho ya mtumiaji
8	Caveman	Ubanaji wa nathari unaotegemea kanuni (~65–75% kwenye matokeo)
9	Aggressive	Ufupishaji + uzeeshaji endelevu 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 daraja la hiari la 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; vigeuzi vya GPT 5.6 huendelea kukataa kwa usalama hadi stakabadhi za mtoa huduma zipatikane. Wasifu wanne wa ubanaji (mkali kama chaguo-msingi, uliosawazishwa, salama kwa uandishi wa msimbo, upitishaji bila mabadiliko) (mkali zaidi; lazima uchague kuutumia)

Vizuizi vya msimbo, URL na data iliyopangwa huhifadhiwa kila wakati bila kubadilisha hata baiti moja. Mipangilio ya awali ya mbofyo mmoja huunganisha injini:

Hali	Uokoaji	Inafaa zaidi kwa
🪶 Lite	~15%	Chaguo-msingi salama linalowashwa kila wakati
🪨 Standard (Caveman)	~30%	Uandishi wa msimbo wa kila siku
⚡ Aggressive	~50%	Vipindi virefu vinavyotumia zana nyingi
🔥 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 — Hali ya Standard:

Kabla (tokeni 69): "Sababu inayowezekana ya kijenzi chako cha React kuonyeshwa upya ni kwamba unaunda rejeleo jipya la kitu katika kila mzunguko wa uonyeshaji. Unapopitisha kitu kilichoandikwa moja kwa moja kama prop, ulinganishaji wa juu juu wa React hukiona kama kitu tofauti kila wakati, jambo linalosababisha kuonyeshwa upya. Ningependekeza utumie useMemo kuhifadhi kitu hicho kwenye kumbukumbu."

Baada (tokeni 19): "Rejeleo jipya la kitu kila uonyeshaji. Prop ya kitu kilichoandikwa moja kwa moja = rejeleo jipya = kuonyeshwa upya. Kifunge katika useMemo."

Jibu lilelile. Tokeni chache kwa 72%. Hakuna upotevu wa usahihi. ✅

Mfano wa PT-BR — hali ya Troglodita:

Kabla (tokeni 42): "Tatizo ni kwamba kijenzi kinachorwa upya kwa sababu rejeleo jipya la kitu linaundwa katika kila mzunguko wa uchoraji. Ningependekeza kutumia useMemo."

Baada (tokeni 12): "Uchoraji upya: rejeleo jipya kila mzunguko (kitu cha inline kinaundwa upya). Tumia useMemo."

Jibu lilelile. Takriban 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 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 mwitikio; yanaweza kuunganishwa, kila moja likiwa na kiwango cha lite / full / ultra. Kuongeza mtindo ni ingizo la mstari mmoja kwenye sajili:
  • Nathari fupi — ondoa maneno ya ziada / vihisishi / kauli za kusita; 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, tofauti ndogo zaidi inayofanya kazi.
  • Nina ADHD (kitendo kwanza) — anza na kitendo kinachofuata, 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 kizingiti kimoja cha tokeni cha kuwasha/kuzima, ongeza matumizi ya injini za gharama nafuu zaidi na zisizopoteza taarifa kadiri tu inavyohitajika ili kutoshea dirisha la muktadha la modeli. Sera: reserve-output (chaguo-msingi, hutambua modeli) · percentage · absolute. Hali: floor (hakikisha inatoshea) · replace-autotrigger (chaguo lako mahususi linatawala) · off (kizingiti cha zamani).
• 🎛️ Mahali ambapo ufinyazaji unaamuliwa (mpangilio wa kipaumbele, juu → chini) — kichwa cha kila ombi cha x-omniroute-compression › ubatilishaji wa mchanganyiko wa uelekezaji › wasifu uliotajwa unaotumika › urekebishaji / uanzishaji otomatiki › chaguo-msingi la paneli › kuzima. Mpango uliotumika hurudishwa katika kichwa cha mwitikio cha X-OmniRoute-Compression: <mode>; source=<source>.

Anzisha kiotomatiki kwa kizingiti cha tokeni, washa kidhibiti kinachojirekebisha, bandika wasifu uliotajwa, weka mpangilio wa mara moja kwa kila ombi, au gawa mnyororo wa uchakataji kwa kila mchanganyiko wa uelekezaji — lolote linalofaa mzigo wa kazi. Zana ya tathmini ya nje ya mtandao ya kuchagua kutumia (npm run eval:compression) hupima uaminifu dhidi ya uokoaji kwenye mkusanyiko uliobandikwa kabla hujapitisha badiliko.

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

⚡ Anza Haraka

1) Sakinisha na uendeshe

npm install -g omniroute
omniroute

💡 Unaona npm warn ERESOLVE au maonyo ya peer-dep? Hayana madhara.

Dashibodi iko http://localhost:20128 · API iko http://localhost:20128/v1.

2) Unganisha mtoa huduma wa BURE (bila kujisajili)

Dashibodi → Watoa Huduma → unganisha Kiro AI (Claude ya bure, takriban salio 50/mwezi kwa kila akaunti) au OpenCode Free (bila uthibitishaji) → tayari.

3) Elekeza zana yako ya kuandika msimbo

URL ya Msingi: http://localhost:20128/v1
Ufunguo wa API: [nakili kutoka Dashibodi → Vituo vya Mwisho]
Modeli:         auto            (uelekezaji mahiri bila usanidi — au mtoa huduma/modeli yoyote)

4) Thibitisha kuwa inafanya kazi

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

Unapaswa kuona modeli ulizounganisha zikiwa zimeorodheshwa. 🎉 Imekamilika — anza kuandika msimbo, na OmniRoute itakuelekezea kiotomatiki na kutumia njia mbadala inapohitajika.

Ikiwa kiteja chako hakiwezi kutuma vichwa maalum, OmniRoute pia hutoa lakabu za uoanifu zilizo na tokeni:

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 kwa kichwa unabaki kuwa hali inayopendelewa.

📦 Mbinu zaidi za usakinishaji — Docker, msimbo chanzo, pnpm, Arch

🐳 Docker

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.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

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.

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.

🥟 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 .).

# Sakinisha na uendeshe kwa Bun
bun install
bun run dev

🛠️ Kutoka kwenye msimbo chanzo

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Kwa kutumia Nix flakes
nix develop
npm run dev

# Au kwa kutumia devbox
devbox run npm run dev

📖 Mwongozo wa Docker — Wasifu wa Compose, Caddy HTTPS, vichuguu vya Cloudflare.

🦭 Podman

# 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.

📖 Mwongozo wa Podman — 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):

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. 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}

🎬 #1 — Instagram nick_saraev — mitazamo 3,042,474

🎬 #2 — Instagram theopenstack — mitazamo 692,419

🎬 #3 — TikTok milesreevesai — mitazamo 620,400

🎬 #4 — YouTube Vaibhav Sisinty — mitazamo 391,109

🎬 #5 — Instagram buildwithai.club — mitazamo 347,652

Orodha kamili (URL kanuni zilizoondolewa nakala, v > 0, ufikiaji mkubwa zaidi):

#1	#2	#3	#4	#5
nick_saraev — Instagram — 3,042,474	theopenstack — Instagram — 692,419	milesreevesai — TikTok — 620,400	Vaibhav Sisinty — YouTube — 391,109	buildwithai.club — Instagram — 347,652

#6	#7	#8	#9	#10
nivedan.ai — Instagram — 331,973	vaibhavsisinty — Instagram — 263,744	Nick Automates — YouTube Shorts — 218,174	theroshankrishna — Instagram — 186,786	midudev — TikTok — 177,800

Vipimo kanuni vya 2026-08-24: video 1.029 za kipekee · mitazamo 11.132.922 inayojulikana (v > 0) · vituo/wasifu 639 kwa kila mtandao. Paneli ghafi ina mistari 1.070; nakala 41 za Instagram zilisawazishwa kwa kutumia URL kanuni, huku idadi kubwa zaidi kwa kila video ikihifadhiwa.

🎬 Umetengeneza video kuhusu OmniRoute? Fungua suala au mjadala ukiambatisha 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
🐙 GitHub — fuata ili kupata matoleo na vidokezo	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Kimataifa	jiunge na kikundi
🟢 WhatsApp — 🇧🇷 Brazili	jiunge na kikundi
🌍 Tovuti	omniroute.online
🌍 🌍Jumuiya ya StHub OmniRoute (bila malipo)	tovuti ya StHub
📦 Msimbo chanzo	github.com/diegosouzapw/OmniRoute
🐛 Ripoti hitilafu	fungua suala — ambatisha matokeo ya npm run system-info
🤝 Changia	CONTRIBUTING.md · Muundo wa Matawi na Matoleo · chagua good first issue
💚 Saidia mradi	Njia za kusaidia ↑ · Wafadhili wa GitHub

---

🛠️ Teknolojia Zinazotumika

Tabaka	Teknolojia
Mazingira ya utekelezaji	Node.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
Lugha	TypeScript 6.0 — TypeScript 100% kote kwenye src/ na open-sse/ (hakuna any katika msingi tangu v2.0)
Mfumo	Next.js 16 + React 19 + Tailwind CSS 4
Hifadhidata	better-sqlite3 (SQLite, uwekaji kumbukumbu wa WAL) + LowDB (urithi wa JSON) — moduli 122 za vikoa, uhamishaji 176
Kumbukumbu	Maandishi kamili ya SQLite FTS5 + upachikaji wa vekta uliokadiriwa kwa int8, ufifishaji wenye aina maalum
Skima	Zod 4 — uthibitishaji wa I/O wa zana za MCP + mikataba ya API
Itifaki	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Utiririshaji	Server-Sent Events (SSE) + daraja la WebSocket (/v1/ws)
Mfinyazo	Mfumo wa injini 12 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Uthibitishaji & usalama	OAuth 2.0 (PKCE) + JWT + Funguo za API + uthibitishaji wa MCP wenye upeo maalum · AES-256-GCM wakati data imehifadhiwa · DOMPurify
Usiri	wreq-js — uigaji wa alama za vidole za JA3 / JA4 TLS, proksi ya viwango 3
Ustahimilivu	Kivunja saketi, ucheleweshaji unaoongezeka kwa eksponenti, kinga dhidi ya msongamano wa maombi ya wakati mmoja, kujirekebisha kiotomatiki kwa mchanganyiko
Uwekaji kumbukumbu	pino — kumbukumbu za JSON zilizopangwa zenye muktadha wa ombi
Majaribio	Kiendeshaji cha majaribio cha Node.js + Vitest — matamko tuli ya majaribio 39,000+ katika faili 5,100+ za majaribio zinazofuatiliwa (kitengo, ujumuishaji, E2E, usalama, mfumo-ikolojia)
Mifumo	Kompyuta ya mezani (Electron) · Android (Termux) · PWA (kivinjari chochote)
CI/CD	GitHub Actions — uchapishaji wa kiotomatiki kwenye npm + Docker Hub wakati wa kutoa toleo
Viungo	Tovuti · npm · Docker Hub

📖 Nyaraka

📘 Kuanza

Hati	Maelezo
Mwongozo wa Mtumiaji	Watoa huduma, michanganyiko, uunganishaji wa CLI, upelekaji
Mwongozo wa Usanidi	Mbinu kamili za usakinishaji, usanidi wa zana za CLI, usanidi wa itifaki, urekebishaji wa muda wa kuisha
Mwongozo wa Zana za CLI	Usanidi wa kila zana kwa Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Hali ya Mbali	Dhibiti OmniRoute ya mbali (VPS) kutoka kwenye CLI ya kompyuta yako kupitia tokeni za ufikiaji zenye upeo maalum
Usanidi wa Claude Code	Elekeza Claude Code kwenye OmniRoute (ya ndani/mbali) kwa kutumia launch + wasifu mahususi kwa kila modeli
Kuanza Haraka	Usakinishaji wa hatua 3 → unganisha → sanidi

🔧 Uendeshaji na Upelekaji

Hati	Maelezo
Mwongozo wa Docker	Uendeshaji wa Docker, wasifu wa Compose, Caddy HTTPS, njia za mawasiliano, lebo za picha
Mwongozo wa Podman	Uunganishaji wa Quadlet systemd, podman-compose, SELinux
Upelekaji kwenye VM	Mwongozo kamili: usanidi wa VM + nginx + Cloudflare
Upelekaji kwenye Fly.io	Peleka kwenye Fly.io kwa hifadhi endelevu
Mwongozo wa Termux	Endesha OmniRoute kwenye Android kupitia Termux
Mwongozo wa PWA	Usakinishaji wa Progressive Web App, uhifadhi wa muda, usanifu
Mwongozo wa Kuondoa Usakinishaji	Uondoaji safi kwa mbinu zote za usakinishaji
Usanidi wa Mazingira	Vigeu na marejeleo kamili ya .env

🧠 Vipengele na Usanifu

Hati	Maelezo
Usanifu	Usanifu wa mfumo, mtiririko wa data na vipengele vya ndani
Mwongozo wa Mfinyazo	Mtiririko wenye chaguo 7: zima / hafifu / kawaida / mkali / wa juu zaidi / RTK / uliopangwa kwa safu
Mfinyazo wa RTK	Mfinyazo wa matokeo ya amri, vichujio, uaminifu, uthibitishaji, urejeshaji wa matokeo ghafi
Injini za Mfinyazo	Caveman, RTK, mitiririko iliyopangwa kwa safu, violesura vya dashibodi/API/MCP
Muundo wa Kanuni za Mfinyazo	Skima za vifurushi vya kanuni vya JSON kwa vichujio vya Caveman na RTK
Vifurushi vya Lugha vya Mfinyazo	Utambuzi wa lugha na uundaji wa vifurushi vya kanuni vya Caveman
Mwongozo wa Ustahimilivu	Vikatiza saketi, vipindi vya kupoa, foleni, kuzuia msongamano wa maombi ya wakati mmoja, uigaji wa TLS
Injini ya Auto-Combo	Ukadiriaji wa vipengele 16, vifurushi vya hali, kujirekebisha
Mwongozo wa Proksi	Mfumo wa proksi wa viwango 3, soko la 1proxy, CRUD ya sajili
Viwango vya Bure	Saraka iliyounganishwa: makundi 34 ya mara kwa mara yaliyoandikwa / maingizo 452 ya viwango vya bure yaliyoorodheshwa
Matunzio ya Vipengele	Ziara ya kuona ya dashibodi yenye picha za skrini
Nyaraka za Msimbo Msingi	Muhtasari wa msimbo msingi unaoeleweka kwa wanaoanza

🤖 Itifaki na API

Hati	Maelezo
Rejeleo la API	Vituo vyote vya mwisho vyenye mifano
Vipimo vya OpenAPI	Vipimo vya OpenAPI 3.0
Seva ya MCP	Zana 110 za MCP, usanidi wa IDE, programu teja za Python/TS/Go
Mwongozo wa Seva ya MCP	Usakinishaji wa MCP, njia za usafirishaji na rejeleo la zana
Seva ya A2A	Itifaki ya JSON-RPC 2.0, ujuzi, utiririshaji, usimamizi wa kazi
Mwongozo wa Seva ya A2A	Kadi ya wakala wa A2A, kazi, ujuzi na utiririshaji

📋 Mradi na Ubora

Hati	Maelezo
Kuchangia	Usanidi na miongozo ya uendelezaji
Muundo wa Matawi na Matoleo	PR zinalenga wapi (release/*), na maana ya main na tagi
Kumbukumbu ya Mabadiliko	Historia kamili ya matoleo kwa kila toleo
Sera ya Usalama	Kuripoti udhaifu na taratibu za usalama
Mwongozo wa i18n	Usaidizi wa lugha 42, mtiririko wa kazi wa tafsiri, RTL
Orodha Hakiki ya Toleo	Hatua za uthibitishaji kabla ya kutoa toleo
Mpango wa Ufunikaji	Mkakati wa ufunikaji wa majaribio kwa matamko tuli ya majaribio 39,000+ katika faili za majaribio 5,100+ zinazofuatiliwa

⭐ Wachangiaji Wakuu

OmniRoute imeundwa na jumuiya yenye shauku ya programu huria. Watu hawa wametoa michango ya kipekee inayoathiri moja kwa moja ubora, uthabiti na ufikikaji wa mradi. Asanteni.

Wachangiaji wa nje kulingana na pull request zilizounganishwa

Nafasi	Mchangiaji	PR Zilizounganishwa	~Mistari iliyobadilishwa
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{Takwimu zimegandishwa katika kilele cha moja kwa moja cha release/v3.8.50, dafb4ae808, zikiwa na miunganisho hadi 2026-08-24 05:26:03 UTC. Sensa ya GitHub GraphQL iliyogawanywa katika kurasa ina PR 5,911 zilizounganishwa: 2,707 na mmiliki wa hazina, 179 na Dependabot, na PR 3,025 za nje kutoka kwa wachangiaji 535 tofauti. “Mistari iliyobadilishwa” ni nyongeza + ufutaji wa GitHub na inajumuisha faili zilizozalishwa, lockfile, katalogi, tafsiri na nyaraka; ni kiwango cha mabadiliko, si LOC iliyoandikwa. Waliofungana katika kikomo wamejumuishwa.}

Commit zinazohusishwa na GitHub

backryun 🥇 commits 220 zinazohusishwa na GitHub	Paijo 🥈 commits 219 zinazohusishwa na GitHub	Randi 🥉 commits 108 zinazohusishwa na GitHub	Ravi Tharuma 🏅 commits 81 zinazohusishwa na GitHub	Chris 🏅 commits 70 zinazohusishwa na GitHub	Markus Hartung 🏅 commits 69 zinazohusishwa na GitHub · nafasi sawa #6
Dizzle 🏅 commits 69 zinazohusishwa na GitHub · nafasi sawa #6	Jan Leon 🏅 commits 64 zinazohusishwa na GitHub	zenobit 🏅 commits 62 zinazohusishwa na GitHub	Bob.Hou 🏅 commits 51 zinazohusishwa na GitHub · nafasi sawa #10	Xiangzhe 🏅 commits 51 zinazohusishwa na GitHub · nafasi sawa #10

_{Imekaguliwa tena saa 2026-08-24 06:14:31 UTC: commits zinazohusishwa na GitHub zilizoripotiwa na API ya Wachangiaji ya hazina kwa tawi chaguo-msingi la release/v3.8.50. API ilirejesha vitambulisho 525 (watumiaji 415, roboti 2, wasiojulikana 108); jedwali hili halijumuishi mtunzaji, roboti na vitambulisho visivyojulikana, na linadumisha nafasi zinazolingana katika ushindani. Ni tofauti na nafasi za PR zilizounganishwa hapo juu na sensa ya watu 639 ya metadata ya Git iliyo hapa chini.}

🙏 Vipengele, marekebisho ya hitilafu na maboresho ya miundombinu ya wachangiaji hawa ni sehemu ya msingi ya kinachoifanya OmniRoute iwe ya kutegemewa na yenye vipengele vingi. Kila ombi la kuunganisha mabadiliko, kila mfano wa 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.

Andrew 💛 Mfadhili hai wa kila mwezi

Vlad I 💛 Mfadhili hai wa kila mwezi

Paco Cartones 💛 Mfadhili hai wa mara moja

Prof. Igor Morais 💛 Msaidizi wa zamani wa mara moja

longtao 💛 Msaidizi wa zamani wa mara moja

_{… 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+

_{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
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 kwa miongozo ya kina.

Kutoa Toleo Jipya

# 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 na port ya TypeScript ya mradi wa Go 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

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
9router	26,161	Mradi wa awali ambao fork hii imejengwa juu yake — umepanuliwa hapa kwa API za modi nyingi na kuandikwa upya kikamilifu kwa TypeScript.
CLIProxyAPI	48,497	Utekelezaji wa Go uliohamasisha port hii ya JavaScript / TypeScript.
LiteLLM	57,100	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.
codex-chatgpt-web	1,410	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.
free-claude-code	48,112	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.
composer-api	322	Miundo ya Cursor Composer ya uteuzi wa zana, vizuizi vya matokeo na uthibitishaji wa zana iliyorekebishwa katika kitekelezaji asilia cha Cursor.
codex-multi-auth	457	Miundo ya kuingia upya na mzunguko wa tokeni za kuonyesha upya iliyohamishwa hadi kwenye uthibitishaji upya wa Codex OAuth.
opencode-anthropic-auth	510	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.
grok2api-merged	2	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.
TQZHR/grok2api	705	Chanzo kikuu cha msimbo tegemezi nyuma ya grok2api-merged; utekelezaji wake wa modeli, vichwa, payload, Statsig na vichakataji umehifadhiwa katika nasaba ya Grok Web.
chenyme/grok2api	7,520	Chanzo cha msingi cha MIT cha payload na chaguo-msingi za kifaa cha Grok, jenereta ya Statsig, na kichakataji cha result.response
grok2api-pro	27	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.
GrokProxy	50	Proksi yake ya Grok inayothibitishwa kwa cookie na muundo wa utiririshaji wa result.response.token
GrokBridge	5	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.
grok-web-api	14	ChatOptions zake za Rust na skima za bahasha za majibu zilisaidia kuunda aina za maombi na majibu yanayotiririshwa za TypeScript Grok katika OmniRoute.

🗜️ Muktadha na mgandamizo wa tokeni — injini

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
Caveman	100,538	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.
RTK – Rust Token Killer	77,185	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.
headroom	67,310	Mbano wa muktadha unaoweza kutenduliwa (SmartCrusher) — ulihamasisha injini yetu ya headroom na muundo wa alama ya urejeshaji wa ccr.
LLMLingua	6,598	Utafiti wa mbano wa vidokezo (LLMLingua / LLMLingua-2) — ulihamasisha injini yetu ya llmlingua isawazishaji, salama kwa msimbo na inayoendelea kufanya kazi hata ikishindwa.
llmlingua-2-js	31	Uhamishaji wa JS/ONNX (MobileBERT / XLM-RoBERTa) unaotumika kama mfumo wa nyuma wa nyuzi za wafanyakazi kwa injini yetu ya LLMLingua.
Troglodita	40	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.
ponytail	108,957	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).
i-have-adhd	23,526	Mtindo wake wa majibu unaotanguliza vitendo na unaowafaa watu wenye ADHD ulirekebishwa kuwa mtindo mfupi wa matokeo wa OmniRoute katika lugha tano.

🧩 Miundo yenye ufupi, utafiti wa tokeni na zana zinazotambua msimbo

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
TOON	25,233	Unukuzi wa Vitu Unaolenga Tokeni — modeli yake ya safu-wima yenye kichwa pamoja na safu mlalo iliunda hatua yetu ya ufupishaji wa kijedwali.
GCF – Graph Compact Format	41	Muundo wake fupi wa grafu na usanifu wa wasifu wa jumla ulitoa mwongozo kwa ufupishaji wa kijedwali wa OmniRoute na muundo wa kodeki ya Headroom.
gcf-typescript	4	Utekelezaji wa MIT wa TypeScript uliojumuishwa moja kwa moja na kupanuliwa kama kodeki ya wasifu wa jumla ya Headroom.
token-optimizer-mcp	494	Akiba ya Brotli/SQLite pamoja na tofauti ya muktadha kwa kila kipindi — ulihamasisha injini yetu ya session-dedup.
token-savior	1,122	Ufupishaji wa matokeo ya Bash pamoja na wasifu wa MCP — ulihamasisha nidhamu yetu ya kusitisha mbano na upunguzaji wa orodha ya zana za MCP.
token-saver	138	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.
token-optimizer	1,951	"Tafuta tokeni zisizoonekana" — muundo wake wa kuhamisha mzigo pamoja na kishikio kinachoweza kurejeshwa ulitoa mwongozo kwa fikra zetu kuhusu uhamishaji wa CCR.
TokenMizer	28	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.
OmniCompress	3	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".
mcp-compressor	113	Mbano wa skima/maelezo ya zana za MCP — ulitoa mwongozo kwa upunguzaji wetu wa idadi ya vipengele katika orodha ya zana za MCP.
RepoMapper	197	Upangaji wa ramani ya hazina kwa mtindo wa Aider — ulitoa mwongozo kwa uchunguzi wetu wa ramani ya hazina/upangaji wa urejeshaji.
quiet-shell-mcp	4	Upunguzaji elekezi wa matokeo ya shell kupitia MCP — ulithibitisha ufupishaji wetu elekezi wa matokeo ya bash.
ts-morph	6,162	Zana ya TypeScript Compiler API — ilihamasisha uondoaji wetu wa maoni unaotegemea kichanganuzi ambao huhifadhi literali za mifuatano, violezo na semi za kawaida.

🧠 Kumbukumbu na RAG

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
Mem0	63,902	Safu ya kumbukumbu ya jumla — muundo wake wa proksi kama mpaka wa kuandika/kusoma uliunda usanifu wetu wa kumbukumbu.
Letta (MemGPT)	24,382	Mawakala wenye hali na kumbukumbu ya ngazi mbalimbali — ilihamasisha muundo wetu wa ngazi mbalimbali wa Udhibiti na Urejeshaji wa Muktadha (CCR).
WFGY	1,781	Taksonomia 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 angavu

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
llm-interceptor	66	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.
ProxyBridge	5,995	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.

📚 Data ya modeli, uangalizi na UI

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
models.dev	6,555	Hifadhidata huria ya vipimo, bei na uwezo wa modeli za AI — imelandanishwa moja kwa moja na katalogi yetu ya modeli.
React Flow / xyflow	38,108	Maktaba ya grafu inayotegemea nodi inayowezesha Studio yetu ya Mfinyazo ya wakati halisi na Studio ya Mchanganyiko/Uelekezaji.
LangGraph	40,314	Uonyeshaji wa moja kwa moja wa grafu ya mtiririko wa kazi wa LangGraph Studio ulihamasisha mwonekano wa mfululizo wa wakati halisi wa Studio zetu.
Langfuse	33,592	Muundo wake wa uangalizi wa ufuatiliaji → kipindi → uzalishaji uliunda mwonekano wa mporomoko wa Studio yetu ya Mfinyazo.
Kiali	3,631	Uangalizi wa matundu ya huduma ya Istio — ulihamasisha beji zetu za kivunja saketi na vielelezo vya kingo za hitilafu katika Studio ya Uelekezaji/Mchanganyiko.
lobe-icons	2,428	Nembo za chapa za AI/LLM zinazoonyesha ikoni za watoa huduma katika dashibodi yetu.
flag-icons	12,354	Hutoa bendera za SVG zenye leseni ya MIT zinazotumiwa na kiteuzi cha lugha cha README.

🛡️ Usalama

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
awesome-secure-defaults	721	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).

🧭 Zana zinazosaidiana

Mradi	⭐	Jinsi ulivyoihamasisha OmniRoute
ClawRouter	6,564	Ilihamasisha uondoaji wa maombi yanayojirudia, chaguo la dharura lisilo na gharama, mikakati ya Auto-Combo inayoweza kuchomekwa na uainishaji wa dhamira wa lugha nyingi.
Antigravity-Manager	30,652	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.
vscode-antigravity-cockpit	4,817	Muundo wake mfupi wa kuhesabu muda uliosalia hadi uwekaji upya wa kikomo ulihamasisha onyesho linalolingana la kikomo cha mtoa huduma katika OmniRoute.
AionUi	32,230	Miunganisho yake ya ACP ilihamasisha ugunduzi otomatiki wa OmniRoute wa mawakala wa CLI waliosakinishwa.
CodexBar	20,507	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 kwa maelezo.

---

⬆ Rudi juu · Imetengenezwa kwa ❤️ kwa ajili ya jumuiya ya AI ya programu huria.

_{OmniRoute v3.8.51 · Node ≥22.22.2 · Leseni ya MIT · omniroute.online}