# README (Malti) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/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) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/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) · 🇸🇰 [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) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Il-Gateway tal-IA B’Xejn

OmniRoute — Qatt tieqaf tikteb il-kodiċi. Kull għodda tal-IA → 355 fornitur — 150+ b’xejn — permezz ta’ endpoint wieħed. Claude Code, Codex, Cursor, Cline, Copilot u Antigravity għal Claude / GPT / Gemini B’XEJN b’fallback awtomatiku. Il-kompressjoni kkombinata RTK + Caveman tiffranka 15–95% tat-tokens (~89% bħala medja) — qatt ma tilħaq il-limiti. 355 fornitur tal-IA · 150+ livell b’xejn · ~1.51B tokens b’xejn/xahar · 19-il strateġija ta’ routing · $0 biex tibda.

## 💰 ~1.51B Tokens B’Xejn / Xahar

> Li tikkombina l-livelli b’xejn manwalment huwa diffiċli — għexieren ta’ SDKs, għexieren ta’ limiti tar-rata, u ebda idea ta’ kemm għandek tassew. OmniRoute jikkataloga **446 entrata ta’ livelli b’xejn mifruxa fuq 38 ċavetta ta’ pools rikorrenti** u jikkalkula ċ-ċifra ewlenija tat-tokens mill-**20 pool b’baġit pożittiv ta’ kull xahar ippubblikat**, bid-duplikati mneħħija skont il-pool kondiviż. Ir-riżultat jibqa’ viżibbli fuq id-dashboard (`/dashboard/free-tiers`).

Kard tal-baġit tal-livelli b’xejn ta’ OmniRoute: ~1.51B tokens b’xejn kull xahar b’mod stabbli, sa ~2.13B fl-ewwel xahar bil-krediti tar-reġistrazzjoni, minn 38 ċavetta dokumentata ta’ pools rikorrenti li jkopru 446 entrata kkatalogata ta’ livelli b’xejn wara endpoint wieħed. Kalkolu onest bid-duplikati tal-pools imneħħija — kull pool kondiviż jingħadd darba biss, inklużi 20 pool rikorrenti b’baġit pożittiv ta’ tokens ta’ kull xahar ippubblikat; 13-il fornitur huma mmarkati bħala avoid fil-katalgu tar-riskji tat-termini sabiex tiddeċiedi int. Il-bar tal-baġit jinkludi Mistral 1B, LLM7 150M, Nara 150M, Gemini 60M u pools iżgħar, flimkien ma’ krediti tar-reġistrazzjoni għall-ewwel xahar u fornituri b’xejn għal dejjem mingħajr limitu ta’ tokens murija separatament sabiex qatt ma jkabbru artifiċjalment iċ-ċifra ewlenija. Użu u bilanċ li jifdal f’ħin reali fuq /dashboard/free-tiers.

> Sommarju animat tal-paġna attiva `/dashboard/free-tiers`. Metodoloġija sħiħa (tneħħija 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 attiv u **jinbidlu fiż-żewġ direzzjonijiet** — jekk fornitur itemm livell b’xejn, in-numru jonqos; jekk jiżdied wieħed ġdid, jitla’. Aħna nippubblikaw dak li fil-fatt jikkalkula l-katalgu, qatt l-aħjar xenarju arrotondat ’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)

[![Klassifikazzjoni 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-mantenitur — 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)**
## 📈 I-Gatewa Qed Tikber

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | -------------------------------- | :-----: | :----------------------: | :-----------------------: | | 🌐 Fornituri | 290 | **352** | iktar fil-lista t'istenni | | 🧩 IDs ta' mudell ta' chat uniku | 1185 | **1312** | — | | 🖼️ Pont tal-Modalità | — | 🆕 vidjo + awdjo + vidjo | — | | 📡 Katalgu b'xejn tar-radar | — | 🆕 għażla | — | | ⚖️ Skedar tal-kwantità b'riżors | — | 🆕 Kwantità-Share | — | | 📊 Telemetrik tal-kwantità | — | 🆕 ħaj | — | **→ [Roadmap](ROADMAP.md) — qed nimxu lejn `v3.9.0 LTS`**

## 🧩 Disponibbli [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](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) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Tnedi	🚀 Bidu Rapidu	📦 installazzjoni	🆓 Zero-config
💡 Tgħallem	💥 Il-Wegħda	🤔 Għaliex OmniRoute	🏆 X'jifirduha
⚙️ Karatteristiċi	🎯 Kombinazzjonijiet	🌐 Fornituri	🔌 CLI & MCP
	🗜️ Kompressjoni	🖥️ Fejn Taħdem	🔒 Privata
👀 Araha	🎬 Fl-Azzjoni	✨ X'għandha Ġdida	🤖 CLIs Kompatibbli
💚 Appoġġ	💚 Appoġġ / Donazzjoni	💬 Komunità	💖 Sponsors
📦 Proġett	🛠️ Stack Tekniku	📖 Dettalji	👥 Kontributuri

🌐 F'49 lingwa

## 🆓 Tivvista mill-ewwel sekonda li tinstallha — bla ċavet, bla configurazzjoni

Tivvista mill-ewwel sekonda li tinstallha — bla configurazzjoni. Tliet passi: 1. Installa — npm i -g omniroute, is-servizz jibda fuq localhost:20128. 2. Timmira l-għodda tiegħek lejn http://localhost:20128/v1 — kwalunkwe għodda kompatibbli mal-OpenAI (Claude Code, Cursor, Cline). 3. Tweġib — sejjaħ `model auto` għal risposta istantanja, bla API key, bla reġistrazzjoni, bla configurazzjoni. Il-fornitur bla ċavet OpenCode Free huwa mmappar ġewwa l-kombinazzjoni `auto`, sabiex installazzjoni ġdida twegib minnufih.

```bash # Installazzjoni ġdida, bla 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 b'xejn speċifiku? Sejjaħ `oc/…` (OpenCode Free) direttament. Imbagħad, għadd għal `auto` u ħalli OmniRoute jagħżel.} _{📦 Kopja u leġġ skriptijiet quickstart għal **Python, Node.js, PHP, u cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 L-Wegħda

# 🤔 Għaliex OmniRoute?

Il-fluss tal-istedini ta' OmniRoute: l-IDE jew il-CLI tiegħek (Claude Code, Cursor, Cline…) jsejjaħ punt wieħed lokali (http://localhost:20128/v1); l-Intelliġenza tal-Mutur ta' OmniRoute (RTK + kumpressjoni Caveman, 19 strateġija ta' rutjar, circuit breakers, TLS stealth, MCP, A2A, salvagwardji) tista' tagħmel fallback fost 4 tier ta' fornitur waqt li hemm mira eliġibbli u sana — Tier 1 Sħubija, Tier 2 API Key, Tier 3 Rħas u Tier 4 B'Xejn.

## 🤝 Appoġġ minn ħbiebna tal-Open Source

> **Trid tissieħek bħala Ħabib tal-Open Source?** Dawn huma l-kumpaniji li jappoġġjaw l-open source u jgħinu jiżguraw li OmniRoute u għadd miexi — u aħnar nistqarru pubblikament fejn imur kull token li jagħtuna. Ikktab: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Grazzi għal Kimi (Moonshot AI), il-Ħabib tal-Open Source Fundatur tagħna, għall-appoġġ tagħhom għal dan il-proġett! Kimi huwa l-laboratorju tal-IA wara l-familji tal-mudelli K2 u K3 b'piż miftuħ — Kimi K3 joffri tfarfir ta' 1M-token, xbieki nattivi u programmazzjoni ta' livell ta' sanometrija bi spejjeż frazzjoni tal-mudelli magħluqa, u jaħdem minnufih ma' Claude Code, Codex u kull għodda tal-programmazzjoni li sservi OmniRoute.

X'jappoġġja l-appoġġ ta' Kimi: Il-kredits tal-API ta' Kimi jappoġġjaw il-pipeline tal-ħruġ tal-IA tal-approvazzjoni tal-IA — l-istadju tal-verifika tal-merge immexxija minn Kimi K3 li tivverifika kull talba ta' qabda qabel ma toħroġ — flimkien mal-iżvilupp tal-karatteristici ta' kuljum. L-appoġġ tal-Kimi ta' klassi għolja jasal fiż-żewġ linji: il-API Dirett ta' Kimi (kimi-k3) u l-pjan tal-programmazzjoni ta' Kimi Code (OAuth u chiave API). OmniRoute huwa wkoll l-ewwel proġett open source fil-programm tal-appoġġ ta' Kimi. Ikseb chiave API ta' Kimi b'15% kredits żejda →

Cheaper Inference
_{cheaperinference.com} Grazzi għal Cheaper Inference, Ħabib tal-Open Source ta' OmniRoute, għall-appoġġ tagħhom għal dan il-proġett! Cheaper Inference huwa portal li jipprezzja b'valur li jbigħ mill-ġdid 42 mudell ta' sanometrija — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok u MiniMax — wara punt wieħed kompatibbli mal-OpenAI, u jġiegħel kull talba lill-fornitur l-irħas eliġibli mingħajr ma jċaħħad qatt 'il fuq mill-prezz tal-lista tal-ħallieq tal-mudell.

Appoġġ ta' klassi għolja f'OmniRoute: Chat Completions, il-punt nattiv /v1/responses, xbieki, sejħiet tal-għodda u 3 mudelli tal-istampi (grok-imagine, nano-banana-pro, nano-banana-2, jistgħu jintlaħqu bħala cheaperinference/<model>). Ikseb chiave API →

_{L-links immarkati b'aff=omniroute huma links tal-imsieħba. Dawn iffinanzjaw il-proġett bla spejjeż żejda għalik.}

_{🎟️ Promozzjoni tal-Affiliates — kupuni ta' reġistrazzjoni b'xejn minn fornituri li ma nsponsorjawx (ikkliljja biex tiġi wiesgħa)}

_{Dan il-parti huwa biss għal kodiċijiet ta' riferiment/kupuni. Is-sħubiji sponsorjati jgħixu fil-🤝 Appoġġ minn ħbiebna tal-Open Source t'hawn fuq. OmniRoute m'għandha l-ebda sponsorizzjoni jew sħubija mal-fornituri elenkati hawn taħt — dawn huma kupuni pubbliċi li xi ħadd jista' juża.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — reġistrazzjoni ta' affiliates · $100 kredits b'xejn meta tivvjaġġa (server b'xejn, ħaġa ta' dewmien ogħla — l-aħjar għat-testijiet, mhux fil-produzzjoni). Appoġġ ta' klassi għolja f'OmniRoute mill-v3.8.50: Chat Completions, il-format tal-wajer kompatibbli mal-Anthropic u t-triq kompatibbli mal-OpenAI. Il-mudelli disponibbli jinkludu claude-opus-4-8, claude-opus-5, gpt-5.6-sol u aktar. Sehem il-$100 tiegħek →}

_{⚠️ Link tal-affiliate — OmniRoute m'għandha l-ebda sponsorizz jew sħubija mal-fornitur.}

_{Inti taf fornitur ieħor b'kupun ta' reġistrazzjoni ġeneruż li jgħin l-utenti ta' OmniRoute? Ftaħ kwistjoni u se nżiduh hawn.}

## 🎯 Kombinazzjonijiet — Il-Model Ftit

L-19 strategiji ta' rottar tal-kombinazzjonijiet animati — tass wieħed 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' fuq biex taf x' tagħmel kull waħda.

> **Kombinazzjoni** huwa katina ta' mudelli li OmniRoute jirrottahom **awtomatikament**. Jekk il-kwota tintemm, xi fornitur jonqos, jew is-spiżi jiżdied, il-kombinazzjoni tista' taqleb għall-mudell li jmiss li jkun tajjeb. 🛡️ ### ⚡ Kxef-kofigurazzjoni — użu biss `auto` Ebda kombinazzjoni x'tirranġa. Poġġi l-mudell tiegħek għal `auto` (xi varianta) u OmniRoute joħloq kombinazzjoni virtwali mill-fornituri marbuta tiegħek, mogħtija skor ħaj:

ID tal-Mudell	Għaliex jottimizza
`auto`	🎯 Defalt bilanċjat (LKGP — jibqa' mal-aħħar fornitur tajjeb għalik)
`auto/coding`	🧑�ż Kwalità l-ewwel għat-tħejxija tal-kodiċi
`auto/fast`	⚡ Lanqas dewmien l-ewwel
`auto/cheap`	💰 L-irħas għal kull token l-ewwel
`auto/offline`	🔋 L-iktar kwota / spazju ta' rata limitata l-ewwel
`auto/smart`	🔭 Kwalità l-ewwel + 10% esplorazzjoni biex issib mudelli aħjar
`auto/lkgp`	📌 Identifiku b'mod ċar mal-aħħar fornitur tajjeb magħruf
`auto/chaos`	🧪 Piżijiet għat-testjar ta' reżiljenza (ingegnerija kaotika)

## ### 🔀 Jew oħroġ dik tiegħek stess — 19 strategija ta' rottar L-**19** strategija — tħallat u tiftaħar mal-pass ta' kull kombinazzjoni:

#	Strateġija	X' tagħmel
1	`priority`	Datalist b'ordni tal-ewwel-mira — metaġġ kul waħda qabel l-oħra 🥇
2	`fill-first`	Imtela b'kollha il-kwota ta' kull mira qabel ma taqleb
3	`weighted`	Intagħżel ġejd biż-żewnijiet skont il-piż ta' kull mira
4	`round-robin`	Idur mal-miri fl-ordni
5	`p2c`	Għażla random bil-qawwa ta' żewġ għażliet għal bilanċi tal-piż
6	`least-used`	Agħżel il-mira bl-iktar piż baxx kurrenti
7	`random`	Għażla uniformi (mhux ripetuta)
8	`strict-random`	Random mingħajr ma telimina ripetizzjonijiet 🎲
9	`cost-optimized`	Tnaqqas il- $ għal kull talba skont il-prezz attwali 💸
10	`headroom`	Agħżel il-mira bl-iktar kwota residwa
11	`reset-window`	Tippreferi il-mira li l-finestra tal-kwota tagħha tirritorna l-ewwel
12	`reset-aware`	Tirranġa skont il-ħin tat-ritorn tal-kwota — finestri qosra l-ewwel 📊
13	`context-relay`	Tgħaddi l-kuntest bejn il-miri għal konversazzjonijiet twal 🧠
14	`context-optimized`	Agħżel l-akbar adattament għad-daqs attwali tal-kuntest
15	`cache-optimized`	Twaħħal kull prefix ta' prompt użizzjonali mal-istess kont — iżżid l-impatti tal-cache tal-prompt 🎯
16	`lkgp`	Mogħdija tal-Aħħar TAJJEB MAGĦRUF — twaħħal mal-aħħar fornitur ta' suċċess, mbagħad jirrikorri għar-rekwiżiti
17	`auto`	Skor ħaj fuq 16 fattur mal-konnessjonijiet kollha 🤖
18	`fusion`	Ixerred mal-panal tal-mudelli + ġurija ssintetizza tweġiba waħda 🧬
19	`pipeline`	Katina ta' passi — output ta' kull mira jidħol f'dik li jmiss 🔗

_{Magna tal-Kombinazzjoni Awtomatika tagħti skor lill-kandidati kollha fuq **16-il fattur** (saħħa, kwota, spiżi, dewmien, adattament tal-impjieg, kwalità, disponibbiltà tas-sessjoni…) — ara [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Ir-Reżiljenza hija mibnija fil-pjan (3 saffi indipendenti)

Reżiljenza ta' OmniRoute — 3 saffi indipendenti li jfejquhom infushom, il-saff it-tajjeb għall-ħsara it-tajjba. Saff 1 il-fornitur jagħlaq (fornitur sħiħ): jagħlaq biss fuq 408/5xx, l-għaddar għal OAuth 8× / API-key 12× / lokali 2×, jirritorna wara 60s/30s/15s fi SPRAWL-Prova, rkupru bil-mod; waqt li huwa AĦMAR il-kombinazzjoni teħles lil-for nitur li jmiss. Saff 2 it-tkessiħ tal-konnessjoni (kunti/kont wieħed): bażi 5s għal OAuth / 3s għal API-key, tnaqqis b'2x b'ħarsien mill-merħla t'għaġġa kbira, 429 iħobb Retry-After, is-suċċess jinqara l-istat kollu ta' żball; kont li jkessiħ wieħed jitwarrab waqt li l-konti ġirienkom jkomplu joffru. Saff 3 it-twaqqif tal-mudell (mudell wieħed): 429 għal kull mudell, lokali 404 jew ripreżentazzjonijiet jorbtu dan il-mudell biss — qatt il-konnessjoni kollha. Stati terminali (pprojbit, skadit, kreditu nfaqgħu) huma għall-operatur, mhux tkessiħ.

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

## 🏆 Dak Li Jiddistingwi OmniRoute

_{📊 Metodoloġija sħiħa & dettalji ta' kull karatteristika vs 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Appoġġa lil OmniRoute OmniRoute huwa liċenzjat MIT u jinżamm fil-miftuħ. Jekk jiffrankalek ħin jew flus, hawn kif iżżommu indipendenti — agħżel dak li jaqbellek. L-isponsorizzazzjoni qatt ma taffettwa l-prijorità tar-routing; tixtri viżibilità, mhux klassifikazzjoni.

⭐ Agħti stilla lir-repo	B'xejn — tassew jgħin fil-viżibilità	Agħti stilla lil OmniRoute
🐙 GitHub Sponsors	Darba waħda jew fix-xahar · l-ebda ħlas ta' pjattaforma	github.com/sponsors/diegosouzapw
☕ Ko-fi	Tip ta' darba malajr, l-ebda 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ħ · open source	liberapay.com/diegosouzapw
🇧🇷 PIX (Brażil)	Immedjat, l-ebda ħlas	key & QR hawn taħt
₿ Crypto	BTC · ETH · USDT-TRC20 · USDC-Solana	indirizzi hawn taħt

**🇧🇷 PIX** — immedjat, l-ebda ħlas (Brażil) Kodiċi QR PIX ta' OmniRoute

Key (każwali): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Crypto — BTC · ETH · USDT-TRC20 · USDC-Solana (ikklikkja biex tespandi)

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

_{⚠️ Ibgħat kull munita biss fuq in-netwerk muri — li tibgħat fuq in-netwerk ħażin tista' titlef il-fondi.}

🐛 Sibt bug jew għandek feedback? 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żviluppatur. Dan il-fajl huwa intenzjonalment injorat permezz ta' .gitignore (ara .gitignore) u qatt m'għandu jiġi kkommettjat — jekk jiġi kkommettjat b'aċċident, ibdel kwalunkwe sigrieti esposti u neħħi l-fajl mill-istorja. Ara docs/DEVELOPER-ENVIRONMENT.md għal gwida dwar il-ġestjoni ta' fajls ambjentali lokali u sigrieti.

## 📡 OmniRoute Radar Il-qarar principali tal-tier b'xejn jibqa' **~1.51B token/xahar** mill-katalogu dokumentat, deduplikat mal-pool, t'hawn fuq. Krediti temporanji ta' reġistrazzjoni tal-fornituri jistgħu jżidu l-ewwel xahar separatament għal **~2.13B**. Radar huwa katalogu fakultattiv, iffirmat, għal min irid disponibbiltà aktar friska tal-mudelli b'xejn bejn ir-rilaxxi ta' OmniRoute; il-katalogu tal-komunità u kull karatteristika b'xejn eżistenti jibqgħu b'xejn. Is-sapporters jistgħu jirċievu l-katalogu ħaj u opportunitajiet addizzjonali tal-fornituri. Il-limitu separat, li jista' jinbidel, tiegħu huwa **madwar 3B token/xahar fil-massimu**, skont id-disponibbiltà tal-fornituri. Dan il-limitu mhuwiex garanzija: il-fornituri jistgħu jibdlu l-kwantitajiet, l-eleġibbiltà, il-mudelli, jew ir-reġjuni fi kwalunkwe ħin. Radar huwa bit-talba u biss GET. Il-klijent OmniRoute ma tbgħatx prompts, traffiku, konfigurazjoni tal-fornitur, telemetrija tal-użu, jew l-istat tat-twaqqif tal-avviżi lokali. Sir af dwar l-eleġibbiltà u l-katalogu attwali f'**[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ X' Hemm Ġdid

> Evidenzi reċenti minn **v3.8.20 → v3.8.50**. Storja sħiħa f'[`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — delegazzjoni A2A inbound lejn il-flotta tal-aġenti tiegħek, ħiliet Conductor fuq il-Karta tal-Aġent, u pannell ta' dashboard b'veċċ chat push-to-talk ta' Faro. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Dħul adattiv u protezzjoni ta' għolla** — it-talbiet chat ital qil jidħlu fil-fila minflok jgħatu 503, b'liri RPM rolling atomici għal kull konnessjoni. → [Gwida tar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Tordni kanoniku `/v1/models`** — blokka waħda kontinja skont il-fornitur għal kull fornitur (kombinazzjonijiet immankati l-ewwel), stabbli f'kull sors tal-katalogu. → [Referenza API](docs/reference/API_REFERENCE.md) - **🗜️ Saħħa tal-Kompressjoni** — gwardja ta' infjazzjoni attiva b'mod default, pacakki Caveman għal DE / FR / JA + Ċiniż (wényán), filtru RTK għal Gradle & .NET. → [Kompressjoni](docs/compression/COMPRESSION_ENGINES.md) - **💸 Preżizzjoni ċara ta' preċjozità fissa** — il-fornituri ta' sottoskrizzjoni / pjan tal-kodiċi juru **$0** fl-analiżi tal-ispejjeż; baġit, kwota u ruting jibqgħu jistimaw. → [Referenza API](docs/reference/API_REFERENCE.md) - **⚖️ Ruting ta' Quota-Share** — qasam il-kwota ta' kont maqsum b'ħarsa ġusta fost ċifri f'pool, b'konservazzjoni tax-xogħol sabiex porzjonijiet ħfiefa jkunu msellfa. → [Gwida tar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Twaqqif b'kmand wieħed CLI/aġent** — 13-il kmand `setup-*` irreġistrati; `omniroute run` jibda 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` jappoġġa 10 miri b'għażla interattiva tal-fornitur+mudell u preferenzi għal kull kuntest. → [Integrazzjonijiet CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Mod imbiegħed** — ħaddem OmniRoute imbiegħed b'tokens skopati (`connect` / `contexts` / `tokens`) + għajnuna OAuth `antigravity` għall-installazzjonijiet VPS. → [Mod Imbiegħed](docs/guides/REMOTE-MODE.md) - **🧭 Ruting awtomatiku aktar intelliġenti** — kombinazzjonijiet `auto/:`, **Fusion** (pannell tal-mudell + ġudikant), ruting konxju tax-xogħol, override tal-mudell / modalità / baġit-USD għal kull talba. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Kompressjoni inkorporabbli** — 12 magni kompostibbli + Compression Studios: LLMLingua-2, Ultra ta' żewġ livelli, omniglyph, bieb tal-fidiljetà għal kull pass, GCF v3.2, editur ta' rerank bit-tir. → [Kompressjoni](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Decriptazzjoni MITM transparenti (TPROXY)** — qbad CLIs li jinjoraw l-variżevi tal-proxy, b'CA għal kull SNI + installatur tal-ħżen tal-fiduċja. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija tal-ispejjeż kullimkien** — intestaturi `X-OmniRoute-*` ta' spejjeż/użu fuq kull endpoint, intestatur ta' tnaqqis cache-HIT, kwota ta' nefqa USD għal kull ċavetta. → [Referenza API](docs/reference/API_REFERENCE.md) - **🧠 Memorja li tikkontrolla** — skatt b'mod default, għażla fakultattiva ta' kwantizzazzjoni vettoriali int8 + tnaqqis ta' tip, `x-omniroute-no-memory` għal kull talba. → [Memorja](docs/frameworks/MEMORY.md) - **🛡️ Sigurtà** — gwardja ta' injezzjoni ta' prompts fuq kull rotta LLM (suite ta' red-team), gwardja ta' maskarar ta' kredenzjali fakultattiva (tirrevedi ċifri/sigrieti API mifluga f'żewġ direzzjonijiet), tiftix web DuckDuckGo b'xejn bħala l-aħħar għażla, u bieb ta' OIDC fakultattiv għad-dashboard (idħul bil-password jibqa' dejjem disponibbli). → [Gwardji](docs/security/GUARDRAILS.md) - **🖼️ Endpoints ġodda** — `/v1/ocr` (Mistral OCR) u `/v1/audio/translations` (b'stil Whisper) jimlew il-wiċċ tal-midja. → [Referenza API](docs/reference/API_REFERENCE.md) - **🎨 Ġenerazzjoni ta' stampi / vidjow / awdjo** — API waħda għall-midja: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, u fornituri tal-kellm bħal ElevenLabs. → [Referenza API](docs/reference/API_REFERENCE.md) - **🌍 Tqegħid u operazzjonijiet** — reverse-proxy `basePath`, għarfien awtomatiku 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 + idħul OAuth, karta ta' Ollama tal-ewwel klassi, Claude Opus 5 & Sonnet 5, sħubija uffiċjali ta' Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… u katalogu aġġornat ta' **352 fornitur**. → [Fornituri](docs/reference/PROVIDER_REFERENCE.md) - **📡 Trasparenza tar-Ruting** — kull risposta ġġorr intestatura `X-OmniRoute-Decision` li tissemma l-istrateġija/fornitur/latenza li ġġarrabha, strateġija ġdida ta' kompożizzjoni `cache-optimized` + fattur `cacheAffinity` ta' Auto-Combo li rutja it-talbiet terriegħa lura lejn il-konnessjoni li ġġorr il-prefiss ġġenerat, u endpoint b'read-only `/v1/auto-combo/{channel}/candidates` juri l-pool ħaj tal-kandidati ta' kanal `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Prestazzjoni u infrastruttura lokali** — Redis lokali b'klikk wieħed, deplojers tal-mitlaq Cloudflare Workers / Deno Deploy, Bifrost & Mux bħala servizzi integrati supervisionati. → [Servizzi Integrati](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Ukoll fil-pakkett** — framework tal-plugins + suq, frameworks ta' ħiliet Omni/Agent/GitHub, integrazzjoni ta' Obsidian vault (22 għodod MCP), API kompatibbli ma' OpenAI ta' Batch & Files, cache tar-risposti semantika, gamifikazzjoni b'leaderboards, skoperta ta' aġenti ACP (15 aġenti integrati), esportazzjoni skedulata tal-log lejn BigQuery, injettjar tal-falliment `auto/chaos`, pont ta' bot Telegram, manager tal-verżjonijiet fl-app u rankings tal-fornituri b'xejn LMArena-ELO. → [Dokumentazzjoni](docs/README.md)

## 🤖 CLIs Kompatibbli u Aġenti tal-Kodifikazzjoni > Konfigurazzjoni waħda — `http://localhost:20128/v1` — u **kull** IDE jew CLI tal-AI jimxi b'mudelli b'xejn u b'xorta irħas.

_{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}

＋ tagħmilx ukoll ma' · Kiro · Command Code · Antigravity · Windsurf · AMP · kull għodda kompatibbli mal-OpenAI

_{📖 Twaqqif skont għodda għall-36 għodda kollha (26 CLI Code's + 10 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Ħoll kull CLI appoġġjat permezz tal-Omniroute b'kmand wieħed** — ħejj intikaw tal-konfigurazzjoni miktuba, il-kredenzjali jiġu injettati għal kull proċess， il-Qwen/Gemini jingħataw dar isolata għal darba: ```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+il-mudell b'mod interattiv u aktar konfigurazzjoni tal-għodda stess: omniroute configure codex # ukoll: claude opencode qwen aider goose gemini cline continue kilo ``` Kull kmand jirrispetta l-kuntest remott attiv (`omniroute connect `)， `--dry-run` juri l-ammont eżatt tal-ambjent/argomenti mingħajr ma jwettaq， u `--api-key-env NAME` iżomm is-sigriet barra mill-istorja tal-shell tiegħek. → [Integrazzjonijiet CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 352 Fornituri tal-AI — 152 Immarkati Bħala B'xejn fil-Katalgu

> **352 fornituri rreġistrati** fil-kollezzjonijiet kanoniċi taċ-chat, tal-midja, tat-tiftix, lokali, cloud-agent 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 fornitur-mudell distinti / 1,283 ID ta' mudell mhux ipproċessati**; il-katalgu separat tal-baġit b'xejn għandu **446 ringieli għal kull mudell**, **38 pixxini rikorrenti** u **53 fornitur rikorrenti/ mingħajr ċavetta b'xejn għal dejjem**. Dawn huma denominaturi differenti bid-disinn; id-definizzjonijiet u l-kalkoli deduplikati tal-pixxini jinsabu fir-[Referenza tal-Fornituri](docs/reference/PROVIDER_REFERENCE.md) u fit-[Tier B'xejn](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 330+ oħra — kull ikona tissolva direttament mill-katalgu tal-fornituri tad-dashboard. 📖 [Referenza tal-Fornituri](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 B'xejn għal Dejjem — $0, l-ebda karta

OpenCode Zen _{DeepSeek V4, Nemotron 3 L-ebda limitu ta' tokens}	Kilo Code _{Auto-router, Tencent Hy3 B'xejn għal dejjem}	Requesty _{GPT-OSS 120B, Nemotron B'xejn għal dejjem}	SiliconFlow _{DeepSeek V3.2 / R1 Tier b'xejn}	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 ILLIMITAT}	Pollinations _{GPT, Llama, Claude L-ebda ċavetta meħtieġa}	Cloudflare AI _{50+ mudell 10K neurons/jum}	NVIDIA NIM _{GLM, MiniMax ~40 RPM b'xejn}	Cerebras _{GLM 4.7, GPT-OSS 1M tokens/jum}	OpenRouter _{:free mudelli +$10 → RPM ogħla}

📖 Katalgu sħiħ li jinqara mill-magni → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Fejn Jaħdem OmniRoute — Kullimkien

> L-app l-istess, il-magna tiegħek, ir-regoli tiegħek. Minn install globali ta' **npm** sa **it-telefon tiegħek** permezz ta' Termux.

Pjattaforma	Installazzjoni	Highlights
📦 npm (globali)	`npm install -g omniroute`	Kummenda waħda, kwalunkwe OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arkitettura AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Tieqa nattiva + tray tal-isistema — Windows / macOS / Linux
💪 ARM	nattiv `arm64`	Raspberry Pi, servers ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Taħdem fuq it-telefon tiegħek, 24/7, bla root
📲 PWA	"Żid mal-Home Screen"	Fullscreen, offline, tista' tinstalla mill-browser
🧩 Plugin tal-OpenCode	`@omniroute/opencode-provider`	Integrazzjoni nattiva tal-OpenCode
🤖 VS Code Copilot Chat	installa l-estensjoni OmniCopilot	Kull mudell ta' OmniRoute jidher fil-picker tal-Copilot Chat nattiv — stabbli & Insiders
🛠️ Minn sors	`npm install && npm run dev`	Ħack fuqu, issieħeb

_{📖 [Gwida ta' Docker](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Ġdid: OmniRoute ġewwa l-Copilot Chat nattiv tal-VS Code

> L-ebda sidebar ġdid, l-ebda UI ta' chat ġdid — kull mudell li OmniRoute jisservi jidher direttament fil-**picker tal-mudelli tal-Copilot Chat li juża diġà**. Minn VS Code 1.122, il-mudelli tal-provider jaħdmu bla sign-in ta' GitHub jew abbonament ta' Copilot — modalità tal-agent, sejħa tal-għodda u viżjoni, b'xejn. Installa l-estensjoni **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, agħtiha l-indirizz tal-server OmniRoute tiegħek (default huwa `localhost:20128`), imbagħad iftaħ Copilot Chat → picker tal-mudelli → **Ħares il-Mudelli…** → **OmniRoute**.

Ħanut	Link	Maħdem ma'
🧩 VS Code Marketplace	Installa →	VS Code — stabbli & Insiders
🔓 Open VSX Registry	Installa →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Mill-ġewwa tal-editor: iftaħ il-**Visualizzazzjoni tal-Estensjonijiti**, fittex **"OmniRoute"**, ikklikkja **Installa** — jaħdem l-istess mod fiż-żewġ ħwienet. Sors, problemi u r-runbook tal-pubblikazzjoni jinsabu f'dan l-indirizz: [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Gwida tal-VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — twaqqif, x'uri l-picker, dashboard f'tab, soluzzjoni tal-problemi}

## 🔒 Privata u Bbażata l-ewwel lokalment

## 🗜️ Ħlif 15–95% Token — Awtomatikament ### 📖 Kif jaħdem — pipeline, arkitettura u matematika tal-ħlif

Pipeline tal-kumpressjoni OmniRoute: talba minn klijent ta' 10,000 token illustrattiva tgħaddi minn 12 magni komponibbli — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra u OmniGlyph — u tista' tasal lill-fornitur b'madwar 1,080 fil-piż kumpless t'hawn taħt. Kontenut strutturat huwa protett minn gardi ta' preservazzjoni u biebiet ta' fedeltà f'kull pass; modi espliċiti li jitlef jew modi sperimentali jistgħu jibdlu kontenut eliġibbli.

Il-kombinazzjoni mtakkra standard taħdem `RTK → Caveman`. Meta it-tnejn jaġixxu fuq l-istess piż ta' għodda/kuntest, il-ħliet jingħaqdu: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Bllokijiet ta' kodifikazzjoni, URLs, JSON u data strutturata huma **dejjem protetti** mill-mekkaniżmu ta' preservazzjoni. > **Għaliex juża ħafna meta ftit jimxi?** It-talba tgħaddi permezz tal-pipeline ta' kumpressjoni ta' OmniRoute **b'mod ħafif** — l-ebda bidla fil-klijent. Issa huwa **mappa ta' 12 magni komponibbli** li jaħdmu f'ordni u jħalltu u jallinjaw mal-kombinazzjoni tat-turiżmu — jibnu 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-mappa tal-12 magni Il-magni jaħdmu fil-pipeline bl-ordni; kull wieħed huwa awtonomament jimmaniggjaw u jista' jiġi kkfigurat għal kull kombinazzjoni:

#	Magni	X'jagħmel
1	Session-Dedup	Neħħi kontenut ripetut bejn i-turns (indirizzat b'kontenut, bejn i-turns)
2	CCR	Jarkivja blokki kbar wara markaturi tal-qlib, talab meta meħtieġ
3	Lite	Tnaqqis ta' bozoz + URLs tal-immaġni (b'latentzza baxxa)
4	RTK	Filtru intelliġenti ta' riżultati tal-għodda, dedup u tnaqqis (kunxju mill-kmandi)
5	Responses Tool Output	Kumpressjoni mhux li tħalli wara għal JSON + dijanjostiċi limitati għal shell/patch/search/build outputs (Responses API)
6	Headroom	Kumpressjoni mhux li tħalli wara b'mod tabular ta' listi JSON (~30%) permezz tal-bidla tal-ħsejjes GCF
7	Relevance	Skoring ta' sentenzi estrattivi kontra l-aħħar talba tal-utent
8	Caveman	Kumpressjoni ta' proza bbażata fuq regoli (~65–75% fuq ir-riżultat)
9	Aggressive	Sommarju + aging progressiv ta' turns qodma
10	LLMLingua-2	Tnaqqis semantiku ML permezz ta' MobileBERT ONNX — sigur għal kodice, asinkronu
11	Ultra	Tnaqqis ta' token b'euristika b'għażla ta' livell ta' mudell żgħir (SLM)
12	OmniGlyph	Kontenut bħala taħħir ta' immaġni sperimentali għal Claude Fable 5 mkejla fuq il-wajer diretta ta' Anthropic; it-trasformers tal-GPT 5.6 jitilfu b'mod sigur meta ma jkunx hemm irċevuta tal-fornitur. Erba' profili ta' kumpressjoni (aggressiv b'mod awtomatiku, bilanċjat, sigur għal kodice, pass-through) (l-aggressiv; b'għażla)

Bllokijiet ta' kodifikazzjoni, URLs u data strutturata huma **dejjem** protetti b'toqba perfetta. **Preset b'buttuna waħda** jgħaqqad il-magni:

Modalità	Ħlif	L-aħjar għal
🪶 Lite	~15%	Dejta sikura li tħaddan dejjem
🪨 Standard (Caveman)	~30%	Tinkixif tal-kodice ta' kuljum
⚡ Aggressive	~50%	Sessjonijiet twal ta' tagħbija tal-għodda
🔥 Ultra	~75%	Ħlif massimu
🧰 RTK	60–90%	Shell/test/build/git outputs
🔗 Mtakkra (RTK → Caveman)	78–95%	Tħeżżiħ mħallat + logs tal-għodda

**Eżempju reali — Standard:** > **Qabel (69 token):** _"Ir-raġuni li l-komponent React tiegħek qed jerġa' jitwettaq probabilment minħabba li qed toħloq referenza ta' oġġett ġdida f'kull ċiklu ta' twettiq. Meta tgħaddi oġġett intern bħala prop, il-kumparazzjoni sekondarja ta' React tara bħala oġġett ġdid kull darba, li jġiegħel jerġa' jitwettaq. Nirrakkomanda li tuża useMemo biex timmorja l-oġġett."_ > > **Wara (19 token):** _"Referenza ġdida kull twettiq. Oġġett intern = referenza ġdida = jerġa' jitwettaq. Ħott f'useMemo."_ > > **Stess tweġiba. 72% token inqas. Ebda telf ta' preċiżjoni.** ✅ **Eżempju PT-BR — [Troglodita](https://github.com/leninejunior/troglodita) modalità:** > **Qabel (42 token):** _"Ir-raġuni li l-komponent qed jerġa' jitwettaq minħabba li referenza ta' oġġett ġdida qed toħroġ f'kull ċiklu ta' twettiq. Nirrakkomanda li tuża useMemo."_ > > **Wara (12 token):** _"Jerġa jitwettaq: referenza ġdida kull ċiklu (oġġett intern reġenrat). Tuża useMemo."_ > > **Stess tweġiba. ~70% token inqas. Preċiżjoni teknika intatta.** ✅
### 🎚️ Lil hinn mill-magni — stili tal-Output, il-dial adattiv u kontroll f'kull talba It-12 magni t'hawn fuq inaqsu dak li jidħol **l-ġewwa**. Tliet saffi oħra jsawru kif, meta, u li jiġi **l-barra**: - **🪄 Stili tal-Output** _(tħarrik ta' assistenza fuq l-output)_ — għaddi struzzjonijiet deterministiċi, sikuri għal-cache li jsawru risposta; jistgħu jitwaħħlu, wieħed b'intensità `lite` / `full` / `ultra`. It-tisfina ta' stil hija reġistru wieħed ta' linja wieħed: - **Proza qasira** — neħħi l-bżonnijiet / artikli / sikurezza; żomm il-kontenut tekniku eżatt. - **Inqas kodice** — "Senior dev trankwill" YAGNI: l-inqas bidla li taħdem, ebda scaffolding mhux mitlub. - **Ponytail (senior dev trankwill)** — ix-xaqliba tal-YAGNI, tissokta l-għerf, l-inqas bidla li taħdem. - **Għandi ADHD (azzjoni l-ewwel)** — l-azzjoni li ġejja tmexxi, passi nnumerati, wieħed wieħed li ġejja, ebda introduzzjoni. - **CJK Ħafif (文言)** — stil ultra-qasir b'dakk klasiku (imsejjes b'liema lingwa `zh`). - **🎯 Baġit ta' kontenut adattiv** _(id-dial)_ — minflok limit wieħed ta' token, ittella' l-inqas, il-magni li jitlefu b'xejn biss sakemm jeħtieġ biex **jaqbad mal-funzjoni tal-kontenut tal-mudell**. Politika: `reserve-output` (standard, kuxjent tal-mudell) · `percentage` · `absolute`. Mod: `floor` (garantixxi l-ajru) · `replace-autotrigger` (għażla espliċita tagħha terbaħ) · `off` (limitu legacy). - **🎛️ Fejn titwaħħal il-kumpressjoni** _(preċedenza, għoli → baxx)_ — f'kull talba `x-omniroute-compression` header › tibdil ta' kombinazzjoni ta' routing › profili magħrufa attivi / auto-trigger › default tal-pajna › off. Il-pjan applikat jerġa' jitkellem fil-header tal-risposta `X-OmniRoute-Compression: ; source=`. Awtomatikament skont il-limitu tat-token, waħda b'konnessjoni, waħda magħrufa, waħda f'kull talba, jew waħda skont il-kombinazzjoni tat-turiżmu — kif jogħġob ix-xogħol. Eval harness offline b'għażla (`npm run eval:compression`) juża fedeltà vs. ħliet fuq korpus magħluq qabel tagħmel 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)

# ⚡ Tqabbil Rapidu

**1) Stall u ħaddem** ```bash npm install -g omniroute omniroute ``` > 💡 Tgħid tara `npm warn ERESOLVE` jew twissijiet ta' peer-dep? [Huma ħżiena](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). Dashboard fuq `http://localhost:20128` · API fuq `http://localhost:20128/v1`. **2) Għaqqad fornitur B'XEJN (ebda reġistrazzjoni)** Dashboard → **Fornituri** → għaqqad **Kiro AI** (Claude b'xejn, ~50 kreditu/xahar għal kull kont) jew **OpenCode Free** (ebda awtentikazzjoni) → lesta. **3) Indirizza l-għodda tal-kodifikazzjoni tiegħek** ```txt Base URL: http://localhost:20128/v1 API Key: [ikkoxxa minn Dashboard → Endpoints] Model: auto (saħansitra turiżmu intelliġenti — jew kwalunkwe fornitur/mudell) ``` **4) Verifika li qed taħdem** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Għandek tara l-mudelli konnessi elenkati. 🎉 Lest —ibda tinkiteb, u OmniRoute jagħmilha awtomatikament u taqa' lura għalik. Jekk il-klijent tiegħek ma jistax jibgħat headers personalizzati, OmniRoute juri wkoll aliases ta' kompatibilità tokenizzati: ```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żaha biss għal klijenti li ma jistax iwaħħlu `Authorization: Bearer ...`. L-awtentikazzjoni ta' header tibqa' l-modalità preferuta.
## 📦 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` jimxi mal-ogħla **ippubblikat** SemVer stabbli. Mhux jimbotta magħna il-`main` ta' git. Agħmel pin `:X.Y.Z` għal GitOps. Ara [Kanalijiet tar-Rilaxx ta' Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Il-pillola tagħmel pin **`OMNIROUTE_MEMORY_MB=1024`**. Dan huwa biżżejjed għad-dashboard u chat ħafif. **Aġenti tal-kodifikazzjoni** (`POST /v1/responses` minn Claude Code, Codex, Grok, …) jeħtieġu V8 heap ħafna akbar inkella l-proċess `FATAL ERROR` jokkorri madwar ~12 GiB taħt żewġ kontesti twal li jgħaqqdu. Daqs il-kontenitur 'l fuq mill-heap (buffer natiivi jinsabu barra minn V8): | Xogħol | Heap (`-e OMNIROUTE_MEMORY_MB`) | Kontenitur (`--memory`) | | ------------------------------------- | ------------------------------- | ----------------------- | | Dashboard / chat ħafif | `1024` (awlott tal-pillola) | ≥2 g | | Aġent tal-kodifikazzjoni wieħed | `8192` | ≥10 g | | Żewġ `/v1/responses` twal concurrenti | `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 ``` Desterqa kollha: [Gwida tal-Docker — RAM tal-ħin ta' ħidma](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Kanal ta' ħarba ta' qabel ir-rilaxx:** `diegosouzapw/omniroute:next` u > `diegosouzapw/omniroute:next-web` jimxu mal-filial preżenti preżunta `release/v*`. > Dawn it-tagijiet li jinbidlu huma intiżi biss għat-testjar ta' tiswija ma ttieħdux > u **mhumiex appoġġati għall-produzzjoni**. Ara > [Kanalijiet tar-Rilaxx ta' Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** `bun install` standard u l-appoġġ globali (`bun install -g omniroute`) huma appoġġati permezz ta' rikonoxximent tal-Bun runtime: - **Mibnija fiha `bun:sqlite`**: OmniRoute juża t-trejner `bun:sqlite` intern tal-Bun meta taħdem taħt Bun, u jirrikorri lura għal `better-sqlite3` fuq Node.js jew `sql.js`. - **Għażla awtomatika tal-bundler Webpack fil-dev**: L-iżvilupp (`bun run dev`) jirrikonoxxi awtomatikament il-Bun u jiddiżattiva t-Turbopack favur il-Webbiex biex jipprevjenji l-inkompatibilitajiet tal-binding V8 nattiv. Il-bini tal-produzzjoni (`bun run build`) jimxi eżatt kif fuq Node: Turbopack b'mod awtentiku, `OMNIROUTE_USE_TURBOPACK=0` biex jibni bil-Webbiex (`Dockerfile.bun` ixxegħelha bħala `--build-arg`). - **Dockerfile apposta għall-Bun**: `Dockerfile.bun` ta' bosta stadji għal deplojamenti tal-produzzjoni nattivi tal-Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Installa u ħaddem bil-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 tal-Nix flakes nix develop npm run dev # Jew bl-użu ta' devbox devbox run npm run dev ``` 📖 [Gwida tal-Docker](docs/guides/DOCKER_GUIDE.md) — Profili tal-Compose, Caddy HTTPS, tunnel tal-Cloudflare. **🦭 Podman** ```bash # 1. Ipprepara d-direttorju tal-masseġġ bil-punti ta' rabta mkdir -p data # 2. Linux + Podman rootless lokali biss (qatt klient Podman Machine remote): podman unshare chown 1000:1000 ./data # 3. Issettja l-ispunt tal-ħin ta' ħidma, ibni l-pillola lokali tal-Compose, u beda echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Fuq macOS jew Windows, Podman juża Podman Machine remote: aqta' `podman unshare` u segwi [gwida tad-direttorju tal-masseġġ skont it-topoloġija](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Gwida tal-Podman](contrib/podman/README.md) — Bini tal-Compose, Podman Machine, u twaqqif tal-Quadlet Linux/systemd. **⚡ Installazzjoni aktar mgħaġġla / irqaq (aqta' il-bini nattiv)** Il-magna nattiva SQLite (`better-sqlite3`) hija dependenza **fakultattiva**, għalhekk installazzjoni globali qatt ma taqsam kompilazzjoni mis-sors: tuża binarju prebuiltin meta dan jikkoinċidi mal-pjattaforma/Node tiegħek, u fin-nuqqas ta' dan tirrikorri b'mod trasparenti għal magni puri JS (`node:sqlite` fuq Node 22+, inkella l-`sql.js` WASM maħbuna) — m'għandhomx bżonn għodod tal-bini. Biex aqta' għal kollox il-bidu sħun wara l-installazzjoni (CI, bla testa, jew magni bil-mod): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 jitlob aqta' wkoll ``` Għall-aktar installazzjonijiet mgħaġġla agħżel **pnpm** (ħażna kontenitur minn effett u links iebsa — ara t'hawn fuq). Għal runtime bla dashboard, bla testa, użu l-profil `base` ta' Docker (hemm fuq) jew il- [gwida tal-Termux](docs/guides/TERMUX_GUIDE.md). Il-CLI u d-dashboard tal-web huma ppreżentati mill- istess proċess fuq port wieħed, għalhekk m'hemm l-ebda applikazzjoni biss-CLI llum.

# 🎬 OmniRoute fl-Azzjoni

## 📹 Gwidi tal-Vidjow

_{Kaptura tal-dashboard fid-24 ta' Awissu 2026 · Katalgu gross: YT 809 | TT 137 | IG 124 · Frisk (jumi): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 views}

🎬 #2 — Instagram
_{theopenstack — 692,419 views}

🎬 #3 — TikTok
_{milesreevesai — 620,400 views}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 views}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 views}

**Ranking sħiħ (URLs kanoniċi deduplikati, `v > 0`, l-akbar perokwu):** | #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** | Metriki kanoniċi fit-24 ta' Awissu 2026: **1,029 vidjow uniku** · **11,132,922 ħarsa magħrufa** (`v > 0`) · **639 kanal/profil għal kull netwerk**. Id-dashboard gross jikkonteni 1,070 linja; 41 duplikat tal-Instagram ġew normalizzati mill-URL kanoniku, u nżammet il-kontedotta l-akbar għal kull vidjow. > 🎬 **Għamilt vidj dwar OmniRoute?** Faħħas [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) jew [diskussjoni](https://github.com/diegosouzapw/OmniRoute/discussions) bil-link — ser ninkluduh hawnhekk.

# 📧 Komunità u Għajnuna > Kollox f'waħda — segwi lill-manutenitur, ħu sehem mal-komunità, jew faħħas issue. | Kanal | Fejn/kif | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — segwi lill-manutenitur | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — segwi għar-rilaxxi 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** | [idħol fil-grupp](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Websajt** | [omniroute.online](https://omniroute.online) | | 🌍 **Komunità StHub OmniRoute (b'xejn)** | [portal 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) | | 🐛 **Tirraporta ħsara** | [faħħas issue](https://github.com/diegosouzapw/OmniRoute/issues) — waħħal l-output ta' `npm run system-info` | | 🤝 **Kontribwixxi** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Mudell tal-Qafas u Rilaxx](docs/ops/BRANCHING_MODEL.md) · agħżel `good first issue` | | 💚 **Appoġġ lill-proġett** | [Modi kif tappoġġa ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Teknoloġija Użata

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 matul `src/` u `open-sse/` (ebda `any` fil-qafas mindu v2.0)
Framewerk	Next.js 16 + React 19 + Tailwind CSS 4
Database	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 moduli tal-materja, 168 migrazzjonijiet
Memorja	SQLite FFS5 full-text + int8-quantized vector embeddings, tnaqqis immarkat
Schemes	Zod 4 — MCP għodda validazzjoni I/O + kuntratti API
Protokolli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + Websocket bridge (`/v1/ws`)
Kompressjoni	12-magna pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Awtenfikazzjoni u Sigurtà	OAuth 2.0 (PKCE) + JWT + API Keys + MCP awtenfikazzjoni skopjata · AES-256-GCM fil-magħżul · DOMPurify
Stealth	wreq-js — JA3 / JA4 TLS fingerprint impersonation, proxy ta' 3 livelli
Reżiljenza	Circuit breaker, backoff esponenzjali, anti-thundering-herd, awto-kombo fejqan awtomatiku
Logging	pino — strutturata JSON logs bil-kuntest tal-htigba
Testjar	Node.js test runner + Vitest — 39,000+ dikjarazzjonijiet test stattiċi matul 5,100+ fajls trakkjati test (unit, integrazzjoni, E2E, sigurtà, ekosistema)
Pjattaformi	Desktop (Electron) · Android (Termux) · PWA (kull browser)
CI/CD	GitHub Actions — awto npm publish + Docker Hub meta joħroġ
Links	Website · npm · Docker Hub

## 📖 Dokumentazzjoni

### 📘 Kif Tibda

Dokument	Deskrizzjoni
Gwida tal-Utent	Fornituri, kombo, integrazzjoni CLI, kummerċjalizzazzjoni
Gwida tal-Installazzjoni	Metodi kollha ta' installazzjoni, konfigurazzjonijiet għodda CLI, installazzjoni protokoll, timming tat-timeout
Gwida tal-Għodda CLI	Installazzjoni speċifika għal għodda Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Modalità Remota	Segwi OmniRoute remota (VPS) mill-CLI tal-laptop tiegħek permezz ta' tokens aċċess skopjati
Konfigurazzjoni Claude Code	Waħħal Claude Code ma' OmniRoute (lokal/remota) b'`launch` + profili għal kull mudell
Tibda Malajr	3 passi install → imqabda → konfigurazzjoni

### 🔧 Operazzjonijiet u Kummerċjalizzazzjoni

Dokument	Deskrizzjoni
Gwida Docker	Docker run, profili Compose, Caddy HTTPS, tunnels, tags tal-ħallisa
Gwida Podman	Integrazzjoni Quadlet systemd, podman-compose, SELinux
Kummerċjalizzazzjoni VM	Gwida sħiħa: VM + nginx + Cloudflare setup
Kummerċjalizzazzjoni Fly.io	Kummerċjalizza fuq Fly.io b'ħażna persistenti
Gwida Termux	Ħaddem OmniRoute fuq Android permezz ta' Termux
Gwida PWA	Progressive Web App installazzjoni, cache, arkitettura
Gwida Neħħi	Tneħħija nadifa għal kull metodu ta' installazzjoni
Konfigurazzjoni Ambjentali	`.env` varjabbli sħaħ u riferimenti

### 🧠 Karatteristiċi u Arkitettura

Dokument	Deskrizzjoni
Arkitettura	Arkitettura tas-sistema, fluss tad-data, u internals
Gwida Kompressjoni	7-għażla pipeline: off / lite / standard / aggressiv / ultra / RTK / kbar
Kompressjoni RTK	Kompressjoni tal-output tal-kmandi, filtrat, fiduċja, verifika, rkupru tal-output ir.raw
Magni Kompressjoni	Caveman, RTK, pipelines kbar, surfaces dashboard/API/MCP
Format tal-Regoli Kompressjoni	Schemes tal-pakketti tal-regoli JSON għal filtrat Caveman u RTK
Pakketti tal-Lingwa Kompressjoni	Rikonoxximent tal-lingwa u kitba tal-pakketti tal-Regoli Caveman
Gwida Reżiljenza	Circuit breakers, cooldowns, queue, anti-thundering herd, spoofing TLS
Magni Awto-Kombo	16-fattur skoring, pakketti modalità, fejqan awtomatiku
Gwida Proxy	Sistema proxy ta' 3 livelli, suq 1proxy, registry CRUD
Tiers Ħielsa	Direttorju konsolidat: 38 pools ripetuti dokumentati / 446 entries ta' tier b'xejn katalogati
Gallerija Karatteristiċi	Turija ta' dashboard viżwali b'screenshots
Dokumentazzjoni tal-Bażi tal-Kodiċi	Passaġġ tal-bażi tal-kodiċi ħafif għall-bidu

### 🤖 Protokolli u APIs

Dokument	Deskrizzjoni
Referenza API	Kull punt tat-tnedija b'eżempji
Speċifikazzjoni OpenAPI	Speċifikazzjoni OpenAPI 3.0
Server MCP	110 għodda MCP, konfigurazzjonijiet IDE, klijenti Python/TS/Go
Gwida Server MCP	Installazzjoni MCP, trasporti, u referenza għodda
Server A2A	Protokoll JSON-RPC 2.0, ħilbiet, streaming, ġestjoni tax-xogħol
Gwida Server A2A	Karta tal-A2A agent, xogħlijiet, ħilbiet, u streaming

### 📋 Proġett u Kwalità

Dokument	Deskrizzjoni
Kontribuzzjoni	Setup tal-iżvilupp u linji guidanti
Modell ta' Fergħa u Rilaxx	Fejn jimmiraw PRs (`release/*`), x'fisser `main` u t-tags
Log tal-Bidliet	Storja sħiħa ta' rilaxxiet għal kull verżjoni
Politika tal-Sigurtà	Segnalazzjoni ta' vulnerabilitajiet u prattiki tal-sigurtà
Gwida i18n	Appoġġ għal 42 lingwa, workflow tal-traduzzjoni, RTL
Checklist Rilaxx	Passi ta' validazzjoni qabel ir-rilaxx
Pjan ta' Koveraġġ	Pjan ta' koveraġġ tat-testjar għal 39,000+ dikjarazzjonijiet test stattiċi matul 5,100+ fajls trakkjati test

# ⭐ Top Kontributuri > OmniRoute ġiet ifformulata minn komunità open-source lejlieni. Dawn l-individwi għamlu kontribuzzjonijiet eċċezzjonali li jaffettwaw direttament il-kwalità, l-istabbiltà, u l-kopertura tal-proġett. **Grazzi.** ### Kontributuri esterni permezz ta' PRs magħluqa

Rank	Kontributur	PRs Magħluqa	~Linji Bidla
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

_{Frożun fil-għajtaħħ release/v3.8.50 dafb4ae808, b'mergers sa 2026-08-24 05:26:03 UTC. L-ċensna tal-GraphQL ta' Ġun fil-paġni jkun fih 5,911 PRs magħluqa: 2,707 mill-propjetarju tal-ħażna, 179 minn Dependabot, u 3,025 PRs esterni minn 535 kontributuri distinti. “Linji Bidla” huwa l-addizzjonijiet + tnaqqis ta' Ġun u jinkludi fajls ġenerati, lockfiles, katalogi, traduzzjonijiet u dokumentazzjoni; huwa churn, mhux LOC awturizzat. Ties fil-limitu jkunu ritenuti.} ### Kummiti attribwiti lill-Ġun

backryun _{🥇 220 kummiti attribwiti lill-Ġun}	Paijo _{🥈 219 kummiti attribwiti lill-Ġun}	Randi _{🥉 108 kummiti attribwiti lill-Ġun}	Ravi Tharuma _{🏅 81 kummiti attribwiti lill-Ġun}	Chris _{🏅 70 kummiti attribwiti lill-Ġun}	Markus Hartung _{🏅 69 kummiti attribwiti lill-Ġun · marbut #6}
Dizzle _{🏅 69 kummiti attribwiti lill-Ġun · marbut #6}	Jan Leon _{🏅 64 kummiti attribwiti lill-Ġun}	zenobit _{🏅 62 kummiti attribwiti lill-Ġun}	Bob.Hou _{🏅 51 kummiti attribwiti lill-Ġun · marbut #10}	Xiangzhe _{🏅 51 kummiti attribwiti lill-Ġun · marbut #10}

_{Ritcheckjat fit-2026-08-24 06:14:31 UTC: Kummiti attribwiti lill-Ġun rapportati mill-API tal-Kontributuri tal-ħażna għall-fergħa predefinita release/v3.8.50. L-API wriet 525 identitajiet (415 utenti, 2 bots, 108 anonimi); din it-tabella tipprokludi l-manutenitur, bots u identitajiet anonimi u tħalli kompetizzjonijiet. Din hija differenti miż-żewġ rankings ta' PRs magħluqa t'hawn fuq u ċ-ċensna ta' 639 persuna ta' metadata Git t'hawn taħt.} > 🙏 Dawn il-kontributuri, il-karatteristiċi, il-korrezzjonijiet tal-bugs, u l-bidliet fl-infrastruttura huma **parti ewlenija** ta' dak li jagħmel OmniRoute affidabbli u mimli b'karatteristiċi. Kull pull request, kull każ ta' test, u kull fajl tal-i18n għandu importanza. L-open source huwa mibni minn nies bħalhom.

--- ## 💖 Sponsors

Grazzi ġenuna minn qalb lin-nies li jiffinanzaw OmniRoute minn butorhom — kull kontribuzzjoni iżżomm il-proġett b'xejn, indipendenti u jimxi 'l quddiem.

Andrew
_{💛 Sponsur xahri attiv}

Vlad I
_{💛 Sponsur xahri attiv}

Paco Cartones
_{💛 Sponsur wieħed darba attiv}

Prof. Igor Morais
_{💛 Appoġġ wieħed darba ta' qabel}

longtao
_{💛 Appoġġ wieħed darba ta' qabel}

_{… u oħrajn li jippreferu jibqew privati 💛} _{Is-Sponsors Pubbliċi ta' ĠitHub ġew verifikati mill-ġdid fl-24 ta' Awwissu 2026. L-istatus activeOnly ta' ĠitHub jiddefinixxi l-etiketti attivi ta' hawn fuq; l-appoġġ pubbliku wieħed darba ta' qabel jidher ġie ringrazzjat, u s-sponsors privati jibqew anonimi.} 💖 Sir sponsur → — kull dollaru iżomm OmniRoute b'xejn u indipendenti.

## 👥 Aktar minn 600 Kontributur

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Awditjar fl-24 ta' Awwissu 2026 fuq il-bażi stabbli ac02c5b42f u rrevedut mill-ġdid fil-ponta ħajja release/v3.8.50 dafb4ae808: 639 identità nnormalizzata ta' ĠitHub umani — 407 dehru bħala awturi tal-kommitt (inkluż il-manutenitur) u 232 biss fil-posti Co-authored-by espliċiti. Il-ċens normalizza l-handles noreply ta' ĠitHub, jeskludi 26 identità ta' bot/agent/servizz/kaxxa, u ma jagħmilx għaqda ta' indirizzi tal-email ordinarji sempliċement għax l-isħab tal-wiri tagħhom jaqblu.} ### Kif Tinkludi 1. Fork ir-repostorju 2. Agħmel branch mill-ponta attiva tal-`release/vX.Y.Z` (mhux il-`main`) — ara [Mudell tal-Branching & Tħieġ](docs/ops/BRANCHING_MODEL.md) 3. Oħloq il-funzjoni tiegħek (`git checkout -b feat/feature-ammirevoli`) 4. Ikkommitja l-bidliet tiegħek (`git commit -m 'feat: żid feature ammirevoli'`) 5. Dħal il-branch (`git push origin feat/feature-ammirevoli`) 6. Agħfas Pull Request bil-bażi = dak il-branch `release/vX.Y.Z` Ara [CONTRIBUTING.md](CONTRIBUTING.md) għal linji gwida dettaljati. ### Tħieġ ta' Verżjoni Ġdida ```bash # Oħloq tħieġ — npm publish jsir awtomatikament VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Stars

## 🌍 StarMapper

## 🙏 Rikonoxxenti

OmniRoute jidhir fuq l-ispallejn tal-ġganti. Beda bħala fork ta' **[9router](https://github.com/decolua/9router)** u port ta' TypeScript tal-proġett Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — u minn hemm, kull subsistema taħt ġiet imħeġġa minn proġett open-source li wasal hemm l-ewwel. Kull wieħed sawwar biċċa konkreta ta' OmniRoute. Dan huwa r-ringrazzjament tagħna għal kulħadd. 🙏 > ⭐ għadd ta' stilel verifikat mill-REST API ta' GitHub fis-24 ta' Awwissu, 2026 — mur u agħti dawn il-proġetti stella. L-għadd huwa stampa data preċiża li naturalment se tinbidel. ### 🧮 Linja u portal

Proġett	⭐	Kif insira f'OmniRoute
9router	26,161	Il-proġett oriġinali li dan il-fork huwa mibni fuqu — estiż hawn b'APIs multi-modali u rikont kollu ta' TypeScript.
CLIProxyAPI	48,497	Il-wiri Go li insira dan il-port ta' JavaScript / TypeScript.
LiteLLM	57,100	Il-portal tal-AI li jipprovdi dataset ta' prezzijiet pubbliċi għat-tħabir tal-ispejjeż tagħna u li l-mudell ta' normalizzazzjoni ta' fornitur wissa r-routing tagħna.
codex-chatgpt-web	1,410	Il-kodiċi MIT adattat fil-pont venderjat ChatGPT Web → Codex Responses, inkluż session-browser, taqsim ta' rispons, adapters tal-użu u tfittxija web.
free-claude-code	48,112	Patterns portati f'rekuperazzjoni stream, aliases mhux jaħsbu, tfittxija web fallback, limiti sliding-window, redazzjoni log u flussi ta' launcher b'saħħitha.
composer-api	322	Cursor Composer għażla għodda, konstrijnt output u patterns ta' għodda commit adattat fil-wiri nattiv ta' Cursor.
codex-multi-auth	457	Patterns ta' login ġdid u rinnovazzjoni refresh-token portati f'riauttentikazzjoni OAuth tal-Codex.
opencode-anthropic-auth	510	Defaults ta' tifsila kompatibbli ma' Claude Code u imġieba ta' header ġeneraliġennat fil-pont b'konfigurazzjoni ta' OmniRoute.
grok2api-merged	2	Il-mapep tal-mudell Grok tiegħu, ġeneratur Statsig fake-TypeError, defaults ta' talba u apparat, u proċessur NDJSON kienu adattat b'mod sostanzjali fil-wiri Grok Web ta' OmniRoute.
TQZHR/grok2api	705	Is-sors transittiv prinċipali wara grok2api-merged; l-ispejjonijiet tal-mudell, header, paylaod, Statsig u proċessur tiegħu huma preżervati fil-linja Grok Web.
chenyme/grok2api	7,520	Is-sors MIT li fuqu huma mibnija l-paylaod Grok u defaults apparat, il-ġeneratur Statsig, u l-proċessur `result.response` li jgħaddi minn TQZHR u grok2api-merged.
grok2api-pro	27	Sors transittiv attribwit lil grok2api-merged għas-saff tiegħu ta' pool proxy; OmniRoute jippreserva dik il-linjiġna iżda ma jsostnix port ta' pool proxy fil-wiri limitat tiegħu ta' Grok Web.
GrokProxy	50	Il-proxy tagħha b'awtentikazzjoni cookie u l-pattern ta' streaming `result.response.token` wissa l-ispeditur Grok Web ta' OmniRoute.
GrokBridge	5	L-ewwel wiri ta' Grok Web konsulta d-disinn upstream HTTP/browser tiegħu; it-triq HTTP diretta tagħha ġejja minn GrokProxy, għalhekk ma hemm l-ebda port indipendenti ta' kodiċi li jsostni.
grok-web-api	14	Is-skeletri Rust `ChatOptions` u envelop rispons tiegħu wissu t-tipi ta' talba Grok u rispons streaming ta' TypeScript ta' OmniRoute.

### 🗜️ Kompressjoni ta' kontekst u token — magni

Proġett	⭐	Kif insira f'OmniRoute
Caveman	100,538	Il-proġett virali "għaliex tuża ħafna token meta ftit token jagħmlu xogħol" — il-filosofija caveman-speak tagħha jispjega l-modalità standard ta' kompressjoni tagħna u aktar minn 30 regola ta' ffiller/kondensazzjoni.
RTK – Rust Token Killer	77,185	Kompressjoni ta' output komanda b'prestazzjoni għolja — insira l-magna RTK tagħna, il-DSL tal-filtru JSON, ir-riabilitazzjoni tal-raw-output u l-pajp imqatta' RTK → Caveman.
headroom	67,310	Kompressjoni ta' kontekst li tista' tittieħed lura (SmartCrusher) — insira l-magna `headroom` tagħna u l-pattern ta' riċerkatur `ccr`.
LLMLingua	6,598	Riċerka ta' kompressjoni ta' prompt (LLMLingua / LLMLingua-2) — insira l-magna tagħna `llmlingua` li hija asin krona, sikura mal-kodiċi, u miftuħa għal falliment.
llmlingua-2-js	31	Il-port JS/ONNX (MobileBERT / XLM-RoBERTa) użat bħala backend ta' ħaġar ta' ħidma għall-magna LLMLingua tagħna.
Troglodita	40	Kompressjoni ta' token PT-BR — jispjega l-pakkett tal-lingwa pt-BR tagħna: tnaqqis ta' pleonasm u tneħħija ta' ffiller skont il-grammatika Taljan-Purtiż.
ponytail	108,957	L-iskill virali "junior dev għajjien" ta' YAGNI-coder — insira l-istil ta' Output less-code tagħna: taqrid ta' bidla żgħira-ħdim li naqqas il-kodiċi ġġenerat (il-ġar tax-xogħol output tal-prosa qasira ta' Caveman).
i-have-adhd	23,526	L-istil ta' rispons tiegħhu li jagħmel l-azzjoni l-ewwel u huwa adattat għal ADHD ġie adattat fl-istil ta' Output qasir ta' OmniRoute f'ħames lingwi.

### 🧩 Format kompatt, riċerka token u għodod kuxjenti tal-kodiċi

Proġett	⭐	Kif insira f'OmniRoute
TOON	25,233	Token-Oriented Object Notation — il-mudell kolonarju, header-piż-rows tiegħu sawwar l-istadju ta' kompattament tabulari tagħna.
GCF – Graph Compact Format	41	Il-format kompatt tal-graf u d-disinn tal-profil ġenerali tiegħu wissa l-kompattament tabulari u l-format tal-kodex ta' OmniRoute.
gcf-typescript	4	Il-wiri TypeScript MIT direttament venderjat u estiż bħala l-kodex tal-profil ėenerali ta' Headroom.
token-optimizer-mcp	494	Cache Brotli/SQLite + delta kontekst kull-sessjoni — insira l-magna `session-dedup` tagħna.
token-savior	1,122	Kompattament ta' output Bash + profili MCP — insira d-dixiplina ta' bailing-out ta' kompressjoni u tnaqqis tal-manifest tal-għodda MCP tagħna.
token-saver	138	Kompressjoni ta' output kuxjenti mal-kontenut, kull tip ta' fajl, b'bailing-out konxju mal-falliment — valida d-dispatch tagħna kull-tip u skip ta' minimu ta' gain.
token-optimizer	1,951	"Sib il-ghost tokens" — il-pattern ta' offloading + handle riċoverabbli tiegħu wissa ħsieb tagħna ta' offload CCR.
TokenMizer	28	Blueprint ta' graff tas-sessjoni + deduplikazzjoni ta' linja bejn it-turufien li wissa d-disinn ta' session-dedup tagħna.
OmniCompress	3	Rust kolonarju-JSON + riċerka indirizzata bil-kontenut + deduplikazzjoni bejn il-messaġġi — valida d-disinn tal-magna tagħna `headroom`/`ccr`/`session-dedup` u l-invarjant "forma kompressa hija indipendenti mill-pożizzjoni" stabli mal-cache.
mcp-compressor	113	Kompressjoni ta' schema/tfisser tal-għodda MCP — wissa t-tnaqqis tal-kardinalità tal-manifest tal-għodda MCP tagħna.
RepoMapper	197	(klassifikazzjoni ta' repo-map stil Aider — wissa l-esplorazzjoni tagħna ta' repo-map / reġistrazzjoni tal-klasifikazzjoni.
quiet-shell-mcp	4	Tnaqqis deklarattiv ta' output shell fuq MCP — valida l-kompattament deklarattiv ta' output bash tagħna.
ts-morph	6,162	Toolkit tal-Kompilatur API ta' TypeScript — insira l-ħsieb bbażat fuq parser li jeħles il-kummenti u jippreserva string, template u letterali regex.

### 🧠 Memorja u RAG

Proġett	⭐	Kif insira f'OmniRoute
Mem0	63,902	Saff tal-memorja universali — il-mudell tiegħu proxy-bħala-limiti ta' kitba/qari sawwar l-arkitettura tal-memorja tagħna.
Letta (MemGPT)	24,382	Aġenti b'stat u memorja f'livelli — insira l-mudell f'livelli ta' Kontroll u Riabilitazzjoni tal-Kontekst (CCR) tagħna.
WFGY	1,781	Il-klassifikazzjoni ProblemMap ta' 16 modi ta' falliment RAG/LLM li jirrekurrew — il-vokabularju komuni fil-gwida tat-trobbija tagħna.

### 🛰️ Spezzjoni tat-traffiku, MITM u proxy trasparenti

Proġett	⭐	Kif insira f'OmniRoute
llm-interceptor	66	L-interċezzjoni/analisi MITM ta' traffiku bejn assistent tal-programmar ↔ LLM wissiet b'mod kmieni r-rekwiżiti tal-Ispezzur tal-Traffiku. Erba' moduli dederivati qabel — għaġda SSE, normalizzazzjoni tal-konverżazzjoni, tħassi tal-mistkrief u sanitizzazzjoni tal-header — kienu sostitwiti b'wiri indipendenti mibni mill-ġdid skont standards tal-protokkolu pubbliku. Iż-żewġ superfici tal-pass-pass (`passthrough.ts` u `_internal/bypass.cjs`) jibqgħu implementazzjonijiet interni tal-OmniRouteifikati b'mod indipendenti; ma kinux rikontbħala parti minn dik is-sostituzzjoni.
ProxyBridge	5,995	Routing proxy trasparenti kull-proċess — insira t-tidwir MITM b'ħarsien kontra crash, timeout tal-idle socket, attribuzzjoni tal-proċess `/proc` u akkwist TPROXY.

### 📚 Dati tal-mudell, osservabilità u UI

Proġett	⭐	Kif insira f'OmniRoute
models.dev	6,555	Database miftuħ ta' speċifikazzjonijiet, prezzijiet u kapaċitajiet tal-mudell AI — sinċronizzat b'mod nattiv fil-katalogu tal-mudelli tagħna.
React Flow / xyflow	38,108	Il-librerija tal-graf ibbażata fuq il-magħdud li tispjega l-Kamra tal-Kompressjoni real-time u l-Kamra Kombo/Routing tagħna.
LangGraph	40,314	Il-viżwalizzazzjoni tal-fluss ħaj tal-graf ta' LangGraph Studio wissiet il-viżwali tal-kaskata real-time tal-Kamra tagħna.
Langfuse	33,592	Il-mudell osservabilità trace → span → ġenerazzjoni tiegħu sawwar il-waterfall tal-Kamra tal-Kompressjoni tagħna.
Kiali	3,631	Osservabilità tal-magħmudija ta' servizz Istio — insira l-badge tal-qatgħa ta' ċirkwit u l-viżwali tal-ħin tal-ħtija fil-Kamra Routing/Kombo.
lobe-icons	2,428	Logos tal-marki tal-AI/LLM li juru l-ikoni tal-fornitur madwar il-dashboard tagħna.
flag-icons	12,354	Jipprovdi l-bandieri SVG liċenzjati MIT użati mis-selettur tal-lingwa README.

### 🛡️ Sigurtà

Proġett	⭐	Kif insira f'OmniRoute
awesome-secure-defaults	721	Lista magħżula ta' libreri b'sigurtà bħala default li tiggwida l-għażliet ta' sigurtà tagħna (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Għodod kumplimentari

Proġett	⭐	Kif insira f'OmniRoute
ClawRouter	6,564	Insira d-deduplikazzjoni tal-talba, il-fallback ta' emerġenza b'ゼロ cost, l-istrateġiji tal-Auto-Combo li jistgħu jinbidlu u l-klassifikazzjoni tal-intenzjoni multilingwi.
Antigravity-Manager	30,652	It-taqsim mill-ġdid tal-mudell b'konxju tal-kont, il-validazzjoni tal-magħdud tal-eżekutabbli u l-imġieba ta' l-etiketta tal-pjan wissu r-runtajm Antigravity ta' OmniRoute.
vscode-antigravity-cockpit	4,817	Il-format kompatt ta' rinnovazzjoni tal-kwantità tiegħu insira l-wiri korrispondenti tal-limiti tal-fornitur f'OmniRoute.
AionUi	32,230	L-integrazzjonijiet ACP tiegħu insira d-detezzjoni awtomatika tal-aġenti CLI installati f'OmniRoute.
CodexBar	20,507	Identifika l-wiċċ tal-kwantità tal-Grok Build; OmniRoute mbagħad verifika u ċċekkja l-format tal-wajer live b'mod indipendenti.

## 📄 Liċenzja Liċenzja MIT - ara [LICENSE](LICENSE) għad-dettalji. ---

**[⬆ Lura fil-quċċiera](#-omniroute)** · Mibnija b'❤️ għall-komunità AI opensource. _{OmniRoute v3.8.51 · Node ≥22.22.2 · Liċenzja MIT · omniroute.online}