🚀 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é.

OpenClaw _{⭐ 205K}	NanoBot _{⭐ 20.9K}	PicoClaw _{⭐ 14.6K}	ZeroClaw _{⭐ 9.9K}	IronClaw _{⭐ 2.1K}
OpenCode _{⭐ 106K}	Codex CLI _{⭐ 60.8K}	Claude Code _{⭐ 67.3K}	Gemini CLI _{⭐ 94.7K}	Kilo Code _{⭐ 15.5K}

_{📡 Tous les agents se connectent via http://localhost:20128/v1 ou http://cloud.omniroute.online/v1 — une configuration, modèles et quota illimités}

🌐 Site web • 🚀 Démarrage rapide • 💡 Fonctionnalités • 📖 Docs • 💰 Tarifs

🤔 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

🎯 What OmniRoute Solves — 16 Real Pain Points

Every developer using AI tools faces these problems daily. OmniRoute was built to solve them all — from cost overruns to regional blocks, from broken OAuth flows to zero observability.

💸 1. "I pay for an expensive subscription but still get interrupted by limits"

Developers pay $20–200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling — 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity.

How OmniRoute solves it:

Smart 4-Tier Fallback — If subscription quota runs out, automatically redirects to API Key → Cheap → Free with zero manual intervention
Real-Time Quota Tracking — Shows token consumption in real-time with reset countdown (5h, daily, weekly)
Multi-Account Support — Multiple accounts per provider with auto round-robin — when one runs out, switches to the next
Custom Combos — Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized)
Codex Business Quotas — Business/Team workspace quota monitoring directly in the dashboard

🔌 2. "I need to use multiple providers but each has a different API"

OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints.

How OmniRoute solves it:

Unified Endpoint — A single http://localhost:20128/v1 serves as proxy for all 36+ providers
Format Translation — Automatic and transparent: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
Response Sanitization — Strips non-standard fields (x_groq, usage_breakdown, service_tier) that break OpenAI SDK v1.83+
Role Normalization — Converts developer → system for non-OpenAI providers; system → user for GLM/ERNIE
Think Tag Extraction — Extracts <think> blocks from models like DeepSeek R1 into standardized reasoning_content
Structured Output for Gemini — json_schema → responseMimeType/responseSchema automatic conversion
stream defaults to false — Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs

🌐 3. "My AI provider blocks my region/country"

Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like unsupported_country_region_territory during OAuth and API connections. This is especially frustrating for developers from developing countries.

How OmniRoute solves it:

3-Level Proxy Config — Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key
Color-Coded Proxy Badges — Visual indicators: 🟢 global proxy, 🟡 provider proxy, 🔵 connection proxy, always showing the IP
OAuth Token Exchange Through Proxy — OAuth flow also goes through the proxy, solving unsupported_country_region_territory
Connection Tests via Proxy — Connection tests use the configured proxy (no more direct bypass)
SOCKS5 Support — Full SOCKS5 proxy support for outbound routing
TLS Fingerprint Spoofing — Browser-like TLS fingerprint via wreq-js to bypass bot detection

🆓 4. "I want to use AI for coding but I have no money"

Not everyone can pay $20–200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost.

How OmniRoute solves it:

Free Tier Providers Built-in — Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free)
Free-Only Combos — Chain gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus = $0/month with zero downtime
NVIDIA NIM Free Credits — 1000 free credits integrated
Cost Optimized Strategy — Routing strategy that automatically chooses the cheapest available provider

🔒 5. "I need to protect my AI gateway from unauthorized access"

When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse.

How OmniRoute solves it:

API Key Management — Generation, rotation, and scoping per provider with a dedicated /dashboard/api-manager page
Model-Level Permissions — Restrict API keys to specific models (openai/*, wildcard patterns), with Allow All/Restrict toggle
API Endpoint Protection — Require a key for /v1/models and block specific providers from the listing
Auth Guard + CSRF Protection — All dashboard routes protected with withAuth middleware + CSRF tokens
Rate Limiter — Per-IP rate limiting with configurable windows
IP Filtering — Allowlist/blocklist for access control
Prompt Injection Guard — Sanitization against malicious prompt patterns
AES-256-GCM Encryption — Credentials encrypted at rest

🛑 6. "My provider went down and I lost my coding flow"

AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application.

How OmniRoute solves it:

Circuit Breaker per-provider — Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open)
Exponential Backoff — Progressive retry delays
Anti-Thundering Herd — Mutex + semaphore protection against concurrent retry storms
Combo Fallback Chains — If the primary provider fails, automatically falls through the chain with no intervention
Combo Circuit Breaker — Auto-disables failing providers within a combo chain
Health Dashboard — Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency

🔧 7. "Configuring each AI tool is tedious and repetitive"

Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time.

How OmniRoute solves it:

CLI Tools Dashboard — Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
GitHub Copilot Config Generator — Generates chatLanguageModels.json for VS Code with bulk model selection
Onboarding Wizard — Guided 4-step setup for first-time users
One endpoint, all models — Configure http://localhost:20128/v1 once, access 36+ providers

🔑 8. "Managing OAuth tokens from multiple providers is hell"

Claude Code, Codex, Gemini CLI, Copilot — all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with client_secret is missing, redirect_uri_mismatch, and failures on remote servers. OAuth on LAN/VPS is particularly problematic.

How OmniRoute solves it:

Auto Token Refresh — OAuth tokens refresh in background before expiration
OAuth 2.0 (PKCE) Built-in — Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow
Multi-Account OAuth — Multiple accounts per provider via JWT/ID token extraction
OAuth LAN/Remote Fix — Private IP detection for redirect_uri + manual URL mode for remote servers
OAuth Behind Nginx — Uses window.location.origin for reverse proxy compatibility
Remote OAuth Guide — Step-by-step guide for Google Cloud credentials on VPS/Docker

📊 9. "I don't know how much I'm spending or where"

Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up.

How OmniRoute solves it:

Cost Analytics Dashboard — Per-token cost tracking and budget management per provider
Budget Limits per Tier — Spending ceiling per tier that triggers automatic fallback
Per-Model Pricing Configuration — Configurable prices per model
Usage Statistics Per API Key — Request count and last-used timestamp per key
Analytics Dashboard — Stat cards, model usage chart, provider table with success rates and latency

🐛 10. "I can't diagnose errors and problems in AI calls"

When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error.

How OmniRoute solves it:

Unified Logs Dashboard — 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console
Console Log Viewer — Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter
SQLite Proxy Logs — Persistent logs that survive server restarts
Translator Playground — 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time)
Request Telemetry — p50/p95/p99 latency + X-Request-Id tracing
File-Based Logging with Rotation — Console interceptor captures everything to JSON log with size-based rotation

🏗️ 11. "Deploying and maintaining the gateway is complex"

Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, EACCES on directories, port conflicts, and cross-platform builds add friction.

How OmniRoute solves it:

npm global install — npm install -g omniroute && omniroute — done
Docker Multi-Platform — AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi)
Docker Compose Profiles — base (no CLI tools) and cli (with Claude Code, Codex, OpenClaw)
Electron Desktop App — Native app for Windows/macOS/Linux with system tray, auto-start, offline mode
Split-Port Mode — API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking)
Cloud Sync — Config synchronization across devices via Cloudflare Workers
DB Backups — Automatic backup, restore, export and import of all settings

🌍 12. "The interface is English-only and my team doesn't speak English"

Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors.

How OmniRoute solves it:

Dashboard i18n — 30 Languages — All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English
RTL Support — Right-to-left support for Arabic and Hebrew
Multi-Language READMEs — 30 complete documentation translations
Language Selector — Globe icon in header for real-time switching

🔄 13. "I need more than chat — I need embeddings, images, audio"

AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format.

How OmniRoute solves it:

Embeddings — /v1/embeddings with 6 providers and 9+ models
Image Generation — /v1/images/generations with 4 providers and 9+ models
Audio Transcription — /v1/audio/transcriptions — Whisper-compatible
Text-to-Speech — /v1/audio/speech — Multi-provider audio synthesis
Moderations — /v1/moderations — Content safety checks
Reranking — /v1/rerank — Document relevance reranking
Responses API — Full /v1/responses support for Codex

🧪 14. "I have no way to test and compare quality across models"

Developers want to know which model is best for their use case — code, translation, reasoning — but comparing manually is slow. No integrated eval tools exist.

How OmniRoute solves it:

LLM Evaluations — Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal
4 Match Strategies — exact, contains, regex, custom (JS function)
Translator Playground Test Bench — Batch testing with multiple inputs and expected outputs, cross-provider comparison
Chat Tester — Full round-trip with visual response rendering
Live Monitor — Real-time stream of all requests flowing through the proxy

📈 15. "I need to scale without losing performance"

As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected.

How OmniRoute solves it:

Semantic Cache — Two-tier cache (signature + semantic) reduces cost and latency
Request Idempotency — 5s deduplication window for identical requests
Rate Limit Detection — Per-provider RPM, min gap, and max concurrent tracking
Editable Rate Limits — Configurable defaults in Settings → Resilience with persistence
API Key Validation Cache — 3-tier cache for production performance
Health Dashboard with Telemetry — p50/p95/p99 latency, cache stats, uptime

🤖 16. "I want to control model behavior globally"

Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical.

How OmniRoute solves it:

System Prompt Injection — Global prompt applied to all requests
Thinking Budget Validation — Reasoning token allocation control per request (passthrough, auto, custom, adaptive)
6 Routing Strategies — Global strategies that determine how requests are distributed
Wildcard Router — provider/* patterns route dynamically to any provider
Combo Enable/Disable Toggle — Toggle combos directly from the dashboard
Provider Toggle — Enable/disable all connections for a provider with one click
Blocked Providers — Exclude specific providers from /v1/models listing

⚡ Démarrage rapide

1. Installer globalement :

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 :

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.

Démarrage rapide :

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

Avec fichier d'environnement :

# 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 :

# 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`	`1.0.6`	~250MB	Version actuelle

🖥️ Application Bureau — Hors Ligne et Toujours Actif

🆕 NOUVEAU ! OmniRoute est maintenant disponible en tant qu'application de bureau native pour Windows, macOS et Linux.

Exécutez OmniRoute en tant qu'application de bureau autonome — sans terminal, sans navigateur, sans internet requis pour les modèles locaux.

🖥️ Fenêtre Native — Fenêtre dédiée avec intégration dans la barre d'état système
🔄 Démarrage Automatique — Lancez OmniRoute à la connexion système
🔔 Notifications Natives — Alertes pour l'épuisement de quota ou les problèmes
⚡ Installation en Un Clic — NSIS (Windows), DMG (macOS), AppImage (Linux)
🌐 Mode Hors Ligne — Fonctionne entièrement hors ligne avec serveur intégré

npm run electron:dev           # Mode développement
npm run electron:build         # Plateforme actuelle
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg)
npm run electron:build:linux   # Linux (.AppImage)

📖 Documentation complète : electron/README.md

💰 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 !

💡 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
🔀 Model Aliases	Auto-forward deprecated model IDs to current replacements (built-in + custom)
⚡ Background Degradation	Auto-route background tasks (titles, summaries) to cheaper models
💬 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
💾 Rate Limit Persistence	Learned limits survive restarts via SQLite with 60s debounce + 24h staleness
🔄 Token Refresh Resilience	Per-provider circuit breaker (5 fails→30min) + 30s timeout per attempt

📊 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é

🎯 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...

📖 Guide de configuration

💳 Fournisseurs par abonnement

Claude Code (Pro/Max)

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)

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 !)

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

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 !)

S'inscrire : build.nvidia.com
Obtenir une clé API gratuite (1000 crédits d'inférence inclus)
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

S'inscrire : platform.deepseek.com
Obtenir une clé API
Tableau de bord → Ajouter fournisseur → DeepSeek

Modèles : deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (Niveau gratuit disponible !)

S'inscrire : console.groq.com
Obtenir une clé API (niveau gratuit inclus)
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)

S'inscrire : openrouter.ai
Obtenir une clé API
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)

S'inscrire : Zhipu AI
Obtenir une clé API du Coding Plan
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)

S'inscrire : MiniMax
Obtenir une clé API
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)

S'abonner : Moonshot AI
Obtenir une clé API
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)

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)

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)

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

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 :

{
  "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

🧪 É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 v1.0.6+ 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/ (v1.0.6)
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
Package : npmjs.com/package/omniroute
Docker : hub.docker.com/r/diegosouzapw/omniroute
Résilience : Circuit breaker, backoff exponentiel, anti-thundering herd, spoofing TLS

📖 Documentation

Document	Description
Guide utilisateur	Fournisseurs, combos, intégration CLI, déploiement
Référence API	Tous les endpoints avec exemples
Dépannage	Problèmes courants et solutions
Architecture	Architecture système et détails internes
Contribuer	Configuration de développement et directives
Spécification OpenAPI	Spécification OpenAPI 3.0
Politique de sécurité	Signalement de vulnérabilités et pratiques sécurité

📧 Support

💬 Rejoignez notre communauté ! Groupe WhatsApp — Obtenez de l'aide, partagez des astuces et restez informé.

Site web : omniroute.online
GitHub : github.com/diegosouzapw/OmniRoute
Issues : github.com/diegosouzapw/OmniRoute/issues
WhatsApp : Groupe communautaire
Projet original : 9router par decolua

👥 Contributeurs

Comment contribuer

Forkez le dépôt
Créez votre branche de fonctionnalité (git checkout -b feature/amazing-feature)
Committez vos changements (git commit -m 'Add amazing feature')
Poussez vers la branche (git push origin feature/amazing-feature)
Ouvrez une Pull Request

Consultez CONTRIBUTING.md pour les directives détaillées.

Publier une nouvelle version

# Créer un release — la publication npm est automatique
gh release create v1.0.6 --title "v1.0.6" --generate-notes

📊 Historique des Stars

🙏 Remerciements

Remerciements spéciaux à 9router par 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 — l'implémentation originale en Go qui a inspiré ce portage en JavaScript.

📄 Licence

Licence MIT — voir LICENSE pour les détails.

_{Fait avec ❤️ pour les développeurs qui codent 24/7}
_{omniroute.online}

FilesExpand file tree

README.fr.md

Latest commit

History

README.fr.md

File metadata and controls

🚀 OmniRoute — La Passerelle IA Gratuite

N'arrêtez jamais de coder. Routage intelligent vers des modèles IA GRATUITS et économiques avec fallback automatique.

🤖 Fournisseur IA gratuit pour vos agents de programmation préférés

🤔 Pourquoi OmniRoute ?

🔄 Comment ça fonctionne

🎯 What OmniRoute Solves — 16 Real Pain Points

⚡ Démarrage rapide

🐳 Docker

🖥️ Application Bureau — Hors Ligne et Toujours Actif

💰 Aperçu des tarifs

💡 Fonctionnalités principales

🧠 Routage & Intelligence

🎵 APIs multi-modales

🛡️ Résilience & Sécurité

📊 Observabilité & Analytique

☁️ Déploiement & Synchronisation

🎯 Fallback intelligent 4 niveaux

📊 Suivi des quotas en temps réel

🔄 Traduction de format

👥 Support multi-comptes

🔄 Renouvellement automatique des tokens

🎨 Combos personnalisés

🏥 Tableau de bord santé

🔧 Playground du traducteur

💾 Cloud Sync

🎯 Cas d'utilisation

Cas 1 : « J'ai un abonnement Claude Pro »

Cas 2 : « Je veux zéro coût »

Cas 3 : « Je dois coder 24/7, sans interruption »

Cas 4 : « Je veux l'IA GRATUITE dans OpenClaw »

📖 Guide de configuration

Claude Code (Pro/Max)

OpenAI Codex (Plus/Pro)

Gemini CLI (GRATUIT 180K/mois !)

GitHub Copilot

NVIDIA NIM (GRATUIT 1000 crédits !)

DeepSeek

Groq (Niveau gratuit disponible !)

OpenRouter (100+ modèles)

GLM-4.7 (Reset quotidien, $0.6/1M)

MiniMax M2.1 (Reset 5h, $0.20/1M)

Kimi K2 (9 $/mois fixe)

iFlow (8 modèles GRATUITS)

Qwen (3 modèles GRATUITS)

Kiro (Claude GRATUIT)

Exemple 1 : Maximiser l'abonnement → Backup économique

Exemple 2 : Gratuit uniquement (Zéro coût)

Cursor IDE

Claude Code

Codex CLI

OpenClaw

Cline / Continue / RooCode

🧪 Évaluations (Evals)

Golden Set intégré

Stratégies d'évaluation

🐛 Dépannage

🛠️ Stack technologique

📖 Documentation

📧 Support

👥 Contributeurs

Comment contribuer

Publier une nouvelle version

📊 Historique des Stars

🙏 Remerciements

📄 Licence