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

# 🚀 OmniRoute — Il-Gateway tal-AI B'Xejn

OmniRoute — Qatt tieqaf tikkodifika. Kull għodda tal-AI → 358 fornitur — 150+ b'xejn — permezz ta' endpoint wieħed. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity f'Claude / GPT / Gemini B'XEJN b'auto-fallback. Il-kompressjoni f'munzelli RTK + Caveman tiffranka 15–95% tokens (~89% medja) — qatt ma tilħaq limiti. 358 fornitur tal-AI · 150+ livelli b'xejn · ~1.62B tokens b'xejn/xahar · 19-il strateġija ta' routing · $0 biex tibda.

## 💰 ~1.62B Token B’Xejn / Xahar

> L-akkumulazzjoni manwali tal-livelli bla ħlas hija tedjanti — għexieren ta’ SDKs, għexieren ta’ limiti tar-rata, u ebda idea ta’ kemm fil-fatt għandek. OmniRoute jikkataloga **489 entrata ta’ livelli bla ħlas mifruxa fuq 35 ċavetta ta’ pools rikorrenti** u jikkalkula ċ-ċifra ewlenija tat-tokens mis-**17-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 reġjonali tal-identità (illum: ModelScope) jintwerew separatament, +~6M wara verifika reġjonali tal-identità, u qatt ma jingħaddu fiċ-ċifra ewlenija. Ir-riżultat jibqa’ viżibbli fid-dashboard (`/dashboard/free-tiers`).

Kard tal-baġit tal-livelli bla ħlas ta’ OmniRoute: ~1.62B token bla ħlas fix-xahar b’mod stabbli, sa ~2.22B fl-ewwel xahar bi krediti tar-reġistrazzjoni, minn 35 ċavetta dokumentata ta’ pools rikorrenti li jkopru 489 entrata kkatalogata ta’ livelli bla ħlas wara endpoint wieħed. Kalkolu onest bid-duplikati tal-pools eliminati — kull pool kondiviż jingħadd darba biss, inklużi 17-il pool rikorrenti b’baġit mensili pożittiv ippubblikat tat-tokens flimkien ma’ ħames limiti Groq għal kull mudell; 13-il fornitur huma mmarkati biex jiġu evitati fil-katalgu tar-riskji tat-termini sabiex tiddeċiedi int. Il-barra tal-baġit tinkludi Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (ħames limiti għal kull mudell) u pools iżgħar, flimkien ma’ krediti tar-reġistrazzjoni għall-ewwel xahar u fornituri bla ħlas b’mod permanenti u mingħajr limitu ta’ tokens, murija separatament sabiex qatt ma jkabbru b’mod artifiċjali ċ-ċifra ewlenija. Użu u bilanċ li jifdal f’ħin reali fuq /dashboard/free-tiers.

> Sommarju animat tal-paġna diretta `/dashboard/free-tiers`. Metodoloġija sħiħa (eliminazzjoni tad-duplikati tal-pools, livelli ta’ kreditu, termini tal-fornituri): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Dawn iċ-ċifri jiġu awditjati mill-ġdid kull ġimagħtejn skont il-katalgu dirett u **jiċċaqalqu fiż-żewġ direzzjonijiet** — fornitur itemm livell bla ħlas u n-numru jinżel; jidħol wieħed ġdid u n-numru jitla’. Aħna nippubblikaw dak li fil-fatt jikkalkula l-katalgu, qatt l-aħjar xenarju miżjud ’il fuq.}

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

[![Stilel](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Klassifika tal-Istorja tal-Istilel](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Ingħaqad mal-komunità **👋 Segwi lill-manutenzjonist — kun l-ewwel li tirċievi fornituri ġodda, rilaxxi u pariri:** [![Segwi lil Diego fuq LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Segwi lil @diegosouzapw fuq GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Globali](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brażil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Sit Web](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Mistoqsijiet, pariri dwar il-fornituri, pjan direzzjonali u appoġġ → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globali](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brażil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Il-Gateway Ikompli Jikber

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | --------------------------------- | :-----: | :--------------------------: | :-----------: | | 🌐 Fornituri | 290 | **357** | aktar fil-kju | | 🧠 IDs uniċi ta’ mudelli taċ-chat | 1185 | **1312** | — | | 🖼️ Pont tal-modalitajiet | — | 🆕 viżjoni + awdjo + vidjo | — | | 📡 Katalgu bla ħlas tar-Radar | — | 🆕 b’għażla ta’ attivazzjoni | — | | ⚖️ Skedar konxju tal-kwota | — | 🆕 Quota-Share | — | | 📊 Telemetrija tal-kwota | — | 🆕 diretta | — | **→ [Pjan direzzjonali](ROADMAP.md) — mexjin fuq il-binarji lejn `v3.9.0 LTS`**

## 🧩 Disponibbli [![verżjoni npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM fix-Xahar](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Liċenzja: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Tniżżiliet minn Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Tniżżiliet ta' Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Ibda	🚀 Bidu Mgħaġġel	📦 Installa	🆓 Mingħajr Konfigurazzjoni
💡 Tgħallem	💥 Il-Wegħda	🤔 Għaliex OmniRoute	🏆 X'Jiddistingwih
⚙️ 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	🛠️ Munzell Teknoloġiku	📖 Dokumentazzjoni	👥 Kontributuri

🌐 F'66 lingwa

## 🆓 Jaħdem mill-ewwel li tinstallah — l-ebda ċwievet, l-ebda konfigurazzjoni

Jaħdem mill-ewwel li tinstallah — konfigurazzjoni żero. Tliet passi: 1. Installa — npm i -g omniroute, is-server jibda fuq localhost:20128. 2. Ipponta l-għodda tiegħek lejn http://localhost:20128/v1 — kwalunkwe għodda kompatibbli mal-OpenAI (Claude Code, Cursor, Cline). 3. Tweġiba — ċempel il-mudell auto għal tweġiba immedjata, mingħajr ċavetta API, mingħajr reġistrazzjoni, mingħajr konfigurazzjoni. Il-fornitur mingħajr ċavetta OpenCode Free huwa diġà konness mal-combo auto, għalhekk installazzjoni ġdida tirrispondi mill-ewwel.

```bash # Installazzjoni ġdida, żero 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 speċifiku b'xejn? Ċempel `oc/…` (OpenCode Free) direttament. Imbagħad aġġorna għal `auto` u ħalli OmniRoute jagħżel.} _{📦 Skripts ta' quickstart biex tikkopja u tippejstja għal **Python, Node.js, PHP, u cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Il-Wegħda

# 🤔 Għaliex OmniRoute?

Fluss ta' talba OmniRoute: l-IDE jew CLI tiegħek (Claude Code, Cursor, Cline…) isejjaħ endpoint lokali wieħed (http://localhost:20128/v1); l-OmniRoute Smart Router (kompressjoni RTK + Caveman, 19-il strateġija ta' routing, circuit breakers, TLS stealth, MCP, A2A, guardrails) jista' jaqa' lura bejn 4 livelli ta' fornituri waqt li tibqa' mira eliġibbli u b'saħħitha — Livell 1 Abbonament, Livell 2 Ċavetta API, Livell 3 Irħis u Livell 4 B'xejn.

## 🤝 Appoġġjati mill-Ħbieb tagħna tal-Open Source

> **Trid tingħaqad bħala Ħabib tal-Open Source?** Dawn huma l-kumpaniji li jappoġġjaw l-open source u jgħinu biex OmniRoute jibqa' miexi — u aħna ngħidu pubblikament fejn imur kull token li jagħtuna. Ikkuntattjana: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Grazzi lil Kimi (Moonshot AI), il-Ħabib Fundatur tagħna tal-Open Source, talli appoġġja dan il-proġett! Kimi huwa l-laboratorju tal-AI wara l-familji ta' mudelli K2 u K3 b'piż miftuħ — Kimi K3 joffri tieqa ta' kuntest ta' 1M-token, viżjoni nattiva u kodifikazzjoni ta' livell avvanzat bi frazzjoni tal-prezzijiet tal-mudelli magħluqa, u jaħdem direttament ma' Claude Code, Codex u kull għodda ta' kodifikazzjoni li OmniRoute jservi.

X'jappoġġja l-appoġġ ta' Kimi: Il-krediti tal-API ta' Kimi jappoġġjaw il-pipeline ta' rilaxx validat mill-AI ta' OmniRoute — l-istadju ta' validazzjoni tal-għaqda mħaddma minn Kimi K3 li jirrevedi kull talba ta' pull qabel ma tiġi rilaxxata — flimkien mal-iżvilupp ta' karatteristiċi ta' kuljum. L-appoġġ ta' Kimi ta' l-ewwel klassi jintbagħat fuq iż-żewġ binarji: l-API diretta ta' Kimi (kimi-k3) u l-pjan ta' kodifikazzjoni ta' Kimi Code (OAuth u ċavetta API). OmniRoute huwa wkoll l-ewwel proġett open-source Brażiljan fil-programm ta' appoġġ ta' Kimi. Ikseb ċavetta API ta' Kimi bi 15% krediti żejda →

Inferenzja Orħos
_{cheaperinference.com} Grazzi lil Cheaper Inference, Ħabib tal-Open Source ta' OmniRoute, talli appoġġja dan il-proġett! Cheaper Inference huwa gateway ikklassifikat skont l-ispiża li jbiegħ mill-ġdid 42 mudell avvanzat — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok u MiniMax — wara endpoint wieħed kompatibbli ma' OpenAI, li jidderieġi kull talba lill-fornitur l-irħas eliġibbli mingħajr qatt ma jitlob aktar mill-prezz tal-lista tal-manifattur tal-mudell.

Appoġġ ta' l-ewwel klassi f'OmniRoute: Chat Completions, l-endpoint nattiv /v1/responses, viżjoni, sejħa ta' għodda u 3 mudelli ta' immaġni (grok-imagine, nano-banana-pro, nano-banana-2, li jistgħu jintlaħqu bħala cheaperinference/<model>). Ikseb ċavetta API →

_{Links bit-tikketta aff=omniroute huma links ta' sħubija. Huma jiffinanzjaw il-proġett mingħajr ebda spiża żejda għalik.}

_{🎟️ Promo tal-Affiljati — kupuni ta' reġistrazzjoni b'xejn minn fornituri li ma nisponsorjawx (ikklikkja biex tespandi)}

_{Din it-taqsima hija għal kodiċijiet ta' riferiment/kupuni biss. Sħubijiet sponsorjati jinsabu f'🤝 Appoġġjati mill-Ħbieb tagħna tal-Open Source hawn fuq. OmniRoute m'għandu l-ebda sponsorizzazzjoni jew sħubija mal-fornituri elenkati hawn — dawn huma kupuni pubbliċi li kulħadd jista' juża.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — reġistrazzjoni affiljata · $100 krediti b'xejn mar-reġistrazzjoni (server b'xejn, stenna latenza ogħla — l-aħjar għall-ittestjar, mhux għall-produzzjoni). Appoġġ ta' l-ewwel klassi f'OmniRoute minn v3.8.50: Chat Completions, il-format tal-wajer kompatibbli ma' Anthropic u l-path kompatibbli ma' OpenAI. Mudelli disponibbli jinkludu claude-opus-4-8, claude-opus-5, gpt-5.6-sol u aktar. Aqbad il-$100 tiegħek →}

_{⚠️ Link affiljata — OmniRoute m'għandu l-ebda sponsorizzazzjoni jew sħubija ma' dan il-fornitur.}

_{Taf fornitur ieħor b'kupun ta' reġistrazzjoni b'xejn ġeneruż li jibbenefika lill-utenti ta' OmniRoute? Iftaħ issue u aħna nżiduh hawn.}

## 🎯 Combos — Il-Prodott Ewlieni

Id-19-il strateġija kollha tar-routing tal-combos animati — maduma waħda għal kull strateġija: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Ara t-tabella ta’ hawn fuq għal dak li tagħmel kull waħda.

> **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`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Ir-reżiljenza hija integrata (3 saffi indipendenti)

Reżiljenza ta’ OmniRoute — 3 saffi indipendenti li jirkupraw waħedhom, is-saff it-tajjeb għall-ħsara t-tajba. Saff 1 circuit breaker tal-fornitur (il-fornitur kollu): jattiva biss fuq 408/5xx, limiti OAuth 8× / API-key 12× / lokali 2×, jerġa’ jiġi ssettjat wara 60s/30s/15s għal prova HALF-OPEN, irkupru għażżien; waqt li jkun OPEN, il-combo jidderieġi mill-ġdid lejn il-fornitur li jmiss. Saff 2 cooldown tal-konnessjoni (ċavetta/kont wieħed): bażi ta’ 5s għal OAuth / 3s għal API-key, backoff esponenzjali ta’ ×2 bi protezzjoni kontra anti-thundering-herd, 429 jirrispetta Retry-After, is-suċċess ineħħi l-istat kollu tal-iżbalji; ċavetta waħda fi stat ta’ cooldown tinqabeż filwaqt li ċ-ċwievet l-oħra jibqgħu jipprovdu s-servizz. Saff 3 imblukkar tal-mudell (mudell wieħed): 429 għal kull mudell, 404 lokali jew rifjuti tal-modalità jimblukkaw biss dak il-mudell — qatt il-konnessjoni kollha. L-istati terminali (ipprojbit, skadut, krediti eżawriti) huma għall-operatur, mhux cooldowns.

_{📖 [Magna Auto-Combo](docs/routing/AUTO-COMBO.md) · [Gwida għar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 X'Jiddistingwi lil OmniRoute

_{📊 Metodoloġija sħiħa & dettall għal kull karatteristika vs 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](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) Kodiċi QR PIX ta’ OmniRoute

Ċ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](https://github.com/diegosouzapw/OmniRoute/discussions).

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 OmniRoute Iċ-ċifra ewlenija tal-livell bla ħlas tibqa’ **~1.62B tokens/xahar** mill-katalogu dokumentat u deduplikat skont il-pool hawn fuq. Il-krediti temporanji ta’ reġistrazzjoni mingħand il-fornituri jistgħu separatament jgħollu l-ewwel xahar għal **~2.22B**. Radar huwa overlay fakultattiv u ffirmat tal-katalogu għal dawk li jixtiequ disponibbiltà aktar aġġornata ta’ mudelli bla ħlas bejn ir-rilaxxi ta’ OmniRoute; il-katalogu tal-komunità u kull karatteristika eżistenti bla ħlas jibqgħu bla ħlas. Is-sostenituri jistgħu jirċievu l-katalogu dirett u opportunitajiet addizzjonali mingħand il-fornituri. Il-limitu separat u varjabbli tiegħu huwa ta’ **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 tat-twarrib tal-avviżi. Sir af dwar l-eliġibbiltà u l-katalogu attwali fuq **[radar.omniroute.online/planos](https://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`](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](docs/frameworks/A2A-SERVER.md) - **🛂 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](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ 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](docs/reference/API_REFERENCE.md) - **🗜️ 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](docs/compression/COMPRESSION_ENGINES.md) - **💸 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](docs/reference/API_REFERENCE.md) - **⚖️ 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](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 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](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ 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](docs/guides/REMOTE-MODE.md) - **🧭 Routing awtomatiku aktar intelliġenti** — combos `auto/:`, **Fusion** (pannell tal-mudelli + ġudikatur), routing konxju tal-kompitu, u sostituzzjonijiet għal kull talba tal-mudell / modalità / baġit f’USD. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ 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](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ 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](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 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](docs/reference/API_REFERENCE.md) - **🧠 Memorja li tikkontrolla int** — diżattivata awtomatikament, kwantizzazzjoni vettorjali int8 fakultattiva + degradazzjoni ttajpjata, `x-omniroute-no-memory` għal kull talba. → [Memorja](docs/frameworks/MEMORY.md) - **🛡️ 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](docs/security/GUARDRAILS.md) - **🖼️ Endpoints ġodda** — `/v1/ocr` (Mistral OCR) u `/v1/audio/translations` (stil Whisper) jikkompletaw il-firxa tal-media. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **🎨 Ġ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](docs/reference/API_REFERENCE.md) - **🌍 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](docs/reference/ENVIRONMENT.md) - **🤝 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](docs/reference/PROVIDER_REFERENCE.md) - **📡 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](docs/routing/AUTO-COMBO.md) - **⚡ 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](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 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](docs/README.md)

## 🤖 CLIs u Aġenti tal-Kodifikazzjoni Kompatibbli > Konfigurazzjoni waħda — `http://localhost:20128/v1` — u **kull** IDE jew CLI tal-IA jaħdem b’mudelli b’xejn 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}	_deyin.ai

＋ jaħdem ukoll ma’ · Agent Deck · 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`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin ta’ OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Ħaddem kwalunkwe CLI appoġġjat permezz ta’ OmniRoute bi kmand wieħed** — mingħajr ma jinkitbu fajls tal-konfigurazzjoni, bil-kredenzjali injettati għal kull proċess, filwaqt li Qwen/Gemini jingħataw direttorju home iżolat u temporanju: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Jew agħżel il-fornitur+mudell b’mod interattiv u ikteb il-konfigurazzjoni tal-għodda nnifisha: omniroute configure codex # ukoll: claude opencode qwen aider goose gemini cline continue kilo ``` Kull kmand jirrispetta l-kuntest remot attiv (`omniroute connect `), `--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 tas-CLI](docs/guides/CLI-INTEGRATIONS.md)

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

> **357 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 jġorru l-metadata ta’ skoperta `hasFree: true`**. Ir-reġistru tal-mudelli taċ-chat ikopri **229 fornitur / 2,554 par distint ta’ fornitur u mudell / 1,283 ID mhux ipproċessat ta’ mudell**; il-katalgu separat tal-baġit bla ħlas għandu **491 ringiela għal kull mudell**, **35 pool rikorrenti** u **54 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](docs/reference/PROVIDER_REFERENCE.md) u fil-[Livelli Bla Ħlas](docs/reference/FREE_TIERS.md).

### 🏢 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](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Bla Ħlas Għal Dejjem — $0, mingħajr kard

OpenCode Zen _{DeepSeek V4, Nemotron 3 Ebda 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 Mhi meħtieġa ebda ċavetta}	Cloudflare AI _{50+ mudell 10K newroni/jum}	NVIDIA NIM _{GLM, MiniMax ~40 RPM b'xejn}	Cerebras _{GLM 4.7, GPT-OSS 1M tokens/jum}	OpenRouter _{mudelli :free +$10 → RPM ogħla}

📖 Katalgu sħiħ li jista' jinqara mill-magni → [`docs/reference/PROVIDER_REFERENCE.md`](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](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Tray tal-menu bar](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Ġ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](https://github.com/diegosouzapw/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](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Gwida għal VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — 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](https://github.com/zoispag/omniroute-tray)** > 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](https://v2.tauri.app/) (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

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Tippreferi tniżżel? Ikseb l-aħħar .dmgIr-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](docs/architecture/AUTHZ_GUIDE.md) · [Miżuri ta' Protezzjoni](docs/security/GUARDRAILS.md) · [Konformità](docs/security/COMPLIANCE.md)}

## 🔌 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`) ```bash 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. ```bash 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](docs/guides/REMOTE-MODE.md)}

Dimostrazzjoni animata fit-terminal tas-CLI ta' OmniRoute — omniroute providers list, omniroute combo list u omniroute health — li ddur mal-wiċċ ewlieni ta' 86 kmand: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

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

```bash # 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](docs/frameworks/MCP-SERVER.md) · [Server A2A](docs/frameworks/A2A-SERVER.md) · [Protokolli tal-Aġenti](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

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

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

Il-pipeline tal-kompressjoni ta’ OmniRoute: talba illustrattiva tal-klijent ta’ 10,000 token tgħaddi minn 12-il magna kompożibbli — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra u OmniGlyph — u tista’ tasal għand il-fornitur b’madwar 1,080 token fl-eżempju dokumentat tal-munzell. Il-kontenut strutturat huwa protett minn salvagwardji ta’ preservazzjoni u gradi ta’ fedeltà għal kull pass; modi espliċiti b’telf jew sperimentali jistgħu jittrasformaw il-kontenut eliġibbli.

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: ```txt 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](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), u [Troglodita](https://github.com/leninejunior/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](https://github.com/leninejunior/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: ; 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`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Bidu Malajr

**1) Installa u ħaddem** ```bash npm install -g omniroute omniroute ``` > 💡 Qed tara `npm warn ERESOLVE` jew twissijiet dwar peer-dependencies? [Ma jagħmlu ebda ħsara](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). 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** ```txt 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** ```bash 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: ```txt 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** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` 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](docs/guides/DOCKER_GUIDE.md#release-channels). 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 | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` It-tabella sħiħa: [Gwida ta’ Docker — RAM waqt it-tħaddim](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **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](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 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 .`). ```bash # Installa u ħaddem b’Bun bun install bun run dev ``` **🛠️ Mis-sors** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # 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](docs/guides/DOCKER_GUIDE.md) — Profili ta’ Compose, Caddy HTTPS, mini ta’ Cloudflare. **🦭 Podman** ```bash # 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](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Gwida ta’ Podman](contrib/podman/README.md) — 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): ```bash 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](docs/guides/TERMUX_GUIDE.md). 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](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **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](https://github.com/diegosouzapw/OmniRoute/issues/new) jew [diskussjoni](https://github.com/diegosouzapw/OmniRoute/discussions) 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](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — segwi għal ħarġiet u pariri | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Globali** | [ingħaqad mal-grupp](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brażil** | [ingħaqad mal-grupp](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Sit web** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Komunità StHub OmniRoute (b’xejn)** | [portal ta’ sthub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Kodiċi sors** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Irrapporta bug** | [iftaħ issue](https://github.com/diegosouzapw/OmniRoute/issues) — ehmeż l-output ta’ `npm run system-info` | | 🤝 **Ikkontribwixxi** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Mudell tal-Branching u tar-Rilaxxi](docs/ops/BRANCHING_MODEL.md) · agħżel `good first issue` | | 💚 **Appoġġja l-proġett** | [Modi kif tappoġġja ↑](#-support-omniroute) · [Sponsors ta’ GitHub](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Munzell Teknoloġiku

Saff	Teknoloġija
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Lingwa	TypeScript 6.0 — 100% TypeScript madwar `src/` u `open-sse/` (żero `any` fil-qalba minn v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Bażi tad-Data	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 moduli tad-dominju, 183 migrazzjonijiet
Memorja	SQLite FTS5 test sħiħ + embeddings vettorjali int8-quantized, dekadiment tat-tip
Skemi	Zod 4 — validazzjoni I/O tal-għodda MCP + kuntratti tal-API
Protokolli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + pont WebSocket (`/v1/ws`)
Kompjessjoni	pipeline ta' 12-il magna — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Awtentikazzjoni u Sigurtà	OAuth 2.0 (PKCE) + JWT + Ċwievet tal-API + awtentikazzjoni b'ambitu MCP · AES-256-GCM waqt il-mistrieħ · DOMPurify
Moħbi	wreq-js — impersonazzjoni tal-marka tas-swaba' TLS JA3 / JA4, proxy bi 3 livelli
Reżiljenza	Circuit breaker, backoff esponenzjali, anti-thundering-herd, awto-combo awto-fejqan
Reġistrazzjoni	pino — logs JSON strutturati b'kuntest tat-talba
Ittestjar	Node.js test runner + Vitest — 39,000+ dikjarazzjonijiet ta' test statiċi madwar 5,100+ fajls tat-test segwiti (unità, integrazzjoni, E2E, sigurtà, ekosistema)
Pjattaformi	Desktop (Electron) · Android (Termux) · PWA (kwalunkwe browser)
CI/CD	GitHub Actions — pubblikazzjoni awtomatika npm + Docker Hub fuq ir-rilaxx
Rabtiet	Websajt · npm · Docker Hub

## 📖 Dokumentazzjoni

### 📘 Kif Tibda

Dokument	Deskrizzjoni
Gwida għall-Utent	Fornituri, kombinazzjonijiet, integrazzjoni tas-CLI, skjerament
Gwida għall-Konfigurazzjoni	Metodi kompluti ta’ installazzjoni, konfigurazzjonijiet tal-għodod CLI, konfigurazzjoni tal-protokolli, irfinar tal-limiti taż-żmien
Gwida għall-Għodod CLI	Konfigurazzjoni 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 tal-aċċess b’ambitu definit
Konfigurazzjoni ta’ Claude Code	Qabbad Claude Code ma’ OmniRoute (lokali/remot) permezz ta’ `launch` + profili għal kull mudell
Bidu Mgħaġġel	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 kompleta: konfigurazzjoni 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 ta’ Progressive Web App, caching, arkitettura
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 aspetti interni
Gwida għall-Kompressjoni	Pipeline b’7 għażliet: mitfi / ħafif / standard / aggressiv / ultra / RTK / f’munzell
Kompressjoni RTK	Kompressjoni tal-output tal-kmandi, filtri, fiduċja, verifika, irkupru tal-output mhux ipproċessat
Magni tal-Kompressjoni	Caveman, RTK, pipelines f’munzell, 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 ħolqien ta’ pakketti ta’ regoli għal Caveman
Gwida għar-Reżiljenza	Circuit breakers, perjodi ta’ stennija, kju, prevenzjoni ta’ thundering herd, spoofing ta’ TLS
Magna Auto-Combo	Evalwazzjoni b’16-il fattur, pakketti ta’ modalitajiet, awtotiswija
Gwida għall-Proxy	Sistema ta’ proxy bi 3 livelli, suq ta’ 1proxy, CRUD tar-reġistru
Livelli Bla Ħlas	Direttorju kkonsolidat: 35 pool rikorrenti dokumentati / 489 entrata katalogata fil-livell bla ħlas
Gallerija tal-Karatteristiċi	Dawra viżiva tad-dashboard bi screenshots
Dokumentazzjoni tal-Codebase	Spjegazzjoni pass pass tal-codebase adattata għal min għadu jibda

### 🤖 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ħodda MCP, konfigurazzjonijiet tal-IDE, klijenti Python/TS/Go
Gwida għas-Server MCP	Installazzjoni tal-MCP, trasporti, u referenza tal-għodod
Server A2A	Protokoll JSON-RPC 2.0, ħiliet, streaming, ġestjoni tal-kompiti
Gwida għas-Server A2A	Karta 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 jimmiraw il-PRs (`release/*`), u xi jfissru `main` u t-tags
Reġistru tal-Bidliet	Storja 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 għall-kopertura tat-testijiet għal aktar minn 39,000 dikjarazzjoni statika tat-test mifruxa fuq aktar minn 5,100 fajl tat-test traċċat

# ⭐ L-Aqwa Kontributuri > OmniRoute huwa msawwar minn komunità passjonata ta’ sors miftuħ. Dawn l-individwi taw kontributi eċċezzjonali li jħallu impatt dirett fuq il-kwalità, l-istabbiltà u l-firxa tal-proġett. **Grazzi.** ### Kontributuri esterni skont il-pull requests magħquda

Pożizzjoni	Kontributur	PRs Magħquda	~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’merġijiet sal-2026-08-24 05:26:03 UTC. Iċ-ċensiment impaġnat ta’ GitHub GraphQL fih 5,911-il PR magħqud: 2,707 mis-sid tar-repożitorju, 179 minn Dependabot, u 3,025 PR estern 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 tkejjel il-volum tal-bidliet, mhux LOC miktuba. Il-pari fl-istess pożizzjoni fil-limitu jinżammu.} ### Commits attribwiti minn GitHub

backryun _{🥇 220 commit attribwiti minn GitHub}	Paijo _{🥈 219-il commit attribwiti minn GitHub}	Randi _{🥉 108 commits attribwiti minn GitHub}	Ravi Tharuma _{🏅 81 commit attribwiti minn GitHub}	Chris _{🏅 70 commit attribwiti minn GitHub}	Markus Hartung _{🏅 69 commit attribwiti minn GitHub · indaqs fis-6 post}
Dizzle _{🏅 69 commit attribwiti minn GitHub · indaqs fis-6 post}	Jan Leon _{🏅 64 commit attribwiti minn GitHub}	zenobit _{🏅 62 commit attribwiti minn GitHub}	Bob.Hou _{🏅 51 commit attribwiti minn GitHub · indaqs fl-10 post}	Xiangzhe _{🏅 51 commit attribwiti minn GitHub · indaqs fl-10 post}

_{Iċċekkjat mill-ġdid fi 2026-08-24 06:14:31 UTC: commits attribwiti minn GitHub irrappurtati mill-Contributors API 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 inkorporati ta’ 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 ewlenija** minn dak li jagħmel lil OmniRoute affidabbli u rikk 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

[![Kontributuri](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{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](docs/ops/BRANCHING_MODEL.md) 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](CONTRIBUTING.md) għal linji gwida dettaljati. ### Kif Toħroġ Verżjoni Ġdida ```bash # 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](https://github.com/decolua/9router)** u port għal TypeScript tal-proġett Go **[CLIProxyAPI](https://github.com/router-for-me/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](LICENSE) għad-dettalji. ---

**[⬆ Lura fil-bidu](#-omniroute)** · Mibni b’❤️ għall-komunità tal-IA b’sors miftuħ. _{OmniRoute v3.8.51 · Node ≥22.22.2 · Liċenzja MIT · omniroute.online}