OmniRoute Dashboard # 🚀 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
OpenClaw
⭐ 205K 		NanoBot
NanoBot
⭐ 20.9K 		PicoClaw
PicoClaw
⭐ 14.6K 		ZeroClaw
ZeroClaw
⭐ 9.9K 		IronClaw
IronClaw
⭐ 2.1K
OpenCode
OpenCode
⭐ 106K 		Codex CLI
Codex CLI
⭐ 60.8K 		Claude Code
Claude Code
⭐ 67.3K 		Gemini CLI
Gemini CLI
⭐ 94.7K 		Kilo Code
Kilo Code
⭐ 15.5K
📡 Tous les agents se connectent via http://localhost:20128/v1 ou http://cloud.omniroute.online/v1 — une configuration, modèles et quota illimités --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [🌐 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` | `1.0.3` | ~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 v1.0.3+ 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.3) - **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 [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](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 v1.0.3 --title "v1.0.3" --generate-notes ``` --- ## 📊 Historique des Stars Star History Chart --- ## 🙏 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