diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8c53445602..0b95dee905 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -37,6 +37,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [0.8.5] — 2026-02-17
+> ### 🔷 MILESTONE: 100% TypeScript Migration
+>
+> **OmniRoute is now fully TypeScript.** The entire `src/` directory (API routes, components, services, lib, domain layer) and all 94 files in `open-sse/` have been migrated from JavaScript/JSX to TypeScript/TSX — with zero `@ts-ignore` annotations and zero TypeScript errors. This is a complete rewrite of the type layer across 200+ files.
+
### Added
- 🔒 **TLS fingerprint spoofing** — Implement browser-like TLS fingerprinting via `wreq-js` to bypass bot detection on providers that enforce TLS client fingerprint checks (`3dd0cc1`, PR #52)
diff --git a/README.de.md b/README.de.md
new file mode 100644
index 0000000000..c06169317b
--- /dev/null
+++ b/README.de.md
@@ -0,0 +1,995 @@
+
+
+
+ # 🚀 OmniRoute — Das kostenlose AI-Gateway
+
+### Höre nie auf zu programmieren. Intelligentes Routing zu **KOSTENLOSEN und günstigen KI-Modellen** mit automatischem Fallback.
+
+_Dein universeller API-Proxy — ein Endpoint, 36+ Anbieter, null Ausfallzeit._
+
+**Chat Completions • Embeddings • Bildgenerierung • Audio • Reranking • 100% TypeScript**
+
+---
+
+### 🤖 Kostenloser KI-Anbieter für deine Lieblings-Coding-Agenten
+
+_Verbinde jedes KI-gesteuerte IDE- oder CLI-Tool über OmniRoute — kostenloses API-Gateway für unbegrenztes Programmieren._
+
+
+
+---
+
+## 🤔 Warum OmniRoute?
+
+**Hör auf, Geld zu verschwenden und an Limits zu stoßen:**
+
+- Abo-Kontingent verfällt jeden Monat ungenutzt
+- Rate-Limits stoppen dich mitten beim Programmieren
+- Teure APIs ($20-50/Monat pro Anbieter)
+- Manuelles Wechseln zwischen Anbietern
+
+**OmniRoute löst das:**
+
+- ✅ **Abos maximieren** — Kontingente tracken, alles vor dem Reset nutzen
+- ✅ **Automatischer Fallback** — Abo → API Key → Günstig → Kostenlos, null Ausfallzeit
+- ✅ **Multi-Account** — Round-Robin zwischen Konten pro Anbieter
+- ✅ **Universal** — Funktioniert mit Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, jedem CLI-Tool
+
+---
+
+## 🔄 So funktioniert's
+
+```
+┌─────────────┐
+│ Dein CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
+│ Tool │
+└──────┬──────┘
+ │ http://localhost:20128/v1
+ ↓
+┌─────────────────────────────────────────┐
+│ OmniRoute (Smart Router) │
+│ • Format-Übersetzung (OpenAI ↔ Claude) │
+│ • Kontingent-Tracking + Embeddings + Bilder │
+│ • Automatische Token-Erneuerung │
+└──────┬──────────────────────────────────┘
+ │
+ ├─→ [Tier 1: ABO] Claude Code, Codex, Gemini CLI
+ │ ↓ Kontingent erschöpft
+ ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM usw.
+ │ ↓ Budget-Limit
+ ├─→ [Tier 3: GÜNSTIG] GLM ($0.6/1M), MiniMax ($0.2/1M)
+ │ ↓ Budget-Limit
+ └─→ [Tier 4: KOSTENLOS] iFlow, Qwen, Kiro (unbegrenzt)
+
+Ergebnis: Nie aufhören zu programmieren, minimale Kosten
+```
+
+---
+
+## ⚡ Schnellstart
+
+**1. Global installieren:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Das Dashboard öffnet sich unter `http://localhost:20128`
+
+| Befehl | Beschreibung |
+| ----------------------- | ----------------------------------- |
+| `omniroute` | Server starten (Standardport 20128) |
+| `omniroute --port 3000` | Benutzerdefinierten Port verwenden |
+| `omniroute --no-open` | Browser nicht automatisch öffnen |
+| `omniroute --help` | Hilfe anzeigen |
+
+**2. KOSTENLOSEN Anbieter verbinden:**
+
+Dashboard → Anbieter → **Claude Code** oder **Antigravity** verbinden → OAuth Login → Fertig!
+
+**3. In deinem CLI-Tool verwenden:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Einstellungen:
+ Endpoint: http://localhost:20128/v1
+ API Key: [vom Dashboard kopieren]
+ Model: if/kimi-k2-thinking
+```
+
+**Das war's!** Beginne mit KOSTENLOSEN KI-Modellen zu programmieren.
+
+**Alternative — aus Quellcode ausführen:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+OmniRoute ist als öffentliches Docker-Image auf [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) verfügbar.
+
+**Schnellstart:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Mit Umgebungsdatei:**
+
+```bash
+# .env kopieren und bearbeiten
+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
+```
+
+**Mit Docker Compose:**
+
+```bash
+# Basisprofil (ohne CLI-Tools)
+docker compose --profile base up -d
+
+# CLI-Profil (Claude Code, Codex, OpenClaw integriert)
+docker compose --profile cli up -d
+```
+
+| Image | Tag | Größe | Beschreibung |
+| ------------------------ | -------- | ------ | ------------------------ |
+| `diegosouzapw/omniroute` | `latest` | ~250MB | Letztes stabiles Release |
+| `diegosouzapw/omniroute` | `0.8.8` | ~250MB | Aktuelle Version |
+
+---
+
+## 💰 Preisübersicht
+
+| Tier | Anbieter | Kosten | Kontingent-Reset | Am besten für |
+| ---------------- | ----------------- | ---------------------------- | ------------------- | ----------------------- |
+| **💳 ABO** | Claude Code (Pro) | $20/Monat | 5h + wöchentlich | Bereits abonniert |
+| | Codex (Plus/Pro) | $20-200/Monat | 5h + wöchentlich | OpenAI-Nutzer |
+| | Gemini CLI | **KOSTENLOS** | 180K/Monat + 1K/Tag | Alle! |
+| | GitHub Copilot | $10-19/Monat | Monatlich | GitHub-Nutzer |
+| **🔑 API KEY** | NVIDIA NIM | **KOSTENLOS** (1000 Credits) | Einmalig | Kostenloses Testen |
+| | DeepSeek | Nach Verbrauch | Keiner | Bestes Preis-Leistung |
+| | Groq | Gratis-Stufe + bezahlt | Begrenzt | Ultra-schnelle Inferenz |
+| | xAI (Grok) | Nach Verbrauch | Keiner | Grok-Modelle |
+| | Mistral | Gratis-Stufe + bezahlt | Begrenzt | Europäische KI |
+| | OpenRouter | Nach Verbrauch | Keiner | 100+ Modelle |
+| **💰 GÜNSTIG** | GLM-4.7 | $0.6/1M | Täglich 10h | Budget-Backup |
+| | MiniMax M2.1 | $0.2/1M | 5h rotierend | Günstigste Option |
+| | Kimi K2 | $9/Monat fest | 10M Token/Monat | Vorhersagbare Kosten |
+| **🆓 KOSTENLOS** | iFlow | $0 | Unbegrenzt | 8 kostenlose Modelle |
+| | Qwen | $0 | Unbegrenzt | 3 kostenlose Modelle |
+| | Kiro | $0 | Unbegrenzt | Kostenloses Claude |
+
+**💡 Profi-Tipp:** Starte mit Gemini CLI (180K gratis/Monat) + iFlow (unbegrenzt gratis) = $0 Kosten!
+
+---
+
+## 🎯 Anwendungsfälle
+
+### Fall 1: „Ich habe ein Claude Pro Abo"
+
+**Problem:** Kontingent verfällt ungenutzt, Rate-Limits während intensivem Programmieren
+
+```
+Combo: "maximize-claude"
+ 1. cc/claude-opus-4-6 (Abo voll ausnutzen)
+ 2. glm/glm-4.7 (günstiges Backup bei erschöpftem Kontingent)
+ 3. if/kimi-k2-thinking (kostenloser Notfall-Fallback)
+
+Monatliche Kosten: $20 (Abo) + ~$5 (Backup) = $25 gesamt
+vs. $20 + an Limits stoßen = Frustration
+```
+
+### Fall 2: „Ich will null Kosten"
+
+**Problem:** Kann sich Abos nicht leisten, braucht zuverlässige KI zum Programmieren
+
+```
+Combo: "free-forever"
+ 1. gc/gemini-3-flash (180K gratis/Monat)
+ 2. if/kimi-k2-thinking (unbegrenzt gratis)
+ 3. qw/qwen3-coder-plus (unbegrenzt gratis)
+
+Monatliche Kosten: $0
+Qualität: Produktionsreife Modelle
+```
+
+### Fall 3: „Ich muss 24/7 programmieren, ohne Unterbrechungen"
+
+**Problem:** Enge Deadlines, kann sich keine Ausfallzeit leisten
+
+```
+Combo: "always-on"
+ 1. cc/claude-opus-4-6 (beste Qualität)
+ 2. cx/gpt-5.2-codex (zweites Abo)
+ 3. glm/glm-4.7 (günstig, täglicher Reset)
+ 4. minimax/MiniMax-M2.1 (günstigste, 5h Reset)
+ 5. if/kimi-k2-thinking (unbegrenzt kostenlos)
+
+Ergebnis: 5 Fallback-Ebenen = null Ausfallzeit
+```
+
+### Fall 4: „Ich will KOSTENLOSE KI in OpenClaw"
+
+**Problem:** Braucht KI-Assistenz in Messaging-Apps, komplett kostenlos
+
+```
+Combo: "openclaw-free"
+ 1. if/glm-4.7 (unbegrenzt kostenlos)
+ 2. if/minimax-m2.1 (unbegrenzt kostenlos)
+ 3. if/kimi-k2-thinking (unbegrenzt kostenlos)
+
+Monatliche Kosten: $0
+Zugang über: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Hauptfunktionen
+
+### 🧠 Routing & Intelligenz
+
+| Funktion | Was es macht |
+| ------------------------------------ | ------------------------------------------------------------------------------ |
+| 🎯 **Intelligenter 4-Tier-Fallback** | Auto-Routing: Abo → API Key → Günstig → Kostenlos |
+| 📊 **Echtzeit-Kontingent-Tracking** | Live Token-Zählung + Reset-Countdown pro Anbieter |
+| 🔄 **Format-Übersetzung** | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro nahtlos |
+| 👥 **Multi-Account-Unterstützung** | Mehrere Konten pro Anbieter mit intelligenter Auswahl |
+| 🔄 **Auto-Token-Erneuerung** | OAuth-Token werden automatisch mit Wiederholungen erneuert |
+| 🎨 **Benutzerdefinierte Combos** | 6 Strategien: fill-first, round-robin, p2c, random, least-used, cost-optimized |
+| 🧩 **Benutzerdefinierte Modelle** | Jede Modell-ID zu jedem Anbieter hinzufügen |
+| 🌐 **Wildcard-Router** | `provider/*` Muster dynamisch an jeden Anbieter routen |
+| 🧠 **Reasoning-Budget** | Passthrough, auto, custom und adaptive Modi für Reasoning-Modelle |
+| 💬 **System Prompt Injection** | Globaler System Prompt für alle Anfragen |
+| 📄 **API Responses** | Volle Unterstützung der OpenAI Responses API (`/v1/responses`) für Codex |
+
+### 🎵 Multi-Modale APIs
+
+| Funktion | Was es macht |
+| -------------------------- | ------------------------------------------------- |
+| 🖼️ **Bildgenerierung** | `/v1/images/generations` — 4 Anbieter, 9+ Modelle |
+| 📐 **Embeddings** | `/v1/embeddings` — 6 Anbieter, 9+ Modelle |
+| 🎤 **Audio-Transkription** | `/v1/audio/transcriptions` — Whisper-kompatibel |
+| 🔊 **Text-zu-Sprache** | `/v1/audio/speech` — Multi-Anbieter Audiosynthese |
+| 🛡️ **Moderationen** | `/v1/moderations` — Sicherheitsüberprüfungen |
+| 🔀 **Reranking** | `/v1/rerank` — Dokumenten-Relevanz-Neuordnung |
+
+### 🛡️ Resilienz & Sicherheit
+
+| Funktion | Was es macht |
+| ------------------------------- | -------------------------------------------------------------------- |
+| 🔌 **Circuit Breaker** | Auto-Öffnung/-Schließung pro Anbieter mit konfigurierbaren Schwellen |
+| 🛡️ **Anti-Thundering Herd** | Mutex + Semaphor Rate-Limit für API-Key-Anbieter |
+| 🧠 **Semantischer Cache** | Zwei-Ebenen-Cache (Signatur + Semantik) senkt Kosten und Latenz |
+| ⚡ **Anfrage-Idempotenz** | 5s Dedup-Fenster für doppelte Anfragen |
+| 🔒 **TLS-Fingerprint-Spoofing** | Bot-Erkennung umgehen via wreq-js |
+| 🌐 **IP-Filterung** | Allowlist/Blocklist für API-Zugriffskontrolle |
+| 📊 **Editierbare Rate-Limits** | Konfigurierbare RPM, minimaler Abstand, max. Konkurrenz |
+
+### 📊 Observability & Analytics
+
+| Funktion | Was es macht |
+| ---------------------------- | -------------------------------------------------------------- |
+| 📝 **Anfrage-Logs** | Debug-Modus mit vollständigen Request/Response-Logs |
+| 💾 **SQLite-Logs** | Persistente Proxy-Logs überleben Neustarts |
+| 📊 **Analytics-Dashboard** | Recharts: Statistik-Karten, Nutzungsdiagramm, Anbieter-Tabelle |
+| 📈 **Fortschritts-Tracking** | Opt-in SSE-Fortschrittsereignisse für Streaming |
+| 🧪 **LLM-Evaluierungen** | Testen mit Golden Set und 4 Match-Strategien |
+| 🔍 **Anfrage-Telemetrie** | p50/p95/p99 Latenz-Aggregation + X-Request-Id Tracking |
+| 📋 **Logs + Kontingente** | Dedizierte Seiten für Log-Browsing und Kontingent-Tracking |
+| 🏥 **Health Dashboard** | Uptime, Circuit-Breaker-Status, Lockouts, Cache-Statistiken |
+| 💰 **Kosten-Tracking** | Budget-Management + Preiseinstellung pro Modell |
+
+### ☁️ Deployment & Sync
+
+| Funktion | Was es macht |
+| -------------------------- | ----------------------------------------------------------------------------- |
+| 💾 **Cloud Sync** | Einstellungen zwischen Geräten via Cloudflare Workers synchronisieren |
+| 🌐 **Überall deployen** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **API-Key-Verwaltung** | API-Keys pro Anbieter generieren, rotieren und einschränken |
+| 🧙 **Setup-Assistent** | 4-Schritte geführtes Setup für neue Nutzer |
+| 🔧 **CLI Tools Dashboard** | Ein-Klick-Konfiguration für Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **DB-Backups** | Automatisches Backup und Wiederherstellung aller Einstellungen |
+
+
+📖 Funktionsdetails
+
+### 🎯 Intelligenter 4-Tier-Fallback
+
+Erstelle Combos mit automatischem Fallback:
+
+```
+Combo: "my-coding-stack"
+ 1. cc/claude-opus-4-6 (dein Abo)
+ 2. nvidia/llama-3.3-70b (kostenlose NVIDIA API)
+ 3. glm/glm-4.7 (günstiges Backup, $0.6/1M)
+ 4. if/kimi-k2-thinking (kostenloser Fallback)
+
+→ Wechselt automatisch bei erschöpftem Kontingent oder Fehlern
+```
+
+### 📊 Echtzeit-Kontingent-Tracking
+
+- Token-Verbrauch pro Anbieter
+- Reset-Countdown (5 Stunden, täglich, wöchentlich)
+- Kostenabschätzung für bezahlte Stufen
+- Monatliche Ausgabenberichte
+
+### 🔄 Format-Übersetzung
+
+Nahtlose Übersetzung zwischen Formaten:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses**
+- Dein CLI sendet OpenAI-Format → OmniRoute übersetzt → Anbieter empfängt natives Format
+- Funktioniert mit jedem Tool, das benutzerdefinierte OpenAI-Endpoints unterstützt
+
+### 👥 Multi-Account-Unterstützung
+
+- Mehrere Konten pro Anbieter hinzufügen
+- Automatisches Round-Robin oder prioritätsbasiertes Routing
+- Fallback zum nächsten Konto bei Kontingent-Erschöpfung
+
+### 🔄 Auto-Token-Erneuerung
+
+- OAuth-Token werden automatisch vor Ablauf erneuert
+- Keine manuelle Neuauthentifizierung nötig
+- Nahtlose Erfahrung über alle Anbieter
+
+### 🎨 Benutzerdefinierte Combos
+
+- Unbegrenzte Modell-Kombinationen erstellen
+- 6 Strategien: fill-first, round-robin, power-of-two-choices, random, least-used, cost-optimized
+- Combos zwischen Geräten mit Cloud Sync teilen
+
+### 🏥 Health Dashboard
+
+- Systemstatus (Uptime, Version, Speichernutzung)
+- Circuit-Breaker-Status pro Anbieter (Closed/Open/Half-Open)
+- Rate-Limit-Status und aktive Lockouts
+- Signatur-Cache-Statistiken
+- Latenz-Telemetrie (p50/p95/p99) + Prompt-Cache
+- Gesundheitsstatus mit einem Klick zurücksetzen
+
+### 🔧 Übersetzer-Playground
+
+- Debug, Test und Visualisierung von API-Format-Übersetzungen
+- Anfragen senden und sehen, wie OmniRoute zwischen Anbieter-Formaten übersetzt
+- Unschätzbar für Integrationsprobleme
+
+### 💾 Cloud Sync
+
+- Anbieter, Combos und Einstellungen zwischen Geräten synchronisieren
+- Automatische Hintergrundsynchronisierung
+- Sichere verschlüsselte Speicherung
+
+
+
+---
+
+## 📖 Einrichtungsanleitung
+
+
+💳 Abo-Anbieter
+
+### Claude Code (Pro/Max)
+
+```bash
+Dashboard → Anbieter → Claude Code verbinden
+→ OAuth Login → Automatische Token-Erneuerung
+→ 5h + wöchentliches Kontingent-Tracking
+
+Modelle:
+ cc/claude-opus-4-6
+ cc/claude-sonnet-4-5-20250929
+ cc/claude-haiku-4-5-20251001
+```
+
+**Profi-Tipp:** Opus für komplexe Aufgaben, Sonnet für Geschwindigkeit. OmniRoute trackt Kontingent pro Modell!
+
+### OpenAI Codex (Plus/Pro)
+
+```bash
+Dashboard → Anbieter → Codex verbinden
+→ OAuth Login (Port 1455)
+→ 5h + wöchentlicher Reset
+
+Modelle:
+ cx/gpt-5.2-codex
+ cx/gpt-5.1-codex-max
+```
+
+### Gemini CLI (KOSTENLOS 180K/Monat!)
+
+```bash
+Dashboard → Anbieter → Gemini CLI verbinden
+→ Google OAuth
+→ 180K Completions/Monat + 1K/Tag
+
+Modelle:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Bester Wert:** Riesiger Gratis-Tarif! Vor bezahlten Stufen nutzen.
+
+### GitHub Copilot
+
+```bash
+Dashboard → Anbieter → GitHub verbinden
+→ OAuth via GitHub
+→ Monatlicher Reset (1. des Monats)
+
+Modelle:
+ gh/gpt-5
+ gh/claude-4.5-sonnet
+ gh/gemini-3-pro
+```
+
+
+
+
+🔑 API-Key-Anbieter
+
+### NVIDIA NIM (KOSTENLOS 1000 Credits!)
+
+1. Registrieren: [build.nvidia.com](https://build.nvidia.com)
+2. Kostenlosen API-Key holen (1000 Inferenz-Credits inklusive)
+3. Dashboard → Anbieter hinzufügen → NVIDIA NIM:
+ - API Key: `nvapi-your-key`
+
+**Modelle:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` und 50+ weitere
+
+**Profi-Tipp:** OpenAI-kompatible API — funktioniert perfekt mit OmniRoutes Format-Übersetzung!
+
+### DeepSeek
+
+1. Registrieren: [platform.deepseek.com](https://platform.deepseek.com)
+2. API-Key holen
+3. Dashboard → Anbieter hinzufügen → DeepSeek
+
+**Modelle:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Gratis-Stufe verfügbar!)
+
+1. Registrieren: [console.groq.com](https://console.groq.com)
+2. API-Key holen (Gratis-Stufe inklusive)
+3. Dashboard → Anbieter hinzufügen → Groq
+
+**Modelle:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Profi-Tipp:** Ultra-schnelle Inferenz — am besten für Echtzeit-Programmierung!
+
+### OpenRouter (100+ Modelle)
+
+1. Registrieren: [openrouter.ai](https://openrouter.ai)
+2. API-Key holen
+3. Dashboard → Anbieter hinzufügen → OpenRouter
+
+**Modelle:** Zugang zu 100+ Modellen aller großen Anbieter über einen einzigen API-Key.
+
+
+
+
+💰 Günstige Anbieter (Backup)
+
+### GLM-4.7 (Täglicher Reset, $0.6/1M)
+
+1. Registrieren: [Zhipu AI](https://open.bigmodel.cn/)
+2. API-Key aus dem Coding Plan holen
+3. Dashboard → API Key hinzufügen:
+ - Anbieter: `glm`
+ - API Key: `your-key`
+
+**Nutze:** `glm/glm-4.7`
+
+**Profi-Tipp:** Der Coding Plan bietet 3× Kontingent zu 1/7 der Kosten! Täglicher Reset um 10:00.
+
+### MiniMax M2.1 (5h Reset, $0.20/1M)
+
+1. Registrieren: [MiniMax](https://www.minimax.io/)
+2. API-Key holen
+3. Dashboard → API Key hinzufügen
+
+**Nutze:** `minimax/MiniMax-M2.1`
+
+**Profi-Tipp:** Günstigste Option für langen Kontext (1M Token)!
+
+### Kimi K2 ($9/Monat fest)
+
+1. Abonnieren: [Moonshot AI](https://platform.moonshot.ai/)
+2. API-Key holen
+3. Dashboard → API Key hinzufügen
+
+**Nutze:** `kimi/kimi-latest`
+
+**Profi-Tipp:** Feste $9/Monat für 10M Token = $0.90/1M effektive Kosten!
+
+
+
+
+🆓 KOSTENLOSE Anbieter (Notfall-Backup)
+
+### iFlow (8 KOSTENLOSE Modelle)
+
+```bash
+Dashboard → iFlow verbinden
+→ iFlow OAuth Login
+→ Unbegrenzte Nutzung
+
+Modelle:
+ if/kimi-k2-thinking
+ if/qwen3-coder-plus
+ if/glm-4.7
+ if/minimax-m2
+ if/deepseek-r1
+```
+
+### Qwen (3 KOSTENLOSE Modelle)
+
+```bash
+Dashboard → Qwen verbinden
+→ Geräte-Code-Autorisierung
+→ Unbegrenzte Nutzung
+
+Modelle:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Kostenloses Claude)
+
+```bash
+Dashboard → Kiro verbinden
+→ AWS Builder ID oder Google/GitHub
+→ Unbegrenzte Nutzung
+
+Modelle:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Combos erstellen
+
+### Beispiel 1: Abo maximieren → Günstiges Backup
+
+```
+Dashboard → Combos → Neues erstellen
+
+Name: premium-coding
+Modelle:
+ 1. cc/claude-opus-4-6 (Primäres Abo)
+ 2. glm/glm-4.7 (Günstiges Backup, $0.6/1M)
+ 3. minimax/MiniMax-M2.1 (Günstigster Fallback, $0.20/1M)
+
+Im CLI nutzen: premium-coding
+```
+
+### Beispiel 2: Nur Kostenlos (Null Kosten)
+
+```
+Name: free-combo
+Modelle:
+ 1. gc/gemini-3-flash-preview (180K gratis/Monat)
+ 2. if/kimi-k2-thinking (unbegrenzt)
+ 3. qw/qwen3-coder-plus (unbegrenzt)
+
+Kosten: Für immer $0!
+```
+
+
+
+
+🔧 CLI-Integration
+
+### Cursor IDE
+
+```
+Einstellungen → Modelle → Erweitert:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [aus OmniRoute Dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### Claude Code
+
+Nutze die **CLI Tools** Seite im Dashboard für Ein-Klick-Konfiguration, oder bearbeite `~/.claude/settings.json` manuell.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Option 1 — Dashboard (empfohlen):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Modell wählen → Anwenden
+```
+
+**Option 2 — Manuell:** `~/.openclaw/openclaw.json` bearbeiten:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Hinweis:** OpenClaw funktioniert nur mit lokalem OmniRoute. Verwende `127.0.0.1` statt `localhost` um IPv6-Auflösungsprobleme zu vermeiden.
+
+### Cline / Continue / RooCode
+
+```
+Einstellungen → API-Konfiguration:
+ Anbieter: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [aus OmniRoute Dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Verfügbare Modelle
+
+
+Alle verfügbaren Modelle anzeigen
+
+**Claude Code (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - KOSTENLOS:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub Copilot (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - KOSTENLOSE Credits:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ weitere Modelle auf [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0.6/1M:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0.2/1M:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - KOSTENLOS:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - KOSTENLOS:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - KOSTENLOS:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ Modelle:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Jedes Modell von [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Evaluierungen (Evals)
+
+OmniRoute enthält ein integriertes Evaluierungs-Framework zum Testen der LLM-Antwortqualität gegen ein Golden Set. Zugang über **Analytics → Evals** im Dashboard.
+
+### Integriertes Golden Set
+
+Das vorgeladene „OmniRoute Golden Set" enthält 10 Testfälle:
+
+- Begrüßungen, Mathematik, Geographie, Code-Generierung
+- JSON-Formatkonformität, Übersetzung, Markdown
+- Sicherheitsablehnung (schädlicher Inhalt), Zählung, Boolesche Logik
+
+### Evaluierungsstrategien
+
+| Strategie | Beschreibung | Beispiel |
+| ---------- | ---------------------------------------------------------- | -------------------------------- |
+| `exact` | Ausgabe muss exakt übereinstimmen | `"4"` |
+| `contains` | Ausgabe muss Teilzeichenfolge enthalten (case-insensitive) | `"Paris"` |
+| `regex` | Ausgabe muss Regex-Muster entsprechen | `"1.*2.*3"` |
+| `custom` | Benutzerdefinierte JS-Funktion gibt true/false zurück | `(output) => output.length > 10` |
+
+---
+
+## 🐛 Fehlerbehebung
+
+
+Klicke zum Erweitern der Fehlerbehebungsanleitung
+
+**„Language model did not provide messages"**
+
+- Anbieter-Kontingent erschöpft → Kontingent-Tracker im Dashboard prüfen
+- Lösung: Combo mit Fallback nutzen oder zu günstigerer Stufe wechseln
+
+**Rate Limiting**
+
+- Abo-Kontingent erschöpft → Fallback zu GLM/MiniMax
+- Combo hinzufügen: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**OAuth-Token abgelaufen**
+
+- Wird automatisch von OmniRoute erneuert
+- Falls Problem bestehen bleibt: Dashboard → Anbieter → Neu verbinden
+
+**Hohe Kosten**
+
+- Nutzungsstatistiken unter Dashboard → Kosten prüfen
+- Primärmodell auf GLM/MiniMax umstellen
+- Gratis-Stufe (Gemini CLI, iFlow) für unkritische Aufgaben nutzen
+
+**Dashboard öffnet sich auf falschem Port**
+
+- `PORT=20128` und `NEXT_PUBLIC_BASE_URL=http://localhost:20128` setzen
+
+**Cloud-Sync-Fehler**
+
+- Prüfe dass `BASE_URL` auf deine laufende Instanz zeigt
+- Prüfe dass `CLOUD_URL` auf den erwarteten Cloud-Endpoint zeigt
+- `NEXT_PUBLIC_*` Werte mit Serverwerten synchron halten
+
+**Erster Login funktioniert nicht**
+
+- `INITIAL_PASSWORD` in `.env` prüfen
+- Falls nicht gesetzt, Standard-Passwort ist `123456`
+
+**Keine Anfrage-Logs**
+
+- `ENABLE_REQUEST_LOGS=true` in `.env` setzen
+
+**Verbindungstest zeigt „Invalid" für OpenAI-kompatible Anbieter**
+
+- Viele Anbieter stellen den `/models` Endpoint nicht bereit
+- OmniRoute v0.8.8+ enthält Fallback-Validierung via Chat Completions
+- Stelle sicher, dass die Base URL den `/v1` Suffix enthält
+
+
+
+---
+
+## 🛠️ Technologie-Stack
+
+- **Runtime**: Node.js 20+
+- **Sprache**: TypeScript 5.9 — **100% TypeScript** in `src/` und `open-sse/` (v0.8.8)
+- **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Datenbank**: LowDB (JSON) + SQLite (Domain-Status + Proxy-Logs)
+- **Streaming**: Server-Sent Events (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys
+- **Testing**: Node.js Test Runner (368+ Unit-Tests)
+- **CI/CD**: GitHub Actions (automatische npm + Docker Hub Veröffentlichung bei Release)
+- **Website**: [omniroute.online](https://omniroute.online)
+- **Paket**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Resilienz**: Circuit Breaker, exponentieller Backoff, Anti-Thundering Herd, TLS-Spoofing
+
+---
+
+## 📖 Dokumentation
+
+| Dokument | Beschreibung |
+| ------------------------------------------ | ---------------------------------------------- |
+| [Benutzerhandbuch](docs/USER_GUIDE.md) | Anbieter, Combos, CLI-Integration, Deploy |
+| [API-Referenz](docs/API_REFERENCE.md) | Alle Endpoints mit Beispielen |
+| [Fehlerbehebung](docs/TROUBLESHOOTING.md) | Häufige Probleme und Lösungen |
+| [Architektur](docs/ARCHITECTURE.md) | Systemarchitektur und Interna |
+| [Mitwirken](CONTRIBUTING.md) | Entwicklungs-Setup und Richtlinien |
+| [OpenAPI-Spezifikation](docs/openapi.yaml) | OpenAPI 3.0 Spezifikation |
+| [Sicherheitsrichtlinie](SECURITY.md) | Schwachstellen melden und Sicherheitspraktiken |
+
+---
+
+## 📧 Support
+
+- **Website**: [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)
+- **Originalprojekt**: [9router von decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Mitwirkende
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Wie du mitwirken kannst
+
+1. Repository forken
+2. Feature-Branch erstellen (`git checkout -b feature/amazing-feature`)
+3. Änderungen committen (`git commit -m 'Add amazing feature'`)
+4. Branch pushen (`git push origin feature/amazing-feature`)
+5. Pull Request öffnen
+
+Siehe [CONTRIBUTING.md](CONTRIBUTING.md) für detaillierte Richtlinien.
+
+### Neue Version veröffentlichen
+
+```bash
+# Release erstellen — npm-Veröffentlichung erfolgt automatisch
+gh release create v0.8.8 --title "v0.8.8" --generate-notes
+```
+
+---
+
+## 📊 Star-Verlauf
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Danksagungen
+
+Besonderer Dank an **[9router](https://github.com/decolua/9router)** von **[decolua](https://github.com/decolua)** — das Originalprojekt, das diesen Fork inspiriert hat. OmniRoute baut auf diesem unglaublichen Fundament auf mit zusätzlichen Funktionen, Multi-Modalen APIs und einem vollständigen TypeScript-Rewrite.
+
+Besonderer Dank an **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — die ursprüngliche Go-Implementierung, die diese JavaScript-Portierung inspiriert hat.
+
+---
+
+## 📄 Lizenz
+
+MIT-Lizenz — siehe [LICENSE](LICENSE) für Details.
+
+---
+
+
+ Mit ❤️ gemacht für Entwickler, die 24/7 programmieren
+
+ omniroute.online
+
diff --git a/README.es.md b/README.es.md
new file mode 100644
index 0000000000..9bf45ab962
--- /dev/null
+++ b/README.es.md
@@ -0,0 +1,995 @@
+
+
+
+ # 🚀 OmniRoute — El Gateway de IA Gratuito
+
+### Nunca dejes de programar. Enrutamiento inteligente hacia **modelos de IA GRATUITOS y económicos** con fallback automático.
+
+_Tu proxy de API universal — un endpoint, 36+ proveedores, cero tiempo de inactividad._
+
+**Chat Completions • Embeddings • Generación de Imágenes • Audio • Reranking • 100% TypeScript**
+
+---
+
+### 🤖 Proveedor de IA Gratuito para tus agentes de programación favoritos
+
+_Conecta cualquier IDE o herramienta CLI con IA a través de OmniRoute — gateway de API gratuito para programación ilimitada._
+
+
+
+---
+
+## 🤔 ¿Por qué OmniRoute?
+
+**Deja de desperdiciar dinero y chocar con límites:**
+
+- La cuota de suscripción expira sin usar cada mes
+- Los límites de tasa te detienen en medio de la programación
+- APIs caras ($20-50/mes por proveedor)
+- Cambiar manualmente entre proveedores
+
+**OmniRoute resuelve esto:**
+
+- ✅ **Maximiza suscripciones** - Rastrea cuotas, usa cada bit antes del reset
+- ✅ **Fallback automático** - Suscripción → API Key → Barato → Gratuito, cero tiempo de inactividad
+- ✅ **Multi-cuenta** - Round-robin entre cuentas por proveedor
+- ✅ **Universal** - Funciona con Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, cualquier herramienta CLI
+
+---
+
+## 🔄 Cómo Funciona
+
+```
+┌─────────────┐
+│ Tu CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
+│ Tool │
+└──────┬──────┘
+ │ http://localhost:20128/v1
+ ↓
+┌─────────────────────────────────────────┐
+│ OmniRoute (Enrutador Inteligente) │
+│ • Traducción de formato (OpenAI ↔ Claude) │
+│ • Rastreo de cuota + Embeddings + Imágenes │
+│ • Renovación automática de tokens │
+└──────┬──────────────────────────────────┘
+ │
+ ├─→ [Tier 1: SUSCRIPCIÓN] Claude Code, Codex, Gemini CLI
+ │ ↓ cuota agotada
+ ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
+ │ ↓ límite de presupuesto
+ ├─→ [Tier 3: BARATO] GLM ($0.6/1M), MiniMax ($0.2/1M)
+ │ ↓ límite de presupuesto
+ └─→ [Tier 4: GRATUITO] iFlow, Qwen, Kiro (ilimitado)
+
+Resultado: Nunca dejes de programar, costo mínimo
+```
+
+---
+
+## ⚡ Inicio Rápido
+
+**1. Instala globalmente:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 El Dashboard se abre en `http://localhost:20128`
+
+| Comando | Descripción |
+| ----------------------- | ---------------------------------------------- |
+| `omniroute` | Iniciar servidor (puerto predeterminado 20128) |
+| `omniroute --port 3000` | Usar puerto personalizado |
+| `omniroute --no-open` | No abrir navegador automáticamente |
+| `omniroute --help` | Mostrar ayuda |
+
+**2. Conecta un proveedor GRATUITO:**
+
+Dashboard → Proveedores → Conectar **Claude Code** o **Antigravity** → Login OAuth → ¡Listo!
+
+**3. Usa en tu herramienta CLI:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Configuración:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copiar del dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**¡Eso es todo!** Comienza a programar con modelos de IA GRATUITOS.
+
+**Alternativa — ejecutar desde código fuente:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+OmniRoute está disponible como imagen Docker pública en [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Ejecución rápida:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Con archivo de entorno:**
+
+```bash
+# Copia y edita el .env primero
+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
+```
+
+**Usando Docker Compose:**
+
+```bash
+# Perfil base (sin herramientas CLI)
+docker compose --profile base up -d
+
+# Perfil CLI (Claude Code, Codex, OpenClaw integrados)
+docker compose --profile cli up -d
+```
+
+| Imagen | Tag | Tamaño | Descripción |
+| ------------------------ | -------- | ------ | ---------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250MB | Última versión estable |
+| `diegosouzapw/omniroute` | `0.8.8` | ~250MB | Versión actual |
+
+---
+
+## 💰 Precios Resumidos
+
+| Tier | Proveedor | Costo | Reset de Cuota | Mejor Para |
+| ------------------ | ----------------- | ---------------------------- | ----------------- | ----------------------- |
+| **💳 SUSCRIPCIÓN** | Claude Code (Pro) | $20/mes | 5h + semanal | Ya suscrito |
+| | Codex (Plus/Pro) | $20-200/mes | 5h + semanal | Usuarios OpenAI |
+| | Gemini CLI | **GRATUITO** | 180K/mes + 1K/día | ¡Todos! |
+| | GitHub Copilot | $10-19/mes | Mensual | Usuarios GitHub |
+| **🔑 API KEY** | NVIDIA NIM | **GRATUITO** (1000 créditos) | Único | Pruebas gratuitas |
+| | DeepSeek | Por uso | Ninguno | Mejor precio/calidad |
+| | Groq | Tier gratuito + pago | Limitado | Inferencia ultra-rápida |
+| | xAI (Grok) | Por uso | Ninguno | Modelos Grok |
+| | Mistral | Tier gratuito + pago | Limitado | IA Europea |
+| | OpenRouter | Por uso | Ninguno | 100+ modelos |
+| **💰 BARATO** | GLM-4.7 | $0.6/1M | Diario 10h | Respaldo económico |
+| | MiniMax M2.1 | $0.2/1M | Rotativo 5h | Opción más barata |
+| | Kimi K2 | $9/mes fijo | 10M tokens/mes | Costo predecible |
+| **🆓 GRATUITO** | iFlow | $0 | Ilimitado | 8 modelos gratuitos |
+| | Qwen | $0 | Ilimitado | 3 modelos gratuitos |
+| | Kiro | $0 | Ilimitado | Claude gratuito |
+
+**💡 Consejo Pro:** ¡Comienza con Gemini CLI (180K gratis/mes) + iFlow (ilimitado gratis) = $0 de costo!
+
+---
+
+## 🎯 Casos de Uso
+
+### Caso 1: "Tengo suscripción Claude Pro"
+
+**Problema:** La cuota expira sin usar, límites de tasa durante programación intensa
+
+```
+Combo: "maximize-claude"
+ 1. cc/claude-opus-4-6 (usar suscripción al máximo)
+ 2. glm/glm-4.7 (respaldo barato cuando la cuota se agota)
+ 3. if/kimi-k2-thinking (fallback de emergencia gratuito)
+
+Costo mensual: $20 (suscripción) + ~$5 (respaldo) = $25 total
+vs. $20 + chocar con límites = frustración
+```
+
+### Caso 2: "Quiero costo cero"
+
+**Problema:** No puede pagar suscripciones, necesita IA confiable para programar
+
+```
+Combo: "free-forever"
+ 1. gc/gemini-3-flash (180K gratis/mes)
+ 2. if/kimi-k2-thinking (ilimitado gratis)
+ 3. qw/qwen3-coder-plus (ilimitado gratis)
+
+Costo mensual: $0
+Calidad: Modelos listos para producción
+```
+
+### Caso 3: "Necesito programar 24/7, sin interrupciones"
+
+**Problema:** Plazos ajustados, no puede permitirse tiempo de inactividad
+
+```
+Combo: "always-on"
+ 1. cc/claude-opus-4-6 (mejor calidad)
+ 2. cx/gpt-5.2-codex (segunda suscripción)
+ 3. glm/glm-4.7 (barato, reset diario)
+ 4. minimax/MiniMax-M2.1 (más barato, reset 5h)
+ 5. if/kimi-k2-thinking (gratuito ilimitado)
+
+Resultado: 5 capas de fallback = cero tiempo de inactividad
+```
+
+### Caso 4: "Quiero IA GRATUITA en OpenClaw"
+
+**Problema:** Necesita asistente de IA en apps de mensajería, completamente gratuito
+
+```
+Combo: "openclaw-free"
+ 1. if/glm-4.7 (ilimitado gratis)
+ 2. if/minimax-m2.1 (ilimitado gratis)
+ 3. if/kimi-k2-thinking (ilimitado gratis)
+
+Costo mensual: $0
+Acceso vía: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Características Principales
+
+### 🧠 Enrutamiento e Inteligencia
+
+| Característica | Qué Hace |
+| -------------------------------------- | ------------------------------------------------------------------------------- |
+| 🎯 **Fallback Inteligente 4 Tiers** | Auto-enrutamiento: Suscripción → API Key → Barato → Gratuito |
+| 📊 **Rastreo de Cuota en Tiempo Real** | Conteo de tokens en vivo + countdown de reset por proveedor |
+| 🔄 **Traducción de Formato** | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro transparente |
+| 👥 **Soporte Multi-Cuenta** | Múltiples cuentas por proveedor con selección inteligente |
+| 🔄 **Renovación Automática de Token** | Tokens OAuth se renuevan automáticamente con reintentos |
+| 🎨 **Combos Personalizados** | 6 estrategias: fill-first, round-robin, p2c, random, least-used, cost-optimized |
+| 🧩 **Modelos Personalizados** | Agrega cualquier ID de modelo a cualquier proveedor |
+| 🌐 **Enrutador Wildcard** | Enruta patrones `provider/*` a cualquier proveedor dinámicamente |
+| 🧠 **Presupuesto de Razonamiento** | Modos passthrough, auto, custom y adaptativo para modelos de razonamiento |
+| 💬 **Inyección de System Prompt** | System prompt global aplicado en todas las solicitudes |
+| 📄 **API Responses** | Soporte completo de la API Responses de OpenAI (`/v1/responses`) para Codex |
+
+### 🎵 APIs Multi-Modal
+
+| Característica | Qué Hace |
+| ----------------------------- | ------------------------------------------------------ |
+| 🖼️ **Generación de Imágenes** | `/v1/images/generations` — 4 proveedores, 9+ modelos |
+| 📐 **Embeddings** | `/v1/embeddings` — 6 proveedores, 9+ modelos |
+| 🎤 **Transcripción de Audio** | `/v1/audio/transcriptions` — Compatible con Whisper |
+| 🔊 **Texto a Voz** | `/v1/audio/speech` — Síntesis de audio multi-proveedor |
+| 🛡️ **Moderaciones** | `/v1/moderations` — Verificaciones de seguridad |
+| 🔀 **Reranking** | `/v1/rerank` — Reranking de relevancia de documentos |
+
+### 🛡️ Resiliencia y Seguridad
+
+| Característica | Qué Hace |
+| ---------------------------------- | ---------------------------------------------------------------- |
+| 🔌 **Circuit Breaker** | Auto-apertura/cierre por proveedor con umbrales configurables |
+| 🛡️ **Anti-Thundering Herd** | Mutex + semáforo rate-limit para proveedores con API key |
+| 🧠 **Caché Semántico** | Caché de dos niveles (firma + semántico) reduce costo y latencia |
+| ⚡ **Idempotencia de Solicitud** | Ventana de dedup de 5s para solicitudes duplicadas |
+| 🔒 **Spoofing de Fingerprint TLS** | Bypass de detección de bot vía TLS con wreq-js |
+| 🌐 **Filtrado de IP** | Allowlist/blocklist para control de acceso a la API |
+| 📊 **Rate Limits Editables** | RPM, gap mínimo y concurrencia máxima configurables |
+
+### 📊 Observabilidad y Analytics
+
+| Característica | Qué Hace |
+| ------------------------------ | --------------------------------------------------------------------- |
+| 📝 **Logs de Solicitud** | Modo debug con logs completos de request/response |
+| 💾 **Logs SQLite** | Logs de proxy persistentes sobreviven a reinicios |
+| 📊 **Dashboard de Analytics** | Recharts: cards de estadísticas, gráfico de uso, tabla de proveedores |
+| 📈 **Rastreo de Progreso** | Eventos de progreso SSE opt-in para streaming |
+| 🧪 **Evaluaciones de LLM** | Pruebas con conjunto golden y 4 estrategias de match |
+| 🔍 **Telemetría de Solicitud** | Agregación de latencia p50/p95/p99 + rastreo X-Request-Id |
+| 📋 **Logs + Cuotas** | Páginas dedicadas para navegación de logs y rastreo de cuotas |
+| 🏥 **Dashboard de Salud** | Uptime, estados de circuit breaker, lockouts, stats de caché |
+| 💰 **Rastreo de Costos** | Gestión de presupuesto + configuración de precios por modelo |
+
+### ☁️ Deploy y Sincronización
+
+| Característica | Qué Hace |
+| --------------------------------- | ------------------------------------------------------------------------------- |
+| 💾 **Cloud Sync** | Sincroniza configuraciones entre dispositivos vía Cloudflare Workers |
+| 🌐 **Deploy en Cualquier Lugar** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **Gestión de API Keys** | Genera, rota y define alcance de API keys por proveedor |
+| 🧙 **Asistente de Configuración** | Setup guiado en 4 pasos para nuevos usuarios |
+| 🔧 **Dashboard CLI Tools** | Configuración en un clic para Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Backups de DB** | Backup y restauración automáticos de todas las configuraciones |
+
+
+📖 Detalles de Características
+
+### 🎯 Fallback Inteligente 4 Tiers
+
+Crea combos con fallback automático:
+
+```
+Combo: "my-coding-stack"
+ 1. cc/claude-opus-4-6 (tu suscripción)
+ 2. nvidia/llama-3.3-70b (API NVIDIA gratuita)
+ 3. glm/glm-4.7 (respaldo barato, $0.6/1M)
+ 4. if/kimi-k2-thinking (fallback gratuito)
+
+→ Cambia automáticamente cuando la cuota se agota o ocurren errores
+```
+
+### 📊 Rastreo de Cuota en Tiempo Real
+
+- Consumo de tokens por proveedor
+- Countdown de reset (5 horas, diario, semanal)
+- Estimación de costo para tiers pagos
+- Reportes de gastos mensuales
+
+### 🔄 Traducción de Formato
+
+Traducción transparente entre formatos:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses**
+- Tu herramienta CLI envía formato OpenAI → OmniRoute traduce → El proveedor recibe formato nativo
+- Funciona con cualquier herramienta que soporte endpoints OpenAI personalizados
+
+### 👥 Soporte Multi-Cuenta
+
+- Agrega múltiples cuentas por proveedor
+- Round-robin automático o enrutamiento por prioridad
+- Fallback a la siguiente cuenta cuando una alcanza la cuota
+
+### 🔄 Renovación Automática de Token
+
+- Los tokens OAuth se renuevan automáticamente antes de expirar
+- Sin necesidad de re-autenticación manual
+- Experiencia transparente en todos los proveedores
+
+### 🎨 Combos Personalizados
+
+- Crea combinaciones ilimitadas de modelos
+- 6 estrategias: fill-first, round-robin, power-of-two-choices, random, least-used, cost-optimized
+- Comparte combos entre dispositivos con Cloud Sync
+
+### 🏥 Dashboard de Salud
+
+- Estado del sistema (uptime, versión, uso de memoria)
+- Estados de circuit breaker por proveedor (Closed/Open/Half-Open)
+- Estado de rate limit y lockouts activos
+- Estadísticas de caché de firma
+- Telemetría de latencia (p50/p95/p99) + caché de prompt
+- Reset de salud con un clic
+
+### 🔧 Playground del Traductor
+
+- Debug, prueba y visualiza traducciones de formato de API
+- Envía solicitudes y ve cómo OmniRoute traduce entre formatos de proveedores
+- Invaluable para troubleshooting de problemas de integración
+
+### 💾 Cloud Sync
+
+- Sincroniza proveedores, combos y configuraciones entre dispositivos
+- Sincronización automática en segundo plano
+- Almacenamiento cifrado seguro
+
+
+
+---
+
+## 📖 Guía de Configuración
+
+
+💳 Proveedores por Suscripción
+
+### Claude Code (Pro/Max)
+
+```bash
+Dashboard → Proveedores → Conectar Claude Code
+→ Login OAuth → Renovación automática de token
+→ Rastreo de cuota 5h + semanal
+
+Modelos:
+ cc/claude-opus-4-6
+ cc/claude-sonnet-4-5-20250929
+ cc/claude-haiku-4-5-20251001
+```
+
+**Consejo Pro:** Usa Opus para tareas complejas, Sonnet para velocidad. ¡OmniRoute rastrea cuota por modelo!
+
+### OpenAI Codex (Plus/Pro)
+
+```bash
+Dashboard → Proveedores → Conectar Codex
+→ Login OAuth (puerto 1455)
+→ Reset 5h + semanal
+
+Modelos:
+ cx/gpt-5.2-codex
+ cx/gpt-5.1-codex-max
+```
+
+### Gemini CLI (¡GRATUITO 180K/mes!)
+
+```bash
+Dashboard → Proveedores → Conectar Gemini CLI
+→ Google OAuth
+→ 180K completions/mes + 1K/día
+
+Modelos:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Mejor Valor:** ¡Tier gratuito enorme! Úsalo antes de los tiers pagos.
+
+### GitHub Copilot
+
+```bash
+Dashboard → Proveedores → Conectar GitHub
+→ OAuth vía GitHub
+→ Reset mensual (1ro del mes)
+
+Modelos:
+ gh/gpt-5
+ gh/claude-4.5-sonnet
+ gh/gemini-3-pro
+```
+
+
+
+
+🔑 Proveedores por API Key
+
+### NVIDIA NIM (¡GRATUITO 1000 créditos!)
+
+1. Regístrate: [build.nvidia.com](https://build.nvidia.com)
+2. Obtén API key gratuita (1000 créditos de inferencia incluidos)
+3. Dashboard → Agregar Proveedor → NVIDIA NIM:
+ - API Key: `nvapi-your-key`
+
+**Modelos:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, y 50+ más
+
+**Consejo Pro:** ¡API compatible con OpenAI — funciona perfectamente con la traducción de formato de OmniRoute!
+
+### DeepSeek
+
+1. Regístrate: [platform.deepseek.com](https://platform.deepseek.com)
+2. Obtén API key
+3. Dashboard → Agregar Proveedor → DeepSeek
+
+**Modelos:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (¡Tier Gratuito Disponible!)
+
+1. Regístrate: [console.groq.com](https://console.groq.com)
+2. Obtén API key (tier gratuito incluido)
+3. Dashboard → Agregar Proveedor → Groq
+
+**Modelos:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Consejo Pro:** ¡Inferencia ultra-rápida — mejor para programación en tiempo real!
+
+### OpenRouter (100+ Modelos)
+
+1. Regístrate: [openrouter.ai](https://openrouter.ai)
+2. Obtén API key
+3. Dashboard → Agregar Proveedor → OpenRouter
+
+**Modelos:** Accede a 100+ modelos de todos los principales proveedores a través de una única API key.
+
+
+
+
+💰 Proveedores Baratos (Respaldo)
+
+### GLM-4.7 (Reset diario, $0.6/1M)
+
+1. Regístrate: [Zhipu AI](https://open.bigmodel.cn/)
+2. Obtén API key del Plan Coding
+3. Dashboard → Agregar API Key:
+ - Proveedor: `glm`
+ - API Key: `your-key`
+
+**Usa:** `glm/glm-4.7`
+
+**Consejo Pro:** ¡El Plan Coding ofrece 3× cuota a 1/7 del costo! Reset diario 10:00 AM.
+
+### MiniMax M2.1 (Reset 5h, $0.20/1M)
+
+1. Regístrate: [MiniMax](https://www.minimax.io/)
+2. Obtén API key
+3. Dashboard → Agregar API Key
+
+**Usa:** `minimax/MiniMax-M2.1`
+
+**Consejo Pro:** ¡Opción más barata para contexto largo (1M tokens)!
+
+### Kimi K2 ($9/mes fijo)
+
+1. Suscríbete: [Moonshot AI](https://platform.moonshot.ai/)
+2. Obtén API key
+3. Dashboard → Agregar API Key
+
+**Usa:** `kimi/kimi-latest`
+
+**Consejo Pro:** ¡$9/mes fijo por 10M tokens = $0.90/1M de costo efectivo!
+
+
+
+
+🆓 Proveedores GRATUITOS (Respaldo de Emergencia)
+
+### iFlow (8 modelos GRATUITOS)
+
+```bash
+Dashboard → Conectar iFlow
+→ Login OAuth iFlow
+→ Uso ilimitado
+
+Modelos:
+ if/kimi-k2-thinking
+ if/qwen3-coder-plus
+ if/glm-4.7
+ if/minimax-m2
+ if/deepseek-r1
+```
+
+### Qwen (3 modelos GRATUITOS)
+
+```bash
+Dashboard → Conectar Qwen
+→ Autorización por código de dispositivo
+→ Uso ilimitado
+
+Modelos:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude GRATUITO)
+
+```bash
+Dashboard → Conectar Kiro
+→ AWS Builder ID o Google/GitHub
+→ Uso ilimitado
+
+Modelos:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Crear Combos
+
+### Ejemplo 1: Maximizar Suscripción → Respaldo Barato
+
+```
+Dashboard → Combos → Crear Nuevo
+
+Nombre: premium-coding
+Modelos:
+ 1. cc/claude-opus-4-6 (Suscripción primaria)
+ 2. glm/glm-4.7 (Respaldo barato, $0.6/1M)
+ 3. minimax/MiniMax-M2.1 (Fallback más barato, $0.20/1M)
+
+Usa en CLI: premium-coding
+```
+
+### Ejemplo 2: Solo Gratuito (Costo Cero)
+
+```
+Nombre: free-combo
+Modelos:
+ 1. gc/gemini-3-flash-preview (180K gratis/mes)
+ 2. if/kimi-k2-thinking (ilimitado)
+ 3. qw/qwen3-coder-plus (ilimitado)
+
+Costo: ¡$0 para siempre!
+```
+
+
+
+
+🔧 Integración CLI
+
+### Cursor IDE
+
+```
+Configuración → Modelos → Avanzado:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [del dashboard OmniRoute]
+ Model: cc/claude-opus-4-6
+```
+
+### Claude Code
+
+Usa la página **CLI Tools** en el dashboard para configuración en un clic, o edita `~/.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
+
+**Opción 1 — Dashboard (recomendado):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Seleccionar Modelo → Aplicar
+```
+
+**Opción 2 — Manual:** Edita `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Nota:** OpenClaw solo funciona con OmniRoute local. Usa `127.0.0.1` en lugar de `localhost` para evitar problemas de resolución IPv6.
+
+### Cline / Continue / RooCode
+
+```
+Configuración → Configuración de API:
+ Proveedor: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [del dashboard OmniRoute]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Modelos Disponibles
+
+
+Ver todos los modelos disponibles
+
+**Claude Code (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - GRATUITO:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub Copilot (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - Créditos GRATUITOS:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ más modelos en [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0.6/1M:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0.2/1M:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - GRATUITO:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - GRATUITO:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - GRATUITO:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ modelos:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Cualquier modelo de [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Evaluaciones (Evals)
+
+OmniRoute incluye un framework de evaluación integrado para probar la calidad de respuestas de LLM contra un conjunto golden. Accede vía **Analytics → Evals** en el dashboard.
+
+### Conjunto Golden Integrado
+
+El "OmniRoute Golden Set" precargado contiene 10 casos de prueba que cubren:
+
+- Saludos, matemáticas, geografía, generación de código
+- Conformidad de formato JSON, traducción, markdown
+- Rechazo de seguridad (contenido dañino), conteo, lógica booleana
+
+### Estrategias de Evaluación
+
+| Estrategia | Descripción | Ejemplo |
+| ---------- | ---------------------------------------------------- | -------------------------------- |
+| `exact` | La salida debe coincidir exactamente | `"4"` |
+| `contains` | La salida debe contener subcadena (case-insensitive) | `"Paris"` |
+| `regex` | La salida debe coincidir con el patrón regex | `"1.*2.*3"` |
+| `custom` | Función JS personalizada retorna true/false | `(output) => output.length > 10` |
+
+---
+
+## 🐛 Solución de Problemas
+
+
+Haz clic para expandir la guía de solución de problemas
+
+**"Language model did not provide messages"**
+
+- Cuota del proveedor agotada → Verifica el rastreador de cuota en el dashboard
+- Solución: Usa combo con fallback o cambia a tier más barato
+
+**Rate limiting**
+
+- Cuota de suscripción agotada → Fallback a GLM/MiniMax
+- Agrega combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Token OAuth expirado**
+
+- Renovado automáticamente por OmniRoute
+- Si persiste: Dashboard → Proveedor → Reconectar
+
+**Costos altos**
+
+- Verifica estadísticas de uso en Dashboard → Costos
+- Cambia modelo primario a GLM/MiniMax
+- Usa tier gratuito (Gemini CLI, iFlow) para tareas no críticas
+
+**Dashboard se abre en el puerto equivocado**
+
+- Establece `PORT=20128` y `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Errores de cloud sync**
+
+- Verifica que `BASE_URL` apunte a tu instancia en ejecución
+- Verifica que `CLOUD_URL` apunte a tu endpoint cloud esperado
+- Mantén los valores `NEXT_PUBLIC_*` alineados con los valores del servidor
+
+**Primer login no funciona**
+
+- Verifica `INITIAL_PASSWORD` en `.env`
+- Si no está definido, la contraseña predeterminada es `123456`
+
+**Sin logs de solicitud**
+
+- Establece `ENABLE_REQUEST_LOGS=true` en `.env`
+
+**Prueba de conexión muestra "Invalid" para proveedores compatibles con OpenAI**
+
+- Muchos proveedores no exponen el endpoint `/models`
+- OmniRoute v0.8.8+ incluye validación vía chat completions como fallback
+- Asegúrate de que la URL base incluya el sufijo `/v1`
+
+
+
+---
+
+## 🛠️ Stack Tecnológico
+
+- **Runtime**: Node.js 20+
+- **Lenguaje**: TypeScript 5.9 — **100% TypeScript** en `src/` y `open-sse/` (v0.8.8)
+- **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Base de Datos**: LowDB (JSON) + SQLite (estado del dominio + logs de proxy)
+- **Streaming**: Server-Sent Events (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys
+- **Testing**: Node.js test runner (368+ tests unitarios)
+- **CI/CD**: GitHub Actions (publicación automática npm + Docker Hub en release)
+- **Website**: [omniroute.online](https://omniroute.online)
+- **Paquete**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Resiliencia**: Circuit breaker, backoff exponencial, anti-thundering herd, spoofing TLS
+
+---
+
+## 📖 Documentación
+
+| Documento | Descripción |
+| ------------------------------------------------ | -------------------------------------------------- |
+| [Guía del Usuario](docs/USER_GUIDE.md) | Proveedores, combos, integración CLI, deploy |
+| [Referencia de API](docs/API_REFERENCE.md) | Todos los endpoints con ejemplos |
+| [Solución de Problemas](docs/TROUBLESHOOTING.md) | Problemas comunes y soluciones |
+| [Arquitectura](docs/ARCHITECTURE.md) | Arquitectura del sistema e internos |
+| [Contribuir](CONTRIBUTING.md) | Setup de desarrollo y directrices |
+| [Spec OpenAPI](docs/openapi.yaml) | Especificación OpenAPI 3.0 |
+| [Política de Seguridad](SECURITY.md) | Reportar vulnerabilidades y prácticas de seguridad |
+
+---
+
+## 📧 Soporte
+
+- **Website**: [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)
+- **Proyecto Original**: [9router por decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Contribuidores
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Cómo Contribuir
+
+1. Haz fork del repositorio
+2. Crea tu rama de funcionalidad (`git checkout -b feature/amazing-feature`)
+3. Haz commit de tus cambios (`git commit -m 'Add amazing feature'`)
+4. Haz push a la rama (`git push origin feature/amazing-feature`)
+5. Abre un Pull Request
+
+Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para directrices detalladas.
+
+### Lanzar una Nueva Versión
+
+```bash
+# Crea un release — la publicación en npm ocurre automáticamente
+gh release create v0.8.8 --title "v0.8.8" --generate-notes
+```
+
+---
+
+## 📊 Historial de Stars
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Agradecimientos
+
+Agradecimiento especial a **[9router](https://github.com/decolua/9router)** por **[decolua](https://github.com/decolua)** — el proyecto original que inspiró este fork. OmniRoute se construye sobre esa increíble base con características adicionales, APIs multi-modal y una reescritura completa en TypeScript.
+
+Agradecimiento especial a **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — la implementación original en Go que inspiró esta adaptación a JavaScript.
+
+---
+
+## 📄 Licencia
+
+Licencia MIT - consulta [LICENSE](LICENSE) para detalles.
+
+---
+
+
+ Hecho con ❤️ para desarrolladores que programan 24/7
+
+ omniroute.online
+
diff --git a/README.fr.md b/README.fr.md
new file mode 100644
index 0000000000..5e8ba75f55
--- /dev/null
+++ b/README.fr.md
@@ -0,0 +1,995 @@
+
+
+
+ # 🚀 OmniRoute — La Passerelle IA Gratuite
+
+### N'arrêtez jamais de coder. Routage intelligent vers des **modèles IA GRATUITS et économiques** avec fallback automatique.
+
+_Votre proxy API universel — un endpoint, 36+ fournisseurs, zéro temps d'arrêt._
+
+**Chat Completions • Embeddings • Génération d'images • Audio • Reranking • 100% TypeScript**
+
+---
+
+### 🤖 Fournisseur IA gratuit pour vos agents de programmation préférés
+
+_Connectez n'importe quel IDE ou outil CLI alimenté par l'IA via OmniRoute — passerelle API gratuite pour un codage illimité._
+
+
+
+📡 Tous les agents se connectent via http://localhost:20128/v1 ou http://cloud.omniroute.online/v1 — une configuration, modèles et quota illimités
+
+---
+
+[](https://www.npmjs.com/package/omniroute)
+[](https://hub.docker.com/r/diegosouzapw/omniroute)
+[](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
+[](https://omniroute.online)
+
+[🌐 Site web](https://omniroute.online) • [🚀 Démarrage rapide](#-démarrage-rapide) • [💡 Fonctionnalités](#-fonctionnalités-principales) • [📖 Docs](#-documentation) • [💰 Tarifs](#-aperçu-des-tarifs)
+
+🌐 **Disponible en :** [English](README.md) | [Português](README.pt-BR.md) | [Español](README.es.md) | [Русский](README.ru.md) | [中文](README.zh-CN.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Italiano](README.it.md)
+
+
+
+---
+
+## 🤔 Pourquoi OmniRoute ?
+
+**Arrêtez de gaspiller de l'argent et de vous heurter aux limites :**
+
+- Le quota d'abonnement expire inutilisé chaque mois
+- Les limites de débit vous arrêtent en plein codage
+- APIs coûteuses (20-50 $/mois par fournisseur)
+- Changement manuel entre fournisseurs
+
+**OmniRoute résout ces problèmes :**
+
+- ✅ **Maximisez les abonnements** — Suivez les quotas, utilisez chaque bit avant la réinitialisation
+- ✅ **Fallback automatique** — Abonnement → Clé API → Économique → Gratuit, zéro temps d'arrêt
+- ✅ **Multi-comptes** — Round-robin entre les comptes par fournisseur
+- ✅ **Universel** — Fonctionne avec Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, tout outil CLI
+
+---
+
+## 🔄 Comment ça fonctionne
+
+```
+┌─────────────┐
+│ Votre CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
+│ Tool │
+└──────┬──────┘
+ │ http://localhost:20128/v1
+ ↓
+┌─────────────────────────────────────────┐
+│ OmniRoute (Routeur intelligent) │
+│ • Traduction de format (OpenAI ↔ Claude) │
+│ • Suivi des quotas + Embeddings + Images │
+│ • Renouvellement automatique des tokens │
+└──────┬──────────────────────────────────┘
+ │
+ ├─→ [Tier 1: ABONNEMENT] Claude Code, Codex, Gemini CLI
+ │ ↓ quota épuisé
+ ├─→ [Tier 2: CLÉ API] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
+ │ ↓ limite de budget
+ ├─→ [Tier 3: ÉCONOMIQUE] GLM ($0.6/1M), MiniMax ($0.2/1M)
+ │ ↓ limite de budget
+ └─→ [Tier 4: GRATUIT] iFlow, Qwen, Kiro (illimité)
+
+Résultat : Ne jamais arrêter de coder, coût minimal
+```
+
+---
+
+## ⚡ Démarrage rapide
+
+**1. Installer globalement :**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Le tableau de bord s'ouvre sur `http://localhost:20128`
+
+| Commande | Description |
+| ----------------------- | ------------------------------------------- |
+| `omniroute` | Démarrer le serveur (port par défaut 20128) |
+| `omniroute --port 3000` | Utiliser un port personnalisé |
+| `omniroute --no-open` | Ne pas ouvrir le navigateur automatiquement |
+| `omniroute --help` | Afficher l'aide |
+
+**2. Connecter un fournisseur GRATUIT :**
+
+Tableau de bord → Fournisseurs → Connecter **Claude Code** ou **Antigravity** → Connexion OAuth → Terminé !
+
+**3. Utiliser dans votre outil CLI :**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Paramètres :
+ Endpoint : http://localhost:20128/v1
+ API Key : [copier depuis le tableau de bord]
+ Model : if/kimi-k2-thinking
+```
+
+**C'est tout !** Commencez à coder avec des modèles IA GRATUITS.
+
+**Alternative — exécuter depuis le code source :**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+OmniRoute est disponible en tant qu'image Docker publique sur [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Démarrage rapide :**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Avec fichier d'environnement :**
+
+```bash
+# Copier et modifier le .env d'abord
+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
+```
+
+**Avec Docker Compose :**
+
+```bash
+# Profil de base (sans outils CLI)
+docker compose --profile base up -d
+
+# Profil CLI (Claude Code, Codex, OpenClaw intégrés)
+docker compose --profile cli up -d
+```
+
+| Image | Tag | Taille | Description |
+| ------------------------ | -------- | ------ | ----------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250MB | Dernière version stable |
+| `diegosouzapw/omniroute` | `0.8.8` | ~250MB | Version actuelle |
+
+---
+
+## 💰 Aperçu des tarifs
+
+| Tier | Fournisseur | Coût | Réinitialisation | Idéal pour |
+| ----------------- | ----------------- | -------------------------- | ------------------- | ----------------------------- |
+| **💳 ABONNEMENT** | Claude Code (Pro) | 20 $/mois | 5h + hebdomadaire | Déjà abonné |
+| | Codex (Plus/Pro) | 20-200 $/mois | 5h + hebdomadaire | Utilisateurs OpenAI |
+| | Gemini CLI | **GRATUIT** | 180K/mois + 1K/jour | Tout le monde ! |
+| | GitHub Copilot | 10-19 $/mois | Mensuel | Utilisateurs GitHub |
+| **🔑 CLÉ API** | NVIDIA NIM | **GRATUIT** (1000 crédits) | Unique | Tests gratuits |
+| | DeepSeek | À l'usage | Aucune | Meilleur rapport qualité-prix |
+| | Groq | Niveau gratuit + payant | Limité | Inférence ultra-rapide |
+| | xAI (Grok) | À l'usage | Aucune | Modèles Grok |
+| | Mistral | Niveau gratuit + payant | Limité | IA européenne |
+| | OpenRouter | À l'usage | Aucune | 100+ modèles |
+| **💰 ÉCONOMIQUE** | GLM-4.7 | 0,6 $/1M | Quotidien 10h | Backup économique |
+| | MiniMax M2.1 | 0,2 $/1M | Rotatif 5h | Option la moins chère |
+| | Kimi K2 | 9 $/mois fixe | 10M tokens/mois | Coût prévisible |
+| **🆓 GRATUIT** | iFlow | 0 $ | Illimité | 8 modèles gratuits |
+| | Qwen | 0 $ | Illimité | 3 modèles gratuits |
+| | Kiro | 0 $ | Illimité | Claude gratuit |
+
+**💡 Conseil Pro :** Commencez avec Gemini CLI (180K gratuits/mois) + iFlow (illimité gratuit) = 0 $ de coût !
+
+---
+
+## 🎯 Cas d'utilisation
+
+### Cas 1 : « J'ai un abonnement Claude Pro »
+
+**Problème :** Le quota expire inutilisé, limites de débit pendant le codage intensif
+
+```
+Combo : "maximize-claude"
+ 1. cc/claude-opus-4-6 (utiliser l'abonnement au maximum)
+ 2. glm/glm-4.7 (backup économique quand le quota est épuisé)
+ 3. if/kimi-k2-thinking (fallback d'urgence gratuit)
+
+Coût mensuel : 20 $ (abonnement) + ~5 $ (backup) = 25 $ au total
+vs. 20 $ + atteindre les limites = frustration
+```
+
+### Cas 2 : « Je veux zéro coût »
+
+**Problème :** Impossible de payer des abonnements, besoin d'IA fiable pour coder
+
+```
+Combo : "free-forever"
+ 1. gc/gemini-3-flash (180K gratuits/mois)
+ 2. if/kimi-k2-thinking (illimité gratuit)
+ 3. qw/qwen3-coder-plus (illimité gratuit)
+
+Coût mensuel : 0 $
+Qualité : Modèles prêts pour la production
+```
+
+### Cas 3 : « Je dois coder 24/7, sans interruption »
+
+**Problème :** Délais serrés, ne peut pas se permettre de temps d'arrêt
+
+```
+Combo : "always-on"
+ 1. cc/claude-opus-4-6 (meilleure qualité)
+ 2. cx/gpt-5.2-codex (deuxième abonnement)
+ 3. glm/glm-4.7 (économique, reset quotidien)
+ 4. minimax/MiniMax-M2.1 (le moins cher, reset 5h)
+ 5. if/kimi-k2-thinking (gratuit illimité)
+
+Résultat : 5 niveaux de fallback = zéro temps d'arrêt
+```
+
+### Cas 4 : « Je veux l'IA GRATUITE dans OpenClaw »
+
+**Problème :** Besoin d'assistant IA dans les apps de messagerie, entièrement gratuit
+
+```
+Combo : "openclaw-free"
+ 1. if/glm-4.7 (illimité gratuit)
+ 2. if/minimax-m2.1 (illimité gratuit)
+ 3. if/kimi-k2-thinking (illimité gratuit)
+
+Coût mensuel : 0 $
+Accès via : WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Fonctionnalités principales
+
+### 🧠 Routage & Intelligence
+
+| Fonctionnalité | Ce qu'elle fait |
+| ------------------------------------- | ------------------------------------------------------------------------------- |
+| 🎯 **Fallback intelligent 4 niveaux** | Auto-routage : Abonnement → Clé API → Économique → Gratuit |
+| 📊 **Suivi des quotas en temps réel** | Comptage de tokens en direct + compte à rebours de réinitialisation |
+| 🔄 **Traduction de format** | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro transparent |
+| 👥 **Support multi-comptes** | Plusieurs comptes par fournisseur avec sélection intelligente |
+| 🔄 **Renouvellement auto des tokens** | Les tokens OAuth se renouvellent automatiquement avec retry |
+| 🎨 **Combos personnalisés** | 6 stratégies : fill-first, round-robin, p2c, random, least-used, cost-optimized |
+| 🧩 **Modèles personnalisés** | Ajoutez n'importe quel ID de modèle à n'importe quel fournisseur |
+| 🌐 **Routeur wildcard** | Routez les patterns `provider/*` vers n'importe quel fournisseur dynamiquement |
+| 🧠 **Budget de raisonnement** | Modes passthrough, auto, custom et adaptive pour les modèles de raisonnement |
+| 💬 **Injection System Prompt** | System prompt global appliqué à toutes les requêtes |
+| 📄 **API Responses** | Support complet de l'API Responses d'OpenAI (`/v1/responses`) pour Codex |
+
+### 🎵 APIs multi-modales
+
+| Fonctionnalité | Ce qu'elle fait |
+| -------------------------- | ------------------------------------------------------- |
+| 🖼️ **Génération d'images** | `/v1/images/generations` — 4 fournisseurs, 9+ modèles |
+| 📐 **Embeddings** | `/v1/embeddings` — 6 fournisseurs, 9+ modèles |
+| 🎤 **Transcription audio** | `/v1/audio/transcriptions` — compatible Whisper |
+| 🔊 **Texte vers parole** | `/v1/audio/speech` — synthèse audio multi-fournisseur |
+| 🛡️ **Modérations** | `/v1/moderations` — vérifications de sécurité |
+| 🔀 **Reranking** | `/v1/rerank` — reclassement de pertinence des documents |
+
+### 🛡️ Résilience & Sécurité
+
+| Fonctionnalité | Ce qu'elle fait |
+| ------------------------------- | -------------------------------------------------------------------- |
+| 🔌 **Circuit Breaker** | Ouverture/fermeture auto par fournisseur avec seuils configurables |
+| 🛡️ **Anti-Thundering Herd** | Mutex + sémaphore de rate-limit pour les fournisseurs avec clé API |
+| 🧠 **Cache sémantique** | Cache à deux niveaux (signature + sémantique) réduit coût et latence |
+| ⚡ **Idempotence des requêtes** | Fenêtre de dédup 5s pour les requêtes dupliquées |
+| 🔒 **Spoofing TLS Fingerprint** | Contournement de détection de bot via wreq-js |
+| 🌐 **Filtrage IP** | Allowlist/blocklist pour le contrôle d'accès API |
+| 📊 **Rate limits éditables** | RPM configurable, intervalle minimum, concurrence max |
+
+### 📊 Observabilité & Analytique
+
+| Fonctionnalité | Ce qu'elle fait |
+| --------------------------------- | ------------------------------------------------------------------------- |
+| 📝 **Logs de requêtes** | Mode debug avec logs complets requête/réponse |
+| 💾 **Logs SQLite** | Logs proxy persistants survivant aux redémarrages |
+| 📊 **Tableau de bord analytique** | Recharts : cartes de stats, graphique d'utilisation, tableau fournisseurs |
+| 📈 **Suivi de progression** | Événements SSE de progression opt-in pour le streaming |
+| 🧪 **Évaluations LLM** | Tests avec golden set et 4 stratégies de correspondance |
+| 🔍 **Télémétrie des requêtes** | Agrégation de latence p50/p95/p99 + traçage X-Request-Id |
+| 📋 **Logs + Quotas** | Pages dédiées pour navigation des logs et suivi des quotas |
+| 🏥 **Tableau de bord santé** | Uptime, états circuit breaker, lockouts, stats cache |
+| 💰 **Suivi des coûts** | Gestion de budget + configuration des prix par modèle |
+
+### ☁️ Déploiement & Synchronisation
+
+| Fonctionnalité | Ce qu'elle fait |
+| --------------------------------- | ------------------------------------------------------------------------------- |
+| 💾 **Cloud Sync** | Synchroniser les paramètres entre appareils via Cloudflare Workers |
+| 🌐 **Déployer partout** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **Gestion des clés API** | Générer, faire tourner et limiter les clés API par fournisseur |
+| 🧙 **Assistant de configuration** | Setup guidé en 4 étapes pour les nouveaux utilisateurs |
+| 🔧 **Tableau de bord CLI Tools** | Configuration en un clic pour Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Sauvegardes DB** | Sauvegarde et restauration automatiques de tous les paramètres |
+
+
+📖 Détails des fonctionnalités
+
+### 🎯 Fallback intelligent 4 niveaux
+
+Créez des combos avec fallback automatique :
+
+```
+Combo : "my-coding-stack"
+ 1. cc/claude-opus-4-6 (votre abonnement)
+ 2. nvidia/llama-3.3-70b (API NVIDIA gratuite)
+ 3. glm/glm-4.7 (backup économique, $0.6/1M)
+ 4. if/kimi-k2-thinking (fallback gratuit)
+
+→ Bascule automatiquement lorsque le quota est épuisé ou en cas d'erreurs
+```
+
+### 📊 Suivi des quotas en temps réel
+
+- Consommation de tokens par fournisseur
+- Compte à rebours de réinitialisation (5 heures, quotidien, hebdomadaire)
+- Estimation des coûts pour les niveaux payants
+- Rapports de dépenses mensuels
+
+### 🔄 Traduction de format
+
+Traduction transparente entre les formats :
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses**
+- Votre CLI envoie le format OpenAI → OmniRoute traduit → Le fournisseur reçoit le format natif
+- Fonctionne avec tout outil supportant les endpoints OpenAI personnalisés
+
+### 👥 Support multi-comptes
+
+- Ajouter plusieurs comptes par fournisseur
+- Round-robin automatique ou routage par priorité
+- Basculement vers le compte suivant lorsqu'un quota est atteint
+
+### 🔄 Renouvellement automatique des tokens
+
+- Les tokens OAuth se renouvellent automatiquement avant expiration
+- Pas de réauthentification manuelle nécessaire
+- Expérience transparente sur tous les fournisseurs
+
+### 🎨 Combos personnalisés
+
+- Créer des combinaisons de modèles illimitées
+- 6 stratégies : fill-first, round-robin, power-of-two-choices, random, least-used, cost-optimized
+- Partager les combos entre appareils avec Cloud Sync
+
+### 🏥 Tableau de bord santé
+
+- Statut du système (uptime, version, utilisation mémoire)
+- États des circuit breakers par fournisseur (Closed/Open/Half-Open)
+- Statut des rate limits et lockouts actifs
+- Statistiques du cache de signatures
+- Télémétrie de latence (p50/p95/p99) + cache de prompt
+- Réinitialisation de la santé en un clic
+
+### 🔧 Playground du traducteur
+
+- Déboguer, tester et visualiser les traductions de format d'API
+- Envoyer des requêtes et voir comment OmniRoute traduit entre les formats des fournisseurs
+- Inestimable pour résoudre les problèmes d'intégration
+
+### 💾 Cloud Sync
+
+- Synchroniser fournisseurs, combos et paramètres entre appareils
+- Synchronisation en arrière-plan automatique
+- Stockage chiffré sécurisé
+
+
+
+---
+
+## 📖 Guide de configuration
+
+
+💳 Fournisseurs par abonnement
+
+### Claude Code (Pro/Max)
+
+```bash
+Tableau de bord → Fournisseurs → Connecter Claude Code
+→ Connexion OAuth → Renouvellement auto des tokens
+→ Suivi de quota 5h + hebdomadaire
+
+Modèles :
+ cc/claude-opus-4-6
+ cc/claude-sonnet-4-5-20250929
+ cc/claude-haiku-4-5-20251001
+```
+
+**Conseil Pro :** Utilisez Opus pour les tâches complexes, Sonnet pour la vitesse. OmniRoute suit les quotas par modèle !
+
+### OpenAI Codex (Plus/Pro)
+
+```bash
+Tableau de bord → Fournisseurs → Connecter Codex
+→ Connexion OAuth (port 1455)
+→ Reset 5h + hebdomadaire
+
+Modèles :
+ cx/gpt-5.2-codex
+ cx/gpt-5.1-codex-max
+```
+
+### Gemini CLI (GRATUIT 180K/mois !)
+
+```bash
+Tableau de bord → Fournisseurs → Connecter Gemini CLI
+→ Google OAuth
+→ 180K completions/mois + 1K/jour
+
+Modèles :
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Meilleure valeur :** Niveau gratuit énorme ! Utilisez avant les niveaux payants.
+
+### GitHub Copilot
+
+```bash
+Tableau de bord → Fournisseurs → Connecter GitHub
+→ OAuth via GitHub
+→ Reset mensuel (1er du mois)
+
+Modèles :
+ gh/gpt-5
+ gh/claude-4.5-sonnet
+ gh/gemini-3-pro
+```
+
+
+
+
+🔑 Fournisseurs par clé API
+
+### NVIDIA NIM (GRATUIT 1000 crédits !)
+
+1. S'inscrire : [build.nvidia.com](https://build.nvidia.com)
+2. Obtenir une clé API gratuite (1000 crédits d'inférence inclus)
+3. Tableau de bord → Ajouter fournisseur → NVIDIA NIM :
+ - API Key : `nvapi-your-key`
+
+**Modèles :** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` et 50+ autres
+
+**Conseil Pro :** API compatible OpenAI — fonctionne parfaitement avec la traduction de format d'OmniRoute !
+
+### DeepSeek
+
+1. S'inscrire : [platform.deepseek.com](https://platform.deepseek.com)
+2. Obtenir une clé API
+3. Tableau de bord → Ajouter fournisseur → DeepSeek
+
+**Modèles :** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Niveau gratuit disponible !)
+
+1. S'inscrire : [console.groq.com](https://console.groq.com)
+2. Obtenir une clé API (niveau gratuit inclus)
+3. Tableau de bord → Ajouter fournisseur → Groq
+
+**Modèles :** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Conseil Pro :** Inférence ultra-rapide — idéal pour le codage en temps réel !
+
+### OpenRouter (100+ modèles)
+
+1. S'inscrire : [openrouter.ai](https://openrouter.ai)
+2. Obtenir une clé API
+3. Tableau de bord → Ajouter fournisseur → OpenRouter
+
+**Modèles :** Accès à 100+ modèles de tous les grands fournisseurs via une seule clé API.
+
+
+
+
+💰 Fournisseurs économiques (Backup)
+
+### GLM-4.7 (Reset quotidien, $0.6/1M)
+
+1. S'inscrire : [Zhipu AI](https://open.bigmodel.cn/)
+2. Obtenir une clé API du Coding Plan
+3. Tableau de bord → Ajouter clé API :
+ - Fournisseur : `glm`
+ - API Key : `your-key`
+
+**Utilisez :** `glm/glm-4.7`
+
+**Conseil Pro :** Le Coding Plan offre 3× le quota à 1/7 du coût ! Reset quotidien à 10h.
+
+### MiniMax M2.1 (Reset 5h, $0.20/1M)
+
+1. S'inscrire : [MiniMax](https://www.minimax.io/)
+2. Obtenir une clé API
+3. Tableau de bord → Ajouter clé API
+
+**Utilisez :** `minimax/MiniMax-M2.1`
+
+**Conseil Pro :** L'option la moins chère pour le contexte long (1M tokens) !
+
+### Kimi K2 (9 $/mois fixe)
+
+1. S'abonner : [Moonshot AI](https://platform.moonshot.ai/)
+2. Obtenir une clé API
+3. Tableau de bord → Ajouter clé API
+
+**Utilisez :** `kimi/kimi-latest`
+
+**Conseil Pro :** 9 $/mois fixe pour 10M tokens = 0,90 $/1M de coût effectif !
+
+
+
+
+🆓 Fournisseurs GRATUITS (Backup d'urgence)
+
+### iFlow (8 modèles GRATUITS)
+
+```bash
+Tableau de bord → Connecter iFlow
+→ Connexion OAuth iFlow
+→ Utilisation illimitée
+
+Modèles :
+ if/kimi-k2-thinking
+ if/qwen3-coder-plus
+ if/glm-4.7
+ if/minimax-m2
+ if/deepseek-r1
+```
+
+### Qwen (3 modèles GRATUITS)
+
+```bash
+Tableau de bord → Connecter Qwen
+→ Autorisation par code d'appareil
+→ Utilisation illimitée
+
+Modèles :
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude GRATUIT)
+
+```bash
+Tableau de bord → Connecter Kiro
+→ AWS Builder ID ou Google/GitHub
+→ Utilisation illimitée
+
+Modèles :
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Créer des combos
+
+### Exemple 1 : Maximiser l'abonnement → Backup économique
+
+```
+Tableau de bord → Combos → Créer nouveau
+
+Nom : premium-coding
+Modèles :
+ 1. cc/claude-opus-4-6 (Abonnement principal)
+ 2. glm/glm-4.7 (Backup économique, $0.6/1M)
+ 3. minimax/MiniMax-M2.1 (Fallback le moins cher, $0.20/1M)
+
+Utilisez en CLI : premium-coding
+```
+
+### Exemple 2 : Gratuit uniquement (Zéro coût)
+
+```
+Nom : free-combo
+Modèles :
+ 1. gc/gemini-3-flash-preview (180K gratuits/mois)
+ 2. if/kimi-k2-thinking (illimité)
+ 3. qw/qwen3-coder-plus (illimité)
+
+Coût : 0 $ pour toujours !
+```
+
+
+
+
+🔧 Intégration CLI
+
+### Cursor IDE
+
+```
+Paramètres → Modèles → Avancé :
+ OpenAI API Base URL : http://localhost:20128/v1
+ OpenAI API Key : [du tableau de bord OmniRoute]
+ Model : cc/claude-opus-4-6
+```
+
+### Claude Code
+
+Utilisez la page **CLI Tools** dans le tableau de bord pour la configuration en un clic, ou modifiez `~/.claude/settings.json` manuellement.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Option 1 — Tableau de bord (recommandé) :**
+
+```
+Tableau de bord → CLI Tools → OpenClaw → Sélectionner modèle → Appliquer
+```
+
+**Option 2 — Manuel :** Modifier `~/.openclaw/openclaw.json` :
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Note :** OpenClaw fonctionne uniquement avec OmniRoute local. Utilisez `127.0.0.1` au lieu de `localhost` pour éviter les problèmes de résolution IPv6.
+
+### Cline / Continue / RooCode
+
+```
+Paramètres → Configuration API :
+ Fournisseur : OpenAI Compatible
+ Base URL : http://localhost:20128/v1
+ API Key : [du tableau de bord OmniRoute]
+ Model : if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Modèles disponibles
+
+
+Voir tous les modèles disponibles
+
+**Claude Code (`cc/`)** - Pro/Max :
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro :
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - GRATUIT :
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub Copilot (`gh/`)** :
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - Crédits GRATUITS :
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ modèles sur [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0.6/1M :
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0.2/1M :
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - GRATUIT :
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - GRATUIT :
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - GRATUIT :
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ modèles :
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Tout modèle de [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Évaluations (Evals)
+
+OmniRoute inclut un framework d'évaluation intégré pour tester la qualité des réponses LLM contre un golden set. Accès via **Analytics → Evals** dans le tableau de bord.
+
+### Golden Set intégré
+
+Le « OmniRoute Golden Set » préchargé contient 10 cas de test :
+
+- Salutations, mathématiques, géographie, génération de code
+- Conformité format JSON, traduction, markdown
+- Rejet de sécurité (contenu nocif), comptage, logique booléenne
+
+### Stratégies d'évaluation
+
+| Stratégie | Description | Exemple |
+| ---------- | -------------------------------------------------------------- | -------------------------------- |
+| `exact` | La sortie doit correspondre exactement | `"4"` |
+| `contains` | La sortie doit contenir la sous-chaîne (insensible à la casse) | `"Paris"` |
+| `regex` | La sortie doit correspondre au motif regex | `"1.*2.*3"` |
+| `custom` | Fonction JS personnalisée retourne true/false | `(output) => output.length > 10` |
+
+---
+
+## 🐛 Dépannage
+
+
+Cliquez pour développer le guide de dépannage
+
+**« Language model did not provide messages »**
+
+- Quota du fournisseur épuisé → Vérifiez le suivi de quota dans le tableau de bord
+- Solution : Utilisez un combo avec fallback ou passez à un niveau moins cher
+
+**Rate limiting**
+
+- Quota d'abonnement épuisé → Fallback vers GLM/MiniMax
+- Ajoutez un combo : `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Token OAuth expiré**
+
+- Renouvelé automatiquement par OmniRoute
+- Si le problème persiste : Tableau de bord → Fournisseur → Reconnecter
+
+**Coûts élevés**
+
+- Vérifiez les statistiques d'utilisation dans Tableau de bord → Coûts
+- Changez le modèle principal pour GLM/MiniMax
+- Utilisez le niveau gratuit (Gemini CLI, iFlow) pour les tâches non critiques
+
+**Le tableau de bord s'ouvre sur le mauvais port**
+
+- Définissez `PORT=20128` et `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Erreurs de cloud sync**
+
+- Vérifiez que `BASE_URL` pointe vers votre instance en cours d'exécution
+- Vérifiez que `CLOUD_URL` pointe vers le point de terminaison cloud attendu
+- Gardez les valeurs `NEXT_PUBLIC_*` alignées avec les valeurs du serveur
+
+**Le premier login ne fonctionne pas**
+
+- Vérifiez `INITIAL_PASSWORD` dans `.env`
+- Si non défini, le mot de passe par défaut est `123456`
+
+**Pas de logs de requêtes**
+
+- Définissez `ENABLE_REQUEST_LOGS=true` dans `.env`
+
+**Le test de connexion affiche « Invalid » pour les fournisseurs compatibles OpenAI**
+
+- Beaucoup de fournisseurs n'exposent pas le point de terminaison `/models`
+- OmniRoute v0.8.8+ inclut une validation de secours via chat completions
+- Assurez-vous que l'URL de base inclut le suffixe `/v1`
+
+
+
+---
+
+## 🛠️ Stack technologique
+
+- **Runtime** : Node.js 20+
+- **Langage** : TypeScript 5.9 — **100% TypeScript** dans `src/` et `open-sse/` (v0.8.8)
+- **Framework** : Next.js 16 + React 19 + Tailwind CSS 4
+- **Base de données** : LowDB (JSON) + SQLite (état du domaine + logs proxy)
+- **Streaming** : Server-Sent Events (SSE)
+- **Auth** : OAuth 2.0 (PKCE) + JWT + API Keys
+- **Tests** : Node.js test runner (368+ tests unitaires)
+- **CI/CD** : GitHub Actions (publication automatique npm + Docker Hub lors du release)
+- **Site web** : [omniroute.online](https://omniroute.online)
+- **Package** : [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker** : [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Résilience** : Circuit breaker, backoff exponentiel, anti-thundering herd, spoofing TLS
+
+---
+
+## 📖 Documentation
+
+| Document | Description |
+| ------------------------------------------ | --------------------------------------------------- |
+| [Guide utilisateur](docs/USER_GUIDE.md) | Fournisseurs, combos, intégration CLI, déploiement |
+| [Référence API](docs/API_REFERENCE.md) | Tous les endpoints avec exemples |
+| [Dépannage](docs/TROUBLESHOOTING.md) | Problèmes courants et solutions |
+| [Architecture](docs/ARCHITECTURE.md) | Architecture système et détails internes |
+| [Contribuer](CONTRIBUTING.md) | Configuration de développement et directives |
+| [Spécification OpenAPI](docs/openapi.yaml) | Spécification OpenAPI 3.0 |
+| [Politique de sécurité](SECURITY.md) | Signalement de vulnérabilités et pratiques sécurité |
+
+---
+
+## 📧 Support
+
+- **Site 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)
+- **Projet original** : [9router par decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Contributeurs
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Comment contribuer
+
+1. Forkez le dépôt
+2. Créez votre branche de fonctionnalité (`git checkout -b feature/amazing-feature`)
+3. Committez vos changements (`git commit -m 'Add amazing feature'`)
+4. Poussez vers la branche (`git push origin feature/amazing-feature`)
+5. Ouvrez une Pull Request
+
+Consultez [CONTRIBUTING.md](CONTRIBUTING.md) pour les directives détaillées.
+
+### Publier une nouvelle version
+
+```bash
+# Créer un release — la publication npm est automatique
+gh release create v0.8.8 --title "v0.8.8" --generate-notes
+```
+
+---
+
+## 📊 Historique des Stars
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Remerciements
+
+Remerciements spéciaux à **[9router](https://github.com/decolua/9router)** par **[decolua](https://github.com/decolua)** — le projet original qui a inspiré ce fork. OmniRoute construit sur cette base incroyable avec des fonctionnalités supplémentaires, des APIs multi-modales et une réécriture complète en TypeScript.
+
+Remerciements spéciaux à **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — l'implémentation originale en Go qui a inspiré ce portage en JavaScript.
+
+---
+
+## 📄 Licence
+
+Licence MIT — voir [LICENSE](LICENSE) pour les détails.
+
+---
+
+
+ Fait avec ❤️ pour les développeurs qui codent 24/7
+
+ omniroute.online
+
diff --git a/README.it.md b/README.it.md
new file mode 100644
index 0000000000..7eb0e17a87
--- /dev/null
+++ b/README.it.md
@@ -0,0 +1,995 @@
+
+
+
+ # 🚀 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._
+
+
- # OmniRoute - Free AI Router
-
- **Never stop coding. Auto-route to FREE & cheap AI models with smart fallback.**
-
- **36+ Providers • Embeddings • Image Generation • Audio • Reranking • Full TypeScript**
-
- **Free AI Provider for OpenClaw.**
-
-
-
-
-
- > *This project is inspired by and originally forked from [9router](https://github.com/decolua/9router) by [decolua](https://github.com/decolua). Thank you for the incredible foundation!*
-
- [](https://www.npmjs.com/package/omniroute)
- [](https://hub.docker.com/r/diegosouzapw/omniroute)
- [](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
- [](https://omniroute.online)
-
- [🌐 Website](https://omniroute.online) • [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Docs](#-documentation)
+ # 🚀 OmniRoute — The Free AI Gateway
+
+### Never stop coding. Smart routing to **FREE & low-cost AI models** with automatic fallback.
+
+_Your universal API proxy — one endpoint, 36+ providers, zero downtime._
+
+**Chat Completions • Embeddings • Image Generation • Audio • Reranking • 100% TypeScript**
+
+---
+
+### 🤖 Free AI Provider for your favorite coding agents
+
+_Connect any AI-powered IDE or CLI tool through OmniRoute — free API gateway for unlimited coding._
+
+
---
@@ -29,17 +113,17 @@
**Stop wasting money and hitting limits:**
-- ❌ Subscription quota expires unused every month
-- ❌ Rate limits stop you mid-coding
-- ❌ Expensive APIs ($20-50/month per provider)
-- ❌ Manual switching between providers
+- Subscription quota expires unused every month
+- Rate limits stop you mid-coding
+- Expensive APIs ($20-50/month per provider)
+- Manual switching between providers
**OmniRoute solves this:**
- ✅ **Maximize subscriptions** - Track quota, use every bit before reset
-- ✅ **Auto fallback** - Subscription → Cheap → Free, zero downtime
+- ✅ **Auto fallback** - Subscription → API Key → Cheap → Free, zero downtime
- ✅ **Multi-account** - Round-robin between accounts per provider
-- ✅ **Universal** - Works with Claude Code, Codex, Gemini CLI, Cursor, Cline, any CLI tool
+- ✅ **Universal** - Works with Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, any CLI tool
---
@@ -61,7 +145,7 @@
│
├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI
│ ↓ quota exhausted
- ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, Together, etc.
+ ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
│ ↓ budget limit
├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)
│ ↓ budget limit
@@ -162,6 +246,92 @@ docker compose --profile cli up -d
---
+## 💰 Pricing at a Glance
+
+| Tier | Provider | Cost | Quota Reset | Best For |
+| ------------------- | ----------------- | ----------------------- | ---------------- | -------------------- |
+| **💳 SUBSCRIPTION** | Claude Code (Pro) | $20/mo | 5h + weekly | Already subscribed |
+| | Codex (Plus/Pro) | $20-200/mo | 5h + weekly | OpenAI users |
+| | Gemini CLI | **FREE** | 180K/mo + 1K/day | Everyone! |
+| | GitHub Copilot | $10-19/mo | Monthly | GitHub users |
+| **🔑 API KEY** | NVIDIA NIM | **FREE** (1000 credits) | One-time | Free tier testing |
+| | DeepSeek | Pay-per-use | None | Best price/quality |
+| | Groq | Free tier + paid | Rate limited | Ultra-fast inference |
+| | xAI (Grok) | Pay-per-use | None | Grok models |
+| | Mistral | Free tier + paid | Rate limited | European AI |
+| | OpenRouter | Pay-per-use | None | 100+ models |
+| **💰 CHEAP** | GLM-4.7 | $0.6/1M | Daily 10AM | Budget backup |
+| | MiniMax M2.1 | $0.2/1M | 5-hour rolling | Cheapest option |
+| | Kimi K2 | $9/mo flat | 10M tokens/mo | Predictable cost |
+| **🆓 FREE** | iFlow | $0 | Unlimited | 8 models free |
+| | Qwen | $0 | Unlimited | 3 models free |
+| | Kiro | $0 | Unlimited | Claude free |
+
+**💡 Pro Tip:** Start with Gemini CLI (180K free/month) + iFlow (unlimited free) combo = $0 cost!
+
+---
+
+## 🎯 Use Cases
+
+### Case 1: "I have Claude Pro subscription"
+
+**Problem:** Quota expires unused, rate limits during heavy coding
+
+```
+Combo: "maximize-claude"
+ 1. cc/claude-opus-4-6 (use subscription fully)
+ 2. glm/glm-4.7 (cheap backup when quota out)
+ 3. if/kimi-k2-thinking (free emergency fallback)
+
+Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
+vs. $20 + hitting limits = frustration
+```
+
+### Case 2: "I want zero cost"
+
+**Problem:** Can't afford subscriptions, need reliable AI coding
+
+```
+Combo: "free-forever"
+ 1. gc/gemini-3-flash (180K free/month)
+ 2. if/kimi-k2-thinking (unlimited free)
+ 3. qw/qwen3-coder-plus (unlimited free)
+
+Monthly cost: $0
+Quality: Production-ready models
+```
+
+### Case 3: "I need 24/7 coding, no interruptions"
+
+**Problem:** Deadlines, can't afford downtime
+
+```
+Combo: "always-on"
+ 1. cc/claude-opus-4-6 (best quality)
+ 2. cx/gpt-5.2-codex (second subscription)
+ 3. glm/glm-4.7 (cheap, resets daily)
+ 4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
+ 5. if/kimi-k2-thinking (free unlimited)
+
+Result: 5 layers of fallback = zero downtime
+```
+
+### Case 4: "I want FREE AI in OpenClaw"
+
+**Problem:** Need AI assistant in messaging apps, completely free
+
+```
+Combo: "openclaw-free"
+ 1. if/glm-4.7 (unlimited free)
+ 2. if/minimax-m2.1 (unlimited free)
+ 3. if/kimi-k2-thinking (unlimited free)
+
+Monthly cost: $0
+Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
## 💡 Key Features
### 🧠 Core Routing & Intelligence
@@ -201,7 +371,6 @@ docker compose --profile cli up -d
| ⚡ **Request Idempotency** | 5s dedup window for duplicate requests |
| 🔒 **TLS Fingerprint Spoofing** | Bypass TLS-based bot detection via wreq-js |
| 🌐 **IP Filtering** | Allowlist/blocklist for API access control |
-| 📋 **Compliance Audit Log** | Tamper-proof request logs with opt-out per API key |
| 📊 **Editable Rate Limits** | Configurable RPM, min gap, and max concurrent at system level |
### 📊 Observability & Analytics
@@ -215,14 +384,440 @@ docker compose --profile cli up -d
| 🧪 **LLM Evaluations** | Golden set testing with 4 match strategies |
| 🔍 **Request Telemetry** | p50/p95/p99 latency aggregation + X-Request-Id tracing |
| 📋 **Request Logs + Quotas** | Dedicated pages for log browsing and limits/quotas tracking |
+| 🏥 **Health Dashboard** | System uptime, circuit breaker states, lockouts, cache stats |
+| 💰 **Cost Tracking** | Budget management + per-model pricing configuration |
### ☁️ Deployment & Sync
-| Feature | What It Does |
-| ------------------------- | ------------------------------------------------- |
-| 💾 **Cloud Sync** | Sync config across devices via Cloudflare Workers |
-| 🌐 **Deploy Anywhere** | Localhost, VPS, Docker, Cloudflare Workers |
-| 🔑 **API Key Management** | Generate, rotate, and scope API keys per provider |
+| Feature | What It Does |
+| -------------------------- | --------------------------------------------------------------------- |
+| 💾 **Cloud Sync** | Sync config across devices via Cloudflare Workers |
+| 🌐 **Deploy Anywhere** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **API Key Management** | Generate, rotate, and scope API keys per provider |
+| 🧙 **Onboarding Wizard** | 4-step guided setup for first-time users |
+| 🔧 **CLI Tools Dashboard** | One-click configure Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **DB Backups** | Automatic backup and restore for all settings |
+
+
+📖 Feature Details
+
+### 🎯 Smart 4-Tier Fallback
+
+Create combos with automatic fallback:
+
+```
+Combo: "my-coding-stack"
+ 1. cc/claude-opus-4-6 (your subscription)
+ 2. nvidia/llama-3.3-70b (free NVIDIA API)
+ 3. glm/glm-4.7 (cheap backup, $0.6/1M)
+ 4. if/kimi-k2-thinking (free fallback)
+
+→ Auto switches when quota runs out or errors occur
+```
+
+### 📊 Real-Time Quota Tracking
+
+- Token consumption per provider
+- Reset countdown (5-hour, daily, weekly)
+- Cost estimation for paid tiers
+- Monthly spending reports
+
+### 🔄 Format Translation
+
+Seamless translation between formats:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses**
+- Your CLI tool sends OpenAI format → OmniRoute translates → Provider receives native format
+- Works with any tool that supports custom OpenAI endpoints
+
+### 👥 Multi-Account Support
+
+- Add multiple accounts per provider
+- Auto round-robin or priority-based routing
+- Fallback to next account when one hits quota
+
+### 🔄 Auto Token Refresh
+
+- OAuth tokens automatically refresh before expiration
+- No manual re-authentication needed
+- Seamless experience across all providers
+
+### 🎨 Custom Combos
+
+- Create unlimited model combinations
+- 6 strategies: fill-first, round-robin, power-of-two-choices, random, least-used, cost-optimized
+- Share combos across devices with Cloud Sync
+
+### 🏥 Health Dashboard
+
+- System status (uptime, version, memory usage)
+- Circuit breaker states per provider (Closed/Open/Half-Open)
+- Rate limit status and active lockouts
+- Signature cache statistics
+- Latency telemetry (p50/p95/p99) + prompt cache
+- Reset health status with one click
+
+### 🔧 Translator Playground
+
+- Debug, test, and visualize API format translations
+- Send requests and see how OmniRoute translates between provider formats
+- Invaluable for troubleshooting integration issues
+
+### 💾 Cloud Sync
+
+- Sync providers, combos, and settings across devices
+- Automatic background sync
+- Secure encrypted storage
+
+
+
+---
+
+## 📖 Setup Guide
+
+
+💳 Subscription Providers
+
+### Claude Code (Pro/Max)
+
+```bash
+Dashboard → Providers → Connect Claude Code
+→ OAuth login → Auto token refresh
+→ 5-hour + weekly quota tracking
+
+Models:
+ cc/claude-opus-4-6
+ cc/claude-sonnet-4-5-20250929
+ cc/claude-haiku-4-5-20251001
+```
+
+**Pro Tip:** Use Opus for complex tasks, Sonnet for speed. OmniRoute tracks quota per model!
+
+### OpenAI Codex (Plus/Pro)
+
+```bash
+Dashboard → Providers → Connect Codex
+→ OAuth login (port 1455)
+→ 5-hour + weekly reset
+
+Models:
+ cx/gpt-5.2-codex
+ cx/gpt-5.1-codex-max
+```
+
+### Gemini CLI (FREE 180K/month!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Best Value:** Huge free tier! Use this before paid tiers.
+
+### GitHub Copilot
+
+```bash
+Dashboard → Providers → Connect GitHub
+→ OAuth via GitHub
+→ Monthly reset (1st of month)
+
+Models:
+ gh/gpt-5
+ gh/claude-4.5-sonnet
+ gh/gemini-3-pro
+```
+
+
+
+
+🔑 API Key Providers
+
+### NVIDIA NIM (FREE 1000 credits!)
+
+1. Sign up: [build.nvidia.com](https://build.nvidia.com)
+2. Get free API key (1000 inference credits included)
+3. Dashboard → Add Provider → NVIDIA NIM:
+ - API Key: `nvapi-your-key`
+
+**Models:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, and 50+ more
+
+**Pro Tip:** OpenAI-compatible API — works seamlessly with OmniRoute's format translation!
+
+### DeepSeek
+
+1. Sign up: [platform.deepseek.com](https://platform.deepseek.com)
+2. Get API key
+3. Dashboard → Add Provider → DeepSeek
+
+**Models:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Free Tier Available!)
+
+1. Sign up: [console.groq.com](https://console.groq.com)
+2. Get API key (free tier included)
+3. Dashboard → Add Provider → Groq
+
+**Models:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Pro Tip:** Ultra-fast inference — best for real-time coding!
+
+### OpenRouter (100+ Models)
+
+1. Sign up: [openrouter.ai](https://openrouter.ai)
+2. Get API key
+3. Dashboard → Add Provider → OpenRouter
+
+**Models:** Access 100+ models from all major providers through a single API key.
+
+
+
+
+💰 Cheap Providers (Backup)
+
+### GLM-4.7 (Daily reset, $0.6/1M)
+
+1. Sign up: [Zhipu AI](https://open.bigmodel.cn/)
+2. Get API key from Coding Plan
+3. Dashboard → Add API Key:
+ - Provider: `glm`
+ - API Key: `your-key`
+
+**Use:** `glm/glm-4.7`
+
+**Pro Tip:** Coding Plan offers 3× quota at 1/7 cost! Reset daily 10:00 AM.
+
+### MiniMax M2.1 (5h reset, $0.20/1M)
+
+1. Sign up: [MiniMax](https://www.minimax.io/)
+2. Get API key
+3. Dashboard → Add API Key
+
+**Use:** `minimax/MiniMax-M2.1`
+
+**Pro Tip:** Cheapest option for long context (1M tokens)!
+
+### Kimi K2 ($9/month flat)
+
+1. Subscribe: [Moonshot AI](https://platform.moonshot.ai/)
+2. Get API key
+3. Dashboard → Add API Key
+
+**Use:** `kimi/kimi-latest`
+
+**Pro Tip:** Fixed $9/month for 10M tokens = $0.90/1M effective cost!
+
+
+
+
+🆓 FREE Providers (Emergency Backup)
+
+### iFlow (8 FREE models)
+
+```bash
+Dashboard → Connect iFlow
+→ iFlow OAuth login
+→ Unlimited usage
+
+Models:
+ if/kimi-k2-thinking
+ if/qwen3-coder-plus
+ if/glm-4.7
+ if/minimax-m2
+ if/deepseek-r1
+```
+
+### Qwen (3 FREE models)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude FREE)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Create Combos
+
+### Example 1: Maximize Subscription → Cheap Backup
+
+```
+Dashboard → Combos → Create New
+
+Name: premium-coding
+Models:
+ 1. cc/claude-opus-4-6 (Subscription primary)
+ 2. glm/glm-4.7 (Cheap backup, $0.6/1M)
+ 3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)
+
+Use in CLI: premium-coding
+```
+
+### Example 2: Free-Only (Zero Cost)
+
+```
+Name: free-combo
+Models:
+ 1. gc/gemini-3-flash-preview (180K free/month)
+ 2. if/kimi-k2-thinking (unlimited)
+ 3. qw/qwen3-coder-plus (unlimited)
+
+Cost: $0 forever!
+```
+
+
+
+
+🔧 CLI Integration
+
+### Cursor IDE
+
+```
+Settings → Models → Advanced:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [from OmniRoute dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### Claude Code
+
+Use the **CLI Tools** page in the dashboard for one-click configuration, or edit `~/.claude/settings.json` manually.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Option 1 — Dashboard (recommended):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Option 2 — Manual:** Edit `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Note:** OpenClaw only works with local OmniRoute. Use `127.0.0.1` instead of `localhost` to avoid IPv6 resolution issues.
+
+### Cline / Continue / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Available Models
+
+
+View all available models
+
+**Claude Code (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - FREE:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub Copilot (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - FREE credits:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ more models on [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0.6/1M:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0.2/1M:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - FREE:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - FREE:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - FREE:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ models:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Any model from [openrouter.ai/models](https://openrouter.ai/models)
+
+
---
@@ -238,13 +833,6 @@ The pre-loaded "OmniRoute Golden Set" contains 10 test cases covering:
- JSON format compliance, translation, markdown
- Safety refusal (harmful content), counting, boolean logic
-### How It Works
-
-1. Click **"Run Eval"** on a suite in the dashboard
-2. Each test case is sent to your proxy endpoint (`/v1/chat/completions`)
-3. Real LLM responses are collected and evaluated against expected criteria
-4. Results show pass/fail status, latency per case, and overall pass rate
-
### Evaluation Strategies
| Strategy | Description | Example |
@@ -254,40 +842,60 @@ The pre-loaded "OmniRoute Golden Set" contains 10 test cases covering:
| `regex` | Output must match regex pattern | `"1.*2.*3"` |
| `custom` | Custom JS function returns true/false | `(output) => output.length > 10` |
-### API Usage
+---
-```bash
-# List all eval suites
-curl http://localhost:20128/api/evals
+## 🐛 Troubleshooting
-# Run a suite with pre-collected outputs
-curl -X POST http://localhost:20128/api/evals \
- -H 'Content-Type: application/json' \
- -d '{"suiteId": "golden-set", "outputs": {"gs-01": "Hello there!", "gs-02": "4"}}'
+
+Click to expand troubleshooting guide
-# Get suite details
-curl http://localhost:20128/api/evals/golden-set
-```
+**"Language model did not provide messages"**
-### Custom Suites
+- Provider quota exhausted → Check dashboard quota tracker
+- Solution: Use combo fallback or switch to cheaper tier
-Register custom suites programmatically via `registerSuite()` in `src/lib/evals/evalRunner.ts`:
+**Rate limiting**
-```typescript
-registerSuite({
- id: "my-suite",
- name: "Custom Eval Suite",
- cases: [
- {
- id: "c-01",
- name: "API response",
- model: "gpt-4o",
- input: { messages: [{ role: "user", content: "Say OK" }] },
- expected: { strategy: "contains", value: "OK" },
- },
- ],
-});
-```
+- Subscription quota out → Fallback to GLM/MiniMax
+- Add combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**OAuth token expired**
+
+- Auto-refreshed by OmniRoute
+- If issues persist: Dashboard → Provider → Reconnect
+
+**High costs**
+
+- Check usage stats in Dashboard → Costs
+- Switch primary model to GLM/MiniMax
+- Use free tier (Gemini CLI, iFlow) for non-critical tasks
+
+**Dashboard opens on wrong port**
+
+- Set `PORT=20128` and `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Cloud sync errors**
+
+- Verify `BASE_URL` points to your running instance
+- Verify `CLOUD_URL` points to your expected cloud endpoint
+- Keep `NEXT_PUBLIC_*` values aligned with server-side values
+
+**First login not working**
+
+- Check `INITIAL_PASSWORD` in `.env`
+- If unset, fallback password is `123456`
+
+**No request logs**
+
+- Set `ENABLE_REQUEST_LOGS=true` in `.env`
+
+**Connection test shows "Invalid" for OpenAI-compatible providers**
+
+- Many providers don't expose a `/models` endpoint
+- OmniRoute v0.8.8+ includes fallback validation via chat completions
+- Ensure base URL includes `/v1` suffix
+
+
---
@@ -354,9 +962,23 @@ gh release create v0.8.8 --title "v0.8.8" --generate-notes
---
+## 📊 Star History
+
+
+
+
+
+
+
+
+
+---
+
## 🙏 Acknowledgments
-Special thanks to **CLIProxyAPI** - the original Go implementation that inspired this JavaScript port.
+Special thanks to **[9router](https://github.com/decolua/9router)** by **[decolua](https://github.com/decolua)** — the original project that inspired this fork. OmniRoute builds upon that incredible foundation with additional features, multi-modal APIs, and a full TypeScript rewrite.
+
+Special thanks to **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — the original Go implementation that inspired this JavaScript port.
---
diff --git a/README.pt-BR.md b/README.pt-BR.md
new file mode 100644
index 0000000000..6513c18aee
--- /dev/null
+++ b/README.pt-BR.md
@@ -0,0 +1,995 @@
+
+
+
+ # 🚀 OmniRoute — O Gateway de IA Gratuito
+
+### Nunca pare de programar. Roteamento inteligente para **modelos de IA GRATUITOS e baratos** com fallback automático.
+
+_Seu proxy de API universal — um endpoint, 36+ provedores, zero tempo de inatividade._
+
+**Chat Completions • Embeddings • Geração de Imagem • Áudio • Reranking • 100% TypeScript**
+
+---
+
+### 🤖 Provedor de IA Gratuito para seus agentes de programação favoritos
+
+_Conecte qualquer IDE ou ferramenta CLI com IA através do OmniRoute — gateway de API gratuito para programação ilimitada._
+
+
+
+ # 🚀 OmniRoute — Das kostenlose AI-Gateway
+
+### Höre nie auf zu programmieren. Intelligentes Routing zu **KOSTENLOSEN und günstigen KI-Modellen** mit automatischem Fallback.
+
+_Dein universeller API-Proxy — ein Endpoint, 36+ Anbieter, null Ausfallzeit._
+
+**Chat Completions • Embeddings • Bildgenerierung • Audio • Reranking • 100% TypeScript**
+
+---
+
+### 🤖 Kostenloser KI-Anbieter für deine Lieblings-Coding-Agenten
+
+_Verbinde jedes KI-gesteuerte IDE- oder CLI-Tool über OmniRoute — kostenloses API-Gateway für unbegrenztes Programmieren._
+
+ 
Abo-Kontingent verfällt jeden Monat ungenutzt
+-