OmniRoute Dashboard # ๐Ÿš€ OmniRoute โ€” Il Gateway IA Gratuito ### Non smettere mai di programmare. Routing intelligente verso **modelli IA GRATUITI e economici** con fallback automatico. _Il tuo proxy API universale โ€” un endpoint, 36+ provider, zero downtime._ **Chat Completions โ€ข Embeddings โ€ข Generazione Immagini โ€ข Audio โ€ข Reranking โ€ข 100% TypeScript** --- ### ๐Ÿค– Provider IA gratuito per i tuoi agenti di programmazione preferiti _Connetti qualsiasi IDE o strumento CLI con IA tramite OmniRoute โ€” gateway API gratuito per programmazione illimitata._
OpenClaw
OpenClaw
โญ 205K 		NanoBot
NanoBot
โญ 20.9K 		PicoClaw
PicoClaw
โญ 14.6K 		ZeroClaw
ZeroClaw
โญ 9.9K 		IronClaw
IronClaw
โญ 2.1K
OpenCode
OpenCode
โญ 106K 		Codex CLI
Codex CLI
โญ 60.8K 		Claude Code
Claude Code
โญ 67.3K 		Gemini CLI
Gemini CLI
โญ 94.7K 		Kilo Code
Kilo Code
โญ 15.5K
๐Ÿ“ก Tutti gli agenti si connettono via http://localhost:20128/v1 o http://cloud.omniroute.online/v1 โ€” una configurazione, modelli e quota illimitati --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) [๐ŸŒ Sito Web](https://omniroute.online) โ€ข [๐Ÿš€ Avvio Rapido](#-avvio-rapido) โ€ข [๐Ÿ’ก Funzionalitร ](#-funzionalitร -principali) โ€ข [๐Ÿ“– Docs](#-documentazione) โ€ข [๐Ÿ’ฐ Prezzi](#-panoramica-prezzi) ๐ŸŒ **Available in:** ๐Ÿ‡บ๐Ÿ‡ธ [English](README.md) | ๐Ÿ‡ง๐Ÿ‡ท [Portuguรชs (Brasil)](README.pt-BR.md) | ๐Ÿ‡ช๐Ÿ‡ธ [Espaรฑol](README.es.md) | ๐Ÿ‡ซ๐Ÿ‡ท [Franรงais](README.fr.md) | ๐Ÿ‡ฎ๐Ÿ‡น [Italiano](README.it.md) | ๐Ÿ‡ท๐Ÿ‡บ [ะ ัƒััะบะธะน](README.ru.md) | ๐Ÿ‡จ๐Ÿ‡ณ [ไธญๆ–‡ (็ฎ€ไฝ“)](README.zh-CN.md) | ๐Ÿ‡ฉ๐Ÿ‡ช [Deutsch](README.de.md) | ๐Ÿ‡ฎ๐Ÿ‡ณ [เคนเคฟเคจเฅเคฆเฅ€](README.in.md) | ๐Ÿ‡น๐Ÿ‡ญ [เน„เธ—เธข](README.th.md) | ๐Ÿ‡บ๐Ÿ‡ฆ [ะฃะบั€ะฐั—ะฝััŒะบะฐ](README.uk-UA.md) | ๐Ÿ‡ธ๐Ÿ‡ฆ [ุงู„ุนุฑุจูŠุฉ](README.ar.md) | ๐Ÿ‡ฏ๐Ÿ‡ต [ๆ—ฅๆœฌ่ชž](README.ja.md) | ๐Ÿ‡ป๐Ÿ‡ณ [Tiแบฟng Viแป‡t](README.vi.md) | ๐Ÿ‡ง๐Ÿ‡ฌ [ะ‘ัŠะปะณะฐั€ัะบะธ](README.bg.md) | ๐Ÿ‡ฉ๐Ÿ‡ฐ [Dansk](README.da.md) | ๐Ÿ‡ซ๐Ÿ‡ฎ [Suomi](README.fi.md) | ๐Ÿ‡ฎ๐Ÿ‡ฑ [ืขื‘ืจื™ืช](README.he.md) | ๐Ÿ‡ญ๐Ÿ‡บ [Magyar](README.hu.md) | ๐Ÿ‡ฎ๐Ÿ‡ฉ [Bahasa Indonesia](README.id.md) | ๐Ÿ‡ฐ๐Ÿ‡ท [ํ•œ๊ตญ์–ด](README.ko.md) | ๐Ÿ‡ฒ๐Ÿ‡พ [Bahasa Melayu](README.ms.md) | ๐Ÿ‡ณ๐Ÿ‡ฑ [Nederlands](README.nl.md) | ๐Ÿ‡ณ๐Ÿ‡ด [Norsk](README.no.md) | ๐Ÿ‡ต๐Ÿ‡น [Portuguรชs (Portugal)](README.pt.md) | ๐Ÿ‡ท๐Ÿ‡ด [Romรขnฤƒ](README.ro.md) | ๐Ÿ‡ต๐Ÿ‡ฑ [Polski](README.pl.md) | ๐Ÿ‡ธ๐Ÿ‡ฐ [Slovenฤina](README.sk.md) | ๐Ÿ‡ธ๐Ÿ‡ช [Svenska](README.sv.md) | ๐Ÿ‡ต๐Ÿ‡ญ [Filipino](README.phi.md)
--- ## ๐Ÿค” Perchรฉ OmniRoute? **Smetti di sprecare soldi e di sbattere contro i limiti:** - La quota dell'abbonamento scade inutilizzata ogni mese - I limiti di rate ti fermano nel mezzo della programmazione - API costose ($20-50/mese per provider) - Cambio manuale tra provider **OmniRoute risolve tutto questo:** - โœ… **Massimizza gli abbonamenti** โ€” Traccia le quote, usa tutto prima del reset - โœ… **Fallback automatico** โ€” Abbonamento โ†’ API Key โ†’ Economico โ†’ Gratuito, zero downtime - โœ… **Multi-account** โ€” Round-robin tra account per provider - โœ… **Universale** โ€” Funziona con Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, qualsiasi strumento CLI --- ## ๐Ÿ”„ Come Funziona ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Il tuo CLI โ”‚ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) โ”‚ Tool โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ http://localhost:20128/v1 โ†“ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ OmniRoute (Router Intelligente) โ”‚ โ”‚ โ€ข Traduzione formato (OpenAI โ†” Claude) โ”‚ โ”‚ โ€ข Tracciamento quote + Embeddings + Immagini โ”‚ โ”‚ โ€ข Rinnovo automatico dei token โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”œโ”€โ†’ [Tier 1: ABBONAMENTO] Claude Code, Codex, Gemini CLI โ”‚ โ†“ quota esaurita โ”œโ”€โ†’ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, ecc. โ”‚ โ†“ limite budget โ”œโ”€โ†’ [Tier 3: ECONOMICO] GLM ($0.6/1M), MiniMax ($0.2/1M) โ”‚ โ†“ limite budget โ””โ”€โ†’ [Tier 4: GRATUITO] iFlow, Qwen, Kiro (illimitato) Risultato: Non smettere mai di programmare, costo minimo ``` --- ## ๐ŸŽฏ What OmniRoute Solves โ€” 16 Real Pain Points > **Every developer using AI tools faces these problems daily.** OmniRoute was built to solve them all โ€” from cost overruns to regional blocks, from broken OAuth flows to zero observability.
๐Ÿ’ธ 1. "I pay for an expensive subscription but still get interrupted by limits" Developers pay $20โ€“200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling โ€” 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity. **How OmniRoute solves it:** - **Smart 4-Tier Fallback** โ€” If subscription quota runs out, automatically redirects to API Key โ†’ Cheap โ†’ Free with zero manual intervention - **Real-Time Quota Tracking** โ€” Shows token consumption in real-time with reset countdown (5h, daily, weekly) - **Multi-Account Support** โ€” Multiple accounts per provider with auto round-robin โ€” when one runs out, switches to the next - **Custom Combos** โ€” Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized) - **Codex Business Quotas** โ€” Business/Team workspace quota monitoring directly in the dashboard
๐Ÿ”Œ 2. "I need to use multiple providers but each has a different API" OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints. **How OmniRoute solves it:** - **Unified Endpoint** โ€” A single `http://localhost:20128/v1` serves as proxy for all 36+ providers - **Format Translation** โ€” Automatic and transparent: OpenAI โ†” Claude โ†” Gemini โ†” Responses API - **Response Sanitization** โ€” Strips non-standard fields (`x_groq`, `usage_breakdown`, `service_tier`) that break OpenAI SDK v1.83+ - **Role Normalization** โ€” Converts `developer` โ†’ `system` for non-OpenAI providers; `system` โ†’ `user` for GLM/ERNIE - **Think Tag Extraction** โ€” Extracts `` blocks from models like DeepSeek R1 into standardized `reasoning_content` - **Structured Output for Gemini** โ€” `json_schema` โ†’ `responseMimeType`/`responseSchema` automatic conversion - **`stream` defaults to `false`** โ€” Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs
๐ŸŒ 3. "My AI provider blocks my region/country" Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like `unsupported_country_region_territory` during OAuth and API connections. This is especially frustrating for developers from developing countries. **How OmniRoute solves it:** - **3-Level Proxy Config** โ€” Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key - **Color-Coded Proxy Badges** โ€” Visual indicators: ๐ŸŸข global proxy, ๐ŸŸก provider proxy, ๐Ÿ”ต connection proxy, always showing the IP - **OAuth Token Exchange Through Proxy** โ€” OAuth flow also goes through the proxy, solving `unsupported_country_region_territory` - **Connection Tests via Proxy** โ€” Connection tests use the configured proxy (no more direct bypass) - **SOCKS5 Support** โ€” Full SOCKS5 proxy support for outbound routing - **TLS Fingerprint Spoofing** โ€” Browser-like TLS fingerprint via `wreq-js` to bypass bot detection
๐Ÿ†“ 4. "I want to use AI for coding but I have no money" Not everyone can pay $20โ€“200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost. **How OmniRoute solves it:** - **Free Tier Providers Built-in** โ€” Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free) - **Free-Only Combos** โ€” Chain `gc/gemini-3-flash โ†’ if/kimi-k2-thinking โ†’ qw/qwen3-coder-plus` = $0/month with zero downtime - **NVIDIA NIM Free Credits** โ€” 1000 free credits integrated - **Cost Optimized Strategy** โ€” Routing strategy that automatically chooses the cheapest available provider
๐Ÿ”’ 5. "I need to protect my AI gateway from unauthorized access" When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse. **How OmniRoute solves it:** - **API Key Management** โ€” Generation, rotation, and scoping per provider with a dedicated `/dashboard/api-manager` page - **Model-Level Permissions** โ€” Restrict API keys to specific models (`openai/*`, wildcard patterns), with Allow All/Restrict toggle - **API Endpoint Protection** โ€” Require a key for `/v1/models` and block specific providers from the listing - **Auth Guard + CSRF Protection** โ€” All dashboard routes protected with `withAuth` middleware + CSRF tokens - **Rate Limiter** โ€” Per-IP rate limiting with configurable windows - **IP Filtering** โ€” Allowlist/blocklist for access control - **Prompt Injection Guard** โ€” Sanitization against malicious prompt patterns - **AES-256-GCM Encryption** โ€” Credentials encrypted at rest
๐Ÿ›‘ 6. "My provider went down and I lost my coding flow" AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application. **How OmniRoute solves it:** - **Circuit Breaker per-provider** โ€” Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open) - **Exponential Backoff** โ€” Progressive retry delays - **Anti-Thundering Herd** โ€” Mutex + semaphore protection against concurrent retry storms - **Combo Fallback Chains** โ€” If the primary provider fails, automatically falls through the chain with no intervention - **Combo Circuit Breaker** โ€” Auto-disables failing providers within a combo chain - **Health Dashboard** โ€” Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency
๐Ÿ”ง 7. "Configuring each AI tool is tedious and repetitive" Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time. **How OmniRoute solves it:** - **CLI Tools Dashboard** โ€” Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline - **GitHub Copilot Config Generator** โ€” Generates `chatLanguageModels.json` for VS Code with bulk model selection - **Onboarding Wizard** โ€” Guided 4-step setup for first-time users - **One endpoint, all models** โ€” Configure `http://localhost:20128/v1` once, access 36+ providers
๐Ÿ”‘ 8. "Managing OAuth tokens from multiple providers is hell" Claude Code, Codex, Gemini CLI, Copilot โ€” all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with `client_secret is missing`, `redirect_uri_mismatch`, and failures on remote servers. OAuth on LAN/VPS is particularly problematic. **How OmniRoute solves it:** - **Auto Token Refresh** โ€” OAuth tokens refresh in background before expiration - **OAuth 2.0 (PKCE) Built-in** โ€” Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow - **Multi-Account OAuth** โ€” Multiple accounts per provider via JWT/ID token extraction - **OAuth LAN/Remote Fix** โ€” Private IP detection for `redirect_uri` + manual URL mode for remote servers - **OAuth Behind Nginx** โ€” Uses `window.location.origin` for reverse proxy compatibility - **Remote OAuth Guide** โ€” Step-by-step guide for Google Cloud credentials on VPS/Docker
๐Ÿ“Š 9. "I don't know how much I'm spending or where" Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up. **How OmniRoute solves it:** - **Cost Analytics Dashboard** โ€” Per-token cost tracking and budget management per provider - **Budget Limits per Tier** โ€” Spending ceiling per tier that triggers automatic fallback - **Per-Model Pricing Configuration** โ€” Configurable prices per model - **Usage Statistics Per API Key** โ€” Request count and last-used timestamp per key - **Analytics Dashboard** โ€” Stat cards, model usage chart, provider table with success rates and latency
๐Ÿ› 10. "I can't diagnose errors and problems in AI calls" When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error. **How OmniRoute solves it:** - **Unified Logs Dashboard** โ€” 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console - **Console Log Viewer** โ€” Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter - **SQLite Proxy Logs** โ€” Persistent logs that survive server restarts - **Translator Playground** โ€” 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time) - **Request Telemetry** โ€” p50/p95/p99 latency + X-Request-Id tracing - **File-Based Logging with Rotation** โ€” Console interceptor captures everything to JSON log with size-based rotation
๐Ÿ—๏ธ 11. "Deploying and maintaining the gateway is complex" Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, `EACCES` on directories, port conflicts, and cross-platform builds add friction. **How OmniRoute solves it:** - **npm global install** โ€” `npm install -g omniroute && omniroute` โ€” done - **Docker Multi-Platform** โ€” AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi) - **Docker Compose Profiles** โ€” `base` (no CLI tools) and `cli` (with Claude Code, Codex, OpenClaw) - **Electron Desktop App** โ€” Native app for Windows/macOS/Linux with system tray, auto-start, offline mode - **Split-Port Mode** โ€” API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking) - **Cloud Sync** โ€” Config synchronization across devices via Cloudflare Workers - **DB Backups** โ€” Automatic backup, restore, export and import of all settings
๐ŸŒ 12. "The interface is English-only and my team doesn't speak English" Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors. **How OmniRoute solves it:** - **Dashboard i18n โ€” 30 Languages** โ€” All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English - **RTL Support** โ€” Right-to-left support for Arabic and Hebrew - **Multi-Language READMEs** โ€” 30 complete documentation translations - **Language Selector** โ€” Globe icon in header for real-time switching
๐Ÿ”„ 13. "I need more than chat โ€” I need embeddings, images, audio" AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format. **How OmniRoute solves it:** - **Embeddings** โ€” `/v1/embeddings` with 6 providers and 9+ models - **Image Generation** โ€” `/v1/images/generations` with 4 providers and 9+ models - **Audio Transcription** โ€” `/v1/audio/transcriptions` โ€” Whisper-compatible - **Text-to-Speech** โ€” `/v1/audio/speech` โ€” Multi-provider audio synthesis - **Moderations** โ€” `/v1/moderations` โ€” Content safety checks - **Reranking** โ€” `/v1/rerank` โ€” Document relevance reranking - **Responses API** โ€” Full `/v1/responses` support for Codex
๐Ÿงช 14. "I have no way to test and compare quality across models" Developers want to know which model is best for their use case โ€” code, translation, reasoning โ€” but comparing manually is slow. No integrated eval tools exist. **How OmniRoute solves it:** - **LLM Evaluations** โ€” Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal - **4 Match Strategies** โ€” `exact`, `contains`, `regex`, `custom` (JS function) - **Translator Playground Test Bench** โ€” Batch testing with multiple inputs and expected outputs, cross-provider comparison - **Chat Tester** โ€” Full round-trip with visual response rendering - **Live Monitor** โ€” Real-time stream of all requests flowing through the proxy
๐Ÿ“ˆ 15. "I need to scale without losing performance" As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected. **How OmniRoute solves it:** - **Semantic Cache** โ€” Two-tier cache (signature + semantic) reduces cost and latency - **Request Idempotency** โ€” 5s deduplication window for identical requests - **Rate Limit Detection** โ€” Per-provider RPM, min gap, and max concurrent tracking - **Editable Rate Limits** โ€” Configurable defaults in Settings โ†’ Resilience with persistence - **API Key Validation Cache** โ€” 3-tier cache for production performance - **Health Dashboard with Telemetry** โ€” p50/p95/p99 latency, cache stats, uptime
๐Ÿค– 16. "I want to control model behavior globally" Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical. **How OmniRoute solves it:** - **System Prompt Injection** โ€” Global prompt applied to all requests - **Thinking Budget Validation** โ€” Reasoning token allocation control per request (passthrough, auto, custom, adaptive) - **6 Routing Strategies** โ€” Global strategies that determine how requests are distributed - **Wildcard Router** โ€” `provider/*` patterns route dynamically to any provider - **Combo Enable/Disable Toggle** โ€” Toggle combos directly from the dashboard - **Provider Toggle** โ€” Enable/disable all connections for a provider with one click - **Blocked Providers** โ€” Exclude specific providers from `/v1/models` listing
## โšก Avvio Rapido **1. Installa globalmente:** ```bash npm install -g omniroute omniroute ``` ๐ŸŽ‰ La Dashboard si apre su `http://localhost:20128` | Comando | Descrizione | | ----------------------- | ------------------------------------------- | | `omniroute` | Avviare il server (porta predefinita 20128) | | `omniroute --port 3000` | Usare una porta personalizzata | | `omniroute --no-open` | Non aprire il browser automaticamente | | `omniroute --help` | Mostrare l'aiuto | **2. Connetti un provider GRATUITO:** Dashboard โ†’ Provider โ†’ Connetti **Claude Code** o **Antigravity** โ†’ Login OAuth โ†’ Fatto! **3. Usa nel tuo strumento CLI:** ``` Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Impostazioni: Endpoint: http://localhost:20128/v1 API Key: [copia dalla dashboard] Model: if/kimi-k2-thinking ``` **Tutto qui!** Inizia a programmare con modelli IA GRATUITI. **Alternativa โ€” eseguire dal codice sorgente:** ```bash cp .env.example .env npm install PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev ``` --- ## ๐Ÿณ Docker OmniRoute รจ disponibile come immagine Docker pubblica su [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute). **Avvio rapido:** ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Con file di ambiente:** ```bash # Copia e modifica il .env prima cp .env.example .env docker run -d \ --name omniroute \ --restart unless-stopped \ --env-file .env \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Con Docker Compose:** ```bash # Profilo base (senza strumenti CLI) docker compose --profile base up -d # Profilo CLI (Claude Code, Codex, OpenClaw integrati) docker compose --profile cli up -d ``` | Immagine | Tag | Dimensione | Descrizione | | ------------------------ | -------- | ---------- | ----------------------- | | `diegosouzapw/omniroute` | `latest` | ~250MB | Ultima versione stabile | | `diegosouzapw/omniroute` | `1.0.6` | ~250MB | Versione attuale | --- --- ## ๐Ÿ–ฅ๏ธ Desktop App โ€” Offline & Always-On > ๐Ÿ†• **NEW!** OmniRoute is now available as a **native desktop application** for Windows, macOS, and Linux. - ๐Ÿ–ฅ๏ธ **Native Window** โ€” Dedicated app window with system tray integration - ๐Ÿ”„ **Auto-Start** โ€” Launch OmniRoute on system login - ๐Ÿ”” **Native Notifications** โ€” Get alerts for quota exhaustion or provider issues - โšก **One-Click Install** โ€” NSIS (Windows), DMG (macOS), AppImage (Linux) - ๐ŸŒ **Offline Mode** โ€” Works fully offline with bundled server ```bash npm run electron:dev # Development mode npm run electron:build # Current platform npm run electron:build:win # Windows (.exe) npm run electron:build:mac # macOS (.dmg) npm run electron:build:linux # Linux (.AppImage) ``` ๐Ÿ“– Full documentation: [`electron/README.md`](electron/README.md) --- ## ๐Ÿ’ฐ Panoramica Prezzi | Tier | Provider | Costo | Reset Quota | Ideale Per | | ------------------ | ----------------- | ---------------------------- | --------------------- | ------------------------------- | | **๐Ÿ’ณ ABBONAMENTO** | Claude Code (Pro) | $20/mese | 5h + settimanale | Giร  abbonato | | | Codex (Plus/Pro) | $20-200/mese | 5h + settimanale | Utenti OpenAI | | | Gemini CLI | **GRATUITO** | 180K/mese + 1K/giorno | Tutti! | | | GitHub Copilot | $10-19/mese | Mensile | Utenti GitHub | | **๐Ÿ”‘ API KEY** | NVIDIA NIM | **GRATUITO** (1000 crediti) | Una tantum | Test gratuiti | | | DeepSeek | A consumo | Nessuno | Miglior rapporto qualitร -prezzo | | | Groq | Livello gratis + a pagamento | Limitato | Inferenza ultra-veloce | | | xAI (Grok) | A consumo | Nessuno | Modelli Grok | | | Mistral | Livello gratis + a pagamento | Limitato | IA Europea | | | OpenRouter | A consumo | Nessuno | 100+ modelli | | **๐Ÿ’ฐ ECONOMICO** | GLM-4.7 | $0.6/1M | Giornaliero 10h | Backup economico | | | MiniMax M2.1 | $0.2/1M | Rotativo 5h | Opzione piรน economica | | | Kimi K2 | $9/mese fisso | 10M token/mese | Costo prevedibile | | **๐Ÿ†“ GRATUITO** | iFlow | $0 | Illimitato | 8 modelli gratuiti | | | Qwen | $0 | Illimitato | 3 modelli gratuiti | | | Kiro | $0 | Illimitato | Claude gratuito | **๐Ÿ’ก Consiglio Pro:** Inizia con Gemini CLI (180K gratis/mese) + iFlow (illimitato gratis) = $0 di costo! --- ## ๐Ÿ’ก Funzionalitร  Principali ### ๐Ÿง  Routing & Intelligenza | Funzionalitร  | Cosa Fa | | ---------------------------------------- | ----------------------------------------------------------------------------- | | ๐ŸŽฏ **Fallback intelligente 4 livelli** | Auto-routing: Abbonamento โ†’ API Key โ†’ Economico โ†’ Gratuito | | ๐Ÿ“Š **Tracciamento quote in tempo reale** | Conteggio token live + countdown reset per provider | | ๐Ÿ”„ **Traduzione di formato** | OpenAI โ†” Claude โ†” Gemini โ†” Cursor โ†” Kiro trasparente | | ๐Ÿ‘ฅ **Supporto multi-account** | Account multipli per provider con selezione intelligente | | ๐Ÿ”„ **Rinnovo automatico dei token** | I token OAuth si rinnovano automaticamente con retry | | ๐ŸŽจ **Combo personalizzati** | 6 strategie: fill-first, round-robin, p2c, random, least-used, cost-optimized | | ๐Ÿงฉ **Modelli personalizzati** | Aggiungi qualsiasi ID modello a qualsiasi provider | | ๐ŸŒ **Router wildcard** | Instrada pattern `provider/*` verso qualsiasi provider dinamicamente | | ๐Ÿง  **Budget di ragionamento** | Modalitร  passthrough, auto, custom e adaptive per modelli di ragionamento | | ๐Ÿ’ฌ **Iniezione System Prompt** | System prompt globale applicato a tutte le richieste | | ๐Ÿ“„ **API Responses** | Supporto completo per OpenAI Responses API (`/v1/responses`) per Codex | ### ๐ŸŽต API Multi-modali | Funzionalitร  | Cosa Fa | | --------------------------- | ---------------------------------------------------- | | ๐Ÿ–ผ๏ธ **Generazione immagini** | `/v1/images/generations` โ€” 4 provider, 9+ modelli | | ๐Ÿ“ **Embeddings** | `/v1/embeddings` โ€” 6 provider, 9+ modelli | | ๐ŸŽค **Trascrizione audio** | `/v1/audio/transcriptions` โ€” Compatibile Whisper | | ๐Ÿ”Š **Testo a voce** | `/v1/audio/speech` โ€” Sintesi audio multi-provider | | ๐Ÿ›ก๏ธ **Moderazioni** | `/v1/moderations` โ€” Controlli di sicurezza | | ๐Ÿ”€ **Reranking** | `/v1/rerank` โ€” Riclassificazione rilevanza documenti | ### ๐Ÿ›ก๏ธ Resilienza & Sicurezza | Funzionalitร  | Cosa Fa | | ------------------------------- | -------------------------------------------------------------- | | ๐Ÿ”Œ **Circuit Breaker** | Apertura/chiusura auto per provider con soglie configurabili | | ๐Ÿ›ก๏ธ **Anti-Thundering Herd** | Mutex + semaforo rate-limit per provider con API key | | ๐Ÿง  **Cache semantica** | Cache a due livelli (firma + semantica) riduce costi e latenza | | โšก **Idempotenza richieste** | Finestra dedup 5s per richieste duplicate | | ๐Ÿ”’ **Spoofing TLS Fingerprint** | Bypass rilevamento bot tramite wreq-js | | ๐ŸŒ **Filtro IP** | Allowlist/blocklist per controllo accesso API | | ๐Ÿ“Š **Rate limit modificabili** | RPM, gap minimo e concorrenza massima configurabili | ### ๐Ÿ“Š Osservabilitร  & Analytics | Funzionalitร  | Cosa Fa | | ----------------------------- | ------------------------------------------------------------ | | ๐Ÿ“ **Log richieste** | Modalitร  debug con log completi richiesta/risposta | | ๐Ÿ’พ **Log SQLite** | Log proxy persistenti che sopravvivono ai riavvii | | ๐Ÿ“Š **Dashboard analytics** | Recharts: card statistiche, grafico uso, tabella provider | | ๐Ÿ“ˆ **Tracciamento progresso** | Eventi SSE di progresso opt-in per lo streaming | | ๐Ÿงช **Valutazioni LLM** | Test con golden set e 4 strategie di corrispondenza | | ๐Ÿ” **Telemetria richieste** | Aggregazione latenza p50/p95/p99 + tracciamento X-Request-Id | | ๐Ÿ“‹ **Log + Quote** | Pagine dedicate per navigazione log e tracciamento quote | | ๐Ÿฅ **Dashboard salute** | Uptime, stati circuit breaker, lockout, statistiche cache | | ๐Ÿ’ฐ **Tracciamento costi** | Gestione budget + configurazione prezzi per modello | ### โ˜๏ธ Deploy & Sincronizzazione | Funzionalitร  | Cosa Fa | | -------------------------------- | -------------------------------------------------------------------------------- | | ๐Ÿ’พ **Cloud Sync** | Sincronizza impostazioni tra dispositivi via Cloudflare Workers | | ๐ŸŒ **Deploy ovunque** | Localhost, VPS, Docker, Cloudflare Workers | | ๐Ÿ”‘ **Gestione API Key** | Genera, ruota e limita API key per provider | | ๐Ÿง™ **Assistente configurazione** | Setup guidato in 4 passaggi per nuovi utenti | | ๐Ÿ”ง **Dashboard CLI Tools** | Configurazione con un clic per Claude, Codex, Cline, OpenClaw, Kilo, Antigravity | | ๐Ÿ”„ **Backup DB** | Backup e ripristino automatici di tutte le impostazioni |
๐Ÿ“– Dettagli funzionalitร  ### ๐ŸŽฏ Fallback intelligente 4 livelli Crea combo con fallback automatico: ``` Combo: "my-coding-stack" 1. cc/claude-opus-4-6 (il tuo abbonamento) 2. nvidia/llama-3.3-70b (API NVIDIA gratuita) 3. glm/glm-4.7 (backup economico, $0.6/1M) 4. if/kimi-k2-thinking (fallback gratuito) โ†’ Cambia automaticamente quando la quota si esaurisce o si verificano errori ``` ### ๐Ÿ“Š Tracciamento quote in tempo reale - Consumo token per provider - Countdown reset (5 ore, giornaliero, settimanale) - Stima dei costi per livelli a pagamento - Report spese mensili ### ๐Ÿ”„ Traduzione di formato Traduzione trasparente tra formati: - **OpenAI** โ†” **Claude** โ†” **Gemini** โ†” **OpenAI Responses** - Il tuo CLI invia in formato OpenAI โ†’ OmniRoute traduce โ†’ Il provider riceve il formato nativo - Funziona con qualsiasi strumento che supporti endpoint OpenAI personalizzati ### ๐Ÿ‘ฅ Supporto multi-account - Aggiungi account multipli per provider - Round-robin automatico o routing per prioritร  - Fallback all'account successivo quando la quota viene raggiunta ### ๐Ÿ”„ Rinnovo automatico dei token - I token OAuth si rinnovano automaticamente prima della scadenza - Nessuna necessitร  di ri-autenticazione manuale - Esperienza trasparente su tutti i provider ### ๐ŸŽจ Combo personalizzati - Crea combinazioni di modelli illimitate - 6 strategie: fill-first, round-robin, power-of-two-choices, random, least-used, cost-optimized - Condividi combo tra dispositivi con Cloud Sync ### ๐Ÿฅ Dashboard salute - Stato del sistema (uptime, versione, utilizzo memoria) - Stati circuit breaker per provider (Closed/Open/Half-Open) - Stato rate limit e lockout attivi - Statistiche cache firme - Telemetria latenza (p50/p95/p99) + cache prompt - Reset salute con un clic ### ๐Ÿ”ง Playground del traduttore - Debug, test e visualizzazione delle traduzioni di formato API - Invia richieste e vedi come OmniRoute traduce tra formati dei provider - Inestimabile per risolvere problemi di integrazione ### ๐Ÿ’พ Cloud Sync - Sincronizza provider, combo e impostazioni tra dispositivi - Sincronizzazione in background automatica - Archiviazione criptata sicura
--- ## ๐ŸŽฏ Casi d'Uso ### Caso 1: "Ho un abbonamento Claude Pro" **Problema:** La quota scade inutilizzata, limiti di rate durante la programmazione intensa ``` Combo: "maximize-claude" 1. cc/claude-opus-4-6 (usa l'abbonamento al massimo) 2. glm/glm-4.7 (backup economico quando la quota รจ esaurita) 3. if/kimi-k2-thinking (fallback d'emergenza gratuito) Costo mensile: $20 (abbonamento) + ~$5 (backup) = $25 totale vs. $20 + sbattere contro i limiti = frustrazione ``` ### Caso 2: "Voglio costo zero" **Problema:** Non puรฒ permettersi abbonamenti, ha bisogno di IA affidabile per programmare ``` Combo: "free-forever" 1. gc/gemini-3-flash (180K gratis/mese) 2. if/kimi-k2-thinking (illimitato gratis) 3. qw/qwen3-coder-plus (illimitato gratis) Costo mensile: $0 Qualitร : Modelli pronti per la produzione ``` ### Caso 3: "Devo programmare 24/7, senza interruzioni" **Problema:** Scadenze strette, non puรฒ permettersi downtime ``` Combo: "always-on" 1. cc/claude-opus-4-6 (migliore qualitร ) 2. cx/gpt-5.2-codex (secondo abbonamento) 3. glm/glm-4.7 (economico, reset giornaliero) 4. minimax/MiniMax-M2.1 (piรน economico, reset 5h) 5. if/kimi-k2-thinking (gratuito illimitato) Risultato: 5 livelli di fallback = zero downtime ``` ### Caso 4: "Voglio IA GRATUITA in OpenClaw" **Problema:** Ha bisogno di assistente IA nelle app di messaggistica, completamente gratuito ``` Combo: "openclaw-free" 1. if/glm-4.7 (illimitato gratis) 2. if/minimax-m2.1 (illimitato gratis) 3. if/kimi-k2-thinking (illimitato gratis) Costo mensile: $0 Accesso via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal... ``` --- ## ๐Ÿ“– Guida alla Configurazione
๐Ÿ’ณ Provider per abbonamento ### Claude Code (Pro/Max) ```bash Dashboard โ†’ Provider โ†’ Connetti Claude Code โ†’ Login OAuth โ†’ Rinnovo automatico token โ†’ Tracciamento quota 5h + settimanale Modelli: cc/claude-opus-4-6 cc/claude-sonnet-4-5-20250929 cc/claude-haiku-4-5-20251001 ``` **Consiglio Pro:** Usa Opus per compiti complessi, Sonnet per velocitร . OmniRoute traccia la quota per modello! ### OpenAI Codex (Plus/Pro) ```bash Dashboard โ†’ Provider โ†’ Connetti Codex โ†’ Login OAuth (porta 1455) โ†’ Reset 5h + settimanale Modelli: cx/gpt-5.2-codex cx/gpt-5.1-codex-max ``` ### Gemini CLI (GRATUITO 180K/mese!) ```bash Dashboard โ†’ Provider โ†’ Connetti Gemini CLI โ†’ Google OAuth โ†’ 180K completions/mese + 1K/giorno Modelli: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **Miglior valore:** Livello gratuito enorme! Usa prima dei livelli a pagamento. ### GitHub Copilot ```bash Dashboard โ†’ Provider โ†’ Connetti GitHub โ†’ OAuth via GitHub โ†’ Reset mensile (1ยฐ del mese) Modelli: gh/gpt-5 gh/claude-4.5-sonnet gh/gemini-3-pro ```
๐Ÿ”‘ Provider per API Key ### NVIDIA NIM (GRATUITO 1000 crediti!) 1. Registrati: [build.nvidia.com](https://build.nvidia.com) 2. Ottieni una API key gratuita (1000 crediti di inferenza inclusi) 3. Dashboard โ†’ Aggiungi Provider โ†’ NVIDIA NIM: - API Key: `nvapi-your-key` **Modelli:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` e 50+ altri **Consiglio Pro:** API compatibile OpenAI โ€” funziona perfettamente con la traduzione di formato di OmniRoute! ### DeepSeek 1. Registrati: [platform.deepseek.com](https://platform.deepseek.com) 2. Ottieni una API key 3. Dashboard โ†’ Aggiungi Provider โ†’ DeepSeek **Modelli:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder` ### Groq (Livello gratuito disponibile!) 1. Registrati: [console.groq.com](https://console.groq.com) 2. Ottieni una API key (livello gratuito incluso) 3. Dashboard โ†’ Aggiungi Provider โ†’ Groq **Modelli:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b` **Consiglio Pro:** Inferenza ultra-veloce โ€” ideale per programmazione in tempo reale! ### OpenRouter (100+ modelli) 1. Registrati: [openrouter.ai](https://openrouter.ai) 2. Ottieni una API key 3. Dashboard โ†’ Aggiungi Provider โ†’ OpenRouter **Modelli:** Accesso a 100+ modelli da tutti i principali provider tramite una singola API key.
๐Ÿ’ฐ Provider economici (Backup) ### GLM-4.7 (Reset giornaliero, $0.6/1M) 1. Registrati: [Zhipu AI](https://open.bigmodel.cn/) 2. Ottieni la API key dal Coding Plan 3. Dashboard โ†’ Aggiungi API Key: - Provider: `glm` - API Key: `your-key` **Usa:** `glm/glm-4.7` **Consiglio Pro:** Il Coding Plan offre 3ร— quota a 1/7 del costo! Reset giornaliero alle 10:00. ### MiniMax M2.1 (Reset 5h, $0.20/1M) 1. Registrati: [MiniMax](https://www.minimax.io/) 2. Ottieni una API key 3. Dashboard โ†’ Aggiungi API Key **Usa:** `minimax/MiniMax-M2.1` **Consiglio Pro:** L'opzione piรน economica per contesto lungo (1M token)! ### Kimi K2 ($9/mese fisso) 1. Abbonati: [Moonshot AI](https://platform.moonshot.ai/) 2. Ottieni una API key 3. Dashboard โ†’ Aggiungi API Key **Usa:** `kimi/kimi-latest` **Consiglio Pro:** $9/mese fisso per 10M token = $0.90/1M di costo effettivo!
๐Ÿ†“ Provider GRATUITI (Backup d'emergenza) ### iFlow (8 modelli GRATUITI) ```bash Dashboard โ†’ Connetti iFlow โ†’ Login OAuth iFlow โ†’ Utilizzo illimitato Modelli: if/kimi-k2-thinking if/qwen3-coder-plus if/glm-4.7 if/minimax-m2 if/deepseek-r1 ``` ### Qwen (3 modelli GRATUITI) ```bash Dashboard โ†’ Connetti Qwen โ†’ Autorizzazione con codice dispositivo โ†’ Utilizzo illimitato Modelli: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### Kiro (Claude GRATUITO) ```bash Dashboard โ†’ Connetti Kiro โ†’ AWS Builder ID o Google/GitHub โ†’ Utilizzo illimitato Modelli: kr/claude-sonnet-4.5 kr/claude-haiku-4.5 ```
๐ŸŽจ Creare combo ### Esempio 1: Massimizzare abbonamento โ†’ Backup economico ``` Dashboard โ†’ Combo โ†’ Crea nuovo Nome: premium-coding Modelli: 1. cc/claude-opus-4-6 (Abbonamento principale) 2. glm/glm-4.7 (Backup economico, $0.6/1M) 3. minimax/MiniMax-M2.1 (Fallback piรน economico, $0.20/1M) Usa nel CLI: premium-coding ``` ### Esempio 2: Solo gratuiti (Costo zero) ``` Nome: free-combo Modelli: 1. gc/gemini-3-flash-preview (180K gratis/mese) 2. if/kimi-k2-thinking (illimitato) 3. qw/qwen3-coder-plus (illimitato) Costo: $0 per sempre! ```
๐Ÿ”ง Integrazione CLI ### Cursor IDE ``` Impostazioni โ†’ Modelli โ†’ Avanzato: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [dalla dashboard OmniRoute] Model: cc/claude-opus-4-6 ``` ### Claude Code Usa la pagina **CLI Tools** nella dashboard per la configurazione con un clic, o modifica `~/.claude/settings.json` manualmente. ### Codex CLI ```bash export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-omniroute-api-key" codex "your prompt" ``` ### OpenClaw **Opzione 1 โ€” Dashboard (consigliato):** ``` Dashboard โ†’ CLI Tools โ†’ OpenClaw โ†’ Seleziona Modello โ†’ Applica ``` **Opzione 2 โ€” Manuale:** Modifica `~/.openclaw/openclaw.json`: ```json { "models": { "providers": { "omniroute": { "baseUrl": "http://127.0.0.1:20128/v1", "apiKey": "sk_omniroute", "api": "openai-completions" } } } } ``` > **Nota:** OpenClaw funziona solo con OmniRoute locale. Usa `127.0.0.1` invece di `localhost` per evitare problemi di risoluzione IPv6. ### Cline / Continue / RooCode ``` Impostazioni โ†’ Configurazione API: Provider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [dalla dashboard OmniRoute] Model: if/kimi-k2-thinking ```
--- ## ๐Ÿงช Valutazioni (Evals) OmniRoute include un framework di valutazione integrato per testare la qualitร  delle risposte LLM contro un golden set. Accesso via **Analytics โ†’ Evals** nella dashboard. ### Golden Set integrato Il "OmniRoute Golden Set" precaricato contiene 10 casi di test: - Saluti, matematica, geografia, generazione codice - Conformitร  formato JSON, traduzione, markdown - Rifiuto sicurezza (contenuto nocivo), conteggio, logica booleana ### Strategie di valutazione | Strategia | Descrizione | Esempio | | ---------- | ---------------------------------------------------------- | -------------------------------- | | `exact` | L'output deve corrispondere esattamente | `"4"` | | `contains` | L'output deve contenere la sottostringa (case-insensitive) | `"Paris"` | | `regex` | L'output deve corrispondere al pattern regex | `"1.*2.*3"` | | `custom` | Funzione JS personalizzata restituisce true/false | `(output) => output.length > 10` | --- ## ๐Ÿ› Risoluzione Problemi
Clicca per espandere la guida alla risoluzione problemi **"Language model did not provide messages"** - Quota del provider esaurita โ†’ Controlla il tracker quote nella dashboard - Soluzione: Usa un combo con fallback o passa a un livello piรน economico **Rate limiting** - Quota abbonamento esaurita โ†’ Fallback a GLM/MiniMax - Aggiungi combo: `cc/claude-opus-4-6 โ†’ glm/glm-4.7 โ†’ if/kimi-k2-thinking` **Token OAuth scaduto** - Rinnovato automaticamente da OmniRoute - Se il problema persiste: Dashboard โ†’ Provider โ†’ Riconnetti **Costi elevati** - Controlla le statistiche di utilizzo in Dashboard โ†’ Costi - Cambia il modello principale a GLM/MiniMax - Usa il livello gratuito (Gemini CLI, iFlow) per compiti non critici **La dashboard si apre sulla porta sbagliata** - Imposta `PORT=20128` e `NEXT_PUBLIC_BASE_URL=http://localhost:20128` **Errori cloud sync** - Verifica che `BASE_URL` punti alla tua istanza in esecuzione - Verifica che `CLOUD_URL` punti all'endpoint cloud previsto - Mantieni i valori `NEXT_PUBLIC_*` allineati con i valori del server **Il primo login non funziona** - Controlla `INITIAL_PASSWORD` nel `.env` - Se non impostata, la password predefinita รจ `123456` **Nessun log delle richieste** - Imposta `ENABLE_REQUEST_LOGS=true` nel `.env` **Il test di connessione mostra "Invalid" per provider compatibili OpenAI** - Molti provider non espongono l'endpoint `/models` - OmniRoute v1.0.6+ include validazione fallback tramite chat completions - Assicurati che la URL base includa il suffisso `/v1`
--- ## ๐Ÿ› ๏ธ Stack Tecnologico - **Runtime**: Node.js 20+ - **Linguaggio**: TypeScript 5.9 โ€” **100% TypeScript** in `src/` e `open-sse/` (v1.0.6) - **Framework**: Next.js 16 + React 19 + Tailwind CSS 4 - **Database**: LowDB (JSON) + SQLite (stato dominio + log proxy) - **Streaming**: Server-Sent Events (SSE) - **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys - **Testing**: Node.js test runner (368+ test unitari) - **CI/CD**: GitHub Actions (pubblicazione automatica npm + Docker Hub al rilascio) - **Sito Web**: [omniroute.online](https://omniroute.online) - **Pacchetto**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute) - **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute) - **Resilienza**: Circuit breaker, backoff esponenziale, anti-thundering herd, TLS spoofing --- ## ๐Ÿ“– Documentazione | Documento | Descrizione | | ----------------------------------------------- | -------------------------------------------------- | | [Guida Utente](docs/USER_GUIDE.md) | Provider, combo, integrazione CLI, deploy | | [Riferimento API](docs/API_REFERENCE.md) | Tutti gli endpoint con esempi | | [Risoluzione Problemi](docs/TROUBLESHOOTING.md) | Problemi comuni e soluzioni | | [Architettura](docs/ARCHITECTURE.md) | Architettura del sistema e dettagli interni | | [Come Contribuire](CONTRIBUTING.md) | Setup di sviluppo e linee guida | | [Spec OpenAPI](docs/openapi.yaml) | Specifica OpenAPI 3.0 | | [Politica di Sicurezza](SECURITY.md) | Segnalazione vulnerabilitร  e pratiche di sicurezza | --- ## ๐Ÿ“ง Supporto > ๐Ÿ’ฌ **Unisciti alla nostra community!** [Gruppo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) โ€” Ottieni aiuto, condividi consigli e rimani aggiornato. - **Sito Web**: [omniroute.online](https://omniroute.online) - **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) - **Issues**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **WhatsApp**: [Gruppo della comunitร ](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **WhatsApp**: [Gruppo della comunitร ](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **Progetto Originale**: [9router di decolua](https://github.com/decolua/9router) --- ## ๐Ÿ‘ฅ Contributori [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) ### Come Contribuire 1. Fai il fork del repository 2. Crea il tuo branch di funzionalitร  (`git checkout -b feature/amazing-feature`) 3. Fai il commit delle modifiche (`git commit -m 'Add amazing feature'`) 4. Fai il push al branch (`git push origin feature/amazing-feature`) 5. Apri una Pull Request Consulta [CONTRIBUTING.md](CONTRIBUTING.md) per le linee guida dettagliate. ### Rilasciare una nuova versione ```bash # Crea un rilascio โ€” la pubblicazione npm avviene automaticamente gh release create v1.0.6 --title "v1.0.6" --generate-notes ``` --- ## ๐Ÿ“Š Cronologia Stelle Star History Chart --- ## ๐Ÿ™ Ringraziamenti Un ringraziamento speciale a **[9router](https://github.com/decolua/9router)** di **[decolua](https://github.com/decolua)** โ€” il progetto originale che ha ispirato questo fork. OmniRoute si costruisce su quell'incredibile base con funzionalitร  aggiuntive, API multi-modali e una riscrittura completa in TypeScript. Un ringraziamento speciale a **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** โ€” l'implementazione originale in Go che ha ispirato questo porting in JavaScript. --- ## ๐Ÿ“„ Licenza Licenza MIT โ€” vedi [LICENSE](LICENSE) per i dettagli. ---
Fatto con โค๏ธ per gli sviluppatori che programmano 24/7
omniroute.online