OpenRouter

Introduction

OpenRouter est un routeur d'API unifie qui donne acces a des centaines de modeles (Claude, GPT, Gemini, DeepSeek, Llama, etc.) via une seule cle API. C'est l'un des providers les plus flexibles pour Hermes Agent: vous payez a l'usage, sans abonnement mensuel obligatoire.

Obtenir une cle API

1. Creez un compte sur openrouter.ai
2. Allez dans Keys et creez une nouvelle cle API
3. Ajoutez des credits dans Credits

Connecter OpenRouter a Hermes Agent

Methode 1: interactive (recommandee)

hermes model

Dans le menu, selectionnez "OpenRouter", entrez votre cle API, puis choisissez un modele par defaut.

Methode 2: manuelle

Ajoutez votre cle API dans ~/.hermes/.env:

echo 'OPENROUTER_API_KEY=sk-or-v1-...' >> ~/.hermes/.env

Puis selectionnez OpenRouter comme provider:

hermes model              # choisir OpenRouter dans la liste
# ou directement:
hermes chat --provider openrouter --model "anthropic/claude-sonnet-4-6"

Choisir un modele

OpenRouter reference les modeles par leur identifiant complet, par exemple:

• anthropic/claude-sonnet-4-6
• openai/gpt-5
• google/gemini-2.5-pro
• deepseek/deepseek-chat
• meta-llama/llama-4-maverick

Utilisez hermes model pour parcourir les modeles disponibles, ou consultez la liste complete sur openrouter.ai/models.

En cours de session, utilisez /model pour changer de modele sans quitter le chat.

Configuration avancee

OpenRouter Provider Routing

OpenRouter peut router vos requetes vers le provider le moins cher ou le plus rapide pour un modele donne. Cette option se configure dans config.yaml:

openrouter:
  provider_routing: true   # active le routage automatique

Pareto Code Router

OpenRouter propose un routeur de code optimise (Pareto) pour les taches de programmation. Activez-le dans config.yaml:

openrouter:
  pareto_code_router: true

Verifier la connexion

hermes status              # verifie l'etat du provider
hermes chat -q "Bonjour"   # test rapide

Depannage

Erreur 401 (Unauthorized)

Verifiez que votre cle API est correcte et que vous avez des credits sur OpenRouter:

cat ~/.hermes/.env | grep OPENROUTER_API_KEY

Erreur 429 (Rate limit)

Vous avez depasse votre limite de credits ou de requetes. Ajoutez des credits sur openrouter.ai/credits ou configurez un fallback provider.

Modele introuvable

Verifiez l'identifiant exact du modele sur openrouter.ai/models. Les identifiants sont sensibles a la casse et au format (provider/modele).

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• AI Providers (https://hermes-agent.nousresearch.com/docs/integrations/providers)
• CLI commands reference (https://hermes-agent.nousresearch.com/docs/reference/cli-commands)
• Depot NousResearch/hermes-agent, commit b4f8c491

Liens internes proposes

• Modeles et providers
• Configurer Hermes Agent
• Nous Portal
• Anthropic
• Depannage