# 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 Ħieles tal-IA **Maħluq minn [Diego Souza](https://github.com/diegosouzapw)**

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

## 💰 ~1.62B Tokens / Xahar Madwar Free Tiers ta’ Partijiet Terzi

> **Uża l-kontijiet tiegħek tal-fornituri.** Dan huwa aggregat stmat madwar free tiers ta’ partijiet terzi eliġibbli separatament, mhux għotja ta’ tokens minn OmniRoute. Irreġistra, akkwista l-kredenzjali fejn meħtieġ, u qabbad il-fornituri li tista’ tuża; kull fornitur jikkontrolla l-limiti, id-disponibbiltà u t-termini tiegħu. > > Il-ġbir manwali tal-free tiers huwa tedjanti — għexieren ta’ SDKs, għexieren ta’ limiti ta’ rata, u l-ebda idea ta’ kemm għandek fil-fatt. OmniRoute jikkataloga **465 entrata ta’ free tier madwar 34 ċavetta ta’ pool rikorrenti** u jikkalkula ċ-ċifra ewlenija tat-tokens mill-**17-il pool b’baġit ta’ kull xahar pożittiv ippubblikat flimkien ma’ ħames limiti ta’ Groq għal kull mudell**, deduplikati skont il-pool kondiviż. Il-kwoti li jinfetħu biss wara verifika tal-identità reġjonali (illum: ModelScope) jintwerew separatament, +~6M wara l-verifika tal-identità reġjonali, u qatt ma jingħaddu fiċ-ċifra ewlenija. Ir-riżultat jibqa’ viżibbli fuq id-dashboard (`/dashboard/free-tiers`).

Il-karta tal-baġit tal-free tier ta’ OmniRoute: ~1.62B tokens b’xejn fix-xahar b’mod stabbli, sa ~2.22B fl-ewwel xahar bi krediti ta’ reġistrazzjoni, minn 34 ċavetta ta’ pool rikorrenti dokumentati li jkopru 465 entrata ta’ free tier katalogati wara endpoint wieħed. Kalkolu onest deduplikat skont il-pool — kull pool kondiviż jingħadd darba biss, inklużi 17-il pool rikorrenti b’baġit ta’ tokens pożittiv ippubblikat fix-xahar flimkien ma’ ħames limiti ta’ Groq għal kull mudell; 12-il fornitur huma mmarkati bħala evitabbli fil-katalgu tar-riskju tat-termini sabiex tiddeċiedi int. Il-bar 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 ta’ reġistrazzjoni tal-ewwel xahar u fornituri b’xejn b’mod permanenti mingħajr limitu ta’ tokens, murija separatament sabiex qatt ma jkabbru ċ-ċifra ewlenija. Użat/jifdal direttament fuq /dashboard/free-tiers.

> Sommarju animat tal-paġna diretta `/dashboard/free-tiers`. Il-metodoloġija sħiħa (deduplikazzjoni 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 kontra l-katalgu dirett u **jiċċaqilqu fiż-żewġ direzzjonijiet** — fornitur itemm free tier u n-numru jonqos; jidħol wieħed ġdid u jogħla. Nippubblikaw dak li l-katalgu jikkalkula fil-fatt, qatt l-aħjar każ arrotondat ’il fuq.}

⭐ Agħti Star lir-repo jekk OMNIROUTE għinek tiffranka l-flus u tagħmel ix-xogħol tiegħek aktar faċli.

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

[![Klassifika tal-Istorja ta’ Stars](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 — ikseb l-ewwel il-fornituri ġodda, ir-rilaxxi u l-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 Global](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) [![Websajt](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Mistoqsijiet, pariri dwar il-fornituri, roadmap 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.50 | **v3.8.51** | `v3.8.54+` | | ---------------------------------- | :------------------------: | :---------: | :-------------------: | | 🌐 Fornituri | 352 | **358** | 388 | | 🧠 IDs uniċi tal-mudelli taċ-chat | 1320 | **1374** | 1491 | | 🖼️ Pont tal-modalitajiet | 🆕 viżjoni + awdjo + vidjo | ✓ | ✓ | | 📡 Katalgu b’xejn tar-Radar | 🆕 b’għażla | ✓ | ✓ | | ⚖️ Skedar konxju tal-kwota | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetrija tal-kwota | 🆕 diretta | ✓ | ✓ | | 🧰 Modalità mingħajr interfaċċa | — | — | 🆕 `serve --headless` | | 🛤️ Infrastruttura tal-linja LTS | — | — | 🆕 kanali tar-rilaxx | | 🔎 API għall-iskoperta tal-mudelli | — | — | 🆕 `/v1/models/query` | **→ [Pjan direzzjonali](ROADMAP.md) — fuq il-linja 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 ta' Kull 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) ![Downloads ta' Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Downloads ta' Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Ibda	🚀 Bidu malajr	📦 Installa	🆓 Qabbad fornitur
💡 Tgħallem	💥 Il-Wegħda	🤔 Għaliex OmniRoute	🏆 X’jagħmlu differenti
⚙️ Karatteristiċi	🎯 Kombinazzjonijiet	🌐 Fornituri	🔌 CLI & MCP
	🗜️ Kompressjoni	🖥️ Fejn jaħdem	🔒 Privat
👀 Ara	🎬 Fl-azzjoni	✨ X’hemm ġdid	🤖 CLI kompatibbli
💚 Appoġġ	💚 Appoġġ / Agħti donazzjoni	💬 Komunità	💖 Sponsors
📦 Proġett	🛠️ Munzell teknoloġiku	📖 Dokumentazzjoni	👥 Kontributuri

🌐 F'67 lingwa

## 🆓 Installa, qabbad fornitur, imbagħad irrotta permezz ta’ endpoint wieħed

Tliet passi: installa u ibda OmniRoute, qabbad fornitur eliġibbli bil-kont jew iċ-ċavetta API tiegħek, imbagħad ipponta l-għodda tiegħek lejn localhost:20128/v1 billi tuża ċavetta API ta’ OmniRoute u l-mudell auto. Ir-routing jiddependi fuq il-konnessjonijiet eliġibbli disponibbli u l-limiti tal-fornitur.

```bash # Wara li tqabbad fornitur, ikkopja ċ-ċavetta ta’ OmniRoute tiegħek minn Dashboard → Endpoints: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` jeħtieġ rotta eliġibbli. Installazzjoni ġdida jista’ ma jkollha l-ebda destinazzjoni eliġibbli mingħajr ċavetta, u fornitur mingħajr ċavetta jista’ jirrifjuta klijenti ta’ partijiet terzi. Il-fornituri mmarkati `tos: avoid`, inkluż Kiro, jiġu esklużi mir-routing awtomatiku b’mod awtomatiku; il-konnessjoni ta’ kont ma tneħħix din is-settings. Ara l-[Gwida tal-Livelli Bla Ħlas](docs/getting-started/FREE-TIERS-GUIDE.md) qabel tagħżel fornitur.} _{📦 Skripts ta’ bidu rapidu li tista’ tikkopja u tippejstja għal **Python, Node.js, PHP, u cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Il-Wegħda

# 🤔 Għaliex OmniRoute?

Fluss ta’ talba ta’ OmniRoute: l-IDE jew CLI tiegħek (Claude Code, Cursor, Cline…) isejjaħ endpoint lokali wieħed (http://localhost:20128/v1); l-Smart Router ta’ OmniRoute (kompressjoni RTK + Caveman, 20 strateġija ta’ routing, circuit breakers, stealth ta’ TLS, MCP, A2A, guardrails) jista’ jaqleb bejn 4 livelli ta’ fornituri sakemm tibqa’ destinazzjoni 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

Eżempji animati għal 18 mill-20 strateġija ta’ routing tal-combos — 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, lkgp, auto, fusion, pipeline. cache-optimized u quota-weighted mhumiex animati; it-tabella t’hawn taħt tiddeskrivi l-20 kollha.

> **Combo** huwa katina ta’ mudelli li OmniRoute jgħaddi bejniethom **awtomatikament**. Jekk il-kwota tispiċċa, fornitur ifalli, jew l-ispejjeż jogħlew f’daqqa, il-combo jista’ jgħ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, b’punteġġ ikkalkulat f’ħin reali:

ID tal-Mudell	Għal xiex jottimizza
`auto`	🎯 Għażla predefinita bbilanċjata (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/subscription`	🎟️ Il-kwota tal-abbonament li diġà tħallas għaliha biss — jagħlaq f’każ ta’ falliment, mingħajr qatt ma jaqa’ lura fuq għażla bi ħlas (gwida)
`auto/thrifty`	🪜 Il-kwota tal-pjan l-ewwel, imbagħad tarġa waħda kull darba lejn l-orħos għażliet bi ħlas — jerġa’ lura fuq il-pjan wara li dan jiġi ssettjat mill-ġdid (gwida)
`auto/offline`	🔋 L-akbar marġni tal-kwota / tal-limitu tar-rata l-ewwel
`auto/smart`	🔭 Il-kwalità l-ewwel + esplorazzjoni ta’ 10% biex jiskopri mudelli aħjar
`auto/lkgp`	📌 Żamma espliċita mal-aħħar fornitur magħruf li kien tajjeb
`auto/chaos`	🧪 Tifrix parallel lejn grupp ta’ mudelli (wieħed għal kull fornitur, 5 b’mod predefinit), u jirritorna tweġiba waħda; sejħa upstream waħda għal kull mudell fil-grupp, mhux injezzjoni ta’ ħsarat

## ### 🔀 Jew ibni tiegħek — 20 strateġija ta’ routing L-**20** strateġija kollha — ħallat u qabbel f’kull pass tal-combo:

#	Strateġija	X’tagħmel
1	`priority`	Lista ordnata bl-ewwel mira — eżawrixxi kull waħda qabel ma jgħaddi għal dik li jmiss 🥇
2	`fill-first`	Uża l-kwota kollha ta’ kull mira qabel ma jgħaddi għal oħra
3	`weighted`	Għażla każwali ppeżata skont il-piż ta’ kull mira
4	`round-robin`	Jdur mal-miri waħda wara l-oħra fl-ordni
5	`p2c`	Ibbilanċjar każwali tat-tagħbija bil-qawwa ta’ żewġ għażliet
6	`least-used`	Jagħżel il-mira bl-inqas tagħbija attwali
7	`random`	Għażla każwali uniformi (mingħajr duplikati)
8	`strict-random`	Għażla każwali mingħajr ma jneħħi r-ripetizzjonijiet 🎲
9	`cost-optimized`	Jimminimizza l-$ għal kull talba mill-prezzijiet diretti tal-katalgu 💸
10	`headroom`	Jagħżel il-mira bl-akbar kwota li fadal
11	`quota-weighted`	Jaqbeż il-kontijiet eżawriti, imbagħad jagħżel fi proporzjon mal-kwota li fadal ÷ it-tagħbija kurrenti — il-konverżazzjonijiet eżistenti jibqgħu marbuta mal-istess mira ⚖️
12	`reset-window`	Jippreferi l-mira li t-tieqa tal-kwota tagħha tiġi ssettjata mill-ġdid l-aktar kmieni
13	`reset-aware`	Jikklassifika skont il-ħin tal-issettjar mill-ġdid tal-kwota — twieqi qosra l-ewwel 📊
14	`context-relay`	Jgħaddi l-kuntest bejn il-miri għal konverżazzjonijiet twal 🧠
15	`context-optimized`	Jagħżel l-aħjar għażla għad-daqs attwali tal-kuntest
16	`cache-optimized`	Jorbot kull prefiss tal-prompt li jista’ jerġa’ jintuża mal-istess kont — jimmassimizza l-hits tal-cache tal-prompt 🎯
17	`lkgp`	L-Aħħar Rotta Magħrufa bħala Tajba — jorbot mal-aħħar fornitur li rnexxa, imbagħad jaqa’ lura fuq ir-regoli
18	`auto`	Punteġġ dirett ibbażat fuq 16-il fattur fil-konnessjonijiet kollha 🤖
19	`fusion`	Jifrex it-talba lejn grupp ta’ mudelli + ġudikant jissintetizza tweġiba waħda 🧬
20	`pipeline`	Jikkatina l-passi — l-output ta’ kull mira jiddaħħal f’dik li jmiss 🔗

_{Il-magna Auto-Combo tagħti punteġġ lil kull kandidat abbażi ta’ **16-il fattur** (saħħa, kwota, spiża, latenza, adattament 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)

Ir-reżiljenza ta’ OmniRoute — 3 saffi indipendenti li jsewwu lilhom infushom, bis-saff it-tajjeb għall-ħsara t-tajba. Saff 1: salvavita taċ-ċirkwit tal-fornitur (il-fornitur kollu): jinqata’ biss fuq 408/5xx, limiti OAuth 8× / ċavetta API 12× / lokali 2×, jiġi ssettjat mill-ġdid 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: perjodu ta’ stennija tal-konnessjoni (ċavetta/kont wieħed): bażi ta’ 5s għal OAuth / 3s għal ċavetta API, dewmien esponenzjali ×2 bi protezzjoni kontra l-anti-thundering-herd, 429 jirrispetta Retry-After, suċċess ineħħi l-istat kollu tal-iżbalji; ċavetta waħda fil-perjodu ta’ stennija tinqabeż filwaqt li ċ-ċwievet l-oħra jibqgħu jservu. 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 għal perjodi ta’ stennija.

_{📖 [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 u dettalji għal kull karatteristika mqabbla ma’ 9router, OpenRouter, CLIProxyAPI u 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.54**. L-istorja sħiħa tinsab f’[`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Rotot `quota-weighted`** — l-istrateġija combo tal-20 post taqbeż il-kontijiet eżawriti, imbagħad tagħżel minn fost il-bqija fi proporzjon għall-kwota li fadal ÷ it-tagħbija ta’ talbiet li għaddejjin, filwaqt li żżomm il-konversazzjonijiet eżistenti marbuta mal-kontijiet tagħhom. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Modalità headless** — `omniroute serve --headless` (jew `OMNIROUTE_HEADLESS=1`) tħaddem biss il-magna proxy `/v1/*`, filwaqt li d-dashboard u s-sottosistemi esklussivi għad-dashboard jibqgħu mitfija. → [Modalità Headless](docs/guides/HEADLESS.md) - **🔎 Skoperta tal-mudelli** — `/v1/models` tiffiltra skont il-kapaċità, il-kuntest, it-tip u t-test, filwaqt li `POST /v1/models/query` tirritorna lista qasira u deterministika tal-aħjar għażliet bl-istess viżibbiltà għal kull ċavetta. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **🔑 Kontroll tar-rotot għal kull ċavetta** — qabbad ċavetta API ma’ mudell jew combo wieħed b’`forcedModel`, u żid jew neħħi l-mudelli u l-combos ta’ ċavetta atomikament (`/api/keys/{id}/access`). → [Referenza tal-API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Kontrolli PII aktar preċiżi** — għażla għal kull tip, sa 20 mudell ta’ masking personalizzat u vvalidat, u counters ta’ identifikazzjoni għal kull tip; il-masking innifsu jibqa’ fakultattiv. → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 67 lingwa** — għad-dashboard, id-dokumenti riflessi u s-CLI, b’`npm run i18n:add-locale` li jżid lingwa kullimkien permezz ta’ kmand wieħed. → [Gwida tal-i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — delegazzjoni A2A deħlin lill-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 ta’ Faro. → [Server A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Ammissjoni adattiva u protezzjoni kontra tagħbija żejda** — talbiet ta’ chat tqal jitqiegħdu fil-kju minflok jirritornaw 503, b’leases rolling RPM atomiki għal kull konnessjoni. → [Gwida tar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Ordni kanoniku ta’ `/v1/models`** — blokka waħda kontigwa raggruppata skont il-fornitur għal kull fornitur (bil-combos l-ewwel), stabbli fis-sorsi kollha tal-katalgu. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **🗜️ Tisħiħ tal-kompressjoni** — protezzjoni kontra ż-żieda eċċessiva tad-daqs attiva awtomatikament, pakketti Caveman għal DE / FR / JA u ċ-Ċiniż (wényán), u filtri RTK għal Gradle u .NET. → [Kompressjoni](docs/compression/COMPRESSION_ENGINES.md) - **💸 Spiża onesta b’rata fissa** — il-fornituri ta’ abbonamenti / coding plans jidhru bi spiża ta’ **$0** fl-analitika tal-ispejjeż; il-baġit, il-kwota u r-rotot jibqgħu jagħmlu stimi. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **⚖️ Rotot Quota-Share** — qassam il-kwota ta’ kont kondiviż b’mod ġust bejn ċwievet miġbura, b’tħaddim effiċjenti li jsellef is-segmenti inattivi. → [Gwida tar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Twaqqif tas-CLI/aġent b’kmand wieħed** — 15-il kmand `setup-*` irreġistrat; `omniroute run` iniedi 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` jappoġġja 11-il mira b’għażla interattiva 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`) + helper OAuth `antigravity` għall-installazzjonijiet fuq VPS. → [Modalità Remota](docs/guides/REMOTE-MODE.md) - **🧭 Rotot awtomatiku aktar intelliġenti** — combos `auto/:`, **Fusion** (pannell tal-mudelli + imħallef), rotot konxju tal-kompitu, u overrides għal kull talba għall-mudell / modalità / baġit f’USD. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Kompressjoni pluggable** — 12-il magna kompożabbli + Compression Studios: LLMLingua-2, Ultra b’żewġ livelli, omniglyph, gate ta’ fedeltà għal kull pass, GCF v3.2, u editur drag-and-reorder. → [Kompressjoni](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Dekriptaġġ MITM trasparenti (TPROXY)** — CLIs ta’ qbid li jinjoraw il-varjabbli tal-ambjent tal-proxy, b’CA għal kull SNI + installatur tal-trust store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetrija tal-ispejjeż kullimkien** — headers tal-ispiża/użu `X-OmniRoute-*` fuq kull endpoint, header tal-iffrankar mill-cache HIT, u kwoti tal-infiq f’USD għal kull ċavetta. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **🧠 Memorja taħt il-kontroll tiegħek** — mitfija awtomatikament, kwantizzazzjoni vettorjali int8 u tnaqqis tat-tip fakultattivi, u `x-omniroute-no-memory` għal kull talba. → [Memorja](docs/frameworks/MEMORY.md) - **🛡️ Sigurtà** — protezzjoni kontra prompt injection fuq kull rotta LLM (suite red-team), guardrail fakultattiv għall-masking tal-kredenzjali (jaħbi ċwievet API/segreti żvelati fiż-żewġ direzzjonijiet), tfittxija web b’DuckDuckGo b’xejn bħala l-aħħar għażla, u gate ta’ login OIDC fakultattiv għad-dashboard (il-login bil-password jibqa’ dejjem disponibbli). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ Endpoints ġodda** — `/v1/ocr` (Mistral OCR) u `/v1/audio/translations` (stil Whisper) jikkompletaw il-wiċċ tal-midja. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **🎨 Ġenerazzjoni ta’ stampi / vidjows / awdjo** — API waħda għall-midja: xAI Grok Imagine u Novita AI għall-vidjows, ComfyUI, Magnific, Adobe Firefly, Segmind, u fornituri tad-diskors bħal ElevenLabs. → [Referenza tal-API](docs/reference/API_REFERENCE.md) - **🌍 Skjerament u operazzjonijiet** — `basePath` ta’ reverse-proxy, identifikazzjoni awtomatika tal-lingwa tal-browser, traċċar tal-apparati għal kull ċavetta, fiduċja MITM mingħajr root, u 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’login permezz tal-browser u OAuth, karta uffiċjali għal Ollama, Claude Opus 5 u Sonnet 5, sħubija uffiċjali ma’ Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… u katalgu aġġornat ta’ **388 fornitur**. → [Fornituri](docs/reference/PROVIDER_REFERENCE.md) - **📡 Trasparenza tar-rotot** — kull tweġiba tinkludi header `X-OmniRoute-Decision` li jindika l-istrateġija/fornitur/latency li serva t-talba, strateġija combo ġdida `cache-optimized` + fattur `cacheAffinity` ta’ Auto-Combo li jirritorna talbiet ripetuti lejn il-konnessjoni li żżomm il-prefiss fil-cache, u endpoint ġdid li jinqara biss `/v1/auto-combo/{channel}/candidates` jesponi l-pool attiv ta’ kandidati tal-kanal `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md). - **⚡ Prestazzjoni u infrastruttura lokali** — Redis lokali b’klikk waħda, deployers tar-relay ta’ Cloudflare Workers / Deno Deploy, Bifrost u Mux bħala servizzi inkorporati ssorveljati. → [Servizzi Inkorporati](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Inkluż ukoll** — qafas tal-plugins + suq, frameworks tal-ħiliet ta’ Omni/Agent/GitHub, integrazzjoni ma’ Obsidian vault (22 għodda MCP), APIs ta’ Batch & Files kompatibbli ma’ OpenAI, cache semantiku għar-risposti, gamification b’klassifiki, skoperta ta’ aġenti ACP (15-il aġent inkorporat), esportazzjoni skedata tar-reġistri lejn BigQuery, fan-out parallel ta’ diversi mudelli `auto/chaos`, bridge għal bot ta’ Telegram, maniġer tal-verżjonijiet fl-applikazzjoni u klassifiki LMArena-ELO ta’ fornituri b’xejn. → [Dokumentazzjoni](docs/README.md)

## 🤖 CLI u Aġenti tal-Kodiċi Kompatibbli > Konfigurazzjoni waħda — `http://localhost:20128/v1` — u **kull** IDE jew CLI tal-AI jaħdem fuq 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 · kull għodda kompatibbli ma' OpenAI

_{📖 Setup għal kull għodda individwali għat-39 għodod kollha (28 CLI Code's + 11 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)}

**Nedja kwalunkwe CLI appoġġjata permezz ta’ OmniRoute b’kmand wieħed** — l-ebda fajls ta’ konfigurazzjoni miktuba, kredenzjali injettati għal kull proċess, Qwen/Gemini jingħataw home iżolat 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 provider+model b’mod interattiv u ikteb il-konfigurazzjoni tal-għodda: omniroute configure codex # ukoll: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Kull kmand josserva l-kuntest remot attiv (`omniroute connect `), `--dry-run` juri preview eżatt tal-env/args mingħajr eżekuzzjoni, u `--api-key-env NAME` iżomm sigrieti barra mill-istorja tas-shell tiegħek. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 Fornitur tal-AI — 153 Immarkati fil-Katalgu bħala Bla Ħlas

> **388 fornitur irreġistrat** fil-kollezzjonijiet kanoniċi taċ-chat, tal-midja, tat-tfittxija, lokali, tal-aġenti fil-cloud u tas-sistema, inklużi **153 li għandhom il-metadata ta’ skoperta `hasFree: true`**. Ir-reġistru tal-mudelli taċ-chat ikopri **239 fornitur / 3,059 par distint ta’ fornitur-mudell / 1,475 ID mhux ipproċessat tal-mudelli**; il-katalgu separat tal-baġit bla ħlas għandu **471 ringiela għal kull mudell**, **34 pool rikorrenti** u **52 fornitur rikorrenti/bla ċavetta u bla ħlas għal dejjem**. Dawn huma denominaturi differenti skont id-disinn; id-definizzjonijiet u l-kalkoli deduplikati skont il-pool 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 350+ oħra — kull ikona tinstab direttament fil-katalgu tal-fornituri tad-dashboard. 📖 [Referenza tal-Fornituri](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Bla Ħlas għal Dejjem — $0, l-ebda karta

OpenCode Zen _{DeepSeek V4, Nemotron 3 L-ebda limit 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 Livell 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 mingħajr limitu}	Pollinations _{GPT, Llama, Claude M’hemmx bżonn ċavetta}	Cloudflare AI _{Aktar minn 50 mudell 10K neurons/jum}	NVIDIA NIM _{GLM, MiniMax ~40 RPM b’xejn}	Cerebras _{GLM 4.7, GPT-OSS Kreditu ta’ $5 darba waħda; karta meħtieġa}	OpenRouter _{mudelli :free +$10 → RPM ogħla}

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

## 🖥️ Fejn OmniRoute Runs — Kullimkien

> L-istess app, il-magna tiegħek, ir-regoli tiegħek. Minn npm globali jinstallaw għal** telefon tiegħek** permezz ta’ Termux.

Pjattaforma	Installa	Highlights
📦 npm (globali)	`npm install -g omniroute`	Kmand wieħed, kwalunkwe OS
⚡ Bun (globali)	`bun add -g omniroute`	L-istess tarball tar-reġistru, installs faster
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Native window + system trey — Windows / macOS / Linux
🎩 Menu-bar (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Jissorvelja & auto-updates the server — macOS
💪 ARM	native `arm64`	Raspberry Pi, ARM servers, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Runs on your phone , 24/7, no root
📲 PWA	"Żid mal-Iskrin tad-Dar"	Skrin sħiħ, offline, jistallabbli mill-browser
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Native OpenCode integration
🤖 VS Kodiċi Copilot Chat	install OmniCopilot extension	OmniRoute mudell zqo fl-indiġeni Copilot Chat picker — stabbli & Insiders
🛠️ Minn sors	`npm install && npm run dev`	Hack fuqha, tikkontribwixxi

_{📖 [Docker Guide](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Menu-bar trey](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 VS Kodiċi nattiv Copilot Chat

> L-ebda sidebar ġdida, l-ebda chat UI ġdida — kull mudell OmniRoute iservi jidher dritt fil-**Copilot Chat model picker li diġà tuża** . Minn VS Code 1.122, il-mudelli tal-fornituri jaħdmu mingħajr GitHub sign-in jew abbonament Copilot — mod ta 'aġent, sejħa ta' għodda u viżjoni, b'xejn. Installa l-** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** estensjoni, ippuntah lejn is-server OmniRoute tiegħek (defaults għal `localhost:20128`), imbagħad iftaħ Copilot Chat → model picker →** Immaniġġja Mudelli...** →**OmniRoute** . < td align ="left">VS Code — stable & Insiders < td align ="left">Cursor, Windsurf, VSCodium, Theia, code-server AntigravityKiro…

Aħżen	Link	Jaħdem ma
🧩 VS Code Marketplace	Install →
🔓 Iftaħ VSX Reġistru	Installa →

Minn ġewwa l-editur: iftaħ il-** Estensjonijiet** ħsieb, tfittxija** "OmniRoute"** , ikklikkja** Installa** — jaħdem bl-istess mod fiż-żewġ ħwienet. Sors, kwistjonijiet u r-runbook tal-pubblikazzjoni ħajjin fuq [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Kodiċi Copilot Gwida taċ-chat](docs/guides/VSCODE-COPILOT.md) — setup, dak li juri l-picker, dashboard-in-a-tab, issolvi l-problemi}

### 🎩 Ġdid: OmniRouteTray — il-portal tiegħek, li tgħix fil-menu bar

> `omniroute serve` huwa happiest meta dejjem mixghul.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** jibdel dan f'app tal-menu-bar issettja u tinsa għal macOS: jibda s-server, iżżommu ħaj matul reboots, jaġġornah f'postu, u jpoġġi l-baġit tat-tokens ħajjin tiegħek klikk waħda bogħod -** l-ebda tieqa terminali ma tithalla miftuha, l-ebda `npm install -g omniroute` ghal babysitting.** Mibnija [b'Tauri v2](https://v2.tauri.app/) (qalba Rust tad-daqs ta 'żball ta' arrotondament), tibgħat il-ħin tar-runtime Node 24 iffirmat tagħha stess u tamministra OmniRoute install ta' app, u għalhekk qatt ma tiġġieled `node`/`bun` globali tiegħek. Huwa** jaqsam il-konfigurazzjoni u d-database `~/.omniroute/` eżistenti tiegħek** — allura huwa l-istess OmniRoute li diġà tmexxi, biss bil-kappell fuq. 🎩 tal-kwoti tal-fornitur, Claude session/weekly limiti b'reset countdowns, tqassim tal-ispejjeż ta' 30 jum

	Kif
🟢 Jissorvelja s-server	Spawns `omniroute serve` , jadotta istanza li diġà qed taħdem minflok ma tidduplikaha
📊 Użu dirett f'daqqa t'għajn
🔄 Aġġornamenti awtomatiċi fis-seħħ	Installazzjoni fi stadji, skambju atomiku, rollback fuq falliment — dejjem fuq l-aktar rilaxx ġdid
🚀 Ibda mal-login	Tnedija mhux obbligatorja mal-login; trej biss, l-ebda ikona tal-baċir
🩺 Tabib & logs	Dijanjostika b'klikk waħda u aċċess għall-log tas-server

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Jippreferi download? Aqbad l-aħħar .dmg minn
Releases . Sors, kwistjonijiet u bini
docs live at zoispag/omniroute-tray.

💛 Proġett komunitarju minn @zoispag — mhux rilaxx uffiċjali 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 **ċentru ta’ kontroll sħiħ 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 # ħaddem il-gateway + id-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 # iddijanjostika l-fornituri, il-ports u d-dipendenzi nattivi ``` ### 🛰️ Modalità remota — ħaddem is-CLI hawnhekk, 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; wara dan, 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 # ← jitħaddem fuq is-server REMOT omniroute configure codex # ← jagħżel mudell remot, jikteb profil Codex lokali omniroute tokens create --name ci --scope read # oħloq tokens b’ambitu idjaq għal magni oħra omniroute contexts use default # ← erġa’ aqleb għas-server lokali ``` It-tokens għandhom ambitu `read` / `write` / `admin`; ir-rotot li jniedu proċessi jibqgħu disponibbli biss permezz tal-loopback. _{📖 [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 bejn id-89 kmand ewlenin: 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 dan 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) jikseb iċ-ċwievet għall-gateway kollu: ir-rotot, il-fornituri, il-kombinazzjonijiet, il-cache, il-kompressjoni u l-memorja — b’mod awtonomu. L-endpoints HTTP ta’ hawn taħt jiġu pprovduti taħt `http://localhost:20128`.

Interfaċċa	Endpoint / kmand	Użaha għal
🧰 MCP (stdio)	`omniroute --mcp`	Qabbadha ma’ Claude Desktop, Cursor jew kwalunkwe klijent MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP remot — 110 għodda, 33 ambitu (l-infurzar jiġi attivat b’għażla), rekord sħiħ 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 ta’ 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)}

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

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

Il-pipeline tal-kompressjoni ta' OmniRoute: talba illustrattiva ta' klijent b'10,000 token tgħaddi minn 12-il magna kompożabbli — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra u OmniGlyph — u tista' tasal għand il-provider b'madwar 1,080 token fl-eżempju dokumentat b'munzelli. Il-kontenut strutturat huwa protett minn preservation guards u fidelity gates għal kull pass; il-modi espliċitament lossy jew sperimentali jistgħu jittrasformaw kontenut eliġibbli.

Il-kombinazzjoni default b'munzelli tħaddem `RTK → Caveman`. Meta t-tnejn jaġixxu fuq l-istess payload 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, l-URLs, il-JSON u d-dejta 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 tibdil fil-klijent. Issa huwa **munzell ta' 12-il magna kompożabbli** li jaħdmu fl-ordni u jitħalltu u jingħaqdu skont kull kombinazzjoni tar-routing — billi 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-munzell ta' 12-il magna Il-magni jaħdmu fl-ordni tal-pipeline; kull waħda tista' tiġi attivata jew diżattivata u kkonfigurata b'mod indipendenti għal kull kombinazzjoni:

#	Magna	X'tagħmel
1	Session-Dedup	Tneħħi kontenut ripetut bejn dawriet (indirizzat bil-kontenut, bejn dawriet)
2	CCR	Tarkivja blokok kbar wara markers ta' rkupru, li jinġabru meta jkun hemm bżonn
3	Lite	Tnaqqas l-ispazji bojod u l-indirizzi URL tal-immaġnijiet (bażi ħafifa f'termini ta' latency)
4	RTK	Iffiltrar intelliġenti tar-riżultati tal-għodod, deduplikazzjoni u tqassir (konxju mill-kmandi)
5	Responses Tool Output	Kompressjoni JSON lossless-first + dijanjostika limitata għall-output tal-shell/patch/search/build (Responses API)
6	Headroom	Kompattazzjoni tabulari lossless ta' arrays JSON (~30%) permezz ta' codec GCF inkluż fil-pakkett
7	Relevance	Punteġġjar estrattiv tas-sentenzi skont l-aħħar mistoqsija tal-utent
8	Caveman	Kompressjoni tal-proża bbażata fuq regoli (~65–75% fuq l-output)
9	Aggressive	Sommarizzazzjoni + tixjiħ progressiv tad-dawriet qodma
10	LLMLingua-2	Tnaqqis semantiku permezz ta' ML permezz ta' MobileBERT ONNX — sikur għall-kodiċi, asinkronu
11	Ultra	Tnaqqis euristiku 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-wire dirett ta' Anthropic; it-transformers ta' GPT 5.6 jibqgħu fail-closed sakemm jaslu l-irċevuti tal-provider. Erba' profili ta' kompressjoni (default aggressiv, bilanċjat, sikur għall-kodifikazzjoni, passthrough) (l-aktar aggressiv; opt-in)

Il-blokok tal-kodiċi, l-URLs u d-dejta strutturata huma **dejjem ippreservati byte-perfect**. **Presets bi klikk waħda** jgħaqqdu l-magni:

Modalità	Iffrankar	L-aħjar għal
🪶 Lite	~15%	Default sikur dejjem attivat
🪨 Standard (Caveman)	~30%	Kodifikazzjoni ta' kuljum
⚡ Aggressive	~50%	Sessjonijiet twal b'ħafna għodod
🔥 Ultra	~75%	Iffrankar massimu
🧰 RTK	60–90%	Output ta' shell/test/build/git
🔗 Stacked (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' jirrendi 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, il-paragun superfiċjali ta' React jarah bħala oġġett differenti kull darba, u dan jiskatta rendering mill-ġdid. Nirrakkomanda li tuża useMemo biex taħżen l-oġġett fil-memorja."_ > > **Wara (19-il token):** _"Referenza ġdida għal oġġett f'kull rendering. Prop ta' oġġett inline = referenza ġdida = rendering mill-ġdid. Użaha ma' useMemo."_ > > **L-istess tweġiba. 72% inqas tokens. Żero telf ta' preċiżjoni.** ✅ **Eżempju PT-BR — modalità [Troglodita](https://github.com/leninejunior/troglodita):** > **Qabel (42 tokens):** _"Il-problema hu li l-komponent qed jerġa’ jirrenderizza għax f’kull ċiklu ta’ rendering qed tinħoloq referenza ġdida għal oġġett. Nirrakkomanda li tuża useMemo."_ > > **Wara (12-il token):** _"Re-render: referenza ġdida f’kull ċiklu (oġġett inline maħluq mill-ġdid). Uża `useMemo`."_ > > **L-istess tweġiba. ~70% inqas tokens. Il-preċiżjoni teknika tibqa’ intatta.** ✅
### 🎚️ Lil hinn mill-magni — stili tal-output, l-arloġġ adattiv u kontroll għal kull talba It-12-il magna ta’ hawn fuq inaqqsu dak li jidħol **ġewwa**. Tliet saffi oħra jsawru **kif**, **meta**, u x’joħroġ: - **🪄 Stili tal-output** _(tmexxija fuq l-assi tal-output)_ — idaħħlu istruzzjonijiet deterministiċi u sikuri għall-cache li jsawru t-tweġiba; jistgħu jiġu kkombinati, kull wieħed b’intensità `lite` / `full` / `ultra`. Iż-żieda ta’ stil hija entrata waħda fir-reġistru: - **Proża qasira** — neħħi l-mili / l-artikoli / il-lingwaġġ tentattiv; ż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 scaffolding mhux mitlub. - **Ponytail (żviluppatur anzjan għażżien)** — għola t-taraġ tal-YAGNI, irranġa l-kawża ewlenija, bl-iżgħar differenza li taħdem. - **Għandi l-ADHD (azzjoni l-ewwel)** — l-azzjoni li jmiss tiġi l-ewwel, il-passi jkunu nnumerati, pass konkret wieħed li jmiss, mingħajr introduzzjoni. - **CJK qasir (文言)** — stil ultrasaqsa biċ-Ċiniż klassiku (limitat skont il-locale għal `zh`). - **🎯 Baġit adattiv tal-kuntest** _(l-arloġġ)_ — minflok limitu wieħed ta’ tokens mixgħul/mitfi, żid il-magni l-orħos u bl-inqas telf biss sakemm ikun biżżejjed biex **jidħol fit-tieqa tal-kuntest tal-mudell**. Politika: `reserve-output` (default, konxja mill-mudell) · `percentage` · `absolute`. Modalità: `floor` (tiggarantixxi li jidħol) · `replace-autotrigger` (l-għażla espliċita tiegħek tirbaħ) · `off` (limitu preċedenti). - **🎛️ 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 bl-isem › trigger awtomatiku / adattiv › default tal-panel › off. Il-pjan applikat jintbagħat lura fil-header tar-rispons `X-OmniRoute-Compression: ; source=`. Attiva t-trigger awtomatiku skont il-limitu tat-tokens, aqleb l-arloġġ adattiv, iffissa profil bl-isem, issettja talba waħda, jew assenja pipeline għal kull kombinazzjoni ta’ routing — skont dak li jaqbel mal-piż tax-xogħol. **eval harness** offline fakultattiv (`npm run eval:compression`) jagħti punteġġ lill-fedeltà kontra l-iffrankar fuq korpus 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ħmlux ħsara](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Qed tuża npm 11 jew aktar?** npm jista’ jimblokka l-iskripts taċ-ċiklu tal-ħajja tal-pakketti sakemm jiġu permessi. Il-`postinstall` ta’ OmniRoute (`node scripts/build/postinstall.mjs`) huwa meħtieġ biex jipprepara l-fajls tar-runtime nattiv tiegħu. Ħalli l-pakketti msemmija fit-twissija ta’ npm meta tinstalla globalment. Għas-sett ta’ pakketti rrappurtat minn OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Biex terġa’ tuża din il-lista ta’ permessi għal installazzjonijiet globali futuri, ikkonfiguraha darba, imbagħad installa b’mod normali: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Il-lista tad-dipendenzi tista’ tinbidel bejn verżjonijiet; jekk npm jirrapporta lista differenti, uża l-ismijiet tal-pakketti minn dik it-twissija. Li tippermetti pakkett jippermetti li l-iskripts tal-installazzjoni tiegħu jitħaddmu. > **Qed tuża Gemini Web jew fornitur ieħor ibbażat fuq web-cookie?** Il-pakkett npm jinkludi > Playwright iżda mhux il-binarju Chromium tiegħu. Ara n-nota dwar > [is-setup ta’ Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > qabel ma tagħmel l-ewwel talba lil fornitur web. Dashboard fuq `http://localhost:20128` · API fuq `http://localhost:20128/v1`. **2) Qabbad fornitur eliġibbli billi tuża l-kont tiegħek** Dashboard → **Providers** → agħżel fornitur li t-termini u l-kwota attwali tiegħu jaqblu mal-każ ta’ użu tiegħek → żid iċ-ċavetta API tiegħu jew imla l-fluss tal-kont tiegħu. Il-livelli b’xejn jistgħu jeħtieġu reġistrazzjoni, approvazzjoni, jew metodu ta’ ħlas. Irrevedi l-[Gwida tal-Livelli B’xejn](docs/getting-started/FREE-TIERS-GUIDE.md); id-disponibbiltà mingħajr ċavetta mhijiex garantita, u l-fornituri mmarkati `tos: avoid` huma esklużi minn `auto` b’mod awtomatiku. **3) Ipponta l-għodda tal-kodifikazzjoni tiegħek** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Ivverifika li qed taħdem** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Għandek tara l-mudelli konnessi tiegħek elenkati. 🎉 Dak kollox — ibda kkodifika, u OmniRoute jagħmel ir-routing u l-fallback awtomatikament għalik. Jekk il-klijent tiegħek ma jistax jibgħat headers personalizzati, OmniRoute jesponi wkoll aliases ta’ kompatibbiltà tokenizzati: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Uża dawni biss għal klijenti li ma jistgħux iżidu `Authorization: Bearer ...`. L-awtentikazzjoni permezz tal-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` 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-10-18 · Katalgu mhux ipproċessat: YT 1.352 | TT 334 | IG 290 · Reċenza (jiem): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 darba li ntwera}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 darba li ntwera}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 darba li ntwera}

🎬 #4 — Instagram
_{theopenstack — 692,419 darba li ntwera}

🎬 #5 — TikTok
_{migue.baena — 685,788 darba li ntwera}

**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** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Metriċi kanoniċi fl-2026-10-18: **1.976 vidjo uniku** · **20.220.289 darba magħrufa li ntwerew** (`v > 0`) · **1.210 kanali/profili għal kull netwerk**. Il-pannell mhux ipproċessat fih 1.976 ringiela (YouTube 1.352 = 740 twal + 612 Shorts · TikTok 334 · Instagram 290); ma baqa’ ebda duplikat wara n-normalizzazzjoni skont il-URL kanoniku, li żżomm l-ogħla għadd għal kull vidjo. Il-ġbir minn YouTube ilu ffriżat mill-2026-10-13 (il-kwota tal-API ntużat kollha mill-14 sat-18/10) u dak minn TikTok/Instagram ilu ffriżat mill-2026-09-02 (mingħajr krediti għall-ġbir); 76 vidjo għad m’għandhomx għadd ta’ kemm-il darba ntwerew. > 🎬 **Għamilt vidjo dwar OmniRoute?** Iftaħ [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) jew [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) bil-link — se nuruh hawnhekk.

# 📧 Komunità u Għajnuna > Kollox f’post wieħed — segwi lill-manutentur, tkellem mal-komunità, jew iftaħ issue. | Kanal | Fejn / kif | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — segwi lill-manutenzjonist | [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 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-Fergħat u tal-Ħruġ](docs/ops/BRANCHING_MODEL.md) · agħżel `good first issue` | | 💚 **Appoġġja l-proġett** | [Modi kif tappoġġja ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Munzell teknoloġiku

Saff	Teknoloġija
Ambjent ta' eżekuzzjoni	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Lingwa	TypeScript 6.0 — 100% TypeScript f’`src/` u `open-sse/` (żero `any` fil-qalba minn v2.0)
Qafas	Next.js 16 + React 19 + Tailwind CSS 4
Bażi tad-dejta	better-sqlite3 (SQLite, ġurnalar WAL) + LowDB (JSON ta’ wirt) — 147-il modulu tad-dominju, 233-il migrazzjoni
Memorja	Test sħiħ b’SQLite FTS5 + embeddings vettorjali kwantizzati b’int8, tħassir ittajpjat
Skemi	Zod 4 — validazzjoni tal-I/O tal-għodod MCP + kuntratti tal-API
Protokolli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Xandir kontinwu	Avvenimenti mibgħuta mis-server (SSE) + pont WebSocket (`/v1/ws`)
Kompressjoni	Pipeline bi 12-il magna — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Awtentikazzjoni & sigurtà	OAuth 2.0 (PKCE) + JWT + Ċwievet API + awtentikazzjoni MCP b’ambitu · AES-256-GCM waqt il-ħażna · DOMPurify
Moħbija	wreq-js — impersonifikazzjoni tal-marki tas-swaba’ TLS JA3 / JA4, proxy bi 3 livelli
Reżiljenza	Circuit breaker, backoff esponenzjali, prevenzjoni tal-effett ta’ merħla, awto-tiswija ta’ auto-combo
Reġistrazzjoni	pino — reġistri JSON strutturati bil-kuntest tat-talba
Ittestjar	Node.js test runner + Vitest — aktar minn 60,000 dikjarazzjoni statika tat-testijiet f’aktar minn 8,400 fajl tat-testijiet segwit (unitarji, ta’ integrazzjoni, E2E, ta’ sigurtà, tal-ekosistema)
Pjattaformi	Desktop (Electron) · Android (Termux) · PWA (kwalunkwe browser)
CI/CD	GitHub Actions — pubblikazzjoni awtomatika fuq npm + Docker Hub mar-rilaxx
Rabtiet	Sit web · npm · Docker Hub

## 📖 Dokumentazzjoni

### 📘 Kif Tibda

Dokument	Deskrizzjoni
Gwida għall-Utent	Providers, kombinazzjonijiet, integrazzjoni ma' CLI, skjerament
Gwida għall-Konfigurazzjoni	Metodi sħaħ ta' installazzjoni, konfigurazzjonijiet tal-għodod CLI, konfigurazzjoni tal-protokoll, aġġustament tal-timeout
Gwida għall-Għodod CLI	Konfigurazzjoni għal kull għodda għal Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Modalità Remota	Ħaddem OmniRoute remot (VPS) mill-CLI tal-laptop tiegħek permezz ta' tokens ta' aċċess b'ambitu limitat
Konfigurazzjoni ta' Claude Code	Ikkonfigura Claude Code biex juża OmniRoute (lokali/remot) b'`launch` + profili għal kull mudell
Bidu Mgħaġġel	Installazzjoni → konnessjoni → konfigurazzjoni fi 3 passi

### 🔧 Operazzjonijiet u Skjerament

Dokument	Deskrizzjoni
Gwida għal Docker	Ħaddem Docker, profili ta' Compose, HTTPS ta' Caddy, tunnels, tags tal-immaġini
Gwida għal Podman	Integrazzjoni ma' systemd permezz ta' Quadlet, podman-compose, SELinux
Skjerament fuq VM	Gwida kompluta: konfigurazzjoni ta' VM + nginx + Cloudflare
Skjerament fuq Fly.io	Skjerament fuq Fly.io b'ħażna persistenti
Gwida għal Termux	Ħaddem OmniRoute fuq Android permezz ta' Termux
Gwida għal 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	Il-varjabbli u r-referenzi kollha ta' `.env`

### 🧠 Karatteristiċi u Arkitettura

Dokument	Deskrizzjoni
Arkitettura	Arkitettura tas-sistema, fluss tad-dejta, u komponenti interni
Gwida għall-Kompressjoni	Pipeline b'7 għażliet: off / lite / standard / aggressive / ultra / RTK / stacked
Kompressjoni RTK	Kompressjoni tal-output tal-kmandi, filtri, fiduċja, verifika, irkupru tal-output mhux ipproċessat
Magni tal-Kompressjoni	Caveman, RTK, pipelines stacked, interfaces tad-dashboard/API/MCP
Format tar-Regoli tal-Kompressjoni	Skemi JSON għal pakketti ta' regoli għall-filtri ta' Caveman u RTK
Pakketti Lingwistiċi tal-Kompressjoni	Sejbien tal-lingwa u kitba ta' pakketti ta' regoli għal Caveman
Gwida għar-Reżiljenza	Circuit breakers, cooldowns, kju, prevenzjoni ta' thundering herd, spoofing TLS
Magna Auto-Combo	Skorjar b'16-il fattur, pakketti tal-modalità, awto-fejqan
Gwida għall-Proxy	Sistema ta' proxy bi 3 livelli, suq ta' 1proxy, CRUD tar-reġistru
Livelli B'xejn	Direttorju kkonsolidat: 34-il grupp rikorrenti dokumentat / 465 entrata katalogata tal-livell b'xejn
Gallerija tal-Karatteristiċi	Ħarsa viżwali lejn id-dashboard bi screenshots
Dokumentazzjoni tal-Codebase	Ħarsa ġenerali lejn il-codebase faċli għall-Bidu

### 🤖 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 ta' MCP, trasporti, u referenza tal-għodod
Server A2A	Protokoll JSON-RPC 2.0, ħiliet, streaming, ġestjoni tal-kompiti
Gwida għas-Server A2A	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-rilaxx	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 ta' vulnerabbiltajiet u prattiki tas-sigurtà
Gwida tal-i18n	Appoġġ għal 67 lingwa, fluss tax-xogħol tat-traduzzjoni, RTL
Lista ta' kontroll tar-rilaxx	Passi ta' validazzjoni qabel ir-rilaxx
Pjan tal-kopertura	Strateġija tal-kopertura tat-testijiet għal aktar minn 60,000 dikjarazzjoni statika tat-test mifruxa fuq aktar minn 8,400 fajl tat-test irreġistrat

# ⭐ Kontributuri ewlenin > OmniRoute huwa ffurmat minn komunità passjonata ta' sors miftuħ. Dawn l-individwi għamlu kontribuzzjonijiet 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	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Ċensiment meħud 2026-11-03 03:01:19 UTC bil-ponta attiva ta' release/v3.8.53 05bc048d6c. Iċ-ċensiment tal-GitHub GraphQL imqassam f'paġni fih 9,947 PR magħquda: 4,130 mis-sid tar-repożitorju, 240 minn Dependabot, 6 minn bots/apps oħra, u 5,571 PR esterni minn 883 kontributur distint. “Linji mibdula” huma ż-żidiet + it-tħassiriet tal-GitHub u jinkludu fajls iġġenerati, lockfiles, katalgi, traduzzjonijiet u dokumentazzjoni; huma tibdil akkumulat, mhux LOC miktuba mill-awtur. 53 PR jirrappurtaw diffi tal-GitHub ta' aktar minn 500,000 linja (pereżempju #13399, żieda waħda ta' provider, jelenka 2,347 fajl mibdul), u dan ikabbar diversi totali ta' hawn fuq. Il-paritajiet jiġu kklassifikati flimkien.} ### Commits attribwiti lil GitHub

Dizzle _{🥇 418 kontribuzzjoni attribwiti lil GitHub}	Bob.Hou _{🥈 294 kontribuzzjoni attribwiti lil GitHub}	Paijo _{🥉 229 kontribuzzjoni attribwiti lil GitHub}	Paco Cartones _{🏅 222 kontribuzzjoni attribwiti lil GitHub}	backryun _{🏅 202 kontribuzzjoni attribwiti lil GitHub}	Jan Leon _{🏅 134 kontribuzzjoni attribwiti lil GitHub}
Ravi Tharuma _{🏅 126 kontribuzzjoni attribwiti lil GitHub}	Markus Hartung _{🏅 115 kontribuzzjoni attribwiti lil GitHub}	Randi _{🏅 108 kontribuzzjoni attribwiti lil GitHub}	Chris _{🏅 70 kontribuzzjoni attribwiti lil GitHub}	WebPerson _{🏅 68 kontribuzzjoni attribwiti lil GitHub}	Koosha Paridehpour _{🏅 68 kontribuzzjoni attribwiti lil GitHub}

_{Iċċekkjat mill-ġdid fit-2026-11-03 02:09:16 UTC: kontribuzzjonijiet attribwiti lil GitHub irrappurtati mill-Contributors API tar-repożitorju għall-fergħa awtomatika release/v3.8.53. L-API rritornat 903 identità (429 utenti, 2 bots, 472 anonimi); din it-tabella teskludi l-mantenitur, il-bots u l-identitajiet anonimi, u żżomm ir-rabtiet fil-kompetizzjoni. Hija distinta kemm mill-klassifika tal-PRs magħquda ta’ hawn fuq kif ukoll miċ-ċensiment tal-metadejta 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ż tat-test u kull fajl tat-traduzzjoni i18n huma importanti. Is-sors miftuħ jinbena minn nies bħalhom.

---
## 💖 Sponsorizzaturi

Ringrazzjament mill-qalb lil dawk li jiffinanzjaw lil OmniRoute minn buthom stess — kull kontribuzzjoni żżomm il-proġett b'xejn, indipendenti u miexi 'l quddiem.

Andrew _{💛 Sponsor attiv ta' kull xahar}	Vlad I _{💛 Sponsor attiv ta' kull xahar}	小妍儿 _{💛 Sponsor attiv ta' kull xahar}	Guilherme Costa _{💛 Sponsor attiv ta' darba}	Henrique Iurkiv _{💛 Sponsor attiv ta' darba}	Somesh Ghaturle _{💛 Sponsor attiv ta' darba}
Kolonie AI _{💛 Sostenitur preċedenti ta' darba}	Prof. Igor Morais _{💛 Sostenitur preċedenti ta' darba}	Pixma _{💛 Sostenitur preċedenti ta' darba}	Paco Cartones _{💛 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 fit-2026-10-18 permezz tal-GitHub Sponsors GraphQL API: 11-il sponsorizzazzjoni pubblika (6 attivi, 5 preċedenti) minn total ta' 14. L-istatus isActive ta' GitHub jiddetermina t-tikketti attivi ta' hawn fuq; is-sostenituri pubbliċi preċedenti ta' darba jibqgħu jingħataw radd il-ħajr, filwaqt li l-isponsors privati jibqgħu anonimi. Id-donazzjonijiet permezz ta' Ko-fi, Buy Me a Coffee, Liberapay, PIX u l-kripto mhumiex elenkati għax m'għandhomx rekord pubbliku ta' sponsor.} 💖 Sir sponsor → — kull dollaru jżomm lil OmniRoute b'xejn u indipendenti.

## 👥 Aktar minn 1,000 Kontributur

[![Kontributuri](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Awditjat fit-2026-11-02 fuq il-ponta attiva ta' release/v3.8.53 1c7135e0fb (7,972 commit): 1,074 identità umani normalizzati ta' Git — 759 jidhru bħala awturi tal-commit (inkluż il-mantenitur) u 315 jidhru biss f'headers espliċiti Co-authored-by. Iċ-ċensiment japplika .mailmap, iqabbel l-indirizzi tal-posta elettronika mingħajr ma jqis il-majuskoli u l-minuskoli, jgħaqqad l-indirizzi numeriċi u sempliċi ta' GitHub noreply biss meta jikkodifikaw l-istess handle, jeskludi 29 identità ta' bot/aġent/servizz/placeholder, u ma jgħaqqadx indirizzi ordinarji tal-posta elettronika sempliċement għax l-ismijiet murija tagħhom jaqblu. L-awditjar tal-2026-08-24 ippubblika 639; meta dan il-metodu jerġa' jitħaddem fuq il-bażi ta' dak l-awditjar ac02c5b42f, jagħti 619, għalhekk iż-żieda ġejja minn kontributuri ġodda, mhux minn metodu aktar laxk.} ### Kif Tikkontribwixxi 1. Oħloq fork tar-repożitorju 2. Oħloq branch mill-ponta **attiva** ta' `release/vX.Y.Z` (mhux `main`) — ara [Mudell tal-Branches u tar-Rilaxx](docs/ops/BRANCHING_MODEL.md) 3. Oħloq il-branch tal-karatteristika tiegħek (`git checkout -b feat/amazing-feature`) 4. Ikkummenta l-bidliet tiegħek (`git commit -m 'feat: add amazing feature'`) 5. Ibgħat lill-branch (`git push origin feat/amazing-feature`) 6. Iftaħ Pull Request b'**base = dik il-branch `release/vX.Y.Z`** Ara [CONTRIBUTING.md](CONTRIBUTING.md) għal linji gwida dettaljati. ### Rilaxx ta' Verżjoni Ġdida ```bash # Oħloq rilaxx — npm publish isir awtomatikament VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Stilel

## 🌍 StarMapper

## 🙏 Rikonoxximenti

OmniRoute tistrieħ fuq spallejn ġganti. Bdiet 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 ’il quddiem, kull subsistema hawn taħt ġiet ispirata minn proġett open-source li wasal hemm qabilha. Kull wieħed minnhom sawwar parti konkreta ta’ OmniRoute. Dan huwa r-ringrazzjament tagħna lilhom kollha. 🙏 > ⭐ in-numri tal-istars ġew ivverifikati mill-GitHub REST API fit-3 ta’ Novembru 2026 — mur agħti stilla lil dawn il-proġetti. In-numri huma stampa eżatta ta’ dik id-data u naturalment se jinbidlu. ### 🧬 Linja ta’ nisel u gateway

Proġett	⭐	Kif ispira lil OmniRoute
9router	31,861	Il-proġett oriġinali li fuqu hija mibnija din il-fork — estiż hawn b’APIs multimodali u kitba mill-ġdid sħiħa f’TypeScript.
CLIProxyAPI	57,329	L-implimentazzjoni f’Go li ispirat dan il-port f’JavaScript / TypeScript.
LiteLLM	62,580	Il-gateway tal-AI li d-dataset pubbliku tiegħu tal-prezzijiet jipprovdi d-dejta għas-sinkronizzazzjoni tat-traċċar tal-ispejjeż tagħna u li l-mudell tiegħu ta’ normalizzazzjoni tal-fornituri informa r-routing tagħna.
codex-chatgpt-web	15,435	Il-kodiċi tas-sors MIT adattat fil-bridge vendored ChatGPT Web → Codex Responses, inklużi adapters għas-sessjoni tal-browser, għat-tfassil tar-risposti, għall-użu u għat-tiftix fuq il-web.
free-claude-code	65,966	Disinji portati għall-irkupru tal-flussi, għal aliases mingħajr thinking, għat-tiftix alternattiv fuq il-web, għal-limiti ta’ sliding window, għall-ħabi tad-dejta sensittiva fil-logs u għal flussi ta’ tnedija msaħħin.
composer-api	347	Disinji ta’ Cursor Composer għall-għażla tal-għodod, għall-kostrinzjonijiet tal-output u għall-ikkommettjar tal-għodod ġew adattati fl-eżekutur nattiv ta’ Cursor.
codex-multi-auth	561	Disinji għal login ġdid u għar-rotazzjoni tar-refresh token ġew portati għall-awtentikazzjoni mill-ġdid ta’ Codex OAuth.
opencode-anthropic-auth	562	Defaults ta’ trasformazzjoni kompatibbli ma’ Claude Code u l-imġiba tal-billing headers ġew ġeneralizzati fil-bridge ta’ OmniRoute mmexxi mill-konfigurazzjoni.
grok2api-merged	2	Il-mappings tal-mudelli ta’ Grok, il-ġeneratur Statsig fake-TypeError, id-defaults tat-talbiet u tal-apparat, u l-proċessur tar-risposti NDJSON tiegħu ġew adattati b’mod materjali fl-eżekutur Grok Web ta’ OmniRoute.
TQZHR/grok2api	707	Is-sors ewlieni transittiv tal-kodiċi wara grok2api-merged; l-implimentazzjonijiet tiegħu tal-mudell, tal-headers, tal-payload, ta’ Statsig u tal-proċessur huma ppreservati fil-linja ta’ nisel ta’ Grok Web.
chenyme/grok2api	7,874	Is-sors sottostanti MIT għall-payload u d-defaults 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 transittiv ikkreditat minn grok2api-merged għas-saff tal-pool tal-proxy; OmniRoute tippreserva din in-nota tal-linja ta’ nisel iżda ma ssostnix li portat pool tal-proxy fl-eżekutur Grok Web limitat tagħha.
GrokProxy	52	Il-proxy ta’ Grok awtentikat bil-cookie u d-disinn ta’ streaming `result.response.token` tiegħu influwenzaw it-trasport Grok Web ta’ OmniRoute.
GrokBridge	5	L-implimentazzjoni oriġinali ta’ Grok Web ġiet ikkonsultata għad-disinn upstream tagħha tal-HTTP/browser; il-mogħdija diretta tagħha tal-HTTP ġejja minn GrokProxy, għalhekk ma huwiex sostnut port indipendenti tal-kodiċi.

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

Proġett	⭐	Kif ispira lil OmniRoute
Caveman	116,957	Il-proġett virali “why use many token when few token do trick” — il-filosofija tiegħu tat-taħdit tal-caveman tħaddem il-mod standard tagħna tal-kompressjoni u aktar minn 30 regola ta’ mili/ikkondensar.
RTK – Rust Token Killer	85,350	Kompressjoni ta’ prestazzjoni għolja tal-output tal-kmandi — ispirat il-magna RTK tagħna, il-DSL tal-filtri JSON, l-irkupru tal-output mhux ipproċessat u l-pipeline f’saffi RTK → Caveman.
headroom	78,672	Kompressjoni riversibbli tal-kuntest (SmartCrusher) — ispirat il-magna `headroom` tagħna u l-mudell tal-markatur tal-irkupru `ccr`.
LLMLingua	6,797	Riċerka dwar il-kompressjoni tal-prompts (LLMLingua / LLMLingua-2) — ispirat il-magna `llmlingua` tagħna, asinkronika, sigura għall-kodiċi u li tiftaħ il-fluss meta jkun hemm żball.
llmlingua-2-js	33	Il-port JS/ONNX (MobileBERT / XLM-RoBERTa) użat bħala backend tal-worker thread għall-magna LLMLingua tagħna.
Troglodita	50	Kompressjoni ta’ tokens PT-BR — tħaddem il-pakkett tal-lingwa pt-BR tagħna: tnaqqis tal-pleonażmi u tneħħija ta’ kliem mimli adattati għall-grammatika tal-Portugiż Brażiljan.
ponytail	182,929	Il-ħila YAGNI-coder virali tal-“lazy senior dev” — ispirat l-Istil tal-Output less-code tagħna: gwida lejn l-iżgħar bidla li taħdem, li tnaqqas il-kodiċi _iġġenerat_ (il-kontroparti fuq l-assi tal-output għall-proża qasira ta’ Caveman).
i-have-adhd	59,838	L-istil ta’ tweġibiet tiegħu, iffukat fuq l-azzjoni u faċli għal persuni b’ADHD, ġie adattat fl-istil konċiż tal-output ta’ OmniRoute f’ħames lingwi.

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

Proġett	⭐	Kif ispira lil OmniRoute
TOON	25,602	Token-Oriented Object Notation — il-mudell tiegħu b’kolonni, b’intestatura u ringieli, ifforma l-istadju tagħna tal-kompattazzjoni tabulari.
GCF – Graph Compact Format	61	Il-format kompatt tal-graffi tiegħu u d-disinn tal-profil ġeneriku influwenzaw il-kompattazzjoni tabulari ta’ OmniRoute u l-format tal-codec ta’ Headroom.
gcf-typescript	4	L-implimentazzjoni MIT TypeScript ġiet inkluża direttament u estiża bħala l-codec tal-profil ġeneriku ta’ Headroom.
token-optimizer-mcp	566	Cache Brotli/SQLite + context-delta għal kull sessjoni — ispirat il-magna `session-dedup` tagħna.
token-savior	1,203	Kompattazzjoni tal-output ta’ Bash + profili MCP — ispirat id-dixxiplina tagħna biex nieqfu mill-kompressjoni meta jkun meħtieġ u t-tnaqqis tal-manifest tal-għodod MCP.
token-saver	162	Kompressjoni tal-output konxja mill-kontenut u skont it-tip ta’ fajl, b’waqfien meta jkun hemm falliment — ivvalidat id-dispaċċ tagħna skont it-tip u l-qbiż meta l-qligħ ikun minimu.
token-optimizer	2,853	“Sib it-tokens fantażma” — il-mudell tiegħu ta’ offload + handle li jista’ jiġi rkuprat informa l-ħsieb tagħna dwar l-offload ta’ CCR.
TokenMizer	34	Blueprint ta’ graff tas-sessjoni + deduplikazzjoni tal-linji bejn id-dawriet, li informa d-disinn tagħna ta’ session-dedup.
OmniCompress	3	JSON f’kolonni ta’ Rust + retrieve indirizzat skont il-kontenut + deduplikazzjoni bejn il-messaġġi — ivvalidaw id-disinn tagħna tal-magni `headroom`/`ccr`/`session-dedup` u l-invariant stabbli għall-cache li l-“forma kkompressata hija indipendenti mill-pożizzjoni”.
mcp-compressor	140	Kompressjoni tal-iskema u d-deskrizzjoni tal-għodod MCP — infurmat it-tnaqqis tagħna fil-kardinalità tal-manifest tal-għodod MCP.
RepoMapper	218	Ranking tal-mappa tar-repo stil Aider — informa l-esplorazzjoni tagħna tal-mappa tar-repo / ranking tal-irkupru.
quiet-shell-mcp	4	Tnaqqis dikjarattiv tal-output tal-shell permezz ta’ MCP — ivvalida l-kompattazzjoni dikjarattiva tagħna tal-output ta’ bash.
ts-morph	6,222	Toolkit tal-API tal-Kompilatur ta’ TypeScript — ispirat it-tneħħija tal-kummenti bbażata fuq parser li tippreserva l-literals ta’ strings, templates u regex.

### 🧠 Memorja u RAG

Proġett	⭐	Kif ispira lil OmniRoute
Mem0	68,294	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)	25,321	Aġenti b’memorja statali f’livelli — ispira l-mudell f’livelli ta’ Context Control & Recovery (CCR) tagħna.
WFGY	1,804	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	81	L-interċezzjoni/analiżi MITM tat-traffiku bejn l-assistent tal-kodifikazzjoni u l-LLM infurmat ir-rekwiżiti bikrija ta’ Traffic Inspector. Erba’ moduli derivati qabel — l-għaqda tal-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ċi ta’ host-passthrough (`passthrough.ts` u `_internal/bypass.cjs`) jibqgħu implimentazzjonijiet interni ta’ OmniRoute, ikklassifikati b’mod indipendenti; ma nkitbux mill-ġdid bħala parti minn dik is-sostituzzjoni.
ProxyBridge	6,978	Rotot trasparenti tal-proxy għal kull proċess — ispira t-tneħħija MITM sigura kontra l-ħsarat, il-timeouts tal-inattività tas-sockets, l-attribuzzjoni tal-proċessi permezz ta’ `/proc` u l-qbid TPROXY tagħna.

### 📚 Dejta tal-mudelli, osservabbiltà u UI

Proġett	⭐	Kif ispira lil OmniRoute
models.dev	7,486	Database miftuħ tal-ispeċifikazzjonijiet, il-prezzijiet u l-kapaċitajiet tal-mudelli tal-AI — sinkronizzat b’mod nattiv fil-katalgu tal-mudelli tagħna.
React Flow / xyflow	38,874	Il-librerija tal-graffi bbażati fuq in-nodi li tħaddem il-Compression Studio u l-Combo/Routing Studio tagħna f’ħin reali.
LangGraph	44,349	Il-viżwalizzazzjoni diretta tal-graff tal-fluss tax-xogħol ta’ LangGraph Studio ispirat il-veduta f’ħin reali tal-kaskata fl-Istudios tagħna.
Langfuse	36,907	Il-mudell tiegħu ta’ osservabbiltà trace → span → generation sawwar il-veduta waterfall tal-Compression Studio tagħna.
Kiali	3,647	Osservabbiltà tas-service mesh ta’ Istio — ispirat il-badges tal-circuit breaker u l-viżwali tat-truf tal-iżbalji tagħna fir-Routing/Combo Studio.
lobe-icons	2,666	Logos tal-marki tal-AI/LLM li jirrendu l-ikoni tal-fornituri fid-dashboard tagħna.
flag-icons	12,499	Jipprovdi l-bnadar SVG liċenzjati taħt il-MIT użati mis-selettur tal-lingwi tar-README.

### 🛡️ Sigurtà

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

### 🧭 Għodod komplementari

Proġett	⭐	Kif ispira lil OmniRoute
ClawRouter	6,649	Ispira d-deduplicazzjoni tat-talbiet, il-fallback ta’ emerġenza mingħajr spiża, l-istrateġiji Auto-Combo pluggable u l-klassifikazzjoni tal-intenzjoni multilingwi.
Antigravity-Manager	32,785	Ir-rimappjar tal-mudelli konxju mill-kontijiet, il-validazzjoni tal-mogħdijiet tal-eżekutabbli u l-imġiba tat-tikketti tal-pjan tiegħu infurmaw ir-runtime Antigravity ta’ OmniRoute.
vscode-antigravity-cockpit	4,852	Il-format kompatt tiegħu tal-countdown għar-reset tal-kwota ispira l-wiri korrispondenti tal-limitu tal-fornitur f’OmniRoute.
AionUi	33,996	L-integrazzjonijiet ACP tiegħu ispiraw l-iskoperta awtomatika tal-aġenti CLI installati minn OmniRoute.
CodexBar	22,955	Identifika s-superfiċi tal-kwota ta’ Grok Build; OmniRoute imbagħad ivverifika u kkoreġa l-format wire attiv b’mod indipendenti.

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

**[⬆ Lura fil-bidu](#-omniroute)** · Mibni b'❤️ għall-komunità tal-IA open-source. _{Maħluq minn Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Liċenzja MIT · omniroute.online}