OmniRoute/docs/i18n/mt

README (Malti)

🌐 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 · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

🚀 OmniRoute — Il-Gateway tal-IA Bla Ħlas

💰 ~1.47B Token B’Xejn / Xahar

L-akkumulazzjoni manwali tal-livelli b’xejn hija diffiċli — għexieren ta’ SDKs, għexieren ta’ limiti tar-rata, u ebda idea ta’ kemm għandek tassew. OmniRoute jikkataloga 452 entrata ta’ livelli b’xejn mifruxa fuq 34 ċavetta ta’ pools rikorrenti u jikkalkula ċ-ċifra ewlenija tat-tokens mis-16-il pool b’baġit mensili pożittiv ippubblikat flimkien ma’ ħames limiti Groq għal kull mudell, bid-duplikati eliminati skont il-pool kondiviż. Il-kwoti li jinfetħu biss wara verifika tal-identità reġjonali (illum: ModelScope) jintwerew separatament, +~6M wara verifika tal-identità reġjonali, u qatt ma jingħaddu fiċ-ċifra ewlenija. Ir-riżultat jibqa’ viżibbli fid-dashboard (/dashboard/free-tiers).

Sommarju animat tal-paġna diretta /dashboard/free-tiers. Metodoloġija sħiħa (eliminazzjoni tad-duplikati tal-pools, livelli tal-kreditu, termini tal-fornituri): docs/reference/FREE_TIERS.md.

_{Dawn iċ-ċifri jiġu awditjati mill-ġdid kull ġimagħtejn skont il-katalgu dirett u jiċċaqilqu fiż-żewġ direzzjonijiet — fornitur itemm livell b’xejn u n-numru jonqos; jidħol wieħed ġdid u jiżdied. Aħna nippubblikaw dak li effettivament jikkalkula l-katalgu, qatt l-aħjar każ arrotondat ’il fuq.}

⭐ Agħti stilla lir-repo jekk OMNIROUTE għenek tiffranka l-flus u tagħmel xogħlok aktar faċli.

💬 Ingħaqad mal-komunità

👋 Segwi lill-mantenitur — kun l-ewwel li tirċievi fornituri ġodda, ħarġiet u pariri:

Mistoqsijiet, pariri dwar il-fornituri, pjan direzzjonali u appoġġ → Discord · Telegram · WhatsApp 🌍 Globali / 🇧🇷 Brażil / Portal

📈 Il-Gateway Ikompli Jikber

	v3.8.49	v3.8.50	v3.8.51+
🌐 Fornituri	290	352	aktar fil-kju
🧠 IDs uniċi ta’ mudelli taċ-chat	1185	1312	—
🖼️ Pont tal-modalitajiet	—	🆕 viżjoni + awdjo + vidjo	—
📡 Katalgu bla ħlas ta’ Radar	—	🆕 fakultattiv	—
⚖️ Skedar konxju tal-kwota	—	🆕 Quota-Share	—
📊 Telemetrija tal-kwota	—	🆕 diretta	—

→ Pjan Direzzjonali — fit-triq lejn v3.9.0 LTS

🧩 Disponibbli

🚀 Ibda	🚀 Bidu Malajr	📦 Installa	🆓 Ebda konfigurazzjoni
💡 Tgħallem	💥 Il-Wegħda	🤔 Għaliex OmniRoute	🏆 X’Jagħmlu Differenti
⚙️ Karatteristiċi	🎯 Kombinazzjonijiet	🌐 Fornituri	🔌 CLI & MCP
	🗜️ Kompressjoni	🖥️ Fejn Jaħdem	🔒 Privat
👀 Arah	🎬 Fl-Azzjoni	✨ X’Hemm Ġdid	🤖 CLIs Kompatibbli
💚 Appoġġ	💚 Appoġġja / Agħti Donazzjoni	💬 Komunità	💖 Sponsors
📦 Proġett	🛠️ Teknoloġiji Użati	📖 Dokumentazzjoni	👥 Kontributuri

🌐 F'66 lingwa

🆓 Jaħdem mill-ewwel hekk kif tinstallah — l-ebda ċavetta, l-ebda konfigurazzjoni

# Installazzjoni ġdida, mingħajr kredenzjali — `auto` diġà jaħdem:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{Tippreferi backend bla ħlas speċifiku? Sejjaħ oc/… (OpenCode Free) direttament. Imbagħad aqleb għal auto u ħalli lil OmniRoute jagħżel.}

_{📦 Skripts ta’ bidu rapidu biex tikkopjahom u twaħħalhom għal Python, Node.js, PHP, u cURL → examples/quickstart/}

💥 Il-Wegħda

🤔 Għaliex OmniRoute?

🤝 Appoġġjat mill-Ħbieb tagħna tas-Sors Miftuħ

Trid tingħaqad bħala Ħabib tas-Sors Miftuħ? Dawn huma l-kumpaniji li jappoġġjaw is-sors miftuħ u jgħinu biex OmniRoute jibqa’ miexi ’l quddiem — u aħna ngħidu pubblikament fejn imur kull token li jagħtuna. Ikkuntattjana: diegosouza.pw@outlook.com

Kimi Moonshot AI

Grazzi lil Kimi (Moonshot AI), il-Ħabib Fundatur tagħna tas-Sors Miftuħ, talli qed jappoġġja dan il-proġett! Kimi huwa l-laboratorju tal-AI wara l-familji ta’ mudelli b’piżijiet miftuħa K2 u K3 — Kimi K3 jipprovdi tieqa tal-kuntest ta’ 1M token, viżjoni nattiva u programmazzjoni tal-ogħla livell bi frazzjoni tal-prezzijiet tal-mudelli magħluqa, u jaħdem minnufih ma’ Claude Code, Codex u kull għodda tal-ipprogrammar li jservi OmniRoute. X’jiffinanzja l-appoġġ ta’ Kimi: Il-krediti tal-API ta’ Kimi jħaddmu l-pipeline tar-rilaxxi vvalidat bl-AI ta’ OmniRoute — l-istadju ta’ validazzjoni tal-merge mħaddma minn Kimi K3 li jirrevedi kull pull request qabel ma jiġi rilaxxat — kif ukoll l-iżvilupp ta’ karatteristiċi ta’ kuljum. L-appoġġ nattiv għal Kimi jiġi pprovdut permezz taż-żewġ kanali: il-Kimi API diretta (kimi-k3) u l-pjan ta’ programmazzjoni Kimi Code (OAuth u ċavetta tal-API). OmniRoute huwa wkoll l-ewwel proġett Brażiljan b’sors miftuħ fil-programm ta’ appoġġ ta’ Kimi. Ikseb ċavetta tal-API ta’ Kimi bi 15% krediti addizzjonali →

Cheaper Inference cheaperinference.com

Grazzi lil Cheaper Inference, Ħabib tas-Sors Miftuħ ta’ OmniRoute, talli qed jappoġġja dan il-proġett! Cheaper Inference huwa gateway ikklassifikat skont l-ispiża li jerġa’ jbigħ 42 mudell tal-ogħla livell — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok u MiniMax — permezz ta’ endpoint wieħed kompatibbli ma’ OpenAI, u jidderieġi kull talba lejn l-orħos fornitur eliġibbli mingħajr qatt ma jitlob aktar mill-prezz uffiċjali tal-produttur tal-mudell. Appoġġ nattiv f’OmniRoute: Chat Completions, l-endpoint nattiv /v1/responses, viżjoni, sejħiet tal-għodod u 3 mudelli tal-immaġnijiet (grok-imagine, nano-banana-pro, nano-banana-2, aċċessibbli bħala cheaperinference/<model>). Ikseb ċavetta tal-API →

_{Il-links immarkati b’aff=omniroute huma links ta’ sħab. Dawn jiffinanzjaw il-proġett mingħajr ebda spiża addizzjonali għalik.}

_{🎟️ Promozzjonijiet tal-Affiljati — kupuni b’xejn għar-reġistrazzjoni mingħand fornituri li ma jisponsorjawniex (ikklikkja biex tespandi)}

_{Din it-taqsima hija biss għal kodiċijiet ta’ riferiment/kupuni. Is-sħubijiet sponsorjati jinsabu fit-taqsima 🤝 Appoġġjat mill-Ħbieb tagħna tas-Sors Miftuħ hawn fuq. OmniRoute m’għandu ebda sponsorizzazzjoni jew sħubija mal-fornituri elenkati hawnhekk — dawn huma kupuni pubbliċi li jista’ juża kulħadd.}

AgentRouter agentrouter.org

AgentRouter — reġistrazzjoni permezz ta’ affiljat · $100 fi krediti b’xejn mar-reġistrazzjoni (server b’xejn, stenna latenza ogħla — l-aħjar għall-ittestjar, mhux għall-produzzjoni). Appoġġ nattiv f’OmniRoute minn v3.8.50: Chat Completions, il-format ta’ komunikazzjoni kompatibbli ma’ Anthropic u l-path kompatibbli ma’ OpenAI. Il-mudelli disponibbli jinkludu claude-opus-4-8, claude-opus-5, gpt-5.6-sol u oħrajn. Ħu l-$100 tiegħek → ⚠️ Link ta’ affiljat — OmniRoute m’għandu ebda sponsorizzazzjoni jew sħubija ma’ dan il-fornitur.

_{Taf b’fornitur ieħor li joffri kupun ġeneruż u b’xejn għar-reġistrazzjoni li jkun ta’ benefiċċju għall-utenti ta’ OmniRoute? Iftaħ issue u nżiduh hawnhekk.}

🎯 Combos — Il-Prodott Ewlieni

Combo hija katina ta’ mudelli li OmniRoute jagħmel routing bejniethom awtomatikament. Jekk il-kwota tispiċċa, fornitur ifalli, jew l-ispejjeż jogħlew f’daqqa, il-combo tista’ tgħaddi għall-mudell eliġibbli u operattiv li jmiss. 🛡️

⚡ Mingħajr konfigurazzjoni — uża biss auto

M’hemmx għalfejn toħloq combo. Issettja l-mudell tiegħek għal auto (jew varjant) u OmniRoute jibni combo virtwali mill-fornituri konnessi tiegħek, evalwati f’ħin reali:

ID tal-Mudell	Għal xiex jottimizza
auto	🎯 Valur predefinit ibbilanċjat (LKGP — jibqa’ mal-aħħar fornitur tajjeb tiegħek)
auto/coding	🧑💻 Piżijiet li jagħtu prijorità lill-kwalità għall-ġenerazzjoni tal-kodiċi
auto/fast	⚡ L-inqas latenza l-ewwel
auto/cheap	💰 L-orħos għal kull token l-ewwel
auto/offline	🔋 L-akbar marġni disponibbli ta’ kwota / limitu tar-rata l-ewwel
auto/smart	🔭 Il-kwalità l-ewwel + 10% esplorazzjoni biex jinstabu mudelli aħjar
auto/lkgp	📌 Persistenza espliċita mal-aħħar fornitur magħruf bħala tajjeb
auto/chaos	🧪 Piżijiet għall-injezzjoni ta’ ħsarat għall-ittestjar tar-reżiljenza (inġinerija tal-kaos)

🔀 Jew ibni tiegħek — 19-il strateġija tar-routing

Id-19-il strateġija kollha — ħallat u qabbel għal kull pass tal-combo:

#	Strateġija	X’tagħmel
1	priority	Lista ordnata bl-ewwel mira bħala prijorità — eżawrixxi kull waħda qabel taqleb għal dik li jmiss 🥇
2	fill-first	Uża l-kwota kollha ta’ kull mira qabel tgħaddi għal dik li jmiss
3	weighted	Għażla aleatorja ponderata skont il-piż ta’ kull mira
4	round-robin	Iddur mal-miri skont l-ordni
5	p2c	Ibbilanċjar aleatorju tat-tagħbija bil-metodu tal-għażla bejn tnejn
6	least-used	Agħżel il-mira bl-inqas tagħbija attwali
7	random	Għażla aleatorja uniformi (mingħajr duplikati)
8	strict-random	Għażla aleatorja mingħajr ma jitneħħew ir-repetizzjonijiet 🎲
9	cost-optimized	Imminimizza l-$ għal kull talba skont l-ipprezzar dirett tal-katalgu 💸
10	headroom	Agħżel il-mira bl-akbar kwota li jifdal
11	reset-window	Ippreferi l-mira li t-tieqa tal-kwota tagħha tiġi ssettjata mill-ġdid l-aktar kmieni
12	reset-aware	Ikklassifika skont il-ħin tal-issettjar mill-ġdid tal-kwota — it-twieqi qosra l-ewwel 📊
13	context-relay	Għaddi l-kuntest bejn il-miri għal konverżazzjonijiet twal 🧠
14	context-optimized	Agħżel l-aħjar għażla għad-daqs attwali tal-kuntest
15	cache-optimized	Waħħal kull prefiss riutilizzabbli tal-prompt mal-istess kont — massimizza s-suċċessi fil-cache tal-prompt 🎯
16	lkgp	L-Aħħar Rotta Magħrufa bħala Tajba — iżomm mal-aħħar fornitur li rnexxa, imbagħad juża r-regoli bħala alternattiva
17	auto	Evalwazzjoni diretta b’16-il fattur fil-konnessjonijiet kollha 🤖
18	fusion	Jibgħat it-talba lil grupp ta’ mudelli + arbitru jissintetizza tweġiba waħda 🧬
19	pipeline	Jikkatina l-passi — l-output ta’ kull mira jiddaħħal f’dik li jmiss 🔗

_{Il-magna Auto-Combo tevalwa kull kandidat skont 16-il fattur (saħħa, kwota, spiża, latenza, adegwatezza għall-kompitu, kwalità, disponibbiltà tas-sessjoni…) — ara docs/routing/AUTO-COMBO.md.}

🧱 Ir-reżiljenza hija integrata (3 saffi indipendenti)

_{📖 Magna Auto-Combo · Gwida għar-Reżiljenza}

🏆 X’Jiddistingwi lil OmniRoute

_{📊 Metodoloġija sħiħa & dettalji għal kull karatteristika mqabbla ma’ 9router, OpenRouter, CLIProxyAPI & LiteLLM → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md}

💚 Appoġġja lil OmniRoute

OmniRoute huwa liċenzjat taħt MIT u miżmum b’mod miftuħ. Jekk jiffrankalek il-ħin jew il-flus, hawn kif tista’ tgħinu jibqa’ indipendenti — agħżel dak li jaqbillek. L-isponsorizzazzjoni qatt ma taffettwa l-prijorità tar-routing; tixtri viżibbiltà, mhux klassifikazzjoni.

⭐ Agħti stilla lir-repożitorju	Bla ħlas — tassew jgħin il-viżibbiltà	Agħti stilla lil OmniRoute
🐙 GitHub Sponsors	Ta’ darba jew kull xahar · ebda tariffa tal-pjattaforma	github.com/sponsors/diegosouzapw
☕ Ko-fi	Donazzjoni ta’ darba u malajr, mingħajr reġistrazzjoni għad-donatur	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Ġest żgħir u informali	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Rikorrenti · mingħajr skop ta’ qligħ · sors miftuħ	liberapay.com/diegosouzapw
🇧🇷 PIX (Brażil)	Immedjat, mingħajr tariffi	iċ-ċavetta & il-QR hawn taħt
₿ Kripto	BTC · ETH · USDT-TRC20 · USDC-Solana	l-indirizzi hawn taħt

🇧🇷 PIX — immedjat, mingħajr tariffi (Brażil)

Ċavetta (każwali): 5d865059-bc44-483a-962d-43ceb80126eb

Pix biex tikkopja u twaħħal:

00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD

₿ Kripto — BTC · ETH · USDT-TRC20 · USDC-Solana (ikklikkja biex tiftaħ)

₿ BTC	Bitcoin (SegWit)	bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH	Ethereum (ERC20)	0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT	Tron (TRC20)	TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC	Solana	2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu

_{⚠️ Ibgħat kull munita biss fuq in-network indikat — jekk tibgħatha fuq network ħażin tista’ titlef il-fondi.}

🐛 Sibt bug jew għandek kummenti? Iftaħ Diskussjoni.

Noti għall-iżviluppaturi: Il-proġett jista’ jiġġenera fajl lokali .env waqt npm install/postinstall għall-konvenjenza tal-iżviluppaturi. Dan il-fajl jiġi injorat intenzjonalment permezz ta’ .gitignore (ara .gitignore) u qatt ma għandu jiġi kkommittjat — jekk jiġi kkommittjat bi żball, dawwar kwalunkwe sigriet espost u neħħi l-fajl mill-istorja. Ara docs/DEVELOPER-ENVIRONMENT.md għal gwida dwar il-ġestjoni tal-fajls tal-ambjent lokali u tas-sigrieti.

📡 Radar ta’ OmniRoute

It-titlu ewlieni tal-pjan bla ħlas jibqa’ ~1.47B tokens/xahar mill-katalgu ddokumentat hawn fuq, bid-duplikati eliminati bejn il-pools. Il-krediti temporanji tar-reġistrazzjoni mal-fornituri jistgħu separatament jgħollu l-ewwel xahar għal ~2.07B. Radar huwa saff fakultattiv u ffirmat fuq il-katalgu għal dawk li jixtiequ disponibbiltà aktar aġġornata ta’ mudelli bla ħlas bejn ir-rilaxxi ta’ OmniRoute; il-katalgu tal-komunità u kull karatteristika eżistenti bla ħlas jibqgħu bla ħlas.

Il-partitarji jistgħu jirċievu l-katalgu dirett u opportunitajiet addizzjonali mingħand il-fornituri. Il-limitu separat u li jista’ jinbidel tiegħu huwa madwar 3B tokens/xahar l-aktar, skont id-disponibbiltà tal-fornituri. Dak il-limitu mhuwiex garanzija: il-fornituri jistgħu jibdlu l-kwoti, l-eliġibbiltà, il-mudelli jew ir-reġjuni fi kwalunkwe ħin.

Radar huwa fakultattiv u juża GET biss. Il-klijent OmniRoute ma jtellax prompts, traffiku, konfigurazzjoni tal-fornituri, telemetrija tal-użu, jew l-istat lokali ta’ tħabbiriet miċħuda. Sir af dwar l-eliġibbiltà u l-katalgu attwali fuq radar.omniroute.online/planos.

✨ X’hemm Ġdid

Punti ewlenin reċenti minn v3.8.20 → v3.8.50. L-istorja sħiħa tinsab f’CHANGELOG.md.

• 🎛️ OmniConductor — delega A2A deħlin lejn il-flotta tal-aġenti tiegħek, ħiliet ta’ Conductor fuq l-Agent Card, u pannell tad-dashboard b’chat bil-vuċi push-to-talk permezz ta’ Faro. → Server A2A
• 🛂 Ammissjoni adattiva u protezzjoni kontra tagħbija żejda — talbiet taċ-chat intensivi jitqiegħdu fil-kju minflok jirritornaw 503, b’kirjiet rolling RPM atomiċi għal kull konnessjoni. → Gwida għar-Reżiljenza
• 🗂️ Ordni kanoniku ta’ /v1/models — blokka waħda kontigwa miġbura skont il-fornitur għal kull fornitur (il-combos imwaħħla l-ewwel), stabbli f’kull sors tal-katalgu. → Referenza tal-API
• 🗜️ Tisħiħ tal-kompressjoni — protezzjoni kontra l-inflazzjoni attivata awtomatikament, pakketti Caveman għal DE / FR / JA + Ċiniż (wényán), filtri RTK għal Gradle u .NET. → Kompressjoni
• 💸 Spiża fissa onesta — il-fornituri ta’ abbonamenti / pjanijiet ta’ kodifikazzjoni juru $0 fl-analitika tal-ispejjeż; il-baġit, il-kwota u r-routing jibqgħu jagħmlu stimi. → Referenza tal-API
• ⚖️ Routing Quota-Share — jaqsam il-kwota ta’ kont kondiviż b’mod ġust bejn ċwievet miġbura flimkien, filwaqt li jikkonserva x-xogħol sabiex ishma mhux użati jiġu mislufa. → Gwida għar-Reżiljenza
• 🤖 Konfigurazzjoni tas-CLI/aġent bi kmand wieħed — 13-il kmand setup-* irreġistrat; omniroute run iniedi 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); omniroute configure jappoġġja 10 miri b’selettur interattiv ta’ fornitur+mudell u favoriti għal kull kuntest. → Integrazzjonijiet tas-CLI
• 🛰️ Modalità remota — ikkontrolla OmniRoute remot b’tokens b’ambitu limitat (connect / contexts / tokens) + għodda awżiljarja OAuth antigravity għal installazzjonijiet fuq VPS. → Modalità Remota
• 🧭 Routing awtomatiku aktar intelliġenti — combos auto/<category>:<tier>, Fusion (pannell tal-mudelli + ġudikatur), routing konxju tal-kompitu, u sostituzzjonijiet għal kull talba tal-mudell / modalità / baġit f’USD. → Auto-Combo
• 🗜️ Kompressjoni modulari — 12-il magna kompożibbli + Compression Studios: LLMLingua-2, Ultra b’żewġ livelli, omniglyph, kontroll tal-fedeltà għal kull pass, GCF v3.2, editur ta’ ridistribuzzjoni bit-tkaxkir. → Kompressjoni
• 🕵️ Deċifrar MITM trasparenti (TPROXY) — jaqbad CLIs li jinjoraw il-varjabbli tal-ambjent tal-proxy, b’CA għal kull SNI + installatur għall-maħżen taċ-ċertifikati fdati. → MITM/TPROXY
• 💸 Telemetrija tal-ispejjeż kullimkien — headers tal-ispejjeż/użu X-OmniRoute-* fuq kull endpoint, header għat-tfaddil minn cache-HIT, kwoti ta’ nfiq f’USD għal kull ċavetta. → Referenza tal-API
• 🧠 Memorja li tikkontrolla int — diżattivata awtomatikament, kwantizzazzjoni vettorjali int8 fakultattiva + degradazzjoni ttajpjata, x-omniroute-no-memory għal kull talba. → Memorja
• 🛡️ Sigurtà — protezzjoni kontra l-injezzjoni ta’ prompts fuq kull rotta LLM (sett ta’ testijiet red-team), salvagwardja fakultattiva għall-maskraġġ tal-kredenzjali (taħbi ċwievet API/sigrieti żvelati fiż-żewġ direzzjonijiet), tfittxija fuq il-web b’DuckDuckGo bla ħlas bħala l-aħħar għażla, u kontroll fakultattiv tal-login OIDC għad-dashboard (il-login bil-password jibqa’ dejjem disponibbli). → Salvagwardji
• 🖼️ Endpoints ġodda — /v1/ocr (Mistral OCR) u /v1/audio/translations (stil Whisper) jikkompletaw il-firxa tal-media. → Referenza tal-API
• 🎨 Ġenerazzjoni ta’ immaġnijiet / vidjow / awdjo — API waħda għall-media: vidjow minn xAI Grok Imagine u Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, u fornituri tad-diskors bħal ElevenLabs. → Referenza tal-API
• 🌍 Distribuzzjoni u operazzjonijiet — basePath ta’ reverse proxy, detezzjoni awtomatika tal-lingwa tal-browser, traċċar tal-apparat għal kull ċavetta, fiduċja MITM mingħajr root, lokalizzazzjoni zh-TW. → Ambjent
• 🤝 Aktar fornituri u aġenti — aġenti cloud (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) b’browser + login OAuth, karta Ollama tal-ewwel klassi, Claude Opus 5 u Sonnet 5, sħubija uffiċjali ma’ Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… u katalgu ta’ 352 fornitur aġġornat. → Fornituri
• 📡 Trasparenza tar-routing — kull tweġiba tinkludi header X-OmniRoute-Decision li jsemmi l-istrateġija/fornitur/latenza li pprovdewha, strateġija combo ġdida cache-optimized + il-fattur cacheAffinity ta’ Auto-Combo jirrototja talbiet ripetuti lura lejn il-konnessjoni li żżomm il-prefiss fil-cache, u endpoint read-only /v1/auto-combo/{channel}/candidates jesponi l-grupp dirett ta’ kandidati ta’ kanal auto/*. → Auto-Combo
• ⚡ Prestazzjoni u infrastruttura lokali — Redis lokali bi klikk waħda, għodod ta’ distribuzzjoni relay għal Cloudflare Workers / Deno Deploy, Bifrost u Mux bħala servizzi integrati taħt superviżjoni. → Servizzi Integrati
• 🧩 Inkluż ukoll — qafas tal-plugins + marketplace, oqfsa tal-ħiliet Omni/Agent/GitHub, integrazzjoni ma’ vault ta’ Obsidian (22 għodda MCP), APIs Batch u Files kompatibbli ma’ OpenAI, cache semantiku tat-tweġibiet, gamifikazzjoni b’klassifiki, skoperta ta’ aġenti ACP (15-il aġent integrat), esportazzjoni skedata tal-logs lejn BigQuery, injezzjoni ta’ ħsarat auto/chaos, pont għal bot ta’ Telegram, maniġer tal-verżjonijiet fl-app u klassifiki LMArena-ELO ta’ fornituri bla ħlas. → Dokumentazzjoni

🤖 CLIs u Aġenti tal-Kodifikazzjoni Kompatibbli

Konfigurazzjoni waħda — http://localhost:20128/v1 — u kull IDE jew CLI tal-AI jaħdem b’mudelli bla ħlas u bi prezz baxx.

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

＋ jaħdem ukoll ma’ · Kiro · Command Code · Antigravity · Windsurf · AMP · kwalunkwe għodda kompatibbli ma’ OpenAI

_{📖 Konfigurazzjoni għal kull għodda għas-36 għodda kollha (26 CLI Code + 10 CLI Agents) → docs/reference/CLI-TOOLS.md · 🧩 Plugin ta’ OpenCode → @omniroute/opencode-provider}

Ħaddem kwalunkwe CLI appoġġjata permezz ta’ OmniRoute bi kmand wieħed — mingħajr ma jinkitbu fajls ta’ konfigurazzjoni, bil-kredenzjali injettati għal kull proċess, u Qwen/Gemini jingħataw home iżolat u temporanju:

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"

# Jew agħżel il-fornitur+mudell b’mod interattiv u ikteb il-konfigurazzjoni tal-għodda stess:
omniroute configure codex          # ukoll: claude opencode qwen aider goose gemini cline continue kilo

Kull kmand jirrispetta l-kuntest remot attiv (omniroute connect <host>), --dry-run juri minn qabel l-env/args eżatti mingħajr ma jeżegwixxi, u --api-key-env NAME iżomm is-sigrieti barra mill-istorja tas-shell tiegħek. → Integrazzjonijiet CLI

🌐 352 Fornitur tal-IA — 152 Immarkati fil-Katalgu bħala Bla Ħlas

352 fornitur irreġistrat fil-kollezzjonijiet kanoniċi taċ-chat, tal-midja, tat-tiftix, lokali, tal-aġenti tal-cloud u tas-sistema, inklużi 152 li għandhom metadata ta’ skoperta hasFree: true. Ir-reġistru tal-mudelli taċ-chat ikopri 229 fornitur / 2,554 par distint ta’ fornitur-mudell / 1,283 ID mhux ipproċessat ta’ mudell; il-katalgu separat tal-baġits bla ħlas għandu 443 ringiela għal kull mudell, 34 pool rikorrenti u 53 fornitur rikorrenti/mingħajr ċavetta li jibqgħu bla ħlas għal dejjem. Dawn huma denominaturi differenti apposta; id-definizzjonijiet u l-kalkoli bid-duplikati tal-pools eliminati jinsabu fir-Referenza tal-Fornituri u fil-Livelli Bla Ħlas.

🏢 Kull laboratorju ewlieni — permezz ta’ endpoint wieħed

OpenAI	Anthropic	Gemini	xAI Grok	DeepSeek	Mistral
Qwen	Meta Llama	Groq	NVIDIA	MiniMax	Cohere
Perplexity	HuggingFace	Together	Fireworks	Cloudflare	Baidu

_{…u aktar minn 330 oħra — kull ikona tittella’ direttament mill-katalgu tal-fornituri tad-dashboard. 📖 Referenza tal-Fornituri}

🆓 Bla Ħlas Għal Dejjem — $0, mingħajr karta

OpenCode Zen DeepSeek V4, Nemotron 3 Bla limitu ta' tokens	Kilo Code Router awtomatiku, Tencent Hy3 B'xejn għal dejjem	Requesty GPT-OSS 120B, Nemotron B'xejn għal dejjem	SiliconFlow DeepSeek V3.2 / R1 Livell bla ħlas	Z.AI GLM GLM-4.7 / 4.5-Flash B'xejn għal dejjem	Baidu ERNIE ERNIE 4.0 B'xejn għal dejjem
Qoder AI Qwen3-Max, Kimi-K2 B'XEJN mingħajr limitu	Pollinations GPT, Llama, Claude Ebda ċavetta meħtieġa	Cloudflare AI 50+ mudell 10K newroni/kuljum	NVIDIA NIM GLM, MiniMax ~40 RPM b'xejn	Cerebras GLM 4.7, GPT-OSS 1M tokens/kuljum	OpenRouter mudelli :free +$10 → RPM ogħla

📖 Katalgu sħiħ li jista' jinqara mill-magni → docs/reference/PROVIDER_REFERENCE.md

🖥️ Fejn Jaħdem OmniRoute — Kullimkien

L-istess app, il-magna tiegħek, ir-regoli tiegħek. Minn installazzjoni globali b’npm sa fuq il-mobile tiegħek permezz ta’ Termux.

Pjattaforma	Installazzjoni	Punti ewlenin
📦 npm (globali)	npm install -g omniroute	Kmand wieħed, kwalunkwe OS
🐳 Docker	docker run … diegosouzapw/omniroute	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	npm run electron:build	Tieqa nattiva + system tray — Windows / macOS / Linux
🎩 Menu bar (OmniRouteTray)	brew install --cask zoispag/tap/omniroute-tray	Jissorvelja u jaġġorna awtomatikament is-server — macOS
💪 ARM	arm64 nattiv	Raspberry Pi, servers ARM, Apple Silicon
📱 Android (Termux)	pkg install nodejs && npx -y omniroute	Jaħdem fuq il-mobile tiegħek, 24/7, mingħajr root
📲 PWA	"Żid mal-Iskrin Prinċipali"	Skrin sħiħ, offline, jista’ jiġi installat mill-browser
🧩 Plugin ta’ OpenCode	@omniroute/opencode-provider	Integrazzjoni nattiva ma’ OpenCode
🤖 VS Code Copilot Chat	installa l-estensjoni OmniCopilot	Kull mudell ta’ OmniRoute fis-selettur nattiv ta’ Copilot Chat — stable u Insiders
🛠️ Mill-kodiċi sors	npm install && npm run dev	Immodifikah, ikkontribwixxi

_{📖 Gwida għal Docker · Desktop · Tray tal-menu bar · Termux · PWA · OpenCode}

🧩 Ġdid: OmniRoute ġewwa l-Copilot Chat nattiv ta’ VS Code

L-ebda sidebar ġdida, l-ebda interfaċċa ġdida għaċ-chat — kull mudell li joffri OmniRoute jidher direttament fis-selettur tal-mudelli ta’ Copilot Chat li diġà tuża. Minn VS Code 1.122 ’il quddiem, il-mudelli tal-providers jaħdmu mingħajr sign-in ma’ GitHub jew abbonament għal Copilot — modalità ta’ aġent, sejħiet ta’ għodod u viżjoni, b’xejn.

Installa l-estensjoni OmniCopilot, qabbadha mas-server OmniRoute tiegħek (b’mod awtomatiku localhost:20128), imbagħad iftaħ Copilot Chat → is-selettur tal-mudelli → Immaniġġja l-Mudelli… → OmniRoute.

Ħanut	Link	Jaħdem ma’
🧩 VS Code Marketplace	Installa →	VS Code — stable u Insiders
🔓 Open VSX Registry	Installa →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Minn ġewwa l-editur: iftaħ il-veduta Extensions, fittex "OmniRoute", ikklikkja Install — jaħdem bl-istess mod fiż-żewġ ħwienet. Il-kodiċi sors, l-issues u l-gwida għall-pubblikazzjoni jinsabu fuq diegosouzapw/OmniCopilot.

_{📖 Gwida għal VS Code Copilot Chat — konfigurazzjoni, x’juri s-selettur, dashboard f’tab, soluzzjoni tal-problemi}

🎩 Ġdid: OmniRouteTray — il-gateway tiegħek, jgħix fil-menu bar

omniroute serve jaħdem l-aħjar meta jkun dejjem mixgħul. OmniRouteTray jibdlu f’app tal-menu bar għal macOS li tikkonfiguraha darba u tħalliha taħdem: jistartja s-server, iżommu jaħdem wara restarts, jaġġornah fuq il-post, u jqiegħed il-baġit tat-tokens tiegħek f’ħin reali klikk waħda biss ’il bogħod — mingħajr tieqa tat-terminal li tibqa’ miftuħa, u mingħajr npm install -g omniroute li trid tibqa’ tieħu ħsiebu.

Mibni b’Tauri v2 (qalba Rust żgħira daqs żball ta’ approssimazzjoni), jiġi bir-runtime iffirmat tiegħu stess ta’ Node 24 u jimmaniġġja installazzjoni ta’ OmniRoute proprjetà tal-app, għalhekk qatt ma jidħol f’kunflitt man- node/bun globali tiegħek. Huwa jaqsam il-konfigurazzjoni u d-database eżistenti tiegħek f’~/.omniroute/ — għalhekk huwa l-istess OmniRoute li diġà tħaddem, sempliċement b’kappell. 🎩

X’jagħmel	Kif
🟢 Jissorvelja s-server	Iniedi omniroute serve, u jadotta istanza li diġà qed taħdem minflok jidduplikaha
📊 Użu f’ħin reali f’daqqa t’għajn	Bars tal-kwota tal-providers, limiti tas-sessjoni/ta’ kull ġimgħa ta’ Claude b’countdowns għar-reset, rendikont tal-ispejjeż ta’ 30 jum
🔄 Jaġġorna awtomatikament fuq il-post	Installazzjoni fi stadji, bdil atomiku, rollback f’każ ta’ falliment — dejjem fuq l-aktar rilaxx ġdid
🚀 Ibda mal-login	Tnedija fakultattiva mal-login; tray biss, mingħajr ikona fid-dock
🩺 Dijanjostika u logs	Dijanjostika bi klikk waħda u aċċess għal-logs tas-server

brew install --cask zoispag/tap/omniroute-tray

_{Tippreferi tniżżel? Ikseb l-aħħar .dmg</code minn Ir-Rilaxxi. Il-kodiċi sors, il-kwistjonijiet u d-dokumentazzjoni tal-bini jinsabu fuq zoispag/omniroute-tray.
💛 Proġett tal-komunità minn @zoispag — mhuwiex rilaxx uffiċjali ta’ OmniRoute.}

🔒 Privat u Lokali mill-Bidu

_{📖 Awtorizzazzjoni · Miżuri ta' Protezzjoni · Konformità}

🔌 CLI Sħiħa + A2A u MCP

Lil hinn mis-server, OmniRoute huwa kabina sħiħa mil-linja tal-kmand b'aktar minn 80 kmand, flimkien ma' protokolli miftuħa għall-aġenti sabiex aġent tal-IA jkun jista' jħaddmu waħdu.

⌨️ CLI vera (mhux biss start)

omniroute               # isservi l-gateway + dashboard (port 20128)
omniroute chat          # klijent taċ-chat TUI interattiv (slash: /model /combo /skill /memory)
omniroute setup         # assistent iggwidat għall-ewwel tħaddim
omniroute doctor        # jiddijanjostika l-fornituri, il-ports u d-dipendenzi nattivi

🛰️ Modalità remota — ħaddem is-CLI hawn, u OmniRoute fuq VPS

OmniRoute fuq server? Ikkontrollah mil-laptop tiegħek bl-istess CLI. Idħol darba b'token ta' aċċess b'ambitu definit; imbagħad kull kmand jimmira lejn is-server remot.

omniroute connect 192.168.0.15            # password → token b'ambitu definit, issejvjat bħala kuntest
omniroute models list                     # ← jitħaddem kontra s-server REMOT
omniroute configure codex                 # ← jagħżel mudell remot, jikteb profil lokali ta' Codex
omniroute tokens create --name ci --scope read   # joħloq tokens b'ambitu aktar limitat għal magni oħra
omniroute contexts use default            # ← jerġa' jaqleb għas-server lokali

It-tokens għandhom ambitu read / write / admin; ir-rotot li joħolqu proċessi jibqgħu limitati għal-loopback biss. _{📖 Modalità Remota}

🤝 Qabbad aġent — u jikkontrolla lil OmniRoute nnifsu

Esponi lil OmniRoute permezz ta' MCP, A2A, REST API, webhooks jew CLI remota — kwalunkwe aġent kapaċi (jew il-kodiċi tiegħek stess) jingħata ċ-ċwievet għall-gateway kollu: ir-rotot, il-fornituri, il-combos, il-cache, il-kompressjoni, il-memorja — b'mod awtonomu. L-endpoints HTTP hawn taħt jiġu servuti taħt http://localhost:20128.

Interfaċċa	Endpoint / kmand	Użah għal
🧰 MCP (stdio)	omniroute --mcp	Qabbdu ma' Claude Desktop, Cursor, jew kwalunkwe klijent MCP
🌊 MCP (HTTP)	/api/mcp/stream	MCP remot — 110 għodod, 33 ambitu (l-infurzar huwa fakultattiv), traċċa sħiħa tal-awditjar
📡 MCP (SSE)	/api/mcp/sse	Trasport MCP bi streaming
🤝 A2A	/.well-known/agent.json	Minn aġent għal aġent, JSON-RPC 2.0 + SSE, 6 ħiliet
🌐 REST API	/v1/*	Kompatibbli ma' OpenAI — chat, embeddings, stampi, awdjo, OCR
🔔 Webhooks	/api/webhooks	Ibgħat avvenimenti ta' talbiet / kwoti lil Slack, Discord, Telegram jew kwalunkwe URL
🛰️ CLI Remota	omniroute connect	Ikkontrolla istanza remota b'tokens ta' aċċess b'ambitu definit

# Agħti lil Claude Code is-sett sħiħ ta' għodod OmniRoute permezz ta' MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 Server MCP · Server A2A · Protokolli tal-Aġenti}

🗜️ Iffranka 15–95% tat-Tokens — Awtomatikament

📖 Kif taħdem — pipeline, arkitettura u kalkolu tal-iffrankar

Il-kombinazzjoni f’munzell awtomatika tħaddem RTK → Caveman. Meta t-tnejn jaġixxu fuq l-istess tagħbija ta’ għodda/kuntest, l-iffrankar jakkumula:

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

Il-blokok tal-kodiċi, il-URLs, il-JSON u d-data strutturata huma dejjem protetti mill-magna tal-preservazzjoni.

Għaliex tuża ħafna tokens meta ftit tokens jagħmlu x-xogħol? Kull talba tgħaddi mill-pipeline tal-kompressjoni ta’ OmniRoute b’mod trasparenti — mingħajr bidliet fil-klijent. Issa huwa munzell ta’ 12-il magna kompożibbli li jaħdmu f’ordni u jistgħu jitħalltu u jitqabblu għal kull kombinazzjoni ta’ routing — mibni fuq ideat minn RTK, Caveman (⭐ 90K+), LLMLingua-2, u Troglodita (PT-BR).

🧱 Il-munzell ta’ 12-il magna

Il-magni jaħdmu skont l-ordni tal-pipeline; kull waħda tista’ tiġi attivata jew diżattivata u kkonfigurata indipendentement għal kull kombinazzjoni:

#	Magna	X’tagħmel
1	Session-Dedup	Tneħħi kontenut ripetut bejn dawriet differenti (ibbażat fuq l-indirizzar tal-kontenut, bejn id-dawriet)
2	CCR	Tarkivja blokok kbar wara markaturi ta’ rkupru, li jinġabru meta jintalbu
3	Lite	Tirqim tal-ispazji bojod u tal-URLs tal-immaġnijiet (bażi ħafifa fil-latenza)
4	RTK	Iffiltrar intelliġenti tar-riżultati tal-għodod, deduplikazzjoni u tronkament (konxju mill-kmandi)
5	Responses Tool Output	JSON mingħajr telf bħala prijorità + kompressjoni dijanjostika limitata għall-outputs ta’ shell/patch/search/build (Responses API)
6	Headroom	Ikkumpattar tabulari mingħajr telf ta’ arrays JSON (~30%) permezz ta’ codec GCF inkluż internament
7	Relevance	Punteġġ estrattiv tas-sentenzi mqabbel mal-aħħar mistoqsija tal-utent
8	Caveman	Kompressjoni tal-proża bbażata fuq regoli (~65–75% fl-output)
9	Aggressive	Taqsir fil-qosor + tixjiħ progressiv tad-dawriet qodma
10	LLMLingua-2	Żbir semantiku bl-ML permezz ta’ MobileBERT ONNX — sikur għall-kodiċi, asinkronu
11	Ultra	Żbir ewristiku tat-tokens b’livell fakultattiv ta’ mudell żgħir (SLM)
12	OmniGlyph	Kodifikazzjoni sperimentali tal-kuntest bħala immaġni għal Claude Fable 5 imkejjel fuq il-konnessjoni diretta ma’ Anthropic; it-transformers GPT 5.6 jibqgħu magħluqa b’mod sikur sakemm jaslu l-konfermi mingħand il-fornitur. Erba’ profili ta’ kompressjoni (aggressiv b’mod awtomatiku, ibbilanċjat, sikur għall-kodifikazzjoni, passthrough) (l-aktar aggressiv; attivazzjoni fakultattiva)

Il-blokok tal-kodiċi, il-URLs u d-data strutturata huma dejjem ippreservati b’mod perfett sal-aħħar byte. Presets b’klikk waħda jikkombinaw il-magni:

Modalità	Iffrankar	L-aħjar għal
🪶 Lite	~15%	Għażla awtomatika sikura u dejjem attiva
🪨 Standard (Caveman)	~30%	Kodifikazzjoni ta’ kuljum
⚡ Aggressive	~50%	Sessjonijiet twal b’użu intensiv tal-għodod
🔥 Ultra	~75%	Iffrankar massimu
🧰 RTK	60–90%	Output ta’ shell/test/build/git
🔗 F’munzell (RTK → Caveman)	78–95%	Prompts imħallta + logs tal-għodod

Eżempju reali — modalità Standard:

Qabel (69 token): "Ir-raġuni għaliex il-komponent React tiegħek qed jerġa’ jiġi renderjat x’aktarx hija li qed toħloq referenza ġdida għal oġġett f’kull ċiklu ta’ rendering. Meta tgħaddi oġġett inline bħala prop, it-tqabbil superfiċjali ta’ React jarah bħala oġġett differenti kull darba, u dan jiskatta rendering mill-ġdid. Nirrakkomanda li tuża useMemo biex timmemorizza l-oġġett."

Wara (19-il token): "Referenza ġdida għal oġġett ma’ kull rendering. Prop ta’ oġġett inline = referenza ġdida = rendering mill-ġdid. Kebbeb b’useMemo."

L-istess tweġiba. 72% inqas tokens. L-ebda telf fil-preċiżjoni. ✅

Eżempju PT-BR — modalità Troglodita:

Qabel (42 token): "Il-problema hu li l-komponent qed jerġa’ jiġi renderjat għax qed tinħoloq referenza ġdida għal oġġett f’kull ċiklu ta’ rendering. Nirrakkomanda li tuża useMemo."

Wara (12-il token): "Rendering mill-ġdid: ref ġdida kull ċiklu (oġġett inline jinħoloq mill-ġdid). Uża useMemo."

L-istess tweġiba. ~70% inqas tokens. Preċiżjoni teknika intatta. ✅

🎚️ Lil hinn mill-engines — stili tal-output, ir-regolatur adattiv u kontroll għal kull talba

It-12-il engine ta’ hawn fuq inaqqsu dak li jidħol ġewwa. Tliet saffi oħra jsawru kif, meta, u x’joħroġ barra:

• 🪄 Stili tal-Output (gwida fuq l-assi tal-output) — jinjettaw struzzjonijiet deterministiċi u sikuri għall-cache biex isawru r-rispons; jistgħu jiġu kkombinati, kull wieħed b’intensità lite / full / ultra. Biex iżżid stil, biżżejjed entrata ta’ linja waħda fir-reġistru:
  • Proża konċiża — neħħi l-mili / l-artikli / l-eżitazzjoni; żomm is-sustanza teknika eżatta.
  • Inqas kodiċi — YAGNI ta’ “żviluppatur anzjan għażżien”: l-iżgħar bidla li taħdem, mingħajr infrastruttura mhux mitluba.
  • Ponytail (żviluppatur anzjan għażżien) — itla’ s-sellum YAGNI, irranġa l-kawża ewlenija, l-iżgħar diff li jaħdem.
  • Għandi ADHD (azzjoni l-ewwel) — ibda bl-azzjoni li jmiss, elenka l-passi, agħti pass konkret wieħed li jmiss, mingħajr introduzzjoni.
  • CJK konċiż (文言) — stil ultra-konċiż taċ-Ċiniż klassiku (limitat għal-locale zh).
• 🎯 Baġit tal-kuntest adattiv (ir-regolatur) — minflok limitu wieħed mixgħul/mitfi għat-tokens, jeskala biss l-orħos engines bl-inqas telf, u biss kemm hemm bżonn biex joqgħod fit-tieqa tal-kuntest tal-mudell. Politika: reserve-output (predefinita, konxja mill-mudell) · percentage · absolute. Modalità: floor (tiggarantixxi li joqgħod) · replace-autotrigger (l-għażla espliċita tiegħek tipprevali) · off (limitu legat).
• 🎛️ Fejn tiġi deċiża l-kompressjoni (preċedenza, għolja → baxxa) — header x-omniroute-compression għal kull talba › override tal-kombinazzjoni tar-routing › profil attiv imsemmi › attivazzjoni adattiva / awtomatika › valur predefinit tal-pannell › mitfi. Il-pjan applikat jintbagħat lura fl-header tar-rispons X-OmniRoute-Compression: <mode>; source=<source>.

Attivah awtomatikament permezz ta’ limitu ta’ tokens, ixgħel ir-regolatur adattiv, iffissa profil imsemmi, issettja għażla ta’ darba għal kull talba, jew assenja pipeline għal kull kombinazzjoni tar-routing — skont dak li jaqbel mal-workload. Eval harness offline u fakultattiv (npm run eval:compression) jivvaluta l-fedeltà kontra l-iffrankar fuq corpus fiss qabel ma tippromwovi bidla.

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

⚡ Bidu Malajr

1) Installa u ħaddem

npm install -g omniroute
omniroute

💡 Qed tara npm warn ERESOLVE jew twissijiet dwar peer-dependencies? Ma jagħmlu ebda ħsara.

Dashboard fuq http://localhost:20128 · API fuq http://localhost:20128/v1.

2) Qabbad fornitur B’XEJN (mingħajr reġistrazzjoni)

Dashboard → Fornituri → qabbad Kiro AI (Claude b’xejn, ~50 kreditu fix-xahar għal kull kont) jew OpenCode Free (mingħajr awtentikazzjoni) → lest.

3) Orjenta l-għodda tal-ipprogrammar tiegħek

URL Bażi:    http://localhost:20128/v1
Ċavetta API: [ikkopja minn Dashboard → Endpoints]
Mudell:      auto            (routing intelliġenti mingħajr konfigurazzjoni — jew kwalunkwe fornitur/mudell)

4) Ivverifika li qed jaħdem

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

Għandek tara l-mudelli mqabbda tiegħek fil-lista. 🎉 Daqshekk — ibda pprogramma, u OmniRoute jagħmel ir-routing awtomatikament u jaqleb għal alternattiva għalik jekk ikun hemm bżonn.

Jekk il-klijent tiegħek ma jistax jibgħat headers personalizzati, OmniRoute jipprovdi wkoll aliases ta’ kompatibbiltà bit-token:

Katalgu OpenAI:     http://localhost:20128/vscode/YOUR_KEY/
Mudelli OpenAI:     http://localhost:20128/vscode/YOUR_KEY/models
Chat OpenAI:        http://localhost:20128/vscode/YOUR_KEY/chat/completions
Risposti OpenAI:    http://localhost:20128/vscode/YOUR_KEY/responses
Chat Ollama:        http://localhost:20128/vscode/YOUR_KEY/api/chat
Tags Ollama:        http://localhost:20128/vscode/YOUR_KEY/api/tags

Uża dawn biss għal klijenti li ma jistgħux iżidu Authorization: Bearer .... L-awtentikazzjoni permezz tal-header tibqa’ l-modalità ppreferuta.

📦 Aktar metodi ta’ installazzjoni — Docker, sors, 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 isegwi l-ogħla SemVer stabbli ppubblikat. Ma jsegwix il-main ta’ git. Uża :X.Y.Z għal GitOps. Ara Kanali tar-Rilaxxi ta’ Docker. L-immaġni tissettja OMNIROUTE_MEMORY_MB=1024. Dan huwa biżżejjed għad-dashboard u għal chat ħafif. Aġenti tal-kodifikazzjoni (POST /v1/responses minn Claude Code, Codex, Grok, …) jeħtieġu heap V8 ferm akbar, inkella l-proċess jagħti FATAL ERROR madwar 12 GiB meta jkun hemm żewġ kuntesti twal li jikkoinċidu. Issettja d-daqs tal-container ogħla mill-heap (il-buffers nattivi jinsabu barra minn V8):

Tagħbija tax-xogħol	Heap (-e OMNIROUTE_MEMORY_MB)	Container (--memory)
Dashboard / chat ħafif	1024 (default tal-immaġni)	≥2 g
Aġent wieħed tal-kodifikazzjoni	8192	≥10 g
Żewġ /v1/responses twal simultanji	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

It-tabella sħiħa: Gwida ta’ Docker — RAM waqt it-tħaddim.

Kanal ta’ Docker għall-verżjonijiet preliminari: diegosouzapw/omniroute:next u diegosouzapw/omniroute:next-web isegwu l-fergħa default attwali release/v*. Dawn it-tags mutabbli huma maħsuba biss għall-ittestjar ta’ tiswijiet li għadhom ma ġewx rilaxxati u mhumiex appoġġjati għall-produzzjoni. Ara Kanali tar-Rilaxxi ta’ Docker.

🥟 Bun

L-bun install standard u l-installazzjoni globali (bun install -g omniroute) huma appoġġjati permezz tal-identifikazzjoni tar-runtime Bun:

• bun:sqlite inkorporat: OmniRoute juża d-driver bun:sqlite inkorporat ta’ Bun meta jitħaddem taħt Bun, u jaqleb għal better-sqlite3 fuq Node.js jew sql.js.
• Għażla awtomatika tal-bundler Webpack fl-iżvilupp: L-iżvilupp (bun run dev) jidentifika awtomatikament lil Bun u jiddiżattiva Turbopack favur Webpack biex jiġu evitati inkompatibbiltajiet mal-bindings nattivi ta’ V8. Il-builds tal-produzzjoni (bun run build) isegwu OMNIROUTE_USE_TURBOPACK eżattament bħal fuq Node: Turbopack b’mod default, jew OMNIROUTE_USE_TURBOPACK=0 biex tibni b’Webpack (Dockerfile.bun jesponih bħala --build-arg).
• Dockerfile apposta għal Bun: Dockerfile.bun b’diversi stadji għal deployments tal-produzzjoni nattivi ta’ Bun (docker build -f Dockerfile.bun -t omniroute:bun .).

# Installa u ħaddem b’Bun
bun install
bun run dev

🛠️ Mis-sors

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)

# Bl-użu ta’ Nix flakes
nix develop
npm run dev

# Jew bl-użu ta’ devbox
devbox run npm run dev

📖 Gwida ta’ Docker — Profili ta’ Compose, Caddy HTTPS, mini ta’ Cloudflare.

🦭 Podman

# 1. Ipprepara d-direttorju tad-data bind-mounted
mkdir -p data

# 2. Linux + Podman lokali rootless biss (qatt klijent remot ta’ Podman Machine):
podman unshare chown 1000:1000 ./data

# 3. Issettja l-ħjiel tar-runtime, ibni l-immaġni lokali ta’ Compose, u ibda
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build

Fuq macOS jew Windows, Podman juża Podman Machine remota: aqbeż podman unshare u segwi l-gwida tad-direttorju tad-data speċifika għat-topoloġija.

📖 Gwida ta’ Podman — Builds ta’ Compose, Podman Machine, u konfigurazzjoni ta’ Quadlet għal Linux/systemd.

⚡ Installazzjoni aktar veloċi / ħafifa (aqbeż il-build nattiva)

L-engine nattiv ta’ SQLite (better-sqlite3) huwa dipendenza mhux obbligatorja, għalhekk installazzjoni globali qatt ma teħel waqt il-kompilazzjoni mis-sors: tuża binary mibnija minn qabel meta jkun hemm waħda kompatibbli mal-pjattaforma/Node tiegħek, u inkella taqleb b’mod trasparenti għal engine JavaScript pur (node:sqlite fuq Node 22+, inkella l-WASM sql.js inkluż) — mingħajr il-ħtieġa ta’ għodod tal-build.

Biex taqbeż għalkollox it-tħejjija nattiva ta’ wara l-installazzjoni (CI, ambjenti headless, jew magni kajmana):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # CI=1 jaqbiżha wkoll

Għall-aktar installazzjonijiet veloċi, ippreferi pnpm (ħażna indirizzata skont il-kontenut + hard links — ara hawn fuq). Għal runtime headless mingħajr dashboard, uża l-profil base ta’ Docker (hawn fuq) jew il- gwida ta’ Termux. Is-CLI u d-dashboard tal-web jiġu servuti mill- istess proċess fuq port wieħed, għalhekk bħalissa m’hemm l-ebda pakkett separat għas-CLI biss.

🎬 OmniRoute fl-Azzjoni

📹 Gwidi bil-Vidjo

_{Ritratt tal-pannell fl-2026-08-24 · Katalgu mhux ipproċessat: YT 809 | TT 137 | IG 124 · Reċenza (jiem): YT 1 | TT 21 | IG 22}

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

🎬 #2 — Instagram theopenstack — 692,419-il dehra

🎬 #3 — TikTok milesreevesai — 620,400 dehra

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

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

Klassifika sħiħa (URLs kanoniċi mingħajr duplikati, v > 0, l-akbar firxa):

#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

Metriċi kanoniċi fl-2026-08-24: 1.029 vidjo uniku · 11.132.922 dehra magħrufa (v > 0) · 639 kanal/profil skont in-network. Il-pannell mhux ipproċessat fih 1.070 ringiela; 41 duplikat ta’ Instagram ġew normalizzati skont il-URL kanoniku, filwaqt li nżamm l-ogħla għadd għal kull vidjo.

🎬 Għamilt vidjo dwar OmniRoute? Iftaħ kwistjoni jew diskussjoni bil-link — se nuruh hawnhekk.

📧 Komunità u Għajnuna

Kollox f’post wieħed — segwi lill-mantenitur, tkellem mal-komunità, jew iftaħ kwistjoni.

Kanal	Fejn / kif
💼 LinkedIn — segwi lill-mantenitur	linkedin.com/in/diegosouzapw
🐙 GitHub — segwi għal ħarġiet u pariri	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Globali	ingħaqad mal-grupp
🟢 WhatsApp — 🇧🇷 Brażil	ingħaqad mal-grupp
🌍 Sit web	omniroute.online
🌍 🌍Komunità StHub OmniRoute (b’xejn)	portal ta’ sthub
📦 Kodiċi sors	github.com/diegosouzapw/OmniRoute
🐛 Irrapporta bug	iftaħ issue — ehmeż l-output ta’ npm run system-info
🤝 Ikkontribwixxi	CONTRIBUTING.md · Mudell tal-Branching u tar-Rilaxxi · agħżel good first issue
💚 Appoġġja l-proġett	Modi kif tappoġġja ↑ · Sponsors ta’ GitHub

---

🛠️ Munzell Teknoloġiku

Saff	Teknoloġija
Ambjent ta’ eżekuzzjoni	Node.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
Lingwa	TypeScript 6.0 — 100% TypeScript f’src/ u open-sse/ kollha (l-ebda any fil-qalba minn v2.0 ’l hawn)
Qafas	Next.js 16 + React 19 + Tailwind CSS 4
Bażi tad-data	better-sqlite3 (SQLite, reġistrazzjoni WAL) + LowDB (legat JSON) — 122 modulu tad-dominju, 176 migrazzjoni
Memorja	Test sħiħ SQLite FTS5 + embeddings vettorjali kkwantizzati għal int8, deklinazzjoni ttajpjata
Skemi	Zod 4 — validazzjoni tal-input/output tal-għodod MCP + kuntratti tal-API
Protokolli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Trażmissjoni kontinwa	Server-Sent Events (SSE) + pont WebSocket (/v1/ws)
Kompressjoni	Pipeline bi 12-il magna — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Awtentikazzjoni u sigurtà	OAuth 2.0 (PKCE) + JWT + Ċwievet tal-API + awtentikazzjoni MCP b’ambitu · AES-256-GCM għad-data maħżuna · DOMPurify
Moħbi	wreq-js — imitazzjoni tal-marki tas-swaba’ TLS JA3 / JA4, proxy fuq 3 livelli
Reżiljenza	Salvavita taċ-ċirkwit, stennija esponenzjali, protezzjoni kontra talbiet simultanji eċċessivi, awtoriparazzjoni awtomatika tal-kombinazzjonijiet
Reġistrazzjoni	pino — reġistri JSON strutturati bil-kuntest tat-talba
Ittestjar	Għodda tat-testijiet ta’ Node.js + Vitest — 39,000+ dikjarazzjoni statika tat-testijiet mifruxa fuq 5,100+ fajl tat-testijiet traċċat (unità, integrazzjoni, E2E, sigurtà, ekosistema)
Pjattaformi	Desktop (Electron) · Android (Termux) · PWA (kwalunkwe browser)
CI/CD	GitHub Actions — pubblikazzjoni awtomatika fuq npm + Docker Hub mar-rilaxx
Links	Sit web · npm · Docker Hub

📖 Dokumentazzjoni

📘 Kif Tibda

Dokument	Deskrizzjoni
Gwida għall-Utent	Fornituri, kombinazzjonijiet, integrazzjoni mas-CLI, skjerament
Gwida għas-Setup	Metodi sħaħ ta' installazzjoni, konfigurazzjonijiet tal-għodod CLI, setup tal-protokolli, irfinar tal-ħinijiet ta' skadenza
Gwida għall-Għodod CLI	Setup għal kull għodda għal Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Modalità Remota	Ikkontrolla OmniRoute remot (VPS) mis-CLI tal-laptop tiegħek permezz ta' tokens ta' aċċess b'ambitu definit
Konfigurazzjoni ta' Claude Code	Orbot Claude Code ma' OmniRoute (lokali/remot) b'launch + profili għal kull mudell
Bidu Rapidu	Installazzjoni fi 3 passi → konnessjoni → konfigurazzjoni

🔧 Operazzjonijiet u Skjerament

Dokument	Deskrizzjoni
Gwida għal Docker	Docker run, profili ta' Compose, Caddy HTTPS, mini, tikketti tal-immaġnijiet
Gwida għal Podman	Integrazzjoni ta' Quadlet ma' systemd, podman-compose, SELinux
Skjerament fuq VM	Gwida kompluta: setup ta' VM + nginx + Cloudflare
Skjerament fuq Fly.io	Skjera fuq Fly.io b'ħażna persistenti
Gwida għal Termux	Ħaddem OmniRoute fuq Android permezz ta' Termux
Gwida għall-PWA	Installazzjoni, caching u arkitettura tal-Progressive Web App
Gwida għad-Diżinstallazzjoni	Tneħħija nadifa għall-metodi kollha ta' installazzjoni
Konfigurazzjoni tal-Ambjent	Varjabbli u referenzi kompluti ta' .env

🧠 Karatteristiċi u Arkitettura

Dokument	Deskrizzjoni
Arkitettura	Arkitettura tas-sistema, fluss tad-data u mekkaniżmi interni
Gwida għall-Kompressjoni	Pipeline b'7 għażliet: mitfi / ħafif / standard / aggressiv / ultra / RTK / f'saffi
Kompressjoni RTK	Kompressjoni tal-output tal-kmandi, filtri, fiduċja, verifika, irkupru tal-output mhux ipproċessat
Magni tal-Kompressjoni	Caveman, RTK, pipelines f'saffi, interfaċċi tad-dashboard/API/MCP
Format tar-Regoli tal-Kompressjoni	Skemi tal-pakketti ta' regoli JSON għall-filtri Caveman u RTK
Pakketti Lingwistiċi tal-Kompressjoni	Sejbien tal-lingwa u kitba ta' pakketti ta' regoli għal Caveman
Gwida għar-Reżiljenza	Circuit breakers, perjodi ta' stennija, kju, prevenzjoni tat-thundering herd, spoofing tat-TLS
Magna Auto-Combo	Punteġġ ibbażat fuq 16-il fattur, pakketti ta' modalitajiet, awtoriparazzjoni
Gwida għall-Proxy	Sistema ta' proxy bi 3 livelli, suq 1proxy, CRUD tar-reġistru
Livelli Bla Ħlas	Direttorju kkonsolidat: 34 pool rikorrenti dokumentati / 452 entrata kkatalogata fil-livell bla ħlas
Gallerija tal-Karatteristiċi	Tour viżiv tad-dashboard bi screenshots
Dokumentazzjoni tal-Codebase	Gwida pass pass tal-codebase adattata għall-prinċipjanti

🤖 Protokolli u APIs

Dokument	Deskrizzjoni
Referenza tal-API	L-endpoints kollha b'eżempji
Speċifikazzjoni OpenAPI	Speċifikazzjoni OpenAPI 3.0
Server MCP	110 għodod MCP, konfigurazzjonijiet tal-IDE, klijenti Python/TS/Go
Gwida għas-Server MCP	Installazzjoni ta' MCP, trasporti u referenza tal-għodod
Server A2A	Protokoll JSON-RPC 2.0, ħiliet, streaming, ġestjoni tal-kompiti
Gwida għas-Server A2A	Kard tal-aġent A2A, kompiti, ħiliet u streaming

📋 Proġett u Kwalità

Dokument	Deskrizzjoni
Kontribut	Konfigurazzjoni u linji gwida għall-iżvilupp
Mudell tal-Fergħat u tar-Rilaxxi	Lejn fejn jiġu mmirati l-PRs (release/*), u xi jfissru main u t-tags
Reġistru tal-Bidliet	L-istorja sħiħa tar-rilaxxi għal kull verżjoni
Politika tas-Sigurtà	Rappurtar tal-vulnerabbiltajiet u prattiki tas-sigurtà
Gwida tal-i18n	Appoġġ għal 42 lingwa, fluss tax-xogħol tat-traduzzjoni, RTL
Lista ta' Kontroll tar-Rilaxx	Passi ta' validazzjoni qabel ir-rilaxx
Pjan ta' Kopertura	Strateġija tal-kopertura tat-testijiet għal aktar minn 39,000 dikjarazzjoni statika tat-testijiet f'aktar minn 5,100 fajl tat-testijiet traċċat

⭐ L-Aqwa Kontributuri

OmniRoute huwa msawwar minn komunità passjonata ta' sors miftuħ. Dawn l-individwi taw kontributi eċċezzjonali li għandhom impatt dirett fuq il-kwalità, l-istabbiltà u l-firxa tal-proġett. Grazzi.

Kontributuri esterni skont it-talbiet għall-ġbid inkorporati

Pożizzjoni	Kontributur	PRs Inkorporati	~Linji mibdula
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

_{Iffriżat fl-aħħar punt attiv ta' release/v3.8.50, dafb4ae808, b'inkorporazzjonijiet sal-2026-08-24 05:26:03 UTC. Iċ-ċensiment impaġnat ta' GitHub GraphQL fih 5,911-il PR inkorporata: 2,707 minn sid ir-repożitorju, 179 minn Dependabot, u 3,025 PR esterna minn 535 kontributur distint. “Linji mibdula” tfisser iż-żidiet + it-tħassir ta' GitHub u tinkludi fajls iġġenerati, lockfiles, katalgi, traduzzjonijiet u dokumentazzjoni; din hija l-kwantità ta' tibdil, mhux LOC miktuba. Il-pari fl-aħħar pożizzjoni jinżammu.}

Commits attribwiti minn GitHub

backryun 🥇 220 commit attribwit lil GitHub	Paijo 🥈 219-il commit attribwit lil GitHub	Randi 🥉 108 commits attribwiti lil GitHub	Ravi Tharuma 🏅 81 commit attribwit lil GitHub	Chris 🏅 70 commit attribwit lil GitHub	Markus Hartung 🏅 69 commit attribwit lil GitHub · parità fis-#6
Dizzle 🏅 69 commit attribwit lil GitHub · parità fis-#6	Jan Leon 🏅 64 commit attribwit lil GitHub	zenobit 🏅 62 commit attribwit lil GitHub	Bob.Hou 🏅 51 commit attribwit lil GitHub · parità fil-#10	Xiangzhe 🏅 51 commit attribwit lil GitHub · parità fil-#10

_{Iċċekkjat mill-ġdid fi 2026-08-24 06:14:31 UTC: commits attribwiti lil GitHub irrappurtati mill-API tal-Kontributuri tar-repożitorju għall-fergħa predefinita release/v3.8.50. L-API rritornat 525 identità (415-il utent, 2 bots, 108 anonimi); din it-tabella teskludi lill-mantenitur, lill-bots u lill-identitajiet anonimi u żżomm il-paritajiet fil-klassifika. Hija distinta kemm mill-klassifika tal-PRs amalgamati hawn fuq kif ukoll miċ-ċensiment ta’ 639 persuna bbażat fuq il-metadata ta’ Git hawn taħt.}

🙏 Il-karatteristiċi, it-tiswijiet tal-bugs, u t-titjib fl-infrastruttura ta’ dawn il-kontributuri huma parti fundamentali minn dak li jagħmel lil OmniRoute affidabbli u għani fil-karatteristiċi. Kull pull request, kull każ ta’ ttestjar, u kull fajl ta’ traduzzjoni i18n huwa importanti. Is-sors miftuħ jinbena minn nies bħalhom.

---

💖 Sponsors

Ringrazzjament mill-qalb lin-nies li jiffinanzjaw lil OmniRoute minn buthom stess — kull kontribuzzjoni żżomm il-proġett bla ħlas, indipendenti u miexi ’l quddiem.

Andrew 💛 Sponsor attiv ta’ kull xahar

Vlad I 💛 Sponsor attiv ta’ kull xahar

Paco Cartones 💛 Sponsor attiv ta’ darba

Prof. Igor Morais 💛 Sostenitur preċedenti ta’ darba

longtao 💛 Sostenitur preċedenti ta’ darba

_{… u oħrajn li jippreferu jibqgħu privati 💛}

_{Il-GitHub Sponsors pubbliċi ġew ivvalidati mill-ġdid fl-2026-08-24. L-istatus activeOnly ta’ GitHub jiddetermina t-tikketti attivi hawn fuq; is-sostenituri pubbliċi ta’ darba li kienu żvelati qabel jibqgħu rringrazzjati, u l-isponsors privati jibqgħu anonimi.}

💖 Sir sponsor → — kull dollaru jgħin biex OmniRoute jibqa’ bla ħlas u indipendenti.

👥 Aktar minn 600 Kontributur

_{Awditjat fl-2026-08-24 fuq il-bażi ffriżata ac02c5b42f u ċċekkjat mill-ġdid fil-ponta attwali ta’ release/v3.8.50, dafb4ae808: 639 identità umana normalizzata ta’ Git — 407 jidhru bħala awturi ta’ commits (inkluż il-manutentur) u 232 jidhru biss fi trailers espliċiti Co-authored-by. Iċ-ċensiment jinnormalizza l-handles noreply ta’ GitHub, jeskludi 26 identità ta’ bots/aġenti/servizzi/placeholders, u ma jgħaqqadx indirizzi tal-email ordinarji sempliċement għax l-ismijiet murija tagħhom jaqblu.}

Kif Tikkontribwixxi

1. Agħmel fork tar-repożitorju
2. Oħloq branch mill-ponta attiva ta’ release/vX.Y.Z (mhux minn main) — ara Mudell tal-Branching u tar-Rilaxxi
3. Oħloq il-feature branch tiegħek (git checkout -b feat/amazing-feature)
4. Agħmel commit tal-bidliet tiegħek (git commit -m 'feat: add amazing feature')
5. Imbotta lejn il-branch (git push origin feat/amazing-feature)
6. Iftaħ Pull Request b’base = dak il-branch release/vX.Y.Z

Ara CONTRIBUTING.md għal linji gwida dettaljati.

Kif Toħroġ Verżjoni Ġdida

# Oħloq rilaxx — npm publish iseħħ awtomatikament
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 Stilel

🌍 StarMapper

🙏 Ringrazzjamenti

OmniRoute jibni fuq ix-xogħol ta’ ġganti. Beda bħala fork ta’ 9router u port għal TypeScript tal-proġett Go CLIProxyAPI — u minn hemm, kull sottosistema hawn taħt kienet ispirata minn proġett open-source li wasal hemm qabel. Kull wieħed minnhom sawwar parti konkreta minn OmniRoute. Dan huwa l-mod tagħna kif nirringrazzjawhom ilkoll. 🙏

⭐ l-għadd ta’ stilel ġie vverifikat permezz tar-REST API ta’ GitHub fl-24 ta’ Awwissu 2026 — morru agħtu stilla lil dawn il-proġetti. L-għadd huwa snapshot eżatt bid-data tiegħu u naturalment se jinbidel.

🧬 Nisel u gateway

Proġett	⭐	Kif ispira lil OmniRoute
9router	26,161	Il-proġett oriġinali li fuqu hija mibnija din il-furketta — estiż hawnhekk b'APIs multimodali u kitba mill-ġdid sħiħa f'TypeScript.
CLIProxyAPI	48,497	L-implimentazzjoni f'Go li ispirat dan il-port għal JavaScript / TypeScript.
LiteLLM	57,100	Il-gateway tal-IA li s-sett pubbliku tad-dejta tal-ipprezzar tiegħu jalimenta s-sinkronizzazzjoni tagħna għat-traċċar tal-ispejjeż, u li l-mudell tiegħu għan-normalizzazzjoni tal-fornituri għen biex jissawwar ir-routing tagħna.
codex-chatgpt-web	1,410	Sors MIT adattat fil-pont integrat ChatGPT Web → Codex Responses, inklużi adapters għas-sessjoni tal-browser, l-inkwadrar tat-tweġibiet, l-użu u t-tiftix fuq il-web.
free-claude-code	48,112	Mudelli ttrasferiti għall-irkupru tal-fluss, psewdonimi mingħajr ħsieb, tiftix ta' riżerva fuq il-web, limiti b'tieqa li tiżżerżaq, ħabi ta' dejta sensittiva fir-reġistri u flussi imsaħħa għat-tnedija.
composer-api	322	Mudelli ta' Cursor Composer għall-għażla tal-għodda, ir-restrizzjonijiet tal-output u l-konferma tal-għodda, adattati fl-eżekutur nattiv ta' Cursor.
codex-multi-auth	457	Mudelli ta' login ġdid u rotazzjoni tat-token ta' tiġdid, ittrasferiti fir-riwtentikazzjoni OAuth ta' Codex.
opencode-anthropic-auth	510	Valuri predefiniti ta' trasformazzjoni kompatibbli ma' Claude Code u mġiba tal-header tal-kontijiet, iġġeneralizzati fil-pont ta' OmniRoute mmexxi mill-konfigurazzjoni.
grok2api-merged	2	Il-mappaturi tiegħu tal-mudelli Grok, il-ġeneratur Statsig b'TypeError falz, il-valuri predefiniti tat-talbiet u tal-apparat, u l-proċessur tat-tweġibiet NDJSON ġew adattati b'mod sostanzjali fl-eżekutur Grok Web ta' OmniRoute.
TQZHR/grok2api	705	Is-sors prinċipali tranżittiv tal-kodiċi wara grok2api-merged; l-implimentazzjonijiet tiegħu tal-mudell, tal-header, tal-payload, ta' Statsig u tal-proċessur huma ppreservati fil-linja ta' nisel ta' Grok Web.
chenyme/grok2api	7,520	Is-sors MIT sottostanti għall-valuri predefiniti tal-payload u tal-apparat ta' Grok, għall-ġeneratur Statsig u għall-proċessur result.response li għadda minn TQZHR u grok2api-merged.
grok2api-pro	27	Sors tranżittiv akkreditat minn grok2api-merged għas-saff tal-ġabra ta' proxies tiegħu; OmniRoute jippreserva dak l-avviż dwar il-linja ta' nisel, iżda ma jippretendix li ttrasferixxa ġabra ta' proxies fl-eżekutur limitat tiegħu ta' Grok Web.
GrokProxy	50	Il-proxy Grok tiegħu awtentikat bil-cookies u l-mudell ta' streaming result.response.token għenu biex jissawwar it-trasport Grok Web ta' OmniRoute.
GrokBridge	5	L-implimentazzjoni oriġinali ta' Grok Web ikkonsultat id-disinn upstream tagħha għal HTTP/browser; il-perkors HTTP dirett tagħha ġej minn GrokProxy, għalhekk ma qed jiġi ddikjarat l-ebda trasferiment indipendenti ta' kodiċi.
grok-web-api	14	L-iskemi Rust tagħha ta' ChatOptions u tal-envelop tat-tweġibiet għenu biex jissawru t-tipi TypeScript ta' OmniRoute għat-talbiet Grok u għat-tweġibiet bi streaming.

🗜️ Kompressjoni tal-kuntest u tat-tokens — magni

Proġett	⭐	Kif ispira lil OmniRoute
Caveman	100,538	Il-proġett virali "għaliex tuża ħafna token meta ftit token jagħmlu x-xogħol" — il-filosofija tiegħu ta' diskors primittiv tħaddem il-modalità standard tagħna ta' kompressjoni u aktar minn 30 regola ta' tneħħija ta' kliem żejjed/kondensazzjoni.
RTK – Rust Token Killer	77,185	Kompressjoni ta' prestazzjoni għolja tal-output tal-kmandi — ispirat il-magna RTK tagħna, id-DSL tal-filtri JSON, l-irkupru tal-output mhux ipproċessat u l-pipeline f'saffi RTK → Caveman.
headroom	67,310	Kompressjoni riversibbli tal-kuntest (SmartCrusher) — ispirat il-magna headroom tagħna u l-mudell tal-markatur tal-irkupru ccr.
LLMLingua	6,598	Riċerka dwar il-kompressjoni tal-prompts (LLMLingua / LLMLingua-2) — ispirat il-magna llmlingua tagħna, li hija asinkronika, sigura għall-kodiċi u tibqa' miftuħa f'każ ta' ħsara.
llmlingua-2-js	31	Il-port JS/ONNX (MobileBERT / XLM-RoBERTa) użat bħala l-backend tal-worker thread għall-magna LLMLingua tagħna.
Troglodita	40	Kompressjoni tat-token għal PT-BR — tħaddem il-pakkett lingwistiku pt-BR tagħna: tnaqqis tal-pleonażmi u tneħħija ta' kliem żejjed irfinati għall-grammatika tal-Portugiż Brażiljan.
ponytail	108,957	Il-ħila virali tal-kodifikazzjoni YAGNI tal-"iżviluppatur anzjan għażżien" — ispirat l-Istil tal-Output less-code tagħna: direzzjoni lejn l-iżgħar bidla li taħdem, li tnaqqas il-kodiċi _ġġenerat_ (l-ekwivalenti fuq l-assi tal-output tal-proża konċiża ta' Caveman).
i-have-adhd	23,526	L-istil ta' tweġib tiegħu, li jagħti prijorità lill-azzjoni u huwa adattat għall-ADHD, ġie adattat fl-istil konċiż tal-output ta' OmniRoute f'ħames lingwi.

🧩 Formati kompatti, riċerka dwar it-token u għodod konxji mill-kodiċi

Proġett	⭐	Kif ispira lil OmniRoute
TOON	25,233	Notazzjoni tal-Oġġetti Orjentata lejn it-Token — il-mudell tiegħu b'kolonni, intestatura u ringieli sawwar l-istadju tagħna ta' kompattazzjoni tabulari.
GCF – Graph Compact Format	41	Il-format kompatt tiegħu għall-graffs u d-disinn ta' profil ġeneriku tiegħu sawru l-kompattazzjoni tabulari ta' OmniRoute u l-format tal-codec Headroom.
gcf-typescript	4	L-implimentazzjoni MIT f'TypeScript, inkorporata direttament u estiża bħala l-codec ta' profil ġeneriku ta' Headroom.
token-optimizer-mcp	494	Cache Brotli/SQLite + delta tal-kuntest għal kull sessjoni — ispirat il-magna session-dedup tagħna.
token-savior	1,122	Kompattazzjoni tal-output ta' Bash + profili MCP — ispirat id-dixxiplina tagħna li nwaqqfu l-kompressjoni meta ma tkunx ta' benefiċċju u t-tnaqqis tal-manifest tal-għodod MCP.
token-saver	138	Kompressjoni tal-output konxja mill-kontenut u skont it-tip tal-fajl, b'waqfien konxju mill-fallimenti — ivvalidat id-dispaċċ tagħna skont it-tip u l-qbiż meta l-qligħ minimu ma jintlaħaqx.
token-optimizer	1,951	"Sib it-token fantażma" — il-mudell tiegħu ta' offload + handle li jista' jiġi rkuprat sawwar il-ħsieb tagħna dwar l-offload CCR.
TokenMizer	28	Pjan ta' graf tas-sessjoni + deduplikazzjoni tal-linji bejn turn u ieħor li sawwar id-disinn tagħna ta' session-dedup.
OmniCompress	3	JSON kolonnari f'Rust + irkupru indirizzat skont il-kontenut + deduplikazzjoni bejn il-messaġġi — ivvalida d-disinn tal-magni headroom/ccr/session-dedup tagħna u l-invarjant stabbli għall-cache li "l-forma kkompressata hija indipendenti mill-pożizzjoni".
mcp-compressor	113	Kompressjoni tal-iskema/deskrizzjoni tal-għodod MCP — sawwret it-tnaqqis tal-kardinalità tal-manifest tal-għodod MCP tagħna.
RepoMapper	197	Klassifikazzjoni ta' mappa tar-repo fl-istil ta' Aider — sawwret l-esplorazzjoni tagħna tal-mappa tar-repo / klassifikazzjoni tal-irkupru.
quiet-shell-mcp	4	Tnaqqis dikjarattiv tal-output tax-shell permezz ta' MCP — ivvalida l-kompattazzjoni dikjarattiva tagħna tal-output ta' bash.
ts-morph	6,162	Sett ta' għodod għall-API tal-Kompilatur TypeScript — ispirat it-tneħħija tal-kummenti bbażata fuq parser tagħna, li tippreserva l-litterali ta' strings, templates u regex.

🧠 Memorja u RAG

Proġett	⭐	Kif ispira lil OmniRoute
Mem0	63,902	Saff universali tal-memorja — il-mudell tiegħu ta’ proxy bħala konfini għall-kitba/qari sawwar l-arkitettura tal-memorja tagħna.
Letta (MemGPT)	24,382	Aġenti bi stat u b’memorja f’livelli — ispiraw il-mudell f’livelli tagħna għall-Kontroll u l-Irkupru tal-Kuntest (CCR).
WFGY	1,781	It-tassonomija ProblemMap ta’ 16-il modalità rikorrenti ta’ falliment ta’ RAG/LLM — il-vokabularju komuni fil-gwida tagħna għas-soluzzjoni tal-problemi.

🛰️ Spezzjoni tat-traffiku, MITM u proxy trasparenti

Proġett	⭐	Kif ispira lil OmniRoute
llm-interceptor	66	L-interċettazzjoni/l-analiżi MITM tat-traffiku bejn l-assistent tal-ipprogrammar ↔ LLM infurmat ir-rekwiżiti bikrija ta’ Traffic Inspector. Erba’ moduli li qabel kienu derivati — l-għaqda ta’ SSE, in-normalizzazzjoni tal-konverżazzjonijiet, il-ħabi tas-sigrieti u s-sanitizzazzjoni tal-headers — ġew sostitwiti b’implimentazzjonijiet indipendenti clean-room ibbażati fuq standards pubbliċi tal-protokolli. Iż-żewġ superfiċji ta’ host-passthrough (passthrough.ts u _internal/bypass.cjs) għadhom implimentazzjonijiet interni ta’ OmniRoute kklassifikati b’mod indipendenti; dawn ma nkitbux mill-ġdid bħala parti minn dak is-sostituzzjoni.
ProxyBridge	5,995	Rotot trasparenti tal-proxy għal kull proċess — ispiraw it-tneħħija MITM tagħna reżistenti għall-kraxxijiet, il-limiti ta’ ħin ta’ inattività tas-sockets, l-attribuzzjoni tal-proċessi permezz ta’ /proc u l-qbid TPROXY.

📚 Data tal-mudelli, osservabbiltà u UI

Proġett	⭐	Kif ispira lil OmniRoute
models.dev	6,555	Bażi tad-data miftuħa tal-ispeċifikazzjonijiet, il-prezzijiet u l-kapaċitajiet tal-mudelli tal-IA — issinkronizzata b’mod nattiv fil-katalgu tal-mudelli tagħna.
React Flow / xyflow	38,108	Il-librerija tal-graffs ibbażata fuq nodi li tħaddem il-Compression Studio u l-Combo/Routing Studio tagħna f’ħin reali.
LangGraph	40,314	Il-viżwalizzazzjoni diretta tal-graff tal-fluss tax-xogħol ta’ LangGraph Studio ispirat il-veduta kaskata f’ħin reali tal-Studios tagħna.
Langfuse	33,592	Il-mudell ta’ osservabbiltà tiegħu traċċa → medda → ġenerazzjoni sawwar il-veduta waterfall tal-Compression Studio tagħna.
Kiali	3,631	Osservabbiltà tas-service mesh ta’ Istio — ispirat il-badges tas-circuit breaker u l-viżwali tat-truf tal-iżbalji fir-Routing/Combo Studio.
lobe-icons	2,428	Logos tad-ditti tal-IA/LLM li jirrendu l-ikoni tal-fornituri fid-dashboard tagħna.
flag-icons	12,354	Jipprovdi l-bnadar SVG liċenzjati taħt MIT użati mis-selettur tal-lingwa tar-README.

🛡️ Sigurtà

Proġett	⭐	Kif ispira lil OmniRoute
awesome-secure-defaults	721	Lista kkurata ta’ libreriji siguri b’mod awtomatiku li tiggwida l-għażliet tas-sigurtà tagħna (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

🧭 Għodod komplementari

Proġett	⭐	Kif ispira lil OmniRoute
ClawRouter	6,564	Ispira t-tneħħija ta’ talbiet duplikati, fallback ta’ emerġenza mingħajr spejjeż, strateġiji Auto-Combo plaggabbli u klassifikazzjoni multilingwi tal-intenzjoni.
Antigravity-Manager	30,652	L-immappjar mill-ġdid tal-mudelli skont il-kont, il-validazzjoni tal-mogħdija tal-eżekutibbli u l-imġiba tat-tikketti tal-pjan tiegħu informaw ir-runtime Antigravity ta’ OmniRoute.
vscode-antigravity-cockpit	4,817	Il-format kompatt tiegħu tal-countdown għar-risettjar tal-kwota ispira l-wiri korrispondenti tal-limitu tal-fornitur f’OmniRoute.
AionUi	32,230	L-integrazzjonijiet ACP tiegħu ispiraw l-individwazzjoni awtomatika ta’ OmniRoute tal-aġenti CLI installati.
CodexBar	20,507	Identifika s-superfiċje tal-kwota ta’ Grok Build; OmniRoute mbagħad ivverifika u kkoreġa b’mod indipendenti l-format attiv fuq il-wajer.

📄 Liċenzja

Liċenzja MIT - ara LICENSE għad-dettalji.

---

⬆ Lura fil-bidu · Mibni b’❤️ għall-komunità tal-IA b’sors miftuħ.

_{OmniRoute v3.8.51 · Node ≥22.22.2 · Liċenzja MIT · omniroute.online}