mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-18 12:52:25 +03:00

Files

Diego Rodrigues de Sa e Souza b637350680 fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

1,104 mirrors rewritten over five passes of run-translation on the 22-source core set: the 14 sources edited since their translation, the 322 mirrors that were still English copies, and the frontmatter the old extractor leaked into the newer locales' bodies. The pipeline now caches per-`## `-section hashes and retranslates only changed sections, never reuses a section that is still English, rebuilds English-copy / leaked mirrors even when the source is unchanged, merges the state on save (parallel runs), and the drift gate (scoped to the core set) is blocking. Final audit: 0 stale, 0 English copies, 0 leaked frontmatter across 1,430 core mirrors.

⚠️ base-red inherited: #12732

2026-09-17 02:55:31 -03:00

docs

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CHANGELOG.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CLAUDE.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CODE_OF_CONDUCT.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CONTRIBUTING.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

GEMINI.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

llm.txt

fix(db): bound health scans and isolate native diagnostics (#13717 )

2026-09-16 12:59:45 -03:00

README.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

SECURITY.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

README.md

README (Italiano)

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

🚀 OmniRoute — Il gateway AI gratuito

OmniRoute — Non smettere mai di programmare. Ogni strumento AI → 359 provider — oltre 150 gratuiti — tramite un unico endpoint. Claude Code, Codex, Cursor, Cline, Copilot e Antigravity con Claude / GPT / Gemini GRATUITI e fallback automatico. La compressione combinata RTK + Caveman consente di risparmiare il 15–95% dei token (~89% in media): non raggiungere mai i limiti. 359 provider AI · oltre 150 piani gratuiti · ~1,47 miliardi di token gratuiti al mese · 19 strategie di routing · $0 per iniziare.

💰 ~1,47 mld di token gratuiti / mese

Combinare manualmente i piani gratuiti è complicato: decine di SDK, decine di limiti di utilizzo e nessuna idea di quante risorse siano effettivamente disponibili. OmniRoute cataloga 452 voci di piani gratuiti distribuite su 34 chiavi di pool ricorrenti e calcola il totale dei token a partire dai 16 pool con un budget mensile positivo pubblicato, più cinque limiti Groq per modello, eliminando i duplicati dovuti ai pool condivisi. Le quote accessibili solo dopo una verifica dell'identità regionale (attualmente: ModelScope) sono mostrate separatamente, +~6 mln dietro verifica dell'identità regionale, e non vengono mai incluse nel totale principale. Il risultato rimane visibile nella dashboard (/dashboard/free-tiers).

Scheda del budget dei piani gratuiti di OmniRoute: ~1,47 mld di token gratuiti stabili al mese, fino a ~2,07 mld nel primo mese grazie ai crediti di registrazione, provenienti da 34 chiavi di pool ricorrenti documentate che coprono 452 voci di piani gratuiti catalogate dietro un unico endpoint. Calcolo trasparente con deduplicazione dei pool: ogni pool condiviso viene conteggiato una sola volta, inclusi 16 pool ricorrenti con un budget mensile positivo di token pubblicato più cinque limiti Groq per modello; 13 provider sono contrassegnati come da evitare nel catalogo dei rischi legati ai termini, così puoi decidere autonomamente. La barra del budget include Mistral 1 mld, Nara 210 mln, LLM7 150 mln, Groq 30 mln (cinque limiti per modello) e pool più piccoli, oltre ai crediti di registrazione del primo mese e ai provider permanentemente gratuiti senza limite di token, mostrati separatamente affinché non gonfino mai il totale principale. Utilizzo e disponibilità residua in tempo reale su /dashboard/free-tiers.

Riepilogo animato della pagina aggiornata in tempo reale /dashboard/free-tiers. Metodologia completa (deduplicazione dei pool, livelli di credito, termini dei provider): docs/reference/FREE_TIERS.md.

_{Questi dati vengono verificati nuovamente ogni due settimane rispetto al catalogo aggiornato e possono variare in entrambe le direzioni: se un provider interrompe un piano gratuito, il numero diminuisce; se ne arriva uno nuovo, aumenta. Pubblichiamo ciò che il catalogo calcola realmente, mai una stima ottimistica arrotondata per eccesso.}

⭐ Metti una stella al repository se OMNIROUTE ti ha aiutato a risparmiare e a semplificare il tuo lavoro.

💬 Unisciti alla community

👋 Segui il manutentore per scoprire per primo nuovi provider, versioni e suggerimenti:

Domande, suggerimenti sui provider, roadmap e assistenza → Discord · Telegram · WhatsApp 🌍 Globale / 🇧🇷 Brasile / Portale

📈 Il gateway continua a crescere

	v3.8.49	v3.8.50	`v3.8.51+`
🌐 Provider	290	342	altri in arrivo
🧠 Modelli documentati	1185	1202	—
🖼️ Modality Bridge	—	🆕 vision	video
📡 Catalogo gratuito Radar	—	🆕 opt-in	—
⚖️ Scheduling quota-aware	—	—	🔭 prossimamente
📊 Telemetria delle quote	—	—	🔭 prossimamente

→ Roadmap — verso v3.9.0 LTS

🧩 Disponibile come

🚀 Inizia	🚀 Avvio rapido	📦 Installazione	🆓 Zero-config
💡 Scopri	💥 La promessa	🤔 Perché OmniRoute	🏆 Cosa lo distingue
⚙️ Funzionalità	🎯 Combo	🌐 Provider	🔌 CLI & MCP
	🗜️ Compressione	🖥️ Dove funziona	🔒 Privacy
👀 Guarda	🎬 In azione	✨ Novità	🤖 CLI compatibili
💚 Supporto	💚 Supporta / Dona	💬 Community	💖 Sponsor
📦 Progetto	🛠️ Stack tecnologico	📖 Documentazione	👥 Contributor

🌐 In 42 lingue

🆓 Funziona dal momento in cui lo installi — nessuna chiave, nessuna configurazione

Funziona dal momento in cui lo installi — configurazione zero. Tre passaggi: 1. Installa — npm i -g omniroute, il server si avvia su localhost:20128. 2. Indirizza il tuo strumento a http://localhost:20128/v1 — qualsiasi strumento compatibile con OpenAI (Claude Code, Cursor, Cline). 3. Risponde — chiama il modello auto per una risposta immediata, senza chiavi API, registrazione o configurazione. Il provider senza chiavi OpenCode Free è preconfigurato nella combinazione auto, quindi una nuova installazione risponde immediatamente.

# Nuova installazione, zero credenziali — `auto` funziona già:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{Preferisci uno specifico backend gratuito? Chiama direttamente oc/… (OpenCode Free). Poi passa ad auto e lascia che OmniRoute scelga.}

_{📦 Script di avvio rapido da copiare e incollare per Python, Node.js, PHP e cURL → examples/quickstart/}

💥 La promessa

🤔 Perché OmniRoute?

Flusso delle richieste di OmniRoute: il tuo IDE o la tua CLI (Claude Code, Cursor, Cline…) chiama un unico endpoint locale (http://localhost:20128/v1); lo Smart Router di OmniRoute (compressione RTK + Caveman, 19 strategie di instradamento, circuit breaker, mascheramento TLS, MCP, A2A, guardrail) può eseguire il fallback tra 4 livelli di provider finché rimane una destinazione idonea e integra — Livello 1 Abbonamento, Livello 2 Chiave API, Livello 3 Economico e Livello 4 Gratuito.

🤝 Supportato dai nostri amici dell'Open Source

Vuoi diventare un Open Source Friend? Queste sono le aziende che sostengono l'open source e aiutano OmniRoute a continuare a crescere — e dichiariamo pubblicamente dove viene usato ogni token che ci forniscono. Contatto: diegosouza.pw@outlook.com

Kimi
_{Moonshot AI} Grazie a Kimi (Moonshot AI), il nostro Open Source Friend fondatore, per il sostegno al progetto! Kimi è il laboratorio AI dietro le famiglie di modelli open-weight K2 e K3 — Kimi K3 offre una finestra di contesto da 1M token, vision nativa e capacità di coding di frontiera a una frazione del prezzo dei modelli chiusi, e funziona subito con Claude Code, Codex e ogni strumento di coding supportato da OmniRoute.

Cosa rende possibile il supporto di Kimi: i crediti API di Kimi alimentano la pipeline di release validata dall'AI di OmniRoute — la fase merge validation powered by Kimi K3 che esamina ogni pull request prima del rilascio — oltre allo sviluppo quotidiano delle funzionalità. Il supporto Kimi di prima classe è disponibile su entrambi i canali: la Kimi API diretta (kimi-k3) e il piano di coding Kimi Code (OAuth e API key). OmniRoute è anche il primo progetto open source brasiliano nel programma di supporto di Kimi. Ottieni una Kimi API key con il 15% di crediti extra →

Cheaper Inference
_{cheaperinference.com} Grazie a Cheaper Inference, un Open Source Friend di OmniRoute, per il sostegno al progetto! Cheaper Inference è un gateway ordinato per costo che rivende 42 modelli di frontiera — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok e MiniMax — dietro un unico endpoint compatibile con OpenAI, instradando ogni richiesta verso il provider idoneo più economico senza mai addebitare più del prezzo di listino del produttore del modello.

Supporto di prima classe in OmniRoute: Chat Completions, endpoint nativo /v1/responses, vision, tool calling e 3 modelli immagine (grok-imagine, nano-banana-pro, nano-banana-2, raggiungibili come cheaperinference/<model>). Ottieni una API key →

_{I link contrassegnati con aff=omniroute sono link partner. Finanziano il progetto senza costi aggiuntivi per te.}

_{🎟️ Promo affiliati — coupon gratuiti di registrazione da provider che non sponsorizziamo (clicca per espandere)}

_{Questa sezione contiene soltanto codici referral/coupon. Le partnership sponsorizzate sono riportate sopra in 🤝 Supportato dai nostri amici dell'Open Source. OmniRoute non ha sponsorizzazioni o partnership con i provider elencati qui: sono coupon pubblici utilizzabili da chiunque.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — registrazione affiliata · $100 di crediti gratuiti alla registrazione (server gratuito, aspettati una latenza maggiore — ideale per test, non per produzione). Supporto di prima classe in OmniRoute dalla v3.8.50: Chat Completions, formato wire compatibile con Anthropic e percorso compatibile con OpenAI. I modelli disponibili includono claude-opus-4-8, claude-opus-5, gpt-5.6-sol e altri. Ottieni i tuoi $100 →}

_{⚠️ Link affiliato — OmniRoute non ha sponsorizzazioni o partnership con questo provider.}

_{Conosci un altro provider con un generoso coupon gratuito di registrazione utile agli utenti OmniRoute? Apri una issue e lo aggiungeremo qui.}

🎯 Combo — La funzionalità di punta

Tutte le 19 strategie di routing delle combo animate — una scheda per strategia: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Consulta la tabella seguente per capire cosa fa ciascuna.

Una combo è una catena di modelli tra cui OmniRoute instrada le richieste automaticamente. La quota finisce, un provider fallisce o i costi aumentano: la combo passa silenziosamente al modello successivo. È questo che rende OmniRoute resistente ai guasti. 🛡️

⚡ Zero-config — usa semplicemente `auto`

Non devi creare nessuna combo. Imposta il modello su auto (o una sua variante) e OmniRoute costruisce una combo virtuale a partire dai provider collegati, assegnando i punteggi in tempo reale:

ID modello	Cosa ottimizza
`auto`	🎯 Predefinito bilanciato (LKGP — resta sull'ultimo provider valido)
`auto/coding`	🧑‍💻 Pesi orientati prima alla qualità per la generazione di codice
`auto/fast`	⚡ Prima la latenza più bassa
`auto/cheap`	💰 Prima il costo per token più basso
`auto/offline`	🔋 Prima il maggiore margine di quota / rate limit
`auto/smart`	🔭 Prima la qualità + 10% di esplorazione per scoprire modelli migliori

🔀 Oppure creane una tua — 19 strategie di routing

Tutte e 19 le strategie — combinabili liberamente per ogni passaggio della combo:

#	Strategia	Cosa fa
1	`priority`	Lista ordinata con priorità al primo target — esaurisce ciascuno prima di passare al successivo 🥇
2	`fill-first`	Usa completamente la quota di ogni target prima di passare oltre
3	`weighted`	Scelta casuale pesata in base al peso assegnato a ogni target
4	`round-robin`	Scorre ciclicamente i target in ordine
5	`p2c`	Bilanciamento casuale del carico Power-of-Two-Choices
6	`least-used`	Sceglie il target con il carico corrente più basso
7	`random`	Scelta casuale uniforme (con deduplicazione)
8	`strict-random`	Casuale senza deduplicare le ripetizioni 🎲
9	`cost-optimized`	Riduce al minimo il costo per richiesta usando i prezzi live del catalogo 💸
10	`headroom`	Sceglie il target con la maggiore quota residua
11	`reset-window`	Preferisce il target la cui finestra di quota si resetta prima
12	`reset-aware`	Ordina in base al reset della quota — prima le finestre più brevi 📊
13	`context-relay`	Passa il contesto tra i target nelle conversazioni lunghe 🧠
14	`context-optimized`	Sceglie il target più adatto alla dimensione corrente del contesto
15	`cache-optimized`	Fissa ogni prefisso di prompt riutilizzabile allo stesso account — massimizza gli hit della prompt cache 🎯
16	`lkgp`	Last-Known-Good Path — resta sull'ultimo target che ha risposto correttamente
17	`auto`	Punteggio live su 14 fattori per ogni connessione 🤖
18	`fusion`	Invia la richiesta a un gruppo di modelli + un giudice sintetizza una sola risposta 🧬
19	`pipeline`	Concatena i passaggi — l'output di ogni target alimenta il successivo 🔗

_{Il motore Auto-Combo valuta ogni candidato su 14 fattori (salute, quota, costo, latenza, tasso di successo, freschezza…) — consulta docs/routing/AUTO-COMBO.md.}

🧱 Resilienza integrata (3 livelli indipendenti)

Resilienza di OmniRoute — 3 livelli indipendenti e autoriparanti, ciascuno dedicato al guasto corretto. Livello 1 circuit breaker del provider (intero provider): scatta solo su 408/5xx, soglie OAuth 10× / API-key 15× / locale 2×, reset dopo 60s/30s/15s con una sonda HALF-OPEN, recupero lazy; mentre è OPEN la combo passa al provider successivo. Livello 2 cooldown della connessione (una chiave/account): base 5s OAuth / 3s API-key, backoff esponenziale ×2 con protezione anti-thundering-herd, i 429 rispettano Retry-After, un successo azzera lo stato d'errore; una chiave in cooldown viene saltata mentre le altre continuano a servire. Livello 3 lockout del modello (un solo modello): 429 per-modello, 404 locali o dinieghi di modalità bloccano solo quel modello, mai l'intera connessione. Gli stati terminali (bannato, scaduto, crediti esauriti) richiedono l'intervento dell'operatore e non sono cooldown.

_{📖 Motore Auto-Combo · Guida alla resilienza}

🏆 Cosa distingue OmniRoute

_{📊 Metodologia completa e dettagli per funzionalità rispetto a 9router, OpenRouter, CLIProxyAPI e LiteLLM → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md}

💚 Supporta OmniRoute

OmniRoute è distribuito con licenza MIT e mantenuto apertamente. Se ti fa risparmiare tempo o denaro, ecco come aiutarlo a restare indipendente — scegli ciò che preferisci. Le sponsorizzazioni non influenzano mai la priorità del routing: acquistano visibilità, non posizionamento.

⭐ Metti una stella alla repo	Gratis — aiuta davvero la visibilità	Dai una stella a OmniRoute
🐙 GitHub Sponsors	Una tantum o mensile · zero commissioni della piattaforma	github.com/sponsors/diegosouzapw
☕ Ko-fi	Mancia una tantum, senza registrazione per chi dona	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Piccolo gesto informale	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Ricorrente · non profit · open source	liberapay.com/diegosouzapw
🇧🇷 PIX (Brasile)	Istantaneo, senza commissioni	chiave e QR qui sotto
₿ Crypto	BTC · ETH · USDT-TRC20 · USDC-Solana	indirizzi qui sotto

🇧🇷 PIX — istantaneo, senza commissioni (Brasile)

Chiave (casuale): 5d865059-bc44-483a-962d-43ceb80126eb

Pix copia-e-cola:

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

₿ Crypto — BTC · ETH · USDT-TRC20 · USDC-Solana (clicca per espandere)

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

_{⚠️ Invia ogni moneta esclusivamente sulla rete indicata: inviarla sulla rete sbagliata può causare la perdita dei fondi.}

🐛 Hai trovato un bug o vuoi lasciare un feedback? Apri una Discussion.

Note per gli sviluppatori: il progetto può generare un file locale .env durante npm install/postinstall per comodità nello sviluppo. Questo file viene intenzionalmente ignorato tramite .gitignore (vedi .gitignore) e non deve mai essere incluso nei commit; se viene committato accidentalmente, ruota ogni secret esposto e rimuovi il file dalla cronologia. Consulta docs/DEVELOPER-ENVIRONMENT.md per le indicazioni sulla gestione dei file di ambiente locali e dei secret.

📡 OmniRoute Radar

Il valore principale dei tier gratuiti resta ~1,53 miliardi di token/mese, calcolato sul catalogo documentato con deduplicazione dei pool riportato sopra. I crediti temporanei di registrazione dei provider possono separatamente portare il primo mese a ~2,15 miliardi. Radar è un overlay opzionale e firmato del catalogo, pensato per chi vuole informazioni più aggiornate sulla disponibilità dei modelli gratuiti tra una release di OmniRoute e la successiva; il catalogo della community e tutte le funzionalità gratuite esistenti restano gratuiti.

I sostenitori possono ricevere il catalogo live e ulteriori opportunità offerte dai provider. Il relativo tetto separato e variabile è di circa 3 miliardi di token/mese al massimo, a seconda della disponibilità dei provider. Questo limite non è una garanzia: i provider possono modificare quote, requisiti, modelli o regioni in qualsiasi momento.

Radar è opt-in e usa soltanto richieste GET. Il client OmniRoute non carica prompt, traffico, configurazione dei provider, telemetria d'uso o lo stato locale di chiusura degli annunci. Dettagli sui requisiti e sul catalogo corrente su radar.omniroute.online/planos.

✨ Novità

Novità principali da v3.8.20 → v3.8.50. Cronologia completa in CHANGELOG.md.

🎛️ OmniConductor — delega A2A in ingresso alla tua flotta di agenti, skill Conductor nell'Agent Card e un pannello dashboard con chat vocale push-to-talk Faro. → A2A Server
🛂 Admission adattiva e protezione dal sovraccarico — le richieste chat pesanti vengono messe in coda invece di ricevere 503, con lease RPM rolling atomici per connessione. → Guida alla resilienza
🗂️ Ordinamento canonico di /v1/models — un blocco contiguo raggruppato per provider per ciascun provider (combo sempre in testa), stabile tra tutte le fonti del catalogo. → Riferimento API
🗜️ Rafforzamento della compressione — protezione dall'inflazione attiva per impostazione predefinita, pack Caveman per DE / FR / JA + cinese (wényán), filtri RTK per Gradle e .NET. → Compressione
💸 Costo flat-rate trasparente — i provider in abbonamento / coding plan risultano a $0 nelle analytics dei costi; budget, quote e routing continuano a fare stime. → Riferimento API
⚖️ Routing Quota-Share — divide equamente la quota di un account condiviso tra chiavi in pool, in modo work-conserving così le porzioni inattive vengono prestate. → Guida alla resilienza
🤖 Configurazione CLI/agente con un comando — setup-* configura oltre 12 strumenti di coding; omniroute run avvia 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) senza scrivere configurazioni; omniroute configure è un selettore interattivo provider+modello con preferiti per contesto. → Integrazioni CLI
🛰️ Modalità remota — controlla un OmniRoute remoto con token scoped (connect / contexts / tokens) + helper OAuth antigravity per installazioni VPS. → Modalità remota
🧭 Auto-routing più intelligente — combo auto/<category>:<tier>, Fusion (gruppo di modelli + giudice), routing task-aware, override per-request di modello / modalità / budget USD. → Auto-Combo
🗜️ Compressione pluggable — 12 motori componibili + Compression Studios: LLMLingua-2, Ultra a due livelli, omniglyph, fidelity gate per passaggio, GCF v3.2, editor drag-reorder. → Compressione
🕵️ Decrittazione MITM trasparente (TPROXY) — cattura le CLI che ignorano le variabili d'ambiente del proxy, con CA per-SNI + installer del trust store. → MITM/TPROXY
💸 Telemetria dei costi ovunque — header di costo/utilizzo X-OmniRoute-* su ogni endpoint, header del risparmio su cache HIT, quote di spesa USD per chiave. → Riferimento API
🧠 Memoria sotto il tuo controllo — disattivata per impostazione predefinita, quantizzazione vettoriale int8 opt-in + decadimento tipizzato, x-omniroute-no-memory per-request. → Memoria
🛡️ Sicurezza — guard contro la prompt injection su ogni route LLM (suite red-team), guardrail opzionale per il masking delle credenziali (oscura API key/secret trapelati in entrambe le direzioni), web search DuckDuckGo gratuita come ultima risorsa e gate di login OIDC opzionale per la dashboard (il login con password resta sempre disponibile). → Guardrail
🖼️ Nuovi endpoint — /v1/ocr (Mistral OCR) e /v1/audio/translations (stile Whisper) completano la superficie media. → Riferimento API
🎨 Generazione immagini / video / audio — una sola API per i media: xAI Grok Imagine e Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind e provider vocali come ElevenLabs. → Riferimento API
🌍 Deployment e operazioni — basePath del reverse proxy, rilevamento automatico della lingua del browser, tracking dei dispositivi per chiave, trust MITM senza root, localizzazione zh-TW. → Ambiente
🤝 Più provider e agenti — Cursor Cloud Agent, Grok Build (xAI) con login browser + OAuth, scheda Ollama di prima classe, Claude Opus 5 e Sonnet 5, partnership ufficiale Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… e un catalogo aggiornato di 350 provider. → Provider
📡 Trasparenza del routing — ogni risposta include un header X-OmniRoute-Decision con strategia/provider/latenza che l'ha servita; una nuova strategia combo cache-optimized + il fattore cacheAffinity di Auto-Combo riportano le richieste ripetute alla connessione che possiede il prefisso in cache; un endpoint read-only /v1/auto-combo/{channel}/candidates espone il pool di candidati live di un canale auto/*. → Auto-Combo
⚡ Prestazioni e infrastruttura locali — Redis locale con un clic, deployer relay Cloudflare Workers / Deno Deploy, Bifrost e Mux come servizi embedded supervisionati. → Servizi embedded

🤖 CLI e agenti di coding compatibili

Una sola configurazione — http://localhost:20128/v1 — e qualsiasi IDE o CLI AI può usare modelli gratuiti e a basso costo.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_{Agent Deck}

＋ funziona anche con · Kiro · Command Code · Antigravity · Windsurf · AMP · qualsiasi strumento compatibile con OpenAI

_{📖 Configurazione per ciascuno dei 34 strumenti (26 CLI Code + 8 CLI Agents) → docs/reference/CLI-TOOLS.md · 🧩 Plugin OpenCode → @omniroute/opencode-provider}

Avvia qualsiasi CLI supportata tramite OmniRoute con un solo comando — senza scrivere file di configurazione, con le credenziali iniettate per singolo processo e una home temporanea isolata per Qwen/Gemini:

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"

# Or pick provider+model interactively and write the tool's own config:
omniroute configure codex          # also: claude opencode qwen aider goose cline continue kilo

Ogni comando rispetta il contesto remoto attivo (omniroute connect <host>); --dry-run mostra in anteprima env/argomenti esatti senza eseguire nulla, mentre --api-key-env NAME evita che i segreti finiscano nella cronologia della shell. → Integrazioni CLI

🌐 352 provider di IA — 152 contrassegnati nel catalogo come gratuiti

352 provider registrati nelle raccolte canoniche di chat, contenuti multimediali, ricerca, servizi locali, agenti cloud e sistema, inclusi 152 con metadati di rilevamento hasFree: true. Il registro dei modelli di chat comprende 229 provider / 2.554 coppie provider-modello distinte / 1.283 ID modello grezzi; il catalogo separato delle quote gratuite contiene 443 righe per modello, 34 pool ricorrenti e 53 provider gratuiti per sempre, ricorrenti o senza chiave. Questi denominatori sono diversi per scelta progettuale; le definizioni e i calcoli con deduplicazione dei pool sono disponibili nel Riferimento dei provider e nei Piani gratuiti.

🏢 Tutti i principali laboratori — tramite un unico endpoint

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…e oltre 330 altri — ogni icona viene caricata in tempo reale dal catalogo dei provider della dashboard. 📖 Riferimento dei provider}

🆓 Gratis per sempre — $0, nessuna carta richiesta

OpenCode Zen _{DeepSeek V4, Nemotron 3 Nessun limite di token}	Kilo Code _{Router automatico, Tencent Hy3 Gratis per sempre}	Requesty _{GPT-OSS 120B, Nemotron Gratis per sempre}	SiliconFlow _{DeepSeek V3.2 / R1 Piano gratuito}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Gratis per sempre}	Baidu ERNIE _{ERNIE 4.0 Gratis per sempre}
Qoder AI _{Qwen3-Max, Kimi-K2 GRATIS senza limiti}	Pollinations _{GPT, Llama, Claude Nessuna chiave necessaria}	Cloudflare AI _{Più di 50 modelli 10K neuroni/giorno}	NVIDIA NIM _{GLM, MiniMax ~40 RPM gratis}	Cerebras _{GLM 4.7, GPT-OSS 1M token/giorno}	OpenRouter _{Modelli :free +$10 → RPM più elevati}

📖 Catalogo completo leggibile dalle macchine → docs/reference/PROVIDER_REFERENCE.md

🖥️ Dove gira OmniRoute — ovunque

La stessa app, sulla tua macchina, secondo le tue regole. Da un'installazione npm globale fino al tuo telefono tramite Termux.

Piattaforma	Installazione	Punti di forza
📦 npm (globale)	`npm install -g omniroute`	Un comando, qualsiasi OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Finestra nativa + system tray — Windows / macOS / Linux
💪 ARM	nativo `arm64`	Raspberry Pi, server ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Gira sul tuo telefono, 24/7, senza root
📲 PWA	"Aggiungi alla schermata Home"	Schermo intero, offline, installabile dal browser
🧩 Plugin OpenCode	`@omniroute/opencode-provider`	Integrazione nativa con OpenCode
🤖 VS Code Copilot Chat	installa l'estensione OmniCopilot	Tutti i modelli OmniRoute nel selettore nativo di Copilot Chat — Stable e Insiders
🛠️ Da sorgente	`npm install && npm run dev`	Modificalo e contribuisci

_{📖 Guida Docker · Desktop · Termux · PWA · OpenCode}

🧩 Novità: OmniRoute dentro il Copilot Chat nativo di VS Code

Nessuna nuova barra laterale, nessuna nuova UI di chat — ogni modello servito da OmniRoute compare direttamente nel selettore modelli di Copilot Chat che usi già. Da VS Code 1.122, i modelli dei provider funzionano senza accesso GitHub né abbonamento Copilot — modalità agent, tool calling e vision, gratuitamente.

Installa l'estensione OmniCopilot, collegala al tuo server OmniRoute (predefinito localhost:20128), poi apri Copilot Chat → selettore modelli → Manage Models… → OmniRoute.

Store	Link	Compatibile con
🧩 VS Code Marketplace	Installa →	VS Code — Stable e Insiders
🔓 Open VSX Registry	Installa →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Dall'editor: apri la vista Extensions, cerca "OmniRoute", fai clic su Install — funziona allo stesso modo su entrambi gli store. Sorgenti, issue e runbook di pubblicazione sono su diegosouzapw/OmniCopilot.

_{📖 Guida VS Code Copilot Chat — configurazione, contenuto del selettore, dashboard in una scheda, risoluzione dei problemi}

🔒 Privato e local-first

_{📖 Autorizzazione · Guardrail · Conformità}

🔌 CLI completa + A2A e MCP

Oltre al server, OmniRoute è una console completa da riga di comando con oltre 80 comandi, più protocolli agent aperti che permettono a un agent AI di gestirlo autonomamente.

⌨️ Una vera CLI (non solo `start`)

omniroute               # serve gateway + dashboard (port 20128)
omniroute chat          # interactive TUI chat client (slash: /model /combo /skill /memory)
omniroute setup         # guided first-run wizard
omniroute doctor        # diagnose providers, ports, native deps

🛰️ Modalità remota — esegui qui la CLI, OmniRoute su un VPS

OmniRoute gira su un server? Gestiscilo dal laptop con la stessa CLI. Accedi una volta con un token di accesso con scope; da quel momento ogni comando punta all'istanza remota.

omniroute connect 192.168.0.15            # password → scoped token, saved as a context
omniroute models list                     # ← runs against the REMOTE server
omniroute configure codex                 # ← picks a remote model, writes a local Codex profile
omniroute tokens create --name ci --scope read   # mint narrower tokens for other machines
omniroute contexts use default            # ← switch back to the local server

I token hanno scope read / write / admin; le route che avviano processi restano limitate al loopback. _{📖 Modalità remota}

Demo animata del terminale con la CLI OmniRoute — omniroute providers list, omniroute combo list, omniroute health — che scorre gli oltre 80 comandi disponibili: 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 …

🤝 Collega un agent — e controllerà OmniRoute stesso

Esponi OmniRoute tramite MCP, A2A, una REST API, webhook o una CLI remota — qualsiasi agent compatibile (o il tuo codice) ottiene accesso al gateway: routing, provider, combo, cache, compressione, memoria — in autonomia. Gli endpoint HTTP qui sotto sono serviti su http://localhost:20128.

Interfaccia	Endpoint / comando	A cosa serve
🧰 MCP (stdio)	`omniroute --mcp`	Collegamento a Claude Desktop, Cursor e qualsiasi client MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP remoto — 110 tool, 33 scope, audit trail completo
📡 MCP (SSE)	`/api/mcp/sse`	Trasporto MCP in streaming
🤝 A2A	`/.well-known/agent.json`	Agent-to-agent, JSON-RPC 2.0 + SSE, 6 skill
🌐 REST API	`/v1/*`	Compatibile con OpenAI — chat, embedding, immagini, audio, OCR
🔔 Webhook	`/api/webhooks`	Invia eventi (utilizzo, quota, errori, routing) al tuo URL
🛰️ CLI remota	`omniroute connect`	Gestisci un'istanza remota con token di accesso con scope

# Give Claude Code the full OmniRoute toolset over MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 MCP Server · A2A Server · Protocolli agent}

🗜️ Risparmia il 15–95% dei token — automaticamente

📖 Come funziona — pipeline, architettura e calcolo del risparmio

Pipeline di compressione OmniRoute: una richiesta client da 10.000 token attraversa 12 motori in cascata — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra, OmniGlyph — e raggiunge il provider con circa 1.080 token, con un risparmio fino al 95%. Codice, URL e JSON sono sempre preservati byte per byte.

La combinazione in cascata predefinita esegue RTK → Caveman. Quando entrambi intervengono sullo stesso payload di tool/contesto, i risparmi si compongono:

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

Blocchi di codice, URL, JSON e dati strutturati sono sempre protetti dal motore di preservazione.

Perché usare molti token quando ne bastano pochi? Ogni richiesta attraversa la pipeline di compressione di OmniRoute in modo trasparente — senza modifiche al client. Ora è una stack di 12 motori componibili eseguiti in ordine e combinabili per ciascun routing combo — basati anche su idee di RTK, Caveman (⭐ 90K+), LLMLingua-2 e Troglodita (PT-BR).

🧱 La stack di 12 motori

I motori vengono eseguiti nell'ordine della pipeline; ciascuno può essere attivato/disattivato e configurato indipendentemente per combo:

#	Motore	Cosa fa
1	Session-Dedup	Elimina contenuti ripetuti tra i turni (content-addressed, cross-turn)
2	CCR	Archivia blocchi grandi dietro marker di recupero, caricati su richiesta
3	Lite	Riduzione di spazi e URL immagine (baseline a bassa latenza)
4	RTK	Filtro intelligente dei risultati dei tool, deduplica e troncamento (consapevole del comando)
5	Responses Tool Output	Compressione JSON lossless-first + diagnostica limitata per output shell/patch/search/build (Responses API)
6	Headroom	Compattazione tabellare lossless di array JSON (~30%) tramite codec GCF incluso nel progetto
7	Relevance	Valutazione estrattiva delle frasi rispetto all'ultima richiesta dell'utente
8	Caveman	Compressione della prosa basata su regole (~65–75% sull'output)
9	Aggressive	Riepilogo + invecchiamento progressivo dei turni precedenti
10	LLMLingua-2	Pruning semantico ML tramite MobileBERT ONNX — code-safe, asincrono
11	Ultra	Pruning euristico dei token con livello opzionale basato su piccolo modello (SLM)
12	OmniGlyph	Codifica sperimentale del contesto come immagine per Claude Fable 5 misurato sul protocollo Anthropic diretto; i transformer GPT 5.6 restano fail-closed in attesa di ricevute del provider. Quattro profili di compressione (aggressive predefinito, balanced, coding-safe, passthrough) (il più aggressivo; opt-in)

Blocchi di codice, URL e dati strutturati sono sempre preservati byte per byte. I preset con un clic combinano i motori:

Modalità	Risparmio	Ideale per
🪶 Lite	~15%	Impostazione predefinita sicura sempre attiva
🪨 Standard (Caveman)	~30%	Coding quotidiano
⚡ Aggressive	~50%	Sessioni lunghe con molti tool
🔥 Ultra	~75%	Massimo risparmio
🧰 RTK	60–90%	Output di shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Prompt misti + log dei tool

Esempio reale — modalità Standard:

Prima (69 token): "The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."

Dopo (19 token): "New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."

Stessa risposta. 72% di token in meno. Nessuna perdita di accuratezza. ✅

Esempio PT-BR — modalità Troglodita:

Antes (42 tokens): "O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."

Depois (12 tokens): "Re-render: ref nova cada ciclo (objeto inline recriado). Usar useMemo."

Mesma resposta. ~70% menos tokens. Precisão técnica intacta. ✅

🎚️ Oltre i motori — output style, regolazione adattiva e controllo per richiesta

I 12 motori sopra riducono ciò che entra in input. Altri tre livelli definiscono come, quando e cosa esce in output:

🪄 Output Styles (controllo dell'output) — iniettano istruzioni deterministiche e cache-safe per modellare la risposta; sono combinabili, ciascuno con intensità lite / full / ultra. Aggiungere uno style richiede una sola voce nel registry:
- Terse prose — elimina riempitivi / articoli / esitazioni; mantiene esatto il contenuto tecnico.
- Less code — YAGNI da "senior dev pigro": modifica minima funzionante, nessuna infrastruttura non richiesta.
- Terse CJK (文言) — stile cinese classico ultra-conciso (limitato alla locale zh).
🎯 Adaptive context-budget (la regolazione) — invece di una singola soglia token on/off, aumenta gradualmente l'uso dei motori più economici e lossless solo quanto necessario per rientrare nella context window del modello. Policy: reserve-output (predefinita, model-aware) · percentage · absolute. Modalità: floor (garantisce il fit) · replace-autotrigger (vince la tua scelta esplicita) · off (soglia legacy).
🎛️ Dove viene decisa la compressione (precedenza, alta → bassa) — header per richiesta x-omniroute-compression › override del routing combo › profilo nominato attivo › adaptive / auto-trigger › impostazione predefinita del pannello › off. Il piano applicato viene restituito nell'header di risposta X-OmniRoute-Compression: <mode>; source=<source>.

Puoi attivare l'auto-trigger tramite soglia token, abilitare la regolazione adattiva, fissare un profilo nominato, impostare una scelta una tantum per richiesta oppure assegnare una pipeline a ciascun routing combo — scegli ciò che si adatta al carico di lavoro. Un eval harness offline opt-in (npm run eval:compression) misura fedeltà e risparmio su un corpus fissato prima di promuovere una modifica.

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

⚡ Avvio rapido

1) Installa e avvia

npm install -g omniroute
omniroute

💡 Vedi npm warn ERESOLVE o avvisi sulle peer dependency? Sono innocui.

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

2) Collega un provider GRATUITO (senza registrazione)

Dashboard → Providers → collega Kiro AI (Claude gratuito, ~50 crediti/mese per account) oppure OpenCode Free (nessuna autenticazione) → fatto.

3) Configura il tuo strumento di coding

Base URL: http://localhost:20128/v1
API Key:  [copy from Dashboard → Endpoints]
Model:    auto            (zero-config smart routing — or any provider/model)

4) Verifica che funzioni

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

Dovresti vedere elencati i modelli collegati. 🎉 Tutto qui — inizia a programmare: OmniRoute instrada automaticamente le richieste ed esegue il fallback quando serve.

Se il tuo client non può inviare header personalizzati, OmniRoute espone anche alias di compatibilità con token incorporato:

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

Usali solo con client che non possono aggiungere Authorization: Bearer .... L'autenticazione tramite header resta la modalità consigliata.

📦 Altri metodi di installazione — Docker, sorgente, pnpm, Arch

🐳 Docker

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

:latest segue la versione SemVer stabile pubblicata più alta. Non segue il branch git main. Per GitOps, fissa :X.Y.Z. Vedi Canali di release Docker. L'immagine imposta OMNIROUTE_MEMORY_MB=1024. È sufficiente per la dashboard e una chat leggera. I coding agent (POST /v1/responses da Claude Code, Codex, Grok, …) richiedono un heap V8 molto più grande, altrimenti il processo va in FATAL ERROR a ~12 GiB con due contesti lunghi sovrapposti. Dimensiona il container oltre l'heap (i buffer nativi si trovano fuori da V8):

Carico di lavoro	Heap (`-e OMNIROUTE_MEMORY_MB`)	Container (`--memory`)
Dashboard / chat leggera	`1024` (predefinito immagine)	≥2 g
Un coding agent	`8192`	≥10 g
Due `/v1/responses` lunghe simultanee	`10240`–`12288`	≥12–16 g

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

Tabella completa: Guida Docker — RAM di runtime.

Canale Docker pre-release: diegosouzapw/omniroute:next e diegosouzapw/omniroute:next-web seguono l'attuale branch release/v* predefinito. Questi tag mutabili sono destinati esclusivamente al test di fix non ancora rilasciati e non sono supportati in produzione. Vedi Canali di release Docker.

🥟 Bun

Sono supportati bun install standard e l'installazione globale (bun install -g omniroute) tramite rilevamento del runtime Bun:

bun:sqlite integrato: OmniRoute usa il driver integrato bun:sqlite quando gira con Bun, con fallback a better-sqlite3 su Node.js o a sql.js.
Selezione automatica del bundler Webpack: sviluppo (bun run dev) e build di produzione (bun run build) rilevano automaticamente Bun e disabilitano Turbopack a favore di Webpack per evitare incompatibilità dei binding V8 nativi.
Dockerfile Bun dedicato: Dockerfile.bun multi-stage per deployment di produzione nativi Bun (docker build -f Dockerfile.bun -t omniroute:bun .).

# Install and run with Bun
bun install
bun run dev

🛠️ Da sorgente

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Using Nix flakes
nix develop
npm run dev

# Or using devbox
devbox run npm run dev

📖 Guida Docker — profili Compose, Caddy HTTPS, tunnel Cloudflare.

🦭 Podman

# 1. Prepare the bind-mounted data directory
mkdir -p data

# 2. Linux + local rootless Podman only (never a remote Podman Machine client):
podman unshare chown 1000:1000 ./data

# 3. Set the runtime hint, build the local Compose image, and start
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build

Su macOS o Windows, Podman usa una Podman Machine remota: salta podman unshare e segui le indicazioni sui permessi della directory dati specifiche per topologia.

📖 Guida Podman — build Compose, Podman Machine e configurazione Quadlet Linux/systemd.

⚡ Installazione più rapida / leggera (salta la build nativa)

Il motore SQLite nativo (better-sqlite3) è una dipendenza opzionale, quindi un'installazione globale non si blocca mai per compilare da sorgente: usa un binario precompilato quando disponibile per la tua piattaforma/Node e altrimenti passa in modo trasparente a un motore pure-JS (node:sqlite su Node 22+, altrimenti sql.js WASM incluso) — senza richiedere strumenti di build.

Per saltare completamente il warm-up nativo post-installazione (CI, sistemi headless o macchine lente):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # CI=1 also skips it

Per installazioni più rapide preferisci pnpm (store content-addressed + hard link — vedi sopra). Per un runtime headless senza dashboard usa il profilo Docker base (sopra) oppure la guida Termux. CLI e dashboard web sono servite dallo stesso processo su una sola porta, quindi oggi non esiste un pacchetto separato solo CLI.

🎬 OmniRoute in azione

📹 Guide video

_{Dati di copertura social al 2026-08-17 · YT: 741 | TT: 137 | IG: 124 · Aggiornamento (giorni): YT 0 · TT 14 · IG 15}

🎬 #1 — Instagram
_{nick_saraev — 1,628,910 visualizzazioni}

🎬 #2 — YouTube
_{Vaibhav Sisinty — 373,084 visualizzazioni}

🎬 #3 — YouTube Shorts
_{Nick Automates — 207,714 visualizzazioni}

🎬 #4 — TikTok
_{milesreevesai — 620,400 visualizzazioni}

🎬 #5 — YouTube
_{Valency Labs — 135,974 visualizzazioni}

Classifica completa (v > 0, maggiore portata):

#1	#2	#3	#4	#5
nick_saraev — Instagram — 1,628,910	milesreevesai — TikTok — 620,400	Vaibhav Sisinty — YouTube — 373,084	Nick Automates — YouTube Shorts — 207,714	midudev — TikTok — 177,800

#6	#7	#8	#9	#10
theopenstack — Instagram — 155,453	t.ghoush.ai — TikTok — 152,800	Valency Labs — YouTube — 135,974	Asati — YouTube — 126,130	Vaibhav Sisinty — YouTube — 122,672

Metriche di validazione: 1002 video monitorati · 7,069,190 visualizzazioni note · 595 profili/canali · 13+ lingue · 13+ creator.

🎬 Hai realizzato un video su OmniRoute? Apri una issue o una discussion con il link — lo metteremo in evidenza qui.

📧 Community e assistenza

Tutto in un unico posto — segui il maintainer, parla con la community oppure apri una issue.

Canale	Dove / come
💼 LinkedIn — segui il maintainer	linkedin.com/in/diegosouzapw
🐙 GitHub — segui release e suggerimenti	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Global	entra nel gruppo
🟢 WhatsApp — 🇧🇷 Brasil	entra nel gruppo
🌍 Sito web	omniroute.online
📦 Codice sorgente	github.com/diegosouzapw/OmniRoute
🐛 Segnala un bug	apri una issue — allega l'output di `npm run system-info`
🤝 Contribuisci	CONTRIBUTING.md · Modello di branching e release · scegli una `good first issue`
💚 Sostieni il progetto	Modi per sostenere ↑ · GitHub Sponsors

🛠️ Stack tecnologico

Livello	Tecnologia
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Linguaggio	TypeScript 6.0 — 100% TypeScript in `src/` e `open-sse/` (zero `any` nel core dalla v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Database	better-sqlite3 (SQLite, journaling WAL) + LowDB (JSON legacy) — 122 moduli di dominio, 176 migrazioni
Memoria	Ricerca full-text SQLite FTS5 + embedding vettoriali quantizzati int8, decadimento tipizzato
Schemi	Zod 4 — convalida I/O degli strumenti MCP + contratti API
Protocolli	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + bridge WebSocket (`/v1/ws`)
Compressione	Pipeline a 12 motori — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autenticazione e sicurezza	OAuth 2.0 (PKCE) + JWT + chiavi API + autenticazione MCP con ambiti · AES-256-GCM per i dati inattivi · DOMPurify
Stealth	wreq-js — imitazione delle impronte digitali TLS JA3 / JA4, proxy a 3 livelli
Resilienza	Circuit breaker, backoff esponenziale, protezione anti-thundering-herd, autoriparazione auto-combo
Logging	pino — log JSON strutturati con contesto della richiesta
Test	Test runner di Node.js + Vitest — oltre 39.000 dichiarazioni di test statiche distribuite in oltre 5.100 file di test monitorati (unitari, di integrazione, E2E, di sicurezza, dell'ecosistema)
Piattaforme	Desktop (Electron) · Android (Termux) · PWA (qualsiasi browser)
CI/CD	GitHub Actions — pubblicazione automatica su npm + Docker Hub al rilascio
Collegamenti	Sito web · npm · Docker Hub

📖 Documentazione

📘 Guida introduttiva

Documento	Descrizione
Guida utente	Provider, combinazioni, integrazione con la CLI, distribuzione
Guida alla configurazione	Metodi completi di installazione, configurazioni degli strumenti CLI, configurazione dei protocolli, ottimizzazione dei timeout
Guida agli strumenti CLI	Configurazione specifica per Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo e Copilot
Modalità remota	Controlla un'istanza remota di OmniRoute (VPS) dalla CLI del tuo portatile tramite token di accesso con ambito limitato
Configurazione di Claude Code	Collega Claude Code a OmniRoute (locale/remoto) con `launch` e profili specifici per modello
Avvio rapido	Installazione in 3 passaggi → connessione → configurazione

🔧 Operazioni e distribuzione

Documento	Descrizione
Guida a Docker	Esecuzione con Docker, profili Compose, HTTPS con Caddy, tunnel, tag delle immagini
Guida a Podman	Integrazione Quadlet con systemd, podman-compose, SELinux
Distribuzione su VM	Guida completa: configurazione di VM + nginx + Cloudflare
Distribuzione su Fly.io	Distribuisci su Fly.io con archiviazione persistente
Guida a Termux	Esegui OmniRoute su Android tramite Termux
Guida alla PWA	Installazione della Progressive Web App, memorizzazione nella cache, architettura
Guida alla disinstallazione	Rimozione completa per tutti i metodi di installazione
Configurazione dell'ambiente	Variabili e riferimenti completi di `.env`

🧠 Funzionalità e architettura

Documento	Descrizione
Architettura	Architettura del sistema, flusso dei dati e meccanismi interni
Guida alla compressione	Pipeline con 7 opzioni: disattivata / leggera / standard / aggressiva / ultra / RTK / sovrapposta
Compressione RTK	Compressione dell'output dei comandi, filtri, attendibilità, verifica, recupero dell'output non elaborato
Motori di compressione	Caveman, RTK, pipeline sovrapposte, interfacce dashboard/API/MCP
Formato delle regole di compressione	Schemi JSON dei pacchetti di regole per i filtri Caveman e RTK
Pacchetti linguistici di compressione	Rilevamento della lingua e creazione di pacchetti di regole per Caveman
Guida alla resilienza	Circuit breaker, periodi di attesa, coda, prevenzione del thundering herd, spoofing TLS
Motore Auto-Combo	Valutazione a 16 fattori, pacchetti di modalità, autoriparazione
Guida ai proxy	Sistema proxy a 3 livelli, marketplace 1proxy, operazioni CRUD sul registro
Piani gratuiti	Elenco consolidato: 34 pool ricorrenti documentati / 452 offerte gratuite catalogate
Galleria delle funzionalità	Tour visivo della dashboard con schermate
Documentazione del codice sorgente	Panoramica del codice sorgente adatta ai principianti

🤖 Protocolli e API

Documento	Descrizione
Riferimento API	Tutti gli endpoint con esempi
Specifica OpenAPI	Specifica OpenAPI 3.0
Server MCP	110 strumenti MCP, configurazioni IDE, client Python/TS/Go
Guida al server MCP	Installazione di MCP, trasporti e riferimento degli strumenti
Server A2A	Protocollo JSON-RPC 2.0, competenze, streaming, gestione delle attività
Guida al server A2A	Scheda agente A2A, attività, competenze e streaming

📋 Progetto e qualità

Documento	Descrizione
Contribuire	Configurazione e linee guida per lo sviluppo
Modello di branching e rilascio	Rami di destinazione delle PR (`release/*`) e significato di `main` e dei tag
Registro delle modifiche	Cronologia completa dei rilasci per versione
Politica di sicurezza	Segnalazione delle vulnerabilità e pratiche di sicurezza
Guida all'i18n	Supporto per 42 lingue, flusso di lavoro di traduzione, RTL
Lista di controllo per il rilascio	Passaggi di convalida precedenti al rilascio
Piano di copertura	Strategia di copertura dei test per oltre 39.000 dichiarazioni di test statiche distribuite su oltre 5.100 file di test monitorati

⭐ Principali collaboratori

OmniRoute è plasmato da un'appassionata comunità open source. Queste persone hanno fornito contributi eccezionali che incidono direttamente sulla qualità, sulla stabilità e sulla diffusione del progetto. Grazie.

Collaboratori esterni per pull request integrate

Posizione	Collaboratore	PR integrate	~Righe modificate
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{Dati congelati alla revisione più recente del ramo release/v3.8.50, dafb4ae808, con integrazioni fino al 2026-08-24 05:26:03 UTC. Il censimento paginato tramite GitHub GraphQL contiene 5.911 PR integrate: 2.707 dal proprietario del repository, 179 da Dependabot e 3.025 PR esterne provenienti da 535 collaboratori distinti. Le «righe modificate» corrispondono alle aggiunte più le eliminazioni rilevate da GitHub e includono file generati, lockfile, cataloghi, traduzioni e documentazione; rappresentano il volume delle modifiche, non le righe di codice create. Le posizioni a pari merito in corrispondenza della soglia sono mantenute.}

Commit attribuiti da GitHub

backryun _{🥇 220 commit attribuiti da GitHub}	Paijo _{🥈 219 commit attribuiti da GitHub}	Randi _{🥉 108 commit attribuiti da GitHub}	Ravi Tharuma _{🏅 81 commit attribuiti da GitHub}	Chris _{🏅 70 commit attribuiti da GitHub}	Markus Hartung _{🏅 69 commit attribuiti da GitHub · 6° posto a pari merito}
Dizzle _{🏅 69 commit attribuiti da GitHub · 6° posto a pari merito}	Jan Leon _{🏅 64 commit attribuiti da GitHub}	zenobit _{🏅 62 commit attribuiti da GitHub}	Bob.Hou _{🏅 51 commit attribuiti da GitHub · 10° posto a pari merito}	Xiangzhe _{🏅 51 commit attribuiti da GitHub · 10° posto a pari merito}

_{Ricontrollato il 2026-08-24 06:14:31 UTC: commit attribuiti da GitHub segnalati dall'API Contributors del repository per il branch predefinito release/v3.8.50. L'API ha restituito 525 identità (415 utenti, 2 bot, 108 anonime); questa tabella esclude il manutentore, i bot e le identità anonime e mantiene i pari merito. È distinta sia dalla classifica delle PR unite riportata sopra, sia dal censimento di 639 persone basato sui metadati Git riportato sotto.}

🙏 Le funzionalità, le correzioni di bug e i miglioramenti dell'infrastruttura apportati da questi collaboratori sono una parte fondamentale di ciò che rende OmniRoute affidabile e ricco di funzionalità. Ogni pull request, ogni caso di test e ogni file di traduzione i18n è importante. L'open source è costruito da persone come loro.

Un grazie di cuore alle persone che finanziano OmniRoute di tasca propria — ogni contributo aiuta a mantenere il progetto gratuito, indipendente e in evoluzione.

Prof. Igor Morais
_{💛 Sponsor}

longtao
_{💛 Sponsor}

_{… e altri che preferiscono restare anonimi 💛}

💖 Diventa sponsor → — ogni contributo mantiene OmniRoute gratuito e indipendente.

👥 Oltre 320 contributor

Come contribuire

Fai un fork del repository
Crea il branch dalla punta della release/vX.Y.Z attiva (non da main) — vedi Modello di branching e release
Crea il tuo feature branch (git checkout -b feat/amazing-feature)
Esegui il commit delle modifiche (git commit -m 'feat: add amazing feature')
Esegui il push del branch (git push origin feat/amazing-feature)
Apri una Pull Request con base = quel branch release/vX.Y.Z

Vedi CONTRIBUTING.md per le linee guida complete.

Pubblicare una nuova versione

# Create a release — npm publish happens automatically
gh release create v3.8.2 --title "v3.8.2" --generate-notes

📊 Stelle

🌍 StarMapper

🙏 Ringraziamenti

OmniRoute è costruito sulle spalle di giganti. È nato come fork di 9router e come port TypeScript del progetto Go CLIProxyAPI — da lì, ogni sottosistema qui sotto è stato ispirato da un progetto open source arrivato prima. Ognuno ha influenzato una parte concreta di OmniRoute. Questo è il nostro ringraziamento a tutti loro. 🙏

⭐ conteggio stelle a luglio 2026 — vai a lasciare una stella a questi progetti.

🧬 Origini e gateway

Progetto	⭐	Come ha ispirato OmniRoute
9router	22.7k	Il progetto originale su cui si basa questo fork — esteso qui con API multimodali e una riscrittura completa in TypeScript.
CLIProxyAPI	43.6k	L'implementazione Go che ha ispirato questo port JavaScript / TypeScript.
LiteLLM	54.0k	Il gateway AI il cui dataset pubblico dei prezzi alimenta la sincronizzazione del cost tracking e il cui modello di normalizzazione dei provider ha influenzato il nostro routing.

🗜️ Compressione di contesto e token — motori

Progetto	⭐	Come ha ispirato OmniRoute
Caveman	90.8k	Il progetto virale "why use many token when few token do trick" — la sua filosofia caveman-speak alimenta la nostra modalità di compressione standard e oltre 30 regole di rimozione riempitivi/condensazione.
RTK – Rust Token Killer	71.8k	Compressione ad alte prestazioni dell'output dei comandi — ha ispirato il nostro motore RTK, la DSL per filtri JSON, il recupero dell'output grezzo e la pipeline stacked RTK → Caveman.
headroom	60.1k	Compressione reversibile del contesto (SmartCrusher) — ha ispirato il nostro motore `headroom` e il pattern dei marker di recupero `ccr`.
LLMLingua	6.5k	Ricerca sulla compressione dei prompt (LLMLingua / LLMLingua-2) — ha ispirato il nostro motore `llmlingua` asincrono, code-safe e fail-open.
llmlingua-2-js	30	Il port JS/ONNX (MobileBERT / XLM-RoBERTa) usato come backend worker-thread dal nostro motore LLMLingua.
Troglodita	26	Compressione token PT-BR — alimenta il nostro language pack pt-BR: riduzione dei pleonasmi e rimozione dei riempitivi ottimizzate per la grammatica portoghese brasiliana.
ponytail	86.0k	La skill virale da "lazy senior dev" basata su YAGNI — ha ispirato il nostro Output Style less-code: orientamento alla modifica minima funzionante che riduce il codice _generato_ (l'equivalente sull'asse output della prosa concisa di Caveman).

🧩 Formati compatti, ricerca sui token e tooling code-aware

Progetto	⭐	Come ha ispirato OmniRoute
TOON	24.9k	Token-Oriented Object Notation — il suo modello colonnare con header + righe ha influenzato la nostra fase di compattazione tabellare.
GCF – Graph Compact Format	22	Ha inizialmente ispirato la nostra fase di compattazione tabellare; ora il suo encoder generic-profile lossless e senza dipendenze è incluso direttamente come codec Headroom (MIT, con marcatura SPDX), insieme ai successivi fix di correttezza per dominio numerico e discrepanze nei conteggi.
token-optimizer-mcp	444	Cache Brotli/SQLite + delta del contesto per sessione — ha ispirato il nostro motore `session-dedup`.
token-savior	1.1k	Compattazione dell'output Bash + profili MCP — ha ispirato la nostra disciplina di bail-out nella compressione e la riduzione del manifest dei tool MCP.
token-saver	117	Compressione dell'output consapevole del contenuto e del tipo di file, con bail-out in caso di errore — ha validato il nostro dispatch per tipo e lo skip basato sul guadagno minimo.
token-optimizer	1.7k	"Find the ghost tokens" — il suo pattern di offload + handle recuperabile ha influenzato il nostro approccio all'offload CCR.
TokenMizer	16	Un blueprint con grafo di sessione + deduplica cross-turn per riga che ha influenzato il design di session-dedup.
OmniCompress	3	JSON colonnare in Rust + retrieve content-addressed + deduplica cross-message — ha validato il design dei nostri motori `headroom`/`ccr`/`session-dedup` e l'invariante cache-stable "la forma compressa è indipendente dalla posizione".
mcp-compressor	98	Compressione degli schemi/descrizioni dei tool MCP — ha influenzato la riduzione della cardinalità del manifest dei tool MCP.
RepoMapper	187	Ranking della repo-map in stile Aider — ha influenzato la nostra esplorazione del ranking di repo-map / retrieval.
quiet-shell-mcp	4	Riduzione dichiarativa dell'output shell tramite MCP — ha validato la nostra compattazione dichiarativa dell'output Bash.
ts-morph	6.1k	Toolkit per la TypeScript Compiler API — ha ispirato la nostra rimozione dei commenti basata su parser, che preserva stringhe, template e literal regex.

🧠 Memoria e RAG

Progetto	⭐	Come ha ispirato OmniRoute
Mem0	61.2k	Layer di memoria universale — il suo modello proxy-as-write/read-boundary ha plasmato la nostra architettura della memoria.
Letta (MemGPT)	23.9k	Agent stateful con memoria a livelli — ha ispirato il nostro modello a livelli Context Control & Recovery (CCR).
WFGY	1.8k	La tassonomia ProblemMap di 16 modalità ricorrenti di errore RAG/LLM — il vocabolario condiviso nella nostra guida alla risoluzione dei problemi.

🛰️ Ispezione del traffico, MITM e proxy trasparente

Progetto	⭐	Come ha ispirato OmniRoute
llm-interceptor	49	Intercettazione/analisi MITM del traffico coding-assistant ↔ LLM — il nostro Traffic Inspector adatta il suo merge SSE, la normalizzazione delle conversazioni, il passthrough degli host e il masking dei segreti (MIT).
ProxyBridge	5.5k	Routing proxy trasparente per processo — ha ispirato il teardown MITM crash-safe, gli idle timeout dei socket, l'attribuzione dei processi tramite `/proc` e la cattura TPROXY.

📚 Dati dei modelli, osservabilità e UI

Progetto	⭐	Come ha ispirato OmniRoute
models.dev	6.0k	Database aperto di specifiche, prezzi e capacità dei modelli AI — sincronizzato nativamente nel nostro catalogo modelli.
React Flow / xyflow	37.7k	La libreria di grafi node-based che alimenta Compression Studio e Combo/Routing Studio in tempo reale.
LangGraph	37.6k	La visualizzazione live dei grafi di workflow di LangGraph Studio ha ispirato la vista a cascata in tempo reale dei nostri Studio.
Langfuse	31.4k	Il suo modello di osservabilità trace → span → generation ha plasmato la waterfall di Compression Studio.
Kiali	3.6k	Osservabilità del service mesh Istio — ha ispirato i badge circuit-breaker e le visualizzazioni degli edge di errore in Routing/Combo Studio.
lobe-icons	2.2k	Loghi dei brand AI/LLM usati per le icone dei provider nella dashboard.

🛡️ Sicurezza

Progetto	⭐	Come ha ispirato OmniRoute
awesome-secure-defaults	710	Una raccolta curata di librerie secure-by-default che guida le nostre scelte di sicurezza (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

🧭 Strumenti complementari

Progetto	⭐	Come ha ispirato OmniRoute

📄 Licenza

Licenza MIT - vedi LICENSE per i dettagli.

⬆ Torna all'inizio · Realizzato con ❤️ per la community AI open source.

_{OmniRoute v3.8.49 · Node ≥22.22.2 · Licenza MIT · omniroute.online}

README.md Unescape Escape

README (Italiano)

🚀 OmniRoute — Il gateway AI gratuito

💰 ~1,47 mld di token gratuiti / mese

⭐ Metti una stella al repository se OMNIROUTE ti ha aiutato a risparmiare e a semplificare il tuo lavoro.

💬 Unisciti alla community

📈 Il gateway continua a crescere

🧩 Disponibile come

🆓 Funziona dal momento in cui lo installi — nessuna chiave, nessuna configurazione

💥 La promessa

🤔 Perché OmniRoute?

🤝 Supportato dai nostri amici dell'Open Source

🎯 Combo — La funzionalità di punta

⚡ Zero-config — usa semplicemente auto

🔀 Oppure creane una tua — 19 strategie di routing

🧱 Resilienza integrata (3 livelli indipendenti)

🏆 Cosa distingue OmniRoute

💚 Supporta OmniRoute

📡 OmniRoute Radar

✨ Novità

🤖 CLI e agenti di coding compatibili

🌐 352 provider di IA — 152 contrassegnati nel catalogo come gratuiti

🏢 Tutti i principali laboratori — tramite un unico endpoint

🆓 Gratis per sempre — $0, nessuna carta richiesta

🖥️ Dove gira OmniRoute — ovunque

🧩 Novità: OmniRoute dentro il Copilot Chat nativo di VS Code

🔒 Privato e local-first

🔌 CLI completa + A2A e MCP

⌨️ Una vera CLI (non solo start)

🛰️ Modalità remota — esegui qui la CLI, OmniRoute su un VPS

🤝 Collega un agent — e controllerà OmniRoute stesso

🗜️ Risparmia il 15–95% dei token — automaticamente

📖 Come funziona — pipeline, architettura e calcolo del risparmio

🧱 La stack di 12 motori

🎚️ Oltre i motori — output style, regolazione adattiva e controllo per richiesta

⚡ Avvio rapido

📦 Altri metodi di installazione — Docker, sorgente, pnpm, Arch

🎬 OmniRoute in azione

📹 Guide video

📧 Community e assistenza

🛠️ Stack tecnologico

📖 Documentazione

📘 Guida introduttiva

🔧 Operazioni e distribuzione

🧠 Funzionalità e architettura

🤖 Protocolli e API

📋 Progetto e qualità

⭐ Principali collaboratori

Collaboratori esterni per pull request integrate

Commit attribuiti da GitHub

💖 Sponsor

👥 Oltre 320 contributor

Come contribuire

Pubblicare una nuova versione

📊 Stelle

🌍 StarMapper

🙏 Ringraziamenti

🧬 Origini e gateway

🗜️ Compressione di contesto e token — motori

🧩 Formati compatti, ricerca sui token e tooling code-aware

🧠 Memoria e RAG

🛰️ Ispezione del traffico, MITM e proxy trasparente

📚 Dati dei modelli, osservabilità e UI

🛡️ Sicurezza

🧭 Strumenti complementari

📄 Licenza

README.md

⚡ Zero-config — usa semplicemente `auto`

⌨️ Una vera CLI (non solo `start`)