## 💰 ~1.62B Tokens / Xahar Fuq Livelli B'xejn ta' Partijiet Terzi
> **Ġib il-kontijiet tal-fornituri tiegħek stess.** Din hija aggregat stmat fuq livelli b'xejn ta' partijiet terzi eliġibbli separatament, mhux għotja ta' tokens minn OmniRoute. Irreġistra, ikseb il-kredenzjali fejn meħtieġ, u qabbad il-fornituri li tista' tuża; kull fornitur jikkontrolla l-limiti, id-disponibilità u t-termini tiegħu.
>
> L-istakkjar tal-livelli b'xejn manwalment huwa process tedjanti — għexieren ta' SDKs, għexieren ta' rate limits, u l-ebda idea ta' kemm għandek fil-fatt. OmniRoute jikkataloga **467 entrata ta' livell b'xejn fuq 34 ċavetta ta' pools rikorrenti** u jikkalkula l-figura prinċipali tat-tokens mill-**17-il pool b'budget xaharri pożittiv ippubblikat, flimkien ma' ħames limiti ta' Groq għal kull mudell**, ddeduplikat skont il-pool kondiviż. Il-kwoti li jinfetħu biss wara verifika reġjonali tal-identità (illum: ModelScope) jintweru appart, +~6M li jeħtieġu verifika reġjonali tal-identità, u qatt ma jiġu msumjati fil-figura prinċipali. Ir-riżultat jibqa' viżibbli fuq id-dashboard (`/dashboard/free-tiers`).
> Sommarju animat tal-paġna live `/dashboard/free-tiers`. Metodoloġija sħiħa (dedupe tal-pools, livelli ta' krediti, termini tal-fornituri): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Dawn il-figuri jiġu awditjati mill-ġdid kull ġimaghtejn skont il-katalogu live u **jimxiwu fiż-żewġ direzzjonijiet** — fornitur itemm livell b'xejn u n-numru jinżel; wieħed ġdid jasal u jitla'. Nippubblikaw dak li l-katalogu verament jikkalkula, 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.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Ingħaqad mal-komunità
**👋 Segwi lill-mantenitur — kun mill-ewwel li tikseb fornituri ġodda, verżjonijiet u pariri:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](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 Jibqa' Jikber
## 🆓 Installa, qabbad fornitur, imbagħad irrotta permezz ta' endpoint wieħed
```bash
# Wara li tkun qabbadt fornitur, ikkopja l-key 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 tista' ma jkollha l-ebda mira eliġibbli mingħajr key, u fornitur mingħajr key jista' jirrifjuta klijenti ta' partijiet terzi. B'mod standard, fornituri mmarkati `tos: avoid`, inkluż Kiro, huma esklużi mill-irrottar awtomatiku; li tqabbad kont ma jirrimpjazzax dak is-setting. Ara l-[Gwida dwar is-Saffi B'xejn](docs/getting-started/FREE-TIERS-GUIDE.md) qabel ma tagħżel fornitur.📦 Skripts ta' quickstart kopja-u-pejst għal **Python, Node.js, PHP, u cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Il-Wiegħda
# 🤔 Għaliex OmniRoute?
## 🤝 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
> **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:
🧑💻 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 🧠
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)
📖 [Magna Auto-Combo](docs/routing/AUTO-COMBO.md) · [Gwida għar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 X'Jagħmel lil OmniRoute Differenti
📊 Metodoloġija sħiħa & dettalji għal kull karatteristika mqabbla ma' 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Appoġġja lil OmniRoute
OmniRoute huwa liċenzjat taħt MIT u miżmum b’mod miftuħ. Jekk jiffrankalek il-ħin jew il-flus, hawn kif tista’ tgħinu jibqa’ indipendenti — agħżel dak li jaqbillek. L-isponsorizzazzjoni qatt ma taffettwa l-prijorità tar-routing; tixtri viżibbiltà, mhux klassifikazzjoni.
**🇧🇷 PIX** — immedjat, mingħajr tariffi (Brażil)
Ċavetta (każwali): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix biex tikkopja u twaħħal:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ Kripto — BTC · ETH · USDT-TRC20 · USDC-Solana (ikklikkja biex tiftaħ)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Ibgħat kull munita biss fuq in-network indikat — jekk tibgħatha fuq network ħażin tista’ titlef il-fondi.
🐛 Sibt bug jew għandek kummenti? Iftaħ [Diskussjoni](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 salienti reċenti minn **v3.8.20 → v3.8.53**. L-istorja sħiħa fi [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Rottar `quota-weighted`** — l-20 strateġija combo taqbeż il-kontijiet eżawriti, imbagħad tagħżel fost il-bqija b'mod proporzjonali mal-kwota li fadal diviża bit-tagħbija in-flight, filwaqt li żżomm il-konversazzjonijiet eżistenti mwaħħla. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Modalità headless** — `omniroute serve --headless` (jew `OMNIROUTE_HEADLESS=1`) jħaddem biss il-magna proxy `/v1/*`, bid-dashboard u s-sottosistemi tad-dashboard biss mitfija. → [Modalità Headless](docs/guides/HEADLESS.md)
- **🔎 Skoperta tal-mudelli** — `/v1/models` jiffiltra skont il-kapaċità, il-kuntest, it-tip u t-test, u `POST /v1/models/query` jirritorna shortlist qasira u deterministika bl-istess viżibilità skont iċ-ċavetta. → [Referenza tal-API](docs/reference/API_REFERENCE.md)
- **🔑 Kontroll tar-rottar skont iċ-ċavetta** — waħħal ċavetta API ma' mudell wieħed jew combo b'`forcedModel`, u żid jew neħħi l-mudelli u l-combos ta' ċavetta b'mod atomiku (`/api/keys/{id}/access`). → [Referenza tal-API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Kontrolli PII aktar raffinati** — għażla skont it-tip, sa 20-il mudell ta' masking personalizzat u validat, u kontaturi tas-sejbien skont it-tip; il-masking innifsu jibqa' opt-in. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67-il lingwa** — dashboard, mera tad-dokumentazzjoni u CLI, b'`npm run i18n:add-locale` iżżid lingwa kullimkien b'kmand wieħed. → [Gwida i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — delegazzjoni A2A inbound lejn il-flotta ta' aġenti tiegħek, ħiliet Conductor fuq l-Agent Card, u pannell tad-dashboard b'chat bil-vuċi push-to-talk ta' Faro. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Ammissjoni adattiva u protezzjoni mill-tagħbija żejda** — talbiet chat tqil jidħlu fil-kju minflok ma jirċievu 503, b'leases rolling RPM atomiċi għal kull konnessjoni. → [Gwida tar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Ordni kanonika ta' `/v1/models`** — blokk wieħed kontinwu raggruppat skont il-provider għal kull provider (combos mwaħħla l-ewwel), stabbli fuq kull sors tal-katalogu. → [Referenza tal-API](docs/reference/API_REFERENCE.md)
- **🗜️ Irwebbit tal-kompressjoni** — gwardja kontra l-inflazzjoni mixgħula b'mod predefinit, pakketti Caveman għal DE / FR / JA + Ċiniż (wényán), filtri RTK għal Gradle & .NET. → [Kompressjoni](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Spiża onesta b'rata fissa** — il-providers ta' abbonament / pjan ta' kodifikazzjoni jidhru **$0** fl-analitika tal-ispejjeż; il-baġit, il-kwota u r-rottar jibqgħu jistmaw. → [Referenza tal-API](docs/reference/API_REFERENCE.md)
- **⚖️ Rottar Quota-Share** — jaqsam il-kwota ta' kont kondiviż b'mod ġust fuq ċwievet pooled, b'konservazzjoni tax-xogħol sabiex il-porzjonijiet idle jitselfu. → [Gwida tar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Setup ta' CLI/aġent b'kmand wieħed** — 15-il kmand `setup-*` reġistrat; `omniroute run` jniedi 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` jappoġġa 11-il mira b'għażliet interattiva ta' provider+mudell u favoriti skont il-kuntest. → [Integrazzjonijiet CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Modalità remota** — imexxi OmniRoute remot b'tokens b'ambitu limitat (`connect` / `contexts` / `tokens`) + għajnuna OAuth `antigravity` għal installazzjonijiet fuq VPS. → [Modalità Remota](docs/guides/REMOTE-MODE.md)
- **🧭 Rottar awtomatiku aktar intelliġenti** — combos `auto/:`, **Fusion** (pannell ta' mudelli + ġudikant), rottar konxju tal-kompitu, u overrides ta' mudell / modalità / baġit f'USD għal kull talba. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Kompressjoni pluggable** — 12-il magna komponibbli + Compression Studios: LLMLingua-2, Ultra b'żewġ livelli, omniglyph, gate ta' fidelity għal kull pass, GCF v3.2, u editur bi tkaxkir u rriordnar. → [Kompressjoni](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Dekriptar MITM trasparenti (TPROXY)** — aqbad CLIs li jinjuraw il-varjabbli ambjentali tal-proxy, b'CA għal kull SNI + installatur tat-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 fi każ ta' cache-HIT, u kwoti ta' nefqa f'USD skont iċ-ċavetta. → [Referenza tal-API](docs/reference/API_REFERENCE.md)
- **🧠 Memorja li tikkontrolla** — mitfija b'mod predefinit, kwantizzazzjoni opt-in ta' vetturi int8 + decay bit-tip, u `x-omniroute-no-memory` għal kull talba. → [Memorja](docs/frameworks/MEMORY.md)
- **🛡️ Sigurtà** — gwardja kontra l-injezzjoni ta' prompts fuq kull rotta LLM (suite ta' red team), guardrail opt-in għall-masking ta' kredenzjali (iħabbi ċwievet/sigrieti tal-API li nixxew fiż-żewġ direzzjonijiet), tfittxija tal-web b'xejn b'DuckDuckGo bħala l-aħħar għażla, u gate tal-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) jikkomplew il-wiċċ tal-midja. → [Referenza tal-API](docs/reference/API_REFERENCE.md)
- **🎨 Ġenerazzjoni ta' immaġni / vidjo / awdjo** — API waħda għall-midja: vidjo ta' xAI Grok Imagine & Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, u providers tad-diskors bħal ElevenLabs. → [Referenza tal-API](docs/reference/API_REFERENCE.md)
- **🌍 Użu u operazzjonijiet** — `basePath` għar-reverse-proxy, sejbien awtomatiku tal-lingwa tal-browser, intraċċar tal-apparat skont iċ-ċavetta, trust MITM mingħajr root, u lokalizzazzjoni zh-TW. → [Ambjent](docs/reference/ENVIRONMENT.md)
- **🤝 Aktar providers u aġenti** — aġenti fil-cloud (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) b'login mill-browser + OAuth, karta ta' klassi l-ewwel għal Ollama, Claude Opus 5 & Sonnet 5, sħubija uffiċjali ma' Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… u **katalogu aġġornat ta' 375 provider**. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Trasparenza tar-rottar** — kull tweġiba ġġor header `X-OmniRoute-Decision` li jissemma l-istrateġija/provider/latenza li servieha, strateġija combo ġdida `cache-optimized` flimkien mal-fattur `cacheAffinity` ta' Auto-Combo jirrotaaw it-talbiet ripetuti lura lejn il-konnessjoni li żżomm il-prefiss fil-cache, u endpoint read-only `/v1/auto-combo/{channel}/candidates` jesponi l-pool ħaj ta' kandidati ta' kanal `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Prestazzjoni u infrastruttura lokali** — Redis lokali b'klikk waħda, deployers tar-relay Cloudflare Workers / Deno Deploy, Bifrost u Mux bħala servizzi inkorporati sorveljati. → [Servizzi Inkorporati](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Ukoll fil-kaxxa** — framework ta' plugins + marketplace, frameworks ta' skills Omni/Agent/GitHub, integrazzjoni tal-vault ta' Obsidian (22 għodda MCP), APIs Batch & Files kompatibbli ma' OpenAI, cache semantika tar-risposti, gamifikazzjoni b'leaderboards, skoperta ta' aġenti ACP (15-il aġent inkorporat), esportazzjoni skedata tal-logs lejn BigQuery, fan-out parallelu multi-mudell `auto/chaos`, pont għal bot Telegram, maniġer tal-verżjonijiet fl-app u klassifiki LMArena-ELO tal-fornituri b'xejn. → [Dokumentazzjoni](docs/README.md)
## 🤖 CLIs Kompatibbli u Aġenti tal-Kodifikazzjoni
> Konfigurazzjoni waħda — `http://localhost:20128/v1` — u **kull** IDE jew CLI tal-IA jaħdem b’mudelli bla ħlas u bi prezz baxx.
＋ jaħdem ukoll ma’ · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · kwalunkwe għodda kompatibbli ma’ OpenAI
📖 Konfigurazzjoni għal kull għodda għas-37 għodda kollha (27 CLI Code + 10 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin ta’ OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Ħaddem kwalunkwe CLI appoġġjata permezz ta’ OmniRoute bi kmand wieħed** — mingħajr ma jinkitbu fajls ta’ konfigurazzjoni,
il-kredenzjali jiddaħħlu għal kull proċess, u Qwen/Gemini jingħataw direttorju home iżolat u temporanju:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Jew agħżel il-fornitur+mudell b’mod interattiv u ikteb il-konfigurazzjoni tal-għodda stess:
omniroute configure codex # ukoll: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Kull kmand jirrispetta l-kuntest remot attiv (`omniroute connect `), `--dry-run`
juri minn qabel l-env/args eżatti mingħajr ma jeżegwixxihom, u `--api-key-env NAME` iżomm is-sigrieti barra
mill-istorja tax-shell tiegħek. → [Integrazzjonijiet tas-CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 Fornitur AI — 153 Immarkat B'xejn fil-Katalogu
> **375 fornitur reġistrat** fil-kollezzjonijiet kanoniċi ta' chat, media, tfittxija, lokali, cloud-agent u sistema, inklużi **153 li jġorru metadata ta' skoperta `hasFree: true`**. Ir-reġistru tal-mudelli chat jkopri **239 fornitur / 3,059 par distint fornitur-mudell / 1,475 ID ta' mudell grezz**; il-katalogu separat tal-baġit b'xejn għandu **467 ringiela għal kull mudell**, **34 pool rikorrenti** u **51 fornitur rikorrenti/bla ċavetta b'xejn għal dejjem**. Dawn huma denominatori differenti apposta; definizzjonijiet u kalkoli deduplikati skont il-pools jinsabu fir-[Referenza tal-Fornituri](docs/reference/PROVIDER_REFERENCE.md) u [Saffi 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 350+ oħra — kull ikonna tirriżolvi live mill-katalogu tal-fornituri tad-dashboard. 📖 [Referenza tal-Fornituri](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 B'xejn għal Dejjem — $0, bla karta
OpenCode Zen DeepSeek V4, Nemotron 3 Bla 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 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 bla limitu
Pollinations GPT, Llama, Claude Bla ċavetta meħtieġa
Cloudflare AI 50+ mudelli 10K neurons/jum
NVIDIA NIM GLM, MiniMax ~40 RPM b'xejn
Cerebras GLM 4.7, GPT-OSS Kreditu ta' $5 darba biss; karta meħtieġa
OpenRouter Mudelli :free +$10 → RPM ogħla
📖 Katalgu sħiħ li jinqara mill-magna → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Fejn Jaħdem OmniRoute — Kullimkien
> L-istess app, il-magna tiegħek, ir-regoli tiegħek. Minn installazzjoni globali b’npm sa **fuq il-mobile tiegħek** permezz ta’ Termux.
Pjattaforma
Installazzjoni
Punti ewlenin
📦 npm (globali)
npm install -g omniroute
Kmand wieħed, kwalunkwe OS
🐳 Docker
docker run … diegosouzapw/omniroute
Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)
npm run electron:build
Tieqa nattiva + system tray — Windows / macOS / Linux
🎩 Menu bar (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Jissorvelja u jaġġorna awtomatikament is-server — macOS
💪 ARM
arm64 nattiv
Raspberry Pi, servers ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Jaħdem fuq il-mobile tiegħek, 24/7, mingħajr root
📲 PWA
"Żid mal-Iskrin Prinċipali"
Skrin sħiħ, offline, jista’ jiġi installat mill-browser
🧩 Plugin ta’ OpenCode
@omniroute/opencode-provider
Integrazzjoni nattiva ma’ OpenCode
🤖 VS Code Copilot Chat
installa l-estensjoni OmniCopilot
Kull mudell ta’ OmniRoute fis-selettur nattiv ta’ Copilot Chat — stable u Insiders
### 🧩 Ġdid: OmniRoute ġewwa l-Copilot Chat nattiv ta’ VS Code
> L-ebda sidebar ġdida, l-ebda interfaċċa ġdida għaċ-chat — kull mudell li joffri OmniRoute jidher direttament
> fis-**selettur tal-mudelli ta’ Copilot Chat li diġà tuża**. Minn VS Code 1.122 ’il quddiem, il-mudelli tal-providers jaħdmu
> mingħajr sign-in ma’ GitHub jew abbonament għal Copilot — modalità ta’ aġent, sejħiet ta’ għodod u viżjoni,
> b’xejn.
Installa l-estensjoni **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, qabbadha
mas-server OmniRoute tiegħek (b’mod awtomatiku `localhost:20128`), imbagħad iftaħ Copilot Chat → is-selettur tal-mudelli
→ **Immaniġġja l-Mudelli…** → **OmniRoute**.
Minn ġewwa l-editur: iftaħ il-veduta **Extensions**, fittex **"OmniRoute"**, ikklikkja **Install**
— jaħdem bl-istess mod fiż-żewġ ħwienet. Il-kodiċi sors, l-issues u l-gwida għall-pubblikazzjoni jinsabu fuq
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Gwida għal VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — konfigurazzjoni, x’juri s-selettur, dashboard f’tab, soluzzjoni tal-problemi
### 🎩 Ġdid: OmniRouteTray — il-gateway tiegħek, jgħix fil-menu bar
> `omniroute serve` jaħdem l-aħjar meta jkun dejjem mixgħul. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> jibdlu f’app tal-menu bar għal macOS li tikkonfiguraha darba u tħalliha taħdem: jistartja s-server, iżommu jaħdem
> wara restarts, jaġġornah fuq il-post, u jqiegħed il-baġit tat-tokens tiegħek f’ħin reali klikk waħda biss ’il bogħod — **mingħajr
> tieqa tat-terminal li tibqa’ miftuħa, u mingħajr `npm install -g omniroute` li trid tibqa’ tieħu ħsiebu.**
Mibni b’[Tauri v2](https://v2.tauri.app/) (qalba Rust żgħira daqs żball ta’ approssimazzjoni), jiġi
bir-runtime iffirmat tiegħu stess ta’ Node 24 u jimmaniġġja installazzjoni ta’ OmniRoute proprjetà tal-app, għalhekk qatt ma jidħol f’kunflitt man-
`node`/`bun` globali tiegħek. Huwa **jaqsam il-konfigurazzjoni u d-database eżistenti tiegħek f’`~/.omniroute/`** — għalhekk huwa
l-istess OmniRoute li diġà tħaddem, sempliċement b’kappell. 🎩
X’jagħmel
Kif
🟢 Jissorvelja s-server
Iniedi omniroute serve, u jadotta istanza li diġà qed taħdem minflok jidduplikaha
📊 Użu f’ħin reali f’daqqa t’għajn
Bars tal-kwota tal-providers, limiti tas-sessjoni/ta’ kull ġimgħa ta’ Claude b’countdowns għar-reset, rendikont tal-ispejjeż ta’ 30 jum
🔄 Jaġġorna awtomatikament fuq il-post
Installazzjoni fi stadji, bdil atomiku, rollback f’każ ta’ falliment — dejjem fuq l-aktar rilaxx ġdid
🚀 Ibda mal-login
Tnedija fakultattiva mal-login; tray biss, mingħajr ikona fid-dock
🩺 Dijanjostika u logs
Dijanjostika bi klikk waħda u aċċess għal-logs tas-server
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Tippreferi tniżżel? Ikseb l-aħħar .dmgIr-Rilaxxi. Il-kodiċi sors, il-kwistjonijiet u d-dokumentazzjoni tal-bini
jinsabu fuq zoispag/omniroute-tray.
💛 Proġett tal-komunità minn @zoispag — mhuwiex rilaxx uffiċjali ta’ OmniRoute.
## 🔒 Privat u Lokali mill-Bidu
📖 [Awtorizzazzjoni](docs/architecture/AUTHZ_GUIDE.md) · [Miżuri ta' Protezzjoni](docs/security/GUARDRAILS.md) · [Konformità](docs/security/COMPLIANCE.md)
## 🔌 CLI Sħiħa + A2A u MCP
> Lil hinn mis-server, OmniRoute huwa **ċ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)
### 🤝 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)
## 🗜️ Iffranka 15–95% tat-Tokens — Awtomatikament
### 📖 Kif jaħdem — il-pipeline, l-arkitettura u l-matematika tal-iffrankar
Il-kombo stacked default tmexxi `RTK → Caveman`. Meta it-tnejn jaġixxu fuq l-istess payload tal-għodda/kuntest, l-iffrankar jikber b'mod kumulattiv:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Il-blokki tal-kodiċi, l-URLs, JSON u d-data strutturata huma **dejjem protetti** mill-magna tal-preservazzjoni.
> **Għaliex tuża ħafna tokens meta ftit jagħmlu x-xogħol?** Kull talba tgħaddi mill-pipeline tal-kompressjoni ta' OmniRoute **b'mod trasparenti** — mingħajr ebda bidla fil-klijent. Issa hija **stack ta' 12-il magna komponibbli** li jaħdmu skont l-ordni u jitħalltu u jitqabblu skont il-kombo tar-rottar — ibbażata 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).
### 🧱 L-stack tal-12-il magna
Il-magni jaħdmu skont l-ordni tal-pipeline; kull waħda tista' tiġi attivata jew diżattivata u kkunfigurata b'mod indipendenti għal kull kombo:
#
Magna
X'tagħmel
1
Session-Dedup
Tneħħi kontenut ripetut tul id-dawriet (indirizzat skont il-kontenut, bejn id-dawriet)
2
CCR
Tarxivja blokki kbar wara indikaturi ta' rkupru, li jinġabru fuq talba
3
Lite
Qtugħ tal-whitespace u tal-URLs tal-istampi (bażi b'latenza baxxa)
4
RTK
Filtrazzjoni intelliġenti tar-riżultati tal-għodod, deduplikazzjoni u qtugħ (konxja tal-kmandi)
Kompressjoni tal-proża bbażata fuq regoli (~65–75% fuq l-output)
9
Aggressive
Qosor + tqadim progressiv tad-dawriet il-qodma
10
LLMLingua-2
Qtugħ semantiku ML permezz ta' MobileBERT ONNX — sigur għall-kodiċi, async
11
Ultra
Qtugħ eweristiku tat-tokens b'livell opzjonali ta' mudell żgħir (SLM)
12
OmniGlyph
Kodifikazzjoni sperimentali tal-kuntest bħala stampa għal Claude Fable 5 imkejjel fuq il-konnessjoni diretta ta' Anthropic; it-transformers GPT 5.6 jibqgħu fail-closed sakemm jaslu l-irċevuti tal-fornitur. Erba' profili ta' kompressjoni (aggressive default, balanced, coding-safe, passthrough) (l-aktar aggressiv; opt-in)
Il-blokki tal-kodiċi, l-URLs u d-data strutturata huma **dejjem ippreservati** byte-perfect. **Presets ta' klikka waħda** jgħaqqdu l-magni:
Modalità
Iffrankar
L-aħjar għal
🪶 Lite
~15%
Default sigur li jibqa' dejjem attiv
🪨 Standard (Caveman)
~30%
Programmazzjoni ta' kuljum
⚡ Aggressive
~50%
Sessjonijiet twal bi ħafna għodod
🔥 Ultra
~75%
Iffrankar massimu
🧰 RTK
60–90%
Output ta' shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Prompts mħallta + logs tal-għodod
**Eżempju reali — modalità Standard:**
> **Qabel (69 tokens):** _"Ir-raġuni għaliex il-komponent React tiegħek qed jerġa' jirrendi hija x'aktarx li qed toħloq referenza ġdida ta' oġġett f'kull ċiklu ta' render. Meta tgħaddi oġġett inline bħala prop, il-komparazzjoni shallow ta' React tarah bħala oġġett differenti kull darba, li jwassal għal re-render. Nirrakkomanda li tuża useMemo biex timmemoizza l-oġġett."_
>
> **Wara (19 tokens):** _"Ref ġdida ta' oġġett f'kull render. Prop ta' oġġett inline = ref ġdida = re-render. Fih f'useMemo."_
>
> **L-istess tweġiba. 72% inqas tokens. Zero telf ta' preċiżjoni.** ✅
**Eżempju PT-BR — modalità [Troglodita](https://github.com/leninejunior/troglodita):**
> **Qabel (42 tokens):** _"Il-problema hija li l-komponent qed jagħmel re-render minħabba li qed tinħoloq referenza ġdida ta' oġġett f'kull ċiklu ta' render. Nirrakkomanda li tuża useMemo."_
>
> **Wara (12 tokens):** _"Re-render: ref ġdida f'kull ċiklu (oġġett inline rikreat mill-ġdid). Uża `useMemo`."_
>
> **L-istess risposta. ~70% inqas tokens. Il-preċiżjoni teknika intatta.** ✅
### 🎚️ Lil hinn mill-magni — stili tal-output, il-kontroll adattattiv u l-kontroll għal kull talba
It-12-il magna hawn fuq jinaqqsu dak li **jidħol**. Tliet saffi oħra jiffurmaw **kif**, **meta** u x'**joħroġ**:
- **🪄 Stili tal-Output** _(tmexxija fuq l-assi tal-output)_ — jinjetta struzzjonijiet deterministiċi u sikuri għall-cache li jiffurmaw ir-risposta; jistgħu jingħaqqdu, kull wieħed b'intensità `lite` / `full` / `ultra`. Biex iżżid stil huwa biżżejjed daħla ta' linja waħda fir-reġistru:
- **Prosa konċiża** — neħħi l-mili / l-artikli / il-lingwaġġ evażiv; żomm is-sustanza teknika eżatta.
- **Inqas kodiċi** — YAGNI ta' "senior dev għażżien": l-iżgħar bidla li taħdem, mingħajr scaffolding mhux mitlub.
- **Ponytail (senior dev għażżien)** — itla' s-sellum tal-YAGNI, sewwi l-kawża mill-għerq, l-iżgħar diff li jaħdem.
- **Għandi ADHD (l-azzjoni l-ewwel)** — l-azzjoni li jmiss tiġi l-ewwel, passi nnumrati, pass konkret wieħed li jmiss, mingħajr preambolu.
- **CJK konċiż (文言)** — stil Ċiniż klassiku ultra-konċiż (limitat għall-locale `zh`).
- **🎯 Baġit tal-kuntest adattattiv** _(il-kontroll gradwali)_ — minflok limitu wieħed ta' tokens mixgħul/mitfi, żid l-irħas u l-aktar magni mingħajr telf biss sakemm ikun meħtieġ biex **tiddaħħal fit-tieqa tal-kuntest tal-mudell**. Politika: `reserve-output` (default, konxja tal-mudell) · `percentage` · `absolute`. Modalità: `floor` (iggarantixxi li jidħol kollox) · `replace-autotrigger` (l-għażla espliċita tiegħek tirbaħ) · `off` (limitu legacy).
- **🎛️ Fejn titteħed id-deċiżjoni dwar il-kompressjoni** _(preċedenza, għolja → baxxa)_ — header `x-omniroute-compression` għal kull talba › override tal-kombo tar-rottar › profil attiv imsemmi › adattattiv / auto-trigger › default tal-pannell › mitfi. Il-pjan applikat jerġa' jidhir fil-header tar-risposta `X-OmniRoute-Compression: ; source=`.
Skatta awtomatikament skont limitu ta' tokens, ixgħel il-kontroll adattattiv, waħħal profil imsemmi, issettja għal darba għal talba waħda, jew assenja pipeline għal kull kombo tar-rottar — skont x'jaqbel mat-tagħbija tax-xogħol. **Harness għall-evalwazzjoni** offline, opt-in (`npm run eval:compression`) jagħti punteġġ għall-fideltà 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 Mgħaġġel
**1) Installa u mexxi**
```bash
npm install -g omniroute
omniroute
```
> 💡 Tara `npm warn ERESOLVE` jew twissijiet ta' peer-dep? [Huma bla ħsara](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Qed tuża npm 11 jew aktar reċenti?** npm jista' jimblokka l-iskripts taċ-ċiklu tal-ħajja tal-pakketti sakemm ma jkunux permessi. Il-`postinstall` ta' OmniRoute (`node scripts/build/postinstall.mjs`) huwa meħtieġ biex jipprepara l-fajls native tar-runtime. Ippermetti l-pakketti msemmija fit-twissija ta' npm meta tkun qed tinstalla globalment. Għas-sett ta' pakketti rrappurtat minn OmniRoute 3.8.53:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Biex terġa' tuża din l-allowlist għal installazzjonijiet globali futuri, kkonfiguraha darba, u mbagħad installa bħas-soltu:
>
> ```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 rilaxx u ieħor; jekk npm jirrapporta lista differenti, uża l-ismijiet tal-pakketti minn dik it-twissija. Li tippermetti pakkett tfisser li l-iskripts tal-installazzjoni tiegħu jistgħu jimxu.
> **Qed tuża Gemini Web jew fornitur ieħor ibbażat fuq cookies tal-web?** 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 lejn fornitur tal-web.
Dashboard fuq `http://localhost:20128` · API fuq `http://localhost:20128/v1`.
**2) Qabbad fornitur eliġibbli billi tuża l-kont tiegħek stess**
Dashboard → **Providers** → agħżel fornitur li t-termini u l-kwota attwali tiegħu jaqblu mal-każ tal-użu tiegħek → żid iċ-ċavetta API tiegħu jew ikkompleta l-fluss tal-kont tiegħu. Il-livelli b'xejn jistgħu jitolbu reġistrazzjoni, approvazzjoni, jew metodu ta' ħlas. Irrevedi l-[Gwida dwar il-Livelli b'Xejn](docs/getting-started/FREE-TIERS-GUIDE.md); id-disponibbiltà mingħajr ċavetta mhix garantita, u l-fornituri mmarkati `tos: avoid` huma esklużi minn `auto` awtomatikament.
**3) Indirizza l-għodda tal-ikkowdjar tiegħek**
```txt
Base URL: http://localhost:20128/v1
API Key: [ikkopja minn Dashboard → Endpoints]
Model: auto (jagħmel ir-rottar bejn konnessjonijiet eliġibbli — jew agħżel fornitur/mudell)
```
**4) Ivverifika li qed jaħdem**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Għandek tara l-mudelli konnessi tiegħek fil-lista. 🎉 Dak kollox — ibda kkowdja, u OmniRoute jagħmel ir-rottar awtomatiku u l-fallback għalik.
Jekk il-klijent tiegħek ma jistax jibgħat headers personalizzati, OmniRoute jesponi wkoll aliases ta' kompatibbiltà b'tokens:
```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 dawn biss għal klijenti li ma jistgħux inqabbdu `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.
Strateġija ta' kopertura tat-test għal 56,000+ dikjarazzjoni statika ta' test f'7,800+ fajl ta' test imsegwi
# ⭐ L-Aqwa Kollaboraturi
> OmniRoute huwa ffurmat minn komunità ta' sors miftuħ passjonata. Dawn l-individwi taw kontribuzzjonijiet eċċezzjonali li jaffettwaw direttament il-kwalità, l-istabbiltà u l-firxa tal-proġett. **Grazzi.**
### Kollaboraturi esterni skont il-pull requests magħquda
Ċensiment meħud nhar il-2026-10-18 15:09:09 UTC bit-tip live ta' release/v3.8.52656f01cb43. Iċ-ċensiment paginat tal-GitHub GraphQL jikkonta 9,191 PR magħquda: 3,834 mis-sid tar-repożitorju, 229 minn Dependabot, 6 minn bots/apps oħrajn, u 5,122 PR esterni minn 835 kollaboratur distint. "Linji mibdula" tfisser ż-żidiet + it-tħassir tal-GitHub u tinkludi fajls ġenerati, lockfiles, katalgi, traduzzjonijiet u dokumentazzjoni; hija churn, mhux LOC miktuba. 49 PR jirrappurtaw diffs tal-GitHub b'aktar minn 500,000 linja (pereżempju #13399, żieda ta' provider wieħed biss, telenka 2,347 fajl mibdul), li jinflixxaw diversi totali hawn fuq. Il-parelli jiġu kklassifikati flimkien.
### Commits attribwiti lil GitHub
Iċċekkjat mill-ġdid fil-2026-10-18 14:44:45 UTC: commits attribwiti minn GitHub kif irrappurtati mill-API tal-Contributors tar-repożitorju għall-branch default release/v3.8.52. L-API rritornat 849 identità (429 utent, 2 bots, 418 anonimi); din it-tabella teskludi l-mantenitur, il-bots u l-identitajiet anonimi, u żżomm it-ties fil-klassifika. Hija distinta kemm mill-klassifika tal-PRs immergedjati ta' hawn fuq, kif ukoll miċ-ċensiment tal-Git-metadata ta' hawn taħt.
> 🙏 Il-funzionalitajiet, it-tiswijiet ta' bugs, u t-titjib fl-infrastruttura ta' dawn il-kontributuri huma **parti essenzjali** minn dak li jagħmel lil OmniRoute affidabbli u sinjur bil-funzionalitajiet. Kull pull request, kull test case, u kull fajl ta' traduzzjoni i18n jgħodd. L-open source 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.
… 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.
## 👥 900+ Kontributur
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Awditjat fit-2026-10-18 fuq l-aħħar punt attiv ta’ release/v3.8.52, ad160ab2d1 (6,826 commit): 993 identità umana normalizzata ta’ Git — 707 jidhru bħala awturi ta’ commit (inkluż il-mantenitur) u 286 jidhru biss f’trailers espliċiti Co-authored-by. Iċ-ċensiment japplika .mailmap, iqabbel l-indirizzi tal-email mingħajr ma jqis jekk l-ittri humiex kbar jew żgħar, jgħaqqad l-indirizzi numeriċi u ordinarji noreply ta’ GitHub biss meta dawn jikkodifikaw l-istess handle, jeskludi 26 identità ta’ bot/aġent/servizz/placeholder, u ma jgħaqqadx indirizzi tal-email ordinarji sempliċement għax l-ismijiet murija tagħhom jaqblu. L-awditu tal-2026-08-24 ippubblika 639; meta dan il-metodu reġa’ tħaddem fuq il-bażi ta’ dak l-awditu, ac02c5b42f, ir-riżultat kien 619, għalhekk iż-żieda ġejja minn kontributuri ġodda, mhux minn metodu inqas strett.
### Kif Tikkontribwixxi
1. Oħloq fork tar-repożitorju
2. Oħloq branch mill-aħħar punt **attiv** ta’ `release/vX.Y.Z` (mhux minn `main`) — ara [Mudell tal-Branches u tar-Rilaxxi](docs/ops/BRANCHING_MODEL.md)
3. Oħloq il-feature branch tiegħek (`git checkout -b feat/amazing-feature`)
4. Agħmel commit tal-bidliet tiegħek (`git commit -m 'feat: add amazing feature'`)
5. Ibgħat il-branch (`git push origin feat/amazing-feature`)
6. Iftaħ Pull Request b’**base = dak il-branch `release/vX.Y.Z`**
Ara [CONTRIBUTING.md](CONTRIBUTING.md) għal linji gwida dettaljati.
### Kif Toħroġ Verżjoni Ġdida
```bash
# Oħloq rilaxx — npm publish iseħħ awtomatikament
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Stilel
## 🌍 StarMapper
## 🙏 Ringrazzjamenti
OmniRoute jinsab fuq spallejn il-ġganti. Beda bħala fork ta’ **[9router](https://github.com/decolua/9router)** u port għal TypeScript tal-proġett Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — u minn hemm ’il quddiem, kull subsistema hawn taħt kienet ispirata minn proġett open-source li wasal hemm qabilna. Kull wieħed minnhom sawwar parti konkreta minn OmniRoute. Dan huwa r-ringrazzjament tagħna lilhom kollha. 🙏
> ⭐ l-għadd ta’ stars ġie vverifikat permezz tal-API REST ta’ GitHub fit-18 ta’ Ottubru 2026 — agħtu star lil dawn il-proġetti. L-għadd huwa snapshot eżatt b’data speċifika u naturalment se jinbidel.
### 🧬 Nisel u gateway
Il-gateway tal-AI li s-sett tad-data pubbliku tiegħu dwar il-prezzijiet jalimenta s-sinkronizzazzjoni tagħna tat-traċċar tal-ispejjeż, u li l-mudell tiegħu għan-normalizzazzjoni tal-fornituri informa r-routing tagħna.
Sors MIT adattat fil-bridge inkorporat ChatGPT Web → Codex Responses, inklużi adapters għas-sessjonijiet tal-browser, l-iffrejmjar tar-rispons, l-użu u t-tiftix fuq il-web.
Valuri predefiniti għat-trasformazzjoni kompatibbli ma’ Claude Code u mġiba tal-headers tal-kontijiet, iġġeneralizzati fil-bridge ta’ OmniRoute mmexxi mill-konfigurazzjoni.
Il-mappings tiegħu tal-mudelli Grok, il-ġeneratur Statsig b’TypeError falz, il-valuri predefiniti għat-talbiet u l-apparati, u l-proċessur tar-rispons NDJSON ġew adattati b’mod sostanzjali fl-eżekutur Grok Web ta’ OmniRoute.
Is-sors prinċipali tal-kodiċi tranżittiv wara grok2api-merged; l-implimentazzjonijiet tiegħu tal-mudell, tal-header, tal-payload, ta’ Statsig u tal-proċessur huma ppreservati fin-nisel ta’ Grok Web.
Is-sors MIT sottostanti għall-payload ta’ Grok u għall-valuri predefiniti tal-apparat, għall-ġeneratur Statsig, u għall-proċessur result.response mgħoddi permezz ta’ TQZHR u grok2api-merged.
Sors tranżittiv ikkreditat minn grok2api-merged għas-saff tal-proxy pool tiegħu; OmniRoute jippreserva dak l-avviż dwar in-nisel, iżda ma jsostnix li ttrasferixxa proxy pool fl-eżekutur limitat tiegħu għal Grok Web.
L-implimentazzjoni oriġinali ta’ Grok Web ikkonsultat id-disinn upstream tagħha għall-HTTP/browser; il-perkors HTTP dirett tagħha ġej minn GrokProxy, għalhekk ma ssir l-ebda pretensjoni ta’ port indipendenti tal-kodiċi.
### 🗜️ Kompressjoni tal-kuntest u tat-tokens — magni
Il-proġett virali "għaliex tuża ħafna tokens meta ftit tokens jagħmlu x-xogħol" — il-filosofija tiegħu ta’ diskors tal-bniedem tal-għerien tħaddem il-modalità standard tagħna ta’ kompressjoni u aktar minn 30 regola għat-tneħħija ta’ kliem żejjed u għall-kondensazzjoni.
Riċerka dwar il-kompressjoni tal-prompts (LLMLingua / LLMLingua-2) — ispirat il-magna llmlingua tagħna, li hija asinkronika, sikura għall-kodiċi u tibqa’ taħdem mingħajr kompressjoni f’każ ta’ ħsara.
L-istil tiegħu ta’ tweġibiet li jqiegħed l-azzjoni l-ewwel u li huwa adattat għall-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
Notazzjoni tal-Oġġetti Orjentata lejn it-Tokens — il-mudell kolonnari tiegħu, b’intestatura u ringieli, sawwar l-istadju tagħna ta’ kompattazzjoni tabulari.
Kompattazzjoni tal-output ta’ Bash + profili MCP — ispirat id-dixxiplina tagħna biex nabbandunaw il-kompressjoni meta ma tkunx ta’ benefiċċju u t-tnaqqis tal-manifest tal-għodod MCP.
Kompressjoni tal-output konxja mill-kontenut u speċifika għal kull tip ta’ fajl, b’abbandun konxju mill-fallimenti — ikkonfermat id-dispaċċ skont it-tip u l-qbiż meta l-gwadann ikun inqas mill-minimu tagħna.
"Sib it-tokens fantażma" — il-mudell tiegħu ta’ trasferiment estern + handle li jista’ jiġi rkuprat informa l-mod kif naħsbu dwar it-trasferiment estern CCR.
JSON kolonnari f’Rust + irkupru indirizzat skont il-kontenut + deduplikazzjoni bejn il-messaġġi — ikkonfermat id-disinn tal-magni headroom/ccr/session-dedup tagħna u l-invarjant stabbli fil-cache li "l-forma kkompressata hija indipendenti mill-pożizzjoni".
Sett ta’ għodod għall-API tal-Kompilatur TypeScript — ispirat it-tneħħija tal-kummenti tagħna bbażata fuq parser, li tippreserva l-litterali ta’ strings, templates u espressjonijiet regolari.
L-interċettazzjoni/analiżi MITM tat-traffiku bejn l-assistent tal-ipprogrammar ↔ LLM għenet biex jiġu definiti r-rekwiżiti bikrija tat-Traffic Inspector. Erba’ moduli derivati qabel — l-għaqda ta’ SSE, in-normalizzazzjoni tal-konverżazzjonijiet, il-ħabi tas-sigrieti u s-sanitizzazzjoni tal-headers — ġew sostitwiti b’implimentazzjonijiet clean-room indipendenti bbażati fuq standards pubbliċi tal-protokolli. Iż-żewġ superfiċji host-passthrough (passthrough.ts u _internal/bypass.cjs) jibqgħu implimentazzjonijiet interni ta’ OmniRoute kklassifikati b’mod indipendenti; ma ġewx miktuba mill-ġdid bħala parti minn dik is-sostituzzjoni.
Ir-routing trasparenti tal-proxy għal kull proċess — ispira t-tneħħija MITM tagħna reżistenti għall-kraxxijiet, it-timeouts tal-inattività tas-sockets, l-attribuzzjoni tal-proċessi permezz ta’ /proc u l-qbid TPROXY.
Lista kkurata ta’ libreriji siguri b’mod awtomatiku li tiggwida l-għażliet tas-sigurtà tagħna (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ispira d-deduplikazzjoni tat-talbiet, fallback ta’ emerġenza mingħajr spejjeż, strateġiji Auto-Combo li jistgħu jiġu pplaggjati u l-klassifikazzjoni multilingwi tal-intenzjonijiet.
Ir-rimmappjar tal-mudelli tiegħu konxju mill-kont, il-validazzjoni tal-path tal-eżekutibbli u l-imġiba tat-tikketti tal-pjan għenu biex jiġi definit ir-runtime Antigravity ta’ OmniRoute.
> Sommarju animat tal-paġna live `/dashboard/free-tiers`. Metodoloġija sħiħa (dedupe tal-pools, livelli ta' krediti, termini tal-fornituri): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Dawn il-figuri jiġu awditjati mill-ġdid kull ġimaghtejn skont il-katalogu live u **jimxiwu fiż-żewġ direzzjonijiet** — fornitur itemm livell b'xejn u n-numru jinżel; wieħed ġdid jasal u jitla'. Nippubblikaw dak li l-katalogu verament jikkalkula, qatt l-aħjar każ arrotondat 'il fuq.
```bash
# Wara li tkun qabbadt fornitur, ikkopja l-key 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 tista' ma jkollha l-ebda mira eliġibbli mingħajr key, u fornitur mingħajr key jista' jirrifjuta klijenti ta' partijiet terzi. B'mod standard, fornituri mmarkati `tos: avoid`, inkluż Kiro, huma esklużi mill-irrottar awtomatiku; li tqabbad kont ma jirrimpjazzax dak is-setting. Ara l-[Gwida dwar is-Saffi B'xejn](docs/getting-started/FREE-TIERS-GUIDE.md) qabel ma tagħżel fornitur.
📦 Skripts ta' quickstart kopja-u-pejst għal **Python, Node.js, PHP, u cURL** → [`examples/quickstart/`](examples/quickstart/)
> **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:
📖 [Magna Auto-Combo](docs/routing/AUTO-COMBO.md) · [Gwida għar-Reżiljenza](docs/architecture/RESILIENCE_GUIDE.md)
📊 Metodoloġija sħiħa & dettalji għal kull karatteristika mqabbla ma' 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Ċavetta (każwali): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix biex tikkopja u twaħħal:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Awtorizzazzjoni](docs/architecture/AUTHZ_GUIDE.md) · [Miżuri ta' Protezzjoni](docs/security/GUARDRAILS.md) · [Konformità](docs/security/COMPLIANCE.md)
Il-kombo stacked default tmexxi `RTK → Caveman`. Meta it-tnejn jaġixxu fuq l-istess payload tal-għodda/kuntest, l-iffrankar jikber b'mod kumulattiv:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Il-blokki tal-kodiċi, l-URLs, JSON u d-data strutturata huma **dejjem protetti** mill-magna tal-preservazzjoni.
> **Għaliex tuża ħafna tokens meta ftit jagħmlu x-xogħol?** Kull talba tgħaddi mill-pipeline tal-kompressjoni ta' OmniRoute **b'mod trasparenti** — mingħajr ebda bidla fil-klijent. Issa hija **stack ta' 12-il magna komponibbli** li jaħdmu skont l-ordni u jitħalltu u jitqabblu skont il-kombo tar-rottar — ibbażata 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).
### 🧱 L-stack tal-12-il magna
Il-magni jaħdmu skont l-ordni tal-pipeline; kull waħda tista' tiġi attivata jew diżattivata u kkunfigurata b'mod indipendenti għal kull kombo:
