## 💰 ~1,62 Md de tokens / mois via les offres gratuites tierces
> **Apportez vos propres comptes de fournisseurs.** Il s'agit d'une estimation agrégée sur des offres gratuites tierces éligibles séparément, et non d'une attribution de tokens de la part d'OmniRoute. Inscrivez-vous, obtenez les identifiants requis le cas échéant, et connectez les fournisseurs que vous pouvez utiliser ; chaque fournisseur contrôle ses limites, sa disponibilité et ses conditions.
>
> Empiler les offres gratuites à la main est pénible — des dizaines de SDK, des dizaines de limites de débit, et aucune idée de ce dont vous disposez réellement. OmniRoute répertorie **467 entrées d'offres gratuites réparties sur 34 clés de pools récurrents** et calcule le chiffre principal de tokens à partir des **17 pools disposant d'un budget mensuel positif publié, plus cinq plafonds Groq par modèle**, dédupliqués par pool partagé. Les quotas qui ne s'ouvrent qu'après une vérification d'identité régionale (aujourd'hui : ModelScope) sont affichés à part, +~6M derrière une vérification d'identité régionale, et ne sont jamais additionnés au chiffre principal. Le résultat reste visible sur le tableau de bord (`/dashboard/free-tiers`).
> Résumé animé de la page `/dashboard/free-tiers` en direct. Méthodologie complète (déduplication des pools, paliers de crédits, conditions des fournisseurs) : **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ces chiffres sont réaudités toutes les deux semaines par rapport au catalogue en direct et **évoluent dans les deux sens** — un fournisseur met fin à une offre gratuite et le chiffre baisse ; une nouvelle offre arrive et il remonte. Nous publions ce que le catalogue calcule réellement, jamais un meilleur cas arrondi à la hausse.
⭐ Mettez une étoile au dépôt si OMNIROUTE vous a aidé à économiser de l'argent et à faciliter votre travail.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Rejoignez la communauté
**👋 Suivez le mainteneur — soyez le premier informé des nouveaux fournisseurs, versions et astuces :**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Questions, astuces sur les fournisseurs, feuille de route et support → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 La passerelle continue de croître
| | v3.8.50 | **v3.8.51** | `v3.8.53+` |
| ---------------------------------- | :-----------------------: | :---------: | :----------------------: |
| 🌐 Fournisseurs | 352 | **358** | 375 |
| 🧠 ID uniques de modèles de chat | 1320 | **1374** | 1475 |
| 🖼️ Pont de modalités | 🆕 vision + audio + vidéo | ✓ | ✓ |
| 📡 Catalogue gratuit Radar | 🆕 opt-in | ✓ | ✓ |
| ⚖️ Ordonnancement selon les quotas | 🆕 Quota-Share | ✓ | ✓ |
| 📊 Télémétrie des quotas | 🆕 en direct | ✓ | ✓ |
| 🧰 Mode headless | — | — | 🆕 `serve --headless` |
| 🛤️ Infra de rail LTS | — | — | 🆕 canaux de publication |
| 🔎 API de découverte des modèles | — | — | 🆕 `/v1/models/query` |
**→ [Feuille de route](ROADMAP.md) — en route sur le rail vers `v3.9.0 LTS`**
## 🆓 Installez, connectez un fournisseur, puis routez via un seul endpoint
```bash
# Après avoir connecté un fournisseur, copiez votre clé OmniRoute depuis Dashboard → Endpoints :
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` nécessite une route éligible. Une installation fraîche peut n'avoir aucune cible keyless éligible, et un fournisseur keyless peut rejeter les clients tiers. Les fournisseurs marqués `tos: avoid`, y compris Kiro, sont exclus du routage automatique par défaut ; connecter un compte ne modifie pas ce réglage. Consultez le [Guide des offres gratuites](docs/getting-started/FREE-TIERS-GUIDE.md) avant de choisir un fournisseur.📦 Scripts de démarrage rapide à copier-coller pour **Python, Node.js, PHP et cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 La Promesse
# 🤔 Pourquoi OmniRoute ?
## 🤝 Soutenu par nos Amis Open Source
> **Vous voulez nous rejoindre en tant qu'Ami Open Source ?** Ce sont les entreprises qui soutiennent l'open source et aident à maintenir OmniRoute en mouvement — et nous déclarons publiquement où va chaque jeton qu'elles nous donnent. Contactez-nous : [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Merci à Kimi (Moonshot AI), notre Ami Fondateur Open Source, de soutenir ce projet ! Kimi est le laboratoire d'IA derrière les familles de modèles à poids ouverts K2 et K3 — Kimi K3 offre une fenêtre contextuelle de 1M de jetons, une vision native et un codage de pointe à une fraction des prix des modèles fermés, et fonctionne directement avec Claude Code, Codex et tous les outils de codage qu'OmniRoute prend en charge.
Ce que le soutien de Kimi finance : Les crédits API de Kimi alimentent le pipeline de publication validé par l'IA d'OmniRoute — l'étape de validation de fusion alimentée par Kimi K3 qui examine chaque pull request avant sa publication — ainsi que le développement quotidien de fonctionnalités. Le support de première classe de Kimi est disponible sur les deux rails : l'API directe Kimi (kimi-k3) et le plan de codage Kimi Code (OAuth et clé API). OmniRoute est également le premier projet open source brésilien dans le programme de soutien de Kimi. Obtenez une clé API Kimi avec 15% de crédits supplémentaires →
Cheaper Inference cheaperinference.com
Merci à Cheaper Inference, un Ami Open Source d'OmniRoute, de soutenir ce projet ! Cheaper Inference est une passerelle classée par coût qui revend 42 modèles de pointe — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok et MiniMax — derrière un seul point d'accès compatible OpenAI, acheminant chaque requête vers le fournisseur éligible le moins cher sans jamais facturer au-dessus du prix catalogue du créateur du modèle.
Support de première classe dans OmniRoute : Chat Completions, le point d'accès natif /v1/responses, la vision, l'appel d'outils et 3 modèles d'image (grok-imagine, nano-banana-pro, nano-banana-2, accessibles sous cheaperinference/<model>). Obtenez une clé API →
Les liens tagués aff=omniroute sont des liens partenaires. Ils financent le projet sans coût supplémentaire pour vous. 🎟️ Promo Affiliés — coupons d'inscription gratuits de fournisseurs que nous ne sponsorisons pas (cliquez pour développer)Cette section est uniquement destinée aux codes de parrainage/coupon. Les partenariats sponsorisés se trouvent dans 🤝 Soutenu par nos Amis Open Source ci-dessus. OmniRoute n'a aucun parrainage ou partenariat avec les fournisseurs listés ici — ce sont des coupons publics que tout le monde peut utiliser.
AgentRouter agentrouter.org
AgentRouter — inscription affiliée · 100 $ de crédits gratuits à l'inscription (serveur gratuit, attendez-vous à une latence plus élevée — idéal pour les tests, pas pour la production). Support de première classe dans OmniRoute depuis la v3.8.50 : Chat Completions, le format de fil compatible Anthropic et le chemin compatible OpenAI. Les modèles disponibles incluent claude-opus-4-8, claude-opus-5, gpt-5.6-sol et plus encore. Récupérez vos 100 $ →
⚠️ Lien d'affiliation — OmniRoute n'a aucun parrainage ou partenariat avec ce fournisseur.
Vous connaissez un autre fournisseur avec un généreux coupon d'inscription gratuit qui profite aux utilisateurs d'OmniRoute ? Ouvrez une issue et nous l'ajouterons ici.
## 🎯 Combos — La fonctionnalité phare
> Un **combo** est une chaîne de modèles entre lesquels OmniRoute effectue le routage **automatiquement**. Si le quota est épuisé, qu'un fournisseur tombe en panne ou que les coûts grimpent, le combo peut passer au modèle sain et éligible suivant. 🛡️
### ⚡ Sans configuration — utilisez simplement `auto`
Aucun combo à créer. Définissez votre modèle sur `auto` (ou une variante) et OmniRoute construit un combo virtuel à partir de vos fournisseurs connectés, évalués en temps réel :
ID du modèle
Ce qu'il optimise
auto
🎯 Choix équilibré par défaut (LKGP — reste sur votre dernier fournisseur fiable)
auto/coding
🧑💻 Pondérations privilégiant la qualité pour la génération de code
auto/fast
⚡ Latence la plus faible en priorité
auto/cheap
💰 Coût par token le plus bas en priorité
auto/subscription
🎟️ Uniquement le quota d'abonnement que vous payez déjà — échec sans repli, jamais de solution de secours facturable (guide)
auto/thrifty
🪜 D'abord le quota du forfait, puis progression palier par palier vers les options payantes les moins chères — retour au forfait après sa réinitialisation (guide)
auto/offline
🔋 Plus grande marge de quota ou de limite de débit en priorité
auto/smart
🔭 Qualité en priorité + 10 % d'exploration pour découvrir de meilleurs modèles
auto/lkgp
📌 Affinité explicite avec le dernier fournisseur fiable connu
auto/chaos
🧪 Diffusion parallèle vers un panel de modèles (un par fournisseur, 5 par défaut), avec renvoi d'une seule réponse ; un appel en amont par modèle du panel, sans injection de panne
##
### 🔀 Ou créez le vôtre — 20 stratégies de routage
Les **20** stratégies — à combiner librement à chaque étape du combo :
#
Stratégie
Fonctionnement
1
priority
Liste ordonnée privilégiant la première cible — épuise chacune avant de passer à la suivante 🥇
2
fill-first
Utilise entièrement le quota de chaque cible avant de passer à la suivante
3
weighted
Sélection aléatoire pondérée selon le poids de chaque cible
4
round-robin
Parcourt les cibles dans l'ordre de manière cyclique
5
p2c
Équilibrage de charge aléatoire selon la puissance de deux choix
6
least-used
Sélectionne la cible ayant la charge actuelle la plus faible
7
random
Sélection aléatoire uniforme (sans doublons)
8
strict-random
Sélection aléatoire sans éliminer les répétitions 🎲
9
cost-optimized
Minimise le coût en $ par requête selon les tarifs du catalogue en temps réel 💸
10
headroom
Sélectionne la cible disposant du plus grand quota restant
11
quota-weighted
Ignore les comptes épuisés, puis effectue un tirage proportionnel au quota restant ÷ la charge en cours — les conversations existantes restent rattachées ⚖️
12
reset-window
Privilégie la cible dont la fenêtre de quota est réinitialisée le plus tôt
13
reset-aware
Classe selon l'heure de réinitialisation du quota — fenêtres courtes en premier 📊
14
context-relay
Transmet le contexte entre les cibles pour les longues conversations 🧠
15
context-optimized
Sélectionne la cible la mieux adaptée à la taille actuelle du contexte
16
cache-optimized
Rattache chaque préfixe de prompt réutilisable au même compte — maximise les accès au cache de prompts 🎯
17
lkgp
Dernier chemin fiable connu — rattache au dernier fournisseur ayant réussi, puis se replie sur les règles
18
auto
Évaluation en temps réel selon 16 facteurs pour chaque connexion 🤖
19
fusion
Diffuse vers un panel de modèles + un juge synthétise une réponse unique 🧬
20
pipeline
Enchaîne les étapes — la sortie de chaque cible alimente la suivante 🔗
Le moteur Auto-Combo évalue chaque candidat selon **16 facteurs** (santé, quota, coût, latence, adéquation à la tâche, qualité, disponibilité de la session…) — voir [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 La résilience est intégrée (3 couches indépendantes)
📖 [Moteur Auto-Combo](docs/routing/AUTO-COMBO.md) · [Guide de résilience](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Ce qui distingue OmniRoute
📊 Méthodologie complète et détails par fonctionnalité par rapport à 9router, OpenRouter, CLIProxyAPI et LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Soutenir OmniRoute
OmniRoute est sous licence MIT et maintenu de manière ouverte. S’il vous fait gagner du temps ou de l’argent, voici comment contribuer à préserver son indépendance — choisissez l’option qui vous convient. Le parrainage n’influence jamais la priorité de routage ; il offre de la visibilité, pas un meilleur classement.
**🇧🇷 PIX** — instantané, sans frais (Brésil)
Clé (aléatoire) : `5d865059-bc44-483a-962d-43ceb80126eb`
Pix à copier-coller :
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ Cryptomonnaies — BTC · ETH · USDT-TRC20 · USDC-Solana (cliquez pour développer)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Envoyez chaque cryptomonnaie uniquement sur le réseau indiqué — un envoi sur le mauvais réseau peut entraîner la perte des fonds.
🐛 Vous avez trouvé un bug ou avez des commentaires ? Ouvrez une [Discussion](https://github.com/diegosouzapw/OmniRoute/discussions).
Notes pour les développeurs : Le projet peut générer un fichier local .env pendant npm install/postinstall afin de faciliter le travail des développeurs. Ce fichier est volontairement ignoré via .gitignore (voir .gitignore) et ne doit jamais être validé dans le dépôt — s’il l’est accidentellement, renouvelez tous les secrets exposés et supprimez le fichier de l’historique. Consultez docs/DEVELOPER-ENVIRONMENT.md pour obtenir des recommandations sur la gestion des fichiers d’environnement locaux et des secrets.
## 📡 Radar OmniRoute
Le principal chiffre à retenir pour l’offre gratuite reste **~1,62 milliard de tokens/mois**, d’après le catalogue documenté et dédupliqué par pool ci-dessus. Les crédits temporaires accordés lors de l’inscription auprès des fournisseurs peuvent porter séparément le premier mois à **~2,22 milliards**. Radar est une surcouche de catalogue facultative et signée, destinée aux personnes qui souhaitent disposer d’informations plus récentes sur la disponibilité des modèles gratuits entre les versions d’OmniRoute ; le catalogue communautaire et toutes les fonctionnalités gratuites existantes restent gratuits.
Les contributeurs peuvent recevoir le catalogue en temps réel ainsi que des possibilités supplémentaires offertes par les fournisseurs. Son plafond distinct et variable est d’**environ 3 milliards de tokens/mois au maximum**, selon la disponibilité des fournisseurs. Ce plafond n’est pas garanti : les fournisseurs peuvent modifier à tout moment les quotas, les critères d’éligibilité, les modèles ou les régions.
Radar est facultatif et utilise uniquement des requêtes GET. Le client OmniRoute ne transmet ni les prompts, ni le trafic, ni la configuration des fournisseurs, ni les données télémétriques d’utilisation, ni l’état local de masquage des annonces. Pour en savoir plus sur l’éligibilité et consulter le catalogue actuel, rendez-vous sur **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Nouveautés
> Faits saillants récents de **v3.8.20 → v3.8.53**. Historique complet dans [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Routage `quota-weighted`** — la 20ᵉ stratégie de combo écarte les comptes épuisés, puis répartit parmi les autres au prorata du quota restant ÷ de la charge en cours, tout en gardant les conversations existantes épinglées. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Mode headless** — `omniroute serve --headless` (ou `OMNIROUTE_HEADLESS=1`) n'exécute que le moteur de proxy `/v1/*`, le tableau de bord et les sous-systèmes réservés au tableau de bord étant désactivés. → [Mode headless](docs/guides/HEADLESS.md)
- **🔎 Découverte de modèles** — `/v1/models` filtre par capacité, contexte, type et texte, et `POST /v1/models/query` renvoie une courte sélection déterministe avec la même visibilité par clé. → [Référence API](docs/reference/API_REFERENCE.md)
- **🔑 Contrôle du routage par clé** — épinglez une clé API à un modèle ou un combo via `forcedModel`, et ajoutez ou retirez atomiquement les modèles et combos d'une clé (`/api/keys/{id}/access`). → [Référence API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Contrôles PII affinés** — sélection par type, jusqu'à 20 motifs de masquage personnalisés validés et compteurs de détection par type ; le masquage lui-même reste opt-in. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 langues** — tableau de bord, miroirs de documentation et CLI, avec `npm run i18n:add-locale` qui ajoute une langue partout en une seule commande. → [Guide i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — délégation A2A entrante vers votre flotte d'agents, compétences Conductor sur la Agent Card, et un panneau du tableau de bord avec le chat vocal push-to-talk Faro. → [Serveur A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Admission adaptative & protection contre la surcharge** — les requêtes de chat lourdes sont mises en file d'attente au lieu de renvoyer un 503, avec des baux glissants RPM atomiques par connexion. → [Guide de résilience](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Ordre canonique de `/v1/models`** — un bloc contigu regroupé par fournisseur pour chaque fournisseur (les combos épinglés en premier), stable quelle que soit la source du catalogue. → [Référence API](docs/reference/API_REFERENCE.md)
- **🗜️ Durcissement de la compression** — garde anti-inflation activée par défaut, packs Caveman pour DE / FR / JA + chinois (wényán), filtres RTK pour Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Coût forfaitaire honnête** — les fournisseurs d'abonnement / de plan de codage affichent **$0** dans les analyses de coûts ; le budget, le quota et le routage continuent d'estimer. → [Référence API](docs/reference/API_REFERENCE.md)
- **⚖️ Routage Quota-Share** — répartissez équitablement le quota d'un compte partagé entre les clés mutualisées, sans gaspillage afin que les tranches inactives soient prêtées. → [Guide de résilience](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Configuration CLI/agent en une commande** — 15 commandes `setup-*` enregistrées ; `omniroute run` lance 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ; `omniroute configure` prend en charge 11 cibles avec un sélecteur interactif fournisseur+modèle et des favoris par contexte. → [Intégrations CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Mode distant** — pilotez un OmniRoute distant avec des jetons à portée limitée (`connect` / `contexts` / `tokens`) + un assistant OAuth `antigravity` pour les installations VPS. → [Mode distant](docs/guides/REMOTE-MODE.md)
- **🧭 Auto-routage plus intelligent** — combos `auto/:`, **Fusion** (panel de modèles + juge), routage selon la tâche, substitutions par requête du modèle / mode / budget en USD. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Compression enfichable** — 12 moteurs composables + Compression Studios : LLMLingua-2, Ultra à deux niveaux, omniglyph, garde de fidélité par étape, GCF v3.2, éditeur par glisser-déposer. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Déchiffrement MITM transparent (TPROXY)** — capturez les CLI qui ignorent les variables d'environnement de proxy, avec un CA par SNI + un installateur de trust-store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Télémétrie de coût partout** — en-têtes de coût/usage `X-OmniRoute-*` sur chaque endpoint, en-tête d'économies sur cache-HIT, quotas de dépenses USD par clé. → [Référence API](docs/reference/API_REFERENCE.md)
- **🧠 Une mémoire que vous contrôlez** — désactivée par défaut, quantification vectorielle int8 + décroissance typée en opt-in, `x-omniroute-no-memory` par requête. → [Mémoire](docs/frameworks/MEMORY.md)
- **🛡️ Sécurité** — garde anti-injection de prompt sur chaque route LLM (suite red-team), garde-fou de masquage des identifiants en opt-in (caviarde les clés API/secrets divulgués dans les deux sens), recherche web gratuite DuckDuckGo en dernier recours, et une porte de connexion OIDC optionnelle pour le tableau de bord (la connexion par mot de passe reste toujours disponible). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Nouveaux endpoints** — `/v1/ocr` (Mistral OCR) et `/v1/audio/translations` (style Whisper) complètent la surface média. → [Référence API](docs/reference/API_REFERENCE.md)
- **🎨 Génération d'images / vidéos / audio** — une seule API pour les médias : vidéo xAI Grok Imagine & Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, et des fournisseurs de parole comme ElevenLabs. → [Référence API](docs/reference/API_REFERENCE.md)
- **🌍 Déploiement & ops** — `basePath` de reverse-proxy, détection automatique de la langue du navigateur, suivi des appareils par clé, confiance MITM sans root, localisation zh-TW. → [Environnement](docs/reference/ENVIRONMENT.md)
- **🤝 Plus de fournisseurs & d'agents** — agents cloud (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) avec connexion navigateur + OAuth, carte Ollama de premier ordre, Claude Opus 5 & Sonnet 5, partenariat officiel Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… et un **catalogue de 375 fournisseurs** actualisé. → [Fournisseurs](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Transparence du routage** — chaque réponse porte un en-tête `X-OmniRoute-Decision` indiquant la stratégie/le fournisseur/la latence qui l'a servie, une nouvelle stratégie de combo `cache-optimized` + un facteur `cacheAffinity` d'Auto-Combo qui renvoie les requêtes répétées vers la connexion détenant le préfixe mis en cache, et un endpoint en lecture seule `/v1/auto-combo/{channel}/candidates` qui expose le pool de candidats actif d'un canal `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Performances locales & infra** — Redis local en un clic, déployeurs de relais Cloudflare Workers / Deno Deploy, Bifrost & Mux en tant que services embarqués supervisés. → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Également inclus** — framework de plugins + marketplace, frameworks de compétences Omni/Agent/GitHub, intégration du coffre Obsidian (22 outils MCP), API Batch & Files compatibles OpenAI, cache sémantique de réponses, gamification avec classements, découverte d'agents ACP (15 agents intégrés), export planifié des logs vers BigQuery, fan-out parallèle multi-modèles `auto/chaos`, un pont de bot Telegram, un gestionnaire de versions intégré à l'application et des classements de fournisseurs gratuits LMArena-ELO. → [Docs](docs/README.md)
## 🤖 CLI et agents de codage compatibles
> Une seule configuration — `http://localhost:20128/v1` — et **tous** les IDE ou CLI d’IA fonctionnent avec des modèles gratuits et à faible coût.
＋ fonctionne également avec · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · tout outil compatible avec OpenAI
📖 Configuration de chacun des 37 outils (27 CLI de codage + 10 agents CLI) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Extension OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Lancez n’importe quelle CLI prise en charge via OmniRoute en une seule commande** — aucun fichier de configuration n’est écrit,
les identifiants sont injectés pour chaque processus, et Qwen/Gemini utilisent un répertoire personnel isolé et temporaire :
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Vous pouvez également choisir le fournisseur et le modèle de manière interactive, puis écrire la configuration propre à l’outil :
omniroute configure codex # également : claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Chaque commande respecte le contexte distant actif (`omniroute connect `), `--dry-run`
affiche un aperçu exact des variables d’environnement et des arguments sans rien exécuter, et `--api-key-env NAME` évite
que les secrets apparaissent dans l’historique de votre shell. → [Intégrations CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 fournisseurs d'IA — 153 marqués gratuits dans le catalogue
> **375 fournisseurs enregistrés** répartis dans les collections canoniques chat, média, recherche, local, cloud-agent et système, dont **153 portant la métadonnée de découverte `hasFree: true`**. Le registre des modèles de chat couvre **239 fournisseurs / 3 059 paires fournisseur-modèle distinctes / 1 475 ID de modèles bruts** ; le catalogue distinct des quotas gratuits comporte **467 lignes par modèle**, **34 pools récurrents** et **51 fournisseurs gratuits à vie, récurrents ou sans clé**. Ces dénominateurs diffèrent par conception ; les définitions et les calculs dédupliqués par pool se trouvent dans la [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) et [Free Tiers](docs/reference/FREE_TIERS.md).
### 🏢 Tous les grands laboratoires — via un seul endpoint
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…et plus de 350 autres — chaque icône est résolue en direct depuis le catalogue de fournisseurs du tableau de bord. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Gratuit à vie — 0 $, sans carte bancaire
OpenCode Zen DeepSeek V4, Nemotron 3 Aucune limite de jetons
Kilo Code Routage automatique, Tencent Hy3 Gratuit pour toujours
Requesty GPT-OSS 120B, Nemotron Gratuit pour toujours
SiliconFlow DeepSeek V3.2 / R1 Offre gratuite
Z.AI GLM GLM-4.7 / 4.5-Flash Gratuit pour toujours
Baidu ERNIE ERNIE 4.0 Gratuit pour toujours
Qoder AI Qwen3-Max, Kimi-K2 GRATUIT et illimité
Pollinations GPT, Llama, Claude Aucune clé requise
Cloudflare AI Plus de 50 modèles 10 000 neurones/jour
NVIDIA NIM GLM, MiniMax ~40 RPM gratuitement
Cerebras GLM 4.7, GPT-OSS Crédit unique de 5 $ ; carte requise
OpenRouter Modèles :free +10 $ → RPM plus élevé
📖 Catalogue complet lisible par machine → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Où fonctionne OmniRoute — partout
> Même application, votre machine, vos règles. D’une installation globale avec npm jusqu’à **votre téléphone** via Termux.
Plateforme
Installation
Points forts
📦 npm (global)
npm install -g omniroute
Une seule commande, sur tous les systèmes d’exploitation
🐳 Docker
docker run … diegosouzapw/omniroute
Multiarchitecture AMD64 + ARM64
🖥️ Bureau (Electron)
npm run electron:build
Fenêtre native + zone de notification — Windows / macOS / Linux
🎩 Barre des menus (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Supervise et met automatiquement à jour le serveur — macOS
💪 ARM
arm64 natif
Raspberry Pi, serveurs ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Fonctionne sur votre téléphone, 24 h/24 et 7 j/7, sans accès root
📲 PWA
« Ajouter à l’écran d’accueil »
Plein écran, hors ligne, installable depuis le navigateur
🧩 Extension OpenCode
@omniroute/opencode-provider
Intégration native à OpenCode
🤖 VS Code Copilot Chat
installer l’extension OmniCopilot
Tous les modèles OmniRoute dans le sélecteur natif de Copilot Chat — versions stable et Insiders
### 🧩 Nouveau : OmniRoute dans l’interface native de Copilot Chat de VS Code
> Aucune nouvelle barre latérale, aucune nouvelle interface de discussion — chaque modèle fourni par OmniRoute apparaît directement dans le
> **sélecteur de modèles de Copilot Chat que vous utilisez déjà**. Depuis VS Code 1.122, les modèles des fournisseurs fonctionnent
> sans connexion à GitHub ni abonnement Copilot — mode agent, appels d’outils et vision,
> gratuitement.
Installez l’extension **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, configurez-la
pour utiliser votre serveur OmniRoute (`localhost:20128` par défaut), puis ouvrez Copilot Chat → sélecteur de modèles
→ **Gérer les modèles…** → **OmniRoute**.
Depuis l’éditeur : ouvrez la vue **Extensions**, recherchez **« OmniRoute »**, puis cliquez sur **Installer**
— le fonctionnement est identique dans les deux boutiques. Le code source, les tickets et le guide de publication sont disponibles sur
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Guide de VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — configuration, contenu du sélecteur, tableau de bord dans un onglet, dépannage
### 🎩 Nouveau : OmniRouteTray — votre passerelle, directement dans la barre des menus
> `omniroute serve` donne le meilleur de lui-même lorsqu’il fonctionne en permanence. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> en fait une application macOS pour la barre des menus que vous configurez une fois pour toutes : elle démarre le serveur, le maintient actif
> après les redémarrages, le met à jour sur place et vous permet de consulter votre budget de jetons en direct en un clic — **sans
> fenêtre de terminal laissée ouverte ni installation `npm install -g omniroute` à surveiller.**
Conçue avec [Tauri v2](https://v2.tauri.app/) (un cœur Rust minuscule), elle embarque
son propre environnement d’exécution Node 24 signé et gère une installation d’OmniRoute propre à l’application, afin de ne jamais entrer en conflit avec vos installations
globales de `node`/`bun`. Elle **partage votre configuration et votre base de données `~/.omniroute/` existantes** — c’est donc le
même OmniRoute que vous utilisez déjà, simplement coiffé d’un chapeau. 🎩
Fonctionnalité
Fonctionnement
🟢 Supervise le serveur
Lance omniroute serve et adopte une instance déjà en cours d’exécution au lieu de la dupliquer
📊 Utilisation en direct d’un seul coup d’œil
Barres de quota des fournisseurs, limites de session/hebdomadaires de Claude avec comptes à rebours avant réinitialisation, ventilation des coûts sur 30 jours
🔄 Mises à jour automatiques sur place
Installation intermédiaire, remplacement atomique, retour en arrière en cas d’échec — toujours sur la version la plus récente
🚀 Démarrage à l’ouverture de session
Lancement facultatif à l’ouverture de session ; uniquement dans la barre des menus, sans icône dans le Dock
🩺 Diagnostic et journaux
Diagnostic en un clic et accès aux journaux du serveur
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Vous préférez un téléchargement ? Récupérez le dernier fichier .dmg depuis les
versions publiées. Le code source, les tickets et la documentation de
compilation sont disponibles sur zoispag/omniroute-tray.
💛 Un projet communautaire par @zoispag — il ne s’agit pas d’une version officielle d’OmniRoute.
> Au-delà du serveur, OmniRoute est un **véritable cockpit en ligne de commande** avec **plus de 80 commandes**, ainsi que des protocoles d’agents ouverts permettant à un agent IA de le piloter **de manière autonome**.
### ⌨️ Une véritable CLI (pas seulement `start`)
```bash
omniroute # lancer la passerelle et le tableau de bord (port 20128)
omniroute chat # client de chat TUI interactif (commandes slash : /model /combo /skill /memory)
omniroute setup # assistant guidé de première configuration
omniroute doctor # diagnostiquer les fournisseurs, les ports et les dépendances natives
```
### 🛰️ Mode distant — exécutez la CLI ici, et OmniRoute sur un VPS
OmniRoute est installé sur un serveur ? Pilotez-le depuis votre ordinateur portable avec la **même CLI**. Connectez-vous une fois
avec un jeton d’accès à portée limitée ; chaque commande ciblera ensuite l’instance distante.
```bash
omniroute connect 192.168.0.15 # mot de passe → jeton à portée limitée, enregistré comme contexte
omniroute models # ← s’exécute sur le serveur DISTANT
omniroute configure codex # ← sélectionne un modèle distant et crée un profil Codex local
omniroute tokens create --name ci --scope read # créer des jetons plus restreints pour d’autres machines
omniroute contexts use default # ← revenir au serveur local
```
Les jetons disposent des portées `read` / `write` / `admin` ; les routes lançant des processus restent accessibles uniquement depuis l’interface de bouclage.
📖 [Mode distant](docs/guides/REMOTE-MODE.md)
### 🤝 Connectez un agent — il contrôle alors OmniRoute lui-même
Exposez OmniRoute via **MCP**, **A2A**, une **API REST**, des **webhooks** ou une **CLI distante** : tout agent compatible (ou votre propre code) obtient les clés de l’ensemble de la passerelle et peut gérer de manière autonome le routage, les fournisseurs, les combinaisons, le cache, la compression et la mémoire. Les points de terminaison HTTP ci-dessous sont servis sous `http://localhost:20128`.
Interface
Point de terminaison / commande
Utilisation
🧰 MCP (stdio)
omniroute --mcp
Intégration à Claude Desktop, Cursor ou tout autre client MCP
Communication d’agent à agent, JSON-RPC 2.0 + SSE, 6 compétences
🌐 API REST
/v1/*
Compatible avec OpenAI — chat, embeddings, images, audio, OCR
🔔 Webhooks
/api/webhooks
Envoyer les événements de requêtes et de quotas vers Slack, Discord, Telegram ou toute autre URL
🛰️ CLI distante
omniroute connect
Piloter une instance distante avec des jetons d’accès à portée limitée
```bash
# Fournir à Claude Code l’ensemble complet des outils OmniRoute via MCP :
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [Serveur MCP](docs/frameworks/MCP-SERVER.md) · [Serveur A2A](docs/frameworks/A2A-SERVER.md) · [Protocoles d’agents](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Économisez automatiquement 15 à 95 % de tokens
### 📖 Fonctionnement — pipeline, architecture et calcul des économies
La combinaison empilée par défaut exécute `RTK → Caveman`. Lorsque les deux agissent sur la même charge utile d’outil ou de contexte, les économies se cumulent :
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Les blocs de code, les URL, le JSON et les données structurées sont **toujours protégés** par le moteur de préservation.
> **Pourquoi utiliser beaucoup de tokens quand quelques-uns suffisent ?** Chaque requête passe **de manière transparente** par le pipeline de compression d’OmniRoute — aucune modification côté client. Il s’agit désormais d’une **pile de 12 moteurs composables** qui s’exécutent dans l’ordre et peuvent être combinés pour chaque configuration de routage — en s’appuyant sur les idées de [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ plus de 90 000), [LLMLingua-2](https://github.com/microsoft/LLMLingua) et [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 La pile de 12 moteurs
Les moteurs s’exécutent dans l’ordre du pipeline ; chacun peut être activé ou désactivé et configuré indépendamment pour chaque combinaison :
#
Moteur
Fonction
1
Session-Dedup
Supprime le contenu répété au fil des échanges (adressé par contenu, inter-échanges)
2
CCR
Archive les blocs volumineux derrière des marqueurs de récupération, puis les récupère à la demande
3
Lite
Réduction des espaces et des URL d’images (base à faible latence)
4
RTK
Filtrage intelligent, déduplication et troncature des résultats d’outils (adaptés aux commandes)
5
Responses Tool Output
JSON sans perte en priorité + compression diagnostique limitée pour les sorties de shell, correctifs, recherches et compilations (Responses API)
6
Headroom
Compactage tabulaire sans perte des tableaux JSON (~30 %) via un codec GCF intégré
7
Relevance
Évaluation extractive des phrases par rapport à la dernière requête de l’utilisateur
8
Caveman
Compression de texte fondée sur des règles (~65 à 75 % en sortie)
9
Aggressive
Résumé + vieillissement progressif des anciens échanges
10
LLMLingua-2
Élagage sémantique par ML via MobileBERT ONNX — compatible avec le code, asynchrone
11
Ultra
Élagage heuristique des tokens avec un niveau optionnel utilisant un petit modèle (SLM)
12
OmniGlyph
Encodage expérimental du contexte sous forme d’image pour Claude Fable 5 mesuré sur la connexion directe Anthropic ; les transformeurs GPT 5.6 restent en mode de fermeture sécurisée en attendant les justificatifs du fournisseur. Quatre profils de compression (agressif par défaut, équilibré, sécurisé pour le code, sans transformation) (le plus agressif ; activation explicite)
Les blocs de code, les URL et les données structurées sont **toujours préservés** à l’octet près. Des **préréglages en un clic** combinent les moteurs :
Mode
Économies
Idéal pour
🪶 Lite
~15 %
Option sûre activée en permanence par défaut
🪨 Standard (Caveman)
~30 %
Développement quotidien
⚡ Aggressive
~50 %
Longues sessions utilisant beaucoup d’outils
🔥 Ultra
~75 %
Économies maximales
🧰 RTK
60 à 90 %
Sorties de shell, de tests, de compilation et de git
🔗 Empilé (RTK → Caveman)
78 à 95 %
Prompts mixtes + journaux d’outils
**Exemple réel — mode Standard :**
> **Avant (69 tokens) :** _« La raison pour laquelle votre composant React s’affiche de nouveau est probablement que vous créez une nouvelle référence d’objet à chaque cycle de rendu. Lorsque vous transmettez un objet en ligne comme prop, la comparaison superficielle de React le considère chaque fois comme un objet différent, ce qui déclenche un nouveau rendu. Je recommande d’utiliser useMemo pour mémoriser l’objet. »_
>
> **Après (19 tokens) :** _« Nouvelle référence d’objet à chaque rendu. Objet en ligne comme prop = nouvelle référence = nouveau rendu. Encapsulez-le dans useMemo. »_
>
> **Même réponse. 72 % de tokens en moins. Aucune perte de précision.** ✅
**Exemple PT-BR — mode [Troglodita](https://github.com/leninejunior/troglodita) :**
> **Avant (42 tokens) :** _"Le problème est que le composant se re-rend parce qu'une nouvelle référence d'objet est créée à chaque cycle de rendu. Je recommanderais d'utiliser useMemo."_
>
> **Après (12 tokens) :** _"Re-render : nouvelle réf à chaque cycle (objet inline recréé). Utiliser `useMemo`."_
>
> **Même réponse. ~70 % de tokens en moins. Précision technique intacte.** ✅
### 🎚️ Au-delà des moteurs — styles de sortie, le cadran adaptatif et le contrôle par requête
Les 12 moteurs ci-dessus réduisent ce qui **entre**. Trois couches supplémentaires façonnent **comment**, **quand** et ce qui **sort** :
- **🪄 Output Styles** _(pilotage sur l'axe de sortie)_ — injectent des instructions déterministes et sûres vis-à-vis du cache qui façonnent la réponse ; combinables, chacune à l'intensité `lite` / `full` / `ultra`. Ajouter un style se fait par une entrée de registre d'une ligne :
- **Terse prose** — supprimer le remplissage / les articles / les précautions ; conserver la substance technique à l'identique.
- **Less code** — YAGNI « dev senior paresseux » : la plus petite modification fonctionnelle, aucun échafaudage non demandé.
- **Ponytail (lazy senior dev)** — gravir l'échelle YAGNI, corriger la cause racine, le plus petit diff fonctionnel.
- **I have ADHD (action-first)** — l'action suivante en tête, étapes numérotées, une seule prochaine étape concrète, pas de préambule.
- **Terse CJK (文言)** — style chinois classique ultra-concis (restreint à la locale `zh`).
- **🎯 Adaptive context-budget** _(le cadran)_ — au lieu d'un seul seuil de tokens on/off, faire monter les moteurs les moins coûteux et les plus fidèles uniquement dans la mesure nécessaire pour **tenir dans la fenêtre de contexte du modèle**. Politique : `reserve-output` (par défaut, conscient du modèle) · `percentage` · `absolute`. Mode : `floor` (garantir la tenue) · `replace-autotrigger` (votre choix explicite l'emporte) · `off` (seuil historique).
- **🎛️ Où la compression est décidée** _(précédence, de la plus haute à la plus basse)_ — en-tête `x-omniroute-compression` par requête › surcharge de combo de routage › profil nommé actif › adaptatif / déclenchement automatique › valeur par défaut du panneau › désactivé. Le plan appliqué est renvoyé dans l'en-tête de réponse `X-OmniRoute-Compression: ; source=`.
Déclenchement automatique par seuil de tokens, activation du cadran adaptatif, épinglage d'un profil nommé, réglage ponctuel par requête, ou affectation d'un pipeline par combo de routage — selon ce qui convient à la charge de travail. Un **harnais d'évaluation** hors ligne optionnel (`npm run eval:compression`) note la fidélité par rapport aux économies sur un corpus épinglé avant que vous ne promouviez un changement.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Démarrage rapide
**1) Installer et lancer**
```bash
npm install -g omniroute
omniroute
```
> 💡 Vous voyez `npm warn ERESOLVE` ou des avertissements de peer-deps ? [Ils sont inoffensifs](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Vous utilisez npm 11 ou une version ultérieure ?** npm peut bloquer les scripts de cycle de vie des paquets s'ils ne sont pas autorisés. Le `postinstall` d'OmniRoute (`node scripts/build/postinstall.mjs`) est requis pour préparer ses fichiers d'exécution natifs. Autorisez les paquets nommés dans l'avertissement de npm lors de l'installation globale. Pour l'ensemble de paquets signalé par OmniRoute 3.8.53 :
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Pour réutiliser cette liste d'autorisations lors de futures installations globales, configurez-la une fois, puis installez normalement :
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> La liste des dépendances peut changer d'une version à l'autre ; si npm signale une liste différente, utilisez les noms de paquets de cet avertissement. Autoriser un paquet permet à ses scripts d'installation de s'exécuter.
> **Vous utilisez Gemini Web ou un autre fournisseur à cookies web ?** Le paquet npm inclut
> Playwright mais pas son binaire Chromium. Consultez la note
> [Installation de Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> avant d'effectuer la première requête vers un fournisseur web.
Tableau de bord sur `http://localhost:20128` · API sur `http://localhost:20128/v1`.
**2) Connecter un fournisseur éligible avec votre propre compte**
Tableau de bord → **Providers** → choisissez un fournisseur dont les conditions et le quota actuels correspondent à votre cas d'usage → ajoutez sa clé API ou complétez son parcours de compte. Les paliers gratuits peuvent nécessiter une inscription, une approbation ou un moyen de paiement. Consultez le [Guide des paliers gratuits](docs/getting-started/FREE-TIERS-GUIDE.md) ; la disponibilité sans clé n'est pas garantie, et les fournisseurs marqués `tos: avoid` sont exclus de `auto` par défaut.
**3) Pointer votre outil de développement**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) Vérifier que tout fonctionne**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Vous devriez voir vos modèles connectés listés. 🎉 C'est tout — commencez à coder, et OmniRoute route et bascule automatiquement pour vous.
Si votre client ne peut pas envoyer d'en-têtes personnalisés, OmniRoute expose aussi des alias de compatibilité tokenisés :
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
N'utilisez ces alias que pour les clients qui ne peuvent pas joindre `Authorization: Bearer ...`. L'authentification par en-tête reste le mode préféré.
## 📦 Autres méthodes d’installation — Docker, code source, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` suit la version SemVer stable **publiée** la plus élevée. Elle ne suit pas la branche git `main`. Épinglez `:X.Y.Z` pour GitOps. Consultez [Canaux de publication Docker](docs/guides/DOCKER_GUIDE.md#release-channels). L’image définit **`OMNIROUTE_MEMORY_MB=1024`**. Cela suffit pour le tableau de bord et une conversation légère. Les **agents de programmation** (`POST /v1/responses` depuis Claude Code, Codex, Grok, …) nécessitent un tas V8 bien plus important, sans quoi le processus déclenche une `FATAL ERROR` à environ 12 Gio avec deux longs contextes qui se chevauchent. Dimensionnez le conteneur au-dessus de la taille du tas (les tampons natifs se trouvent en dehors de V8) :
| Charge de travail | Tas (`-e OMNIROUTE_MEMORY_MB`) | Conteneur (`--memory`) |
| ------------------------------------- | ------------------------------------- | ---------------------- |
| Tableau de bord / conversation légère | `1024` (valeur par défaut de l’image) | ≥2 g |
| Un agent de programmation | `8192` | ≥10 g |
| Deux longs `/v1/responses` simultanés | `10240`–`12288` | ≥12–16 g |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
Tableau complet : [Guide Docker — RAM d’exécution](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Canal Docker de préversion :** `diegosouzapw/omniroute:next` et
> `diegosouzapw/omniroute:next-web` suivent la branche `release/v*` actuellement
> définie par défaut. Ces balises modifiables sont uniquement destinées à tester des correctifs
> non publiés et ne sont **pas prises en charge en production**. Consultez
> [Canaux de publication Docker](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
L’installation standard avec `bun install` et l’installation globale (`bun install -g omniroute`) sont prises en charge grâce à la détection de l’environnement d’exécution Bun :
- **`bun:sqlite` intégré** : OmniRoute utilise le pilote `bun:sqlite` intégré à Bun lors de son exécution sous Bun, avec repli sur `better-sqlite3` sous Node.js ou sur `sql.js`.
- **Sélection automatique de Webpack pour le regroupement en développement** : le mode développement (`bun run dev`) détecte automatiquement Bun et désactive Turbopack au profit de Webpack afin d’éviter les incompatibilités avec les liaisons V8 natives. Les compilations de production (`bun run build`) respectent précisément `OMNIROUTE_USE_TURBOPACK`, comme sous Node : Turbopack par défaut, ou `OMNIROUTE_USE_TURBOPACK=0` pour compiler avec Webpack (`Dockerfile.bun` l’expose en tant que `--build-arg`).
- **Dockerfile dédié à Bun** : `Dockerfile.bun` multiétape pour les déploiements natifs de Bun en production (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Installer et exécuter avec Bun
bun install
bun run dev
```
**🛠️ Depuis le code source**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Avec les flakes Nix
nix develop
npm run dev
# Ou avec devbox
devbox run npm run dev
```
📖 [Guide Docker](docs/guides/DOCKER_GUIDE.md) — Profils Compose, HTTPS avec Caddy, tunnels Cloudflare.
**🦭 Podman**
```bash
# 1. Préparer le répertoire de données monté par liaison
mkdir -p data
# 2. Uniquement sous Linux avec Podman local sans privilèges root (jamais avec un client Podman Machine distant) :
podman unshare chown 1000:1000 ./data
# 3. Définir l’indication d’environnement d’exécution, créer l’image Compose locale et démarrer
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
Sous macOS ou Windows, Podman utilise une Podman Machine distante : ignorez `podman unshare` et
suivez les [instructions relatives au répertoire de données propres à la topologie](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Guide Podman](contrib/podman/README.md) — Compilations Compose, Podman Machine et
configuration de Quadlet avec Linux/systemd.
**⚡ Installation plus rapide / légère (sans compilation native)**
Le moteur SQLite natif (`better-sqlite3`) est une dépendance **facultative** ; une installation
globale n’est donc jamais bloquée par une compilation depuis le code source : elle utilise un binaire précompilé lorsqu’il en existe un
pour votre plateforme/Node et, dans le cas contraire, se replie de façon transparente sur un moteur JavaScript pur
(`node:sqlite` sous Node 22+, sinon le moteur WASM `sql.js` inclus) — aucun outil de compilation n’est requis.
Pour ignorer entièrement la préparation native après l’installation (CI, environnement sans interface graphique ou machines lentes) :
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 l’ignore également
```
Pour des installations plus rapides, privilégiez **pnpm** (stockage adressé par contenu + liens physiques — voir ci-dessus).
Pour un environnement d’exécution sans tableau de bord et sans interface graphique, utilisez le profil Docker `base` (ci-dessus) ou le
[guide Termux](docs/guides/TERMUX_GUIDE.md). La CLI et le tableau de bord web sont servis par le
même processus sur un seul port ; il n’existe donc actuellement aucun paquet distinct exclusivement destiné à la CLI.
pino — journaux JSON structurés avec contexte de requête
Tests
Runner de tests Node.js + Vitest — plus de 56 000 déclarations de tests statiques réparties dans plus de 7 800 fichiers de tests suivis (unitaires, intégration, E2E, sécurité, écosystème)
Plateformes
Bureau (Electron) · Android (Termux) · PWA (tout navigateur)
CI/CD
GitHub Actions — publication npm automatique + Docker Hub à chaque release
Stratégie de couverture de tests pour plus de 56 000 déclarations de tests statiques réparties dans plus de 7 800 fichiers de test suivis
# ⭐ Meilleurs contributeurs
> OmniRoute est façonné par une communauté open source passionnée. Ces personnes ont apporté des contributions exceptionnelles qui ont un impact direct sur la qualité, la stabilité et la portée du projet. **Merci.**
### Contributeurs externes par pull requests fusionnées
Recensement effectué le 2026-10-18 15:09:09 UTC sur la pointe active de release/v3.8.52, 656f01cb43. Le recensement paginé GitHub GraphQL contient 9 191 PR fusionnées : 3 834 du propriétaire du dépôt, 229 de Dependabot, 6 d'autres bots/apps, et 5 122 PR externes provenant de 835 contributeurs distincts. Les « lignes modifiées » correspondent aux ajouts + suppressions GitHub et incluent les fichiers générés, les lockfiles, les catalogues, les traductions et la documentation ; il s'agit d'un volume de modifications (churn), et non de lignes de code écrites. 49 PR signalent des diffs GitHub supérieurs à 500 000 lignes (par exemple #13399, un simple ajout de fournisseur, répertorie 2 347 fichiers modifiés), ce qui gonfle plusieurs totaux ci-dessus. Les ex æquo sont classés ensemble.
### Commits attribués à GitHub
Revérifié le 2026-10-18 à 14:44:45 UTC : commits attribués à GitHub signalés par l'API Contributors du dépôt pour la branche par défaut release/v3.8.52. L'API a renvoyé 849 identités (429 utilisateurs, 2 bots, 418 anonymes) ; ce tableau exclut le mainteneur, les bots et les identités anonymes, et conserve les ex æquo. Il se distingue à la fois du classement des PR fusionnées ci-dessus et du recensement des métadonnées Git ci-dessous.
> 🙏 Les fonctionnalités, corrections de bugs et améliorations de l'infrastructure apportées par ces contributeurs constituent une **partie essentielle** de ce qui rend OmniRoute fiable et riche en fonctionnalités. Chaque pull request, chaque cas de test et chaque fichier de traduction i18n compte. L'open source est construit par des gens comme eux.
---
## 💖 Sponsors
Un grand merci aux personnes qui financent OmniRoute de leur propre poche — chaque contribution permet au projet de rester gratuit, indépendant et actif.
… ainsi que d’autres personnes qui préfèrent rester anonymes 💛Les sponsors GitHub publics ont été revérifiés le 2026-10-18 via l’API GraphQL de GitHub Sponsors : 11 parrainages publics (6 actifs, 5 passés) sur un total de 14. Le statut isActive de GitHub détermine les libellés d’activité ci-dessus ; les anciens soutiens publics ponctuels restent remerciés et les sponsors privés demeurent anonymes. Les dons effectués via Ko-fi, Buy Me a Coffee, Liberapay, PIX et les cryptomonnaies ne sont pas répertoriés, car ils ne disposent d’aucun enregistrement public de sponsor.💖 Devenir sponsor → — chaque dollar permet à OmniRoute de rester gratuit et indépendant.
## 👥 Plus de 900 contributeurs
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Audit effectué le 2026-10-18 sur la pointe active de release/v3.8.52, au commit ad160ab2d1 (6 826 commits) : 993 identités Git humaines normalisées — 707 apparaissent comme auteurs de commits (y compris le responsable de la maintenance) et 286 uniquement dans des lignes explicites Co-authored-by. Le recensement applique .mailmap, compare les adresses e-mail sans tenir compte de la casse, associe les adresses GitHub noreply numériques et textuelles uniquement lorsqu’elles encodent le même identifiant, exclut 26 identités de bots, d’agents, de services ou de substitution, et ne fusionne pas des adresses e-mail ordinaires au seul motif que leurs noms d’affichage correspondent. L’audit du 2026-08-24 en recensait 639 ; cette méthode, réexécutée sur le commit de base ac02c5b42f de cet audit, en dénombre 619. L’augmentation provient donc de nouveaux contributeurs, et non d’une méthode moins stricte.
### Comment contribuer
1. Créez un fork du dépôt
2. Créez une branche à partir de la pointe **active** de `release/vX.Y.Z` (et non de `main`) — consultez le [modèle de branches et de versions](docs/ops/BRANCHING_MODEL.md)
3. Créez votre branche de fonctionnalité (`git checkout -b feat/amazing-feature`)
4. Validez vos modifications (`git commit -m 'feat: add amazing feature'`)
5. Envoyez-les vers la branche (`git push origin feat/amazing-feature`)
6. Ouvrez une Pull Request avec **base = cette branche `release/vX.Y.Z`**
Consultez [CONTRIBUTING.md](CONTRIBUTING.md) pour obtenir des directives détaillées.
### Publier une nouvelle version
```bash
# Créer une version — la publication sur npm s’effectue automatiquement
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Étoiles
## 🌍 StarMapper
## 🙏 Remerciements
OmniRoute repose sur le travail de géants. Le projet a débuté comme un fork de **[9router](https://github.com/decolua/9router)** et un portage TypeScript du projet Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — puis, à partir de là, chaque sous-système présenté ci-dessous s’est inspiré d’un projet open source qui l’avait précédé. Chacun d’eux a façonné une partie concrète d’OmniRoute. Nous tenons à tous les remercier. 🙏
> ⭐ nombres d’étoiles vérifiés à l’aide de l’API REST de GitHub le 18 octobre 2026 — n’hésitez pas à attribuer une étoile à ces projets. Ces nombres constituent un instantané exact à cette date et évolueront naturellement.
### 🧬 Filiation et passerelle
La passerelle d’IA dont le jeu de données public sur les tarifs alimente notre synchronisation du suivi des coûts et dont le modèle de normalisation des fournisseurs a guidé notre routage.
Source MIT adaptée dans la passerelle intégrée ChatGPT Web → Codex Responses, notamment pour la session du navigateur, le cadrage des réponses, l’utilisation et les adaptateurs de recherche web.
Modèles transposés dans la récupération des flux, les alias sans raisonnement, la recherche web de secours, les limites à fenêtre glissante, la rédaction des journaux et les processus renforcés du lanceur.
Valeurs de transformation par défaut compatibles avec Claude Code et comportement des en-têtes de facturation, généralisés dans la passerelle d’OmniRoute pilotée par la configuration.
Ses correspondances de modèles Grok, son générateur Statsig simulant une TypeError, ses valeurs par défaut pour les requêtes et les appareils, ainsi que son processeur de réponses NDJSON ont été adaptés de manière substantielle dans l’exécuteur Grok Web d’OmniRoute.
La principale source de code transitive à l’origine de grok2api-merged ; ses implémentations des modèles, des en-têtes, des charges utiles, de Statsig et des processeurs sont préservées dans la filiation de Grok Web.
La source MIT sous-jacente des valeurs par défaut des charges utiles et des appareils Grok, du générateur Statsig et du processeur result.response, transmise par l’intermédiaire de TQZHR et de grok2api-merged.
Une source transitive créditée par grok2api-merged pour sa couche de pool de proxys ; OmniRoute conserve cette mention de filiation, mais ne revendique pas le portage d’un pool de proxys dans son exécuteur Grok Web à périmètre limité.
L’implémentation Grok Web d’origine s’est appuyée sur sa conception de service en amont HTTP/navigateur ; son chemin HTTP direct dérive de GrokProxy, aucun portage de code indépendant n’est donc revendiqué.
### 🗜️ Compression du contexte et des jetons — moteurs
Le projet viral « pourquoi utiliser beaucoup jetons quand peu jetons faire affaire » — sa philosophie d’homme des cavernes alimente notre mode de compression standard et plus de 30 règles de suppression des mots de remplissage et de condensation.
Compression haute performance des sorties de commandes — a inspiré notre moteur RTK, notre DSL de filtrage JSON, la récupération des sorties brutes et le pipeline empilé RTK → Caveman.
Recherche sur la compression des prompts (LLMLingua / LLMLingua-2) — a inspiré notre moteur llmlingua asynchrone, sûr pour le code et à comportement ouvert en cas d’échec.
Compression de jetons en portugais brésilien — alimente notre pack linguistique pt-BR : réduction des pléonasmes et suppression des mots de remplissage adaptées à la grammaire du portugais brésilien.
La compétence virale de codeur « développeur senior paresseux » fondée sur YAGNI — a inspiré notre style de sortie less-code : une orientation vers la plus petite modification fonctionnelle, qui réduit le code _généré_ (l’équivalent, côté sortie, de la prose concise de Caveman).
Compactage des sorties Bash + profils MCP — a inspiré notre approche rigoureuse de l’abandon de la compression et de la réduction des manifestes d’outils MCP.
Compression des sorties sensible au contenu et adaptée à chaque type de fichier, avec abandon en cas d’échec — a validé notre répartition par type et notre abandon lorsque le gain minimal n’est pas atteint.
JSON en colonnes avec Rust + récupération adressée par le contenu + déduplication entre messages — a validé la conception de nos moteurs headroom/ccr/session-dedup ainsi que l’invariant garantissant la stabilité du cache : « la forme compressée est indépendante de la position ».
Boîte à outils pour l’API du compilateur TypeScript — a inspiré notre suppression des commentaires fondée sur un analyseur syntaxique, qui préserve les littéraux de chaînes, de gabarits et d’expressions régulières.
L’interception/l’analyse MITM du trafic entre assistants de codage et LLM a influencé les premières exigences de Traffic Inspector. Quatre modules précédemment dérivés — fusion SSE, normalisation des conversations, masquage des secrets et assainissement des en-têtes — ont été remplacés par des implémentations indépendantes en salle blanche, fondées sur des normes de protocole publiques. Les deux surfaces de contournement de l’hôte (passthrough.ts et _internal/bypass.cjs) restent des implémentations internes à OmniRoute classées indépendamment ; elles n’ont pas été réécrites dans le cadre de ce remplacement.
Routage transparent du proxy par processus — a inspiré notre arrêt MITM résistant aux plantages, les délais d’inactivité des sockets, l’attribution des processus via /proc et la capture TPROXY.
### 📚 Données de modèles, observabilité et interface utilisateur
Observabilité du maillage de services Istio — a inspiré nos badges de disjoncteur et nos représentations visuelles des arêtes en erreur dans le Routing/Combo Studio.
Une liste organisée de bibliothèques sécurisées par défaut qui guide nos choix en matière de sécurité (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
A inspiré la déduplication des requêtes, le mécanisme de repli d’urgence sans coût, les stratégies Auto-Combo enfichables et la classification multilingue des intentions.
Son remappage des modèles tenant compte des comptes, sa validation des chemins d’exécutables et son comportement relatif aux libellés des offres ont influencé l’environnement d’exécution Antigravity d’OmniRoute.
Son format compact de compte à rebours avant la réinitialisation des quotas a inspiré l’affichage correspondant des limites des fournisseurs dans OmniRoute.
A permis d’identifier l’interface de quota de Grok Build ; OmniRoute a ensuite vérifié et corrigé indépendamment le format réel des données échangées.
## 📄 Licence
Licence MIT - voir [LICENSE](LICENSE) pour plus de détails.
---
**[⬆ Retour en haut](#-omniroute)** · Conçu avec ❤️ pour la communauté IA open source.
OmniRoute v3.8.53 · Node ≥22.22.2 · Licence MIT · omniroute.online
> Résumé animé de la page `/dashboard/free-tiers` en direct. Méthodologie complète (déduplication des pools, paliers de crédits, conditions des fournisseurs) : **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ces chiffres sont réaudités toutes les deux semaines par rapport au catalogue en direct et **évoluent dans les deux sens** — un fournisseur met fin à une offre gratuite et le chiffre baisse ; une nouvelle offre arrive et il remonte. Nous publions ce que le catalogue calcule réellement, jamais un meilleur cas arrondi à la hausse.
```bash
# Après avoir connecté un fournisseur, copiez votre clé OmniRoute depuis Dashboard → Endpoints :
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` nécessite une route éligible. Une installation fraîche peut n'avoir aucune cible keyless éligible, et un fournisseur keyless peut rejeter les clients tiers. Les fournisseurs marqués `tos: avoid`, y compris Kiro, sont exclus du routage automatique par défaut ; connecter un compte ne modifie pas ce réglage. Consultez le [Guide des offres gratuites](docs/getting-started/FREE-TIERS-GUIDE.md) avant de choisir un fournisseur.
📦 Scripts de démarrage rapide à copier-coller pour **Python, Node.js, PHP et cURL** → [`examples/quickstart/`](examples/quickstart/)
> Un **combo** est une chaîne de modèles entre lesquels OmniRoute effectue le routage **automatiquement**. Si le quota est épuisé, qu'un fournisseur tombe en panne ou que les coûts grimpent, le combo peut passer au modèle sain et éligible suivant. 🛡️
### ⚡ Sans configuration — utilisez simplement `auto`
Aucun combo à créer. Définissez votre modèle sur `auto` (ou une variante) et OmniRoute construit un combo virtuel à partir de vos fournisseurs connectés, évalués en temps réel :
📖 [Moteur Auto-Combo](docs/routing/AUTO-COMBO.md) · [Guide de résilience](docs/architecture/RESILIENCE_GUIDE.md)
📊 Méthodologie complète et détails par fonctionnalité par rapport à 9router, OpenRouter, CLIProxyAPI et LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Clé (aléatoire) : `5d865059-bc44-483a-962d-43ceb80126eb`
Pix à copier-coller :
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Autorisation](docs/architecture/AUTHZ_GUIDE.md) · [Garde-fous](docs/security/GUARDRAILS.md) · [Conformité](docs/security/COMPLIANCE.md)
La combinaison empilée par défaut exécute `RTK → Caveman`. Lorsque les deux agissent sur la même charge utile d’outil ou de contexte, les économies se cumulent :
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Les blocs de code, les URL, le JSON et les données structurées sont **toujours protégés** par le moteur de préservation.
> **Pourquoi utiliser beaucoup de tokens quand quelques-uns suffisent ?** Chaque requête passe **de manière transparente** par le pipeline de compression d’OmniRoute — aucune modification côté client. Il s’agit désormais d’une **pile de 12 moteurs composables** qui s’exécutent dans l’ordre et peuvent être combinés pour chaque configuration de routage — en s’appuyant sur les idées de [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ plus de 90 000), [LLMLingua-2](https://github.com/microsoft/LLMLingua) et [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 La pile de 12 moteurs
Les moteurs s’exécutent dans l’ordre du pipeline ; chacun peut être activé ou désactivé et configuré indépendamment pour chaque combinaison :
