Comment utiliser Hermes Agent avec OpenRouter

Hermes Agent, l’agent autonome open-source développé par Nous Research, s’installe directement dans un terminal pour exécuter des tâches complexes, de la génération de code à l’automatisation de workflows. Relié à OpenRouter, il donne accès à plus de 400 modèles de langage, répartis chez 60 fournisseurs, avec une seule clé API. Le routage intelligent, les basculements automatiques et la facturation unifiée suivent derrière. Ce tutoriel vous montre comment configurer cet ensemble, de l’installation aux réglages avancés, pour obtenir un assistant persistant, économique et souple.

Préparer votre environnement de travail

Avant d’installer l’agent, vérifiez que vous disposez des éléments suivants. L’installation va vite, mais ces quelques contrôles évitent les blocages inutiles.

Système d’exploitation et terminal

Hermes Agent fonctionne nativement sur Linux, macOS et Windows Subsystem for Linux 2 (WSL2). Sous Windows sans WSL, un installateur PowerShell dédié prend le relais. Vous aurez besoin d’un terminal (bash, zsh, PowerShell) et d’une connexion internet stable. Le script fourni installe automatiquement Python, Node.js, l’outil de recherche ripgrep et le framework multimédia ffmpeg, donc rien à configurer à la main.

Compte et clé API OpenRouter

Rendez-vous sur openrouter.ai pour créer un compte gratuit. Générez une clé API depuis le tableau de bord : elle commence toujours par le préfixe sk-or-. Cette clé est le seul secret à renseigner. Gardez-la précieusement, car elle sera facturée à l’usage. Aucun abonnement préalable n’est exigé, vous ne payez que les tokens consommés.

Connaissances de base

Vous devez être à l’aise avec la ligne de commande : savoir naviguer dans l’arborescence, éditer un fichier texte et exécuter des instructions. Même sans expertise approfondie, les commandes présentées ici restent accessibles.

Étape 1 : installer Hermes Agent

L’installation repose sur un script unique qui clone le dépôt officiel, installe les dépendances et rend la commande hermes disponible globalement.

Depuis votre terminal, exécutez :

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Sur Windows (hors WSL), lancez plutôt l’installateur PowerShell correspondant, téléchargeable depuis la documentation. Le processus télécharge le code dans ~/.hermes/hermes-agent/ et place les configurations futures dans ~/.hermes/. Une fois terminé, rechargez votre shell, par exemple avec source ~/.bashrc, ou fermez puis rouvrez le terminal pour que la commande hermes soit reconnue.

Si vous préférez contrôler l’environnement, clonez manuellement le dépôt Git et lancez l’installation localement.
Conseil pratique

Étape 2 : initialiser l’agent

Une fois la commande disponible, l’agent a besoin d’une première initialisation interactive. Tapez :

hermes setup

Un assistant vous invite à choisir votre fournisseur principal. Sélectionnez openrouter parmi la liste proposée. L’initialisation vérifie aussi les outils requis (Python, Node.js, etc.) et configure les chemins par défaut. À ce stade, vous pouvez déjà démarrer l’agent, mais il ne pourra pas communiquer avec les modèles tant que la clé API ne sera pas renseignée.

Étape 3 : connecter Hermes à OpenRouter

La liaison s’effectue en enregistrant la clé API dans le fichier de secrets, séparé du reste de la configuration. Utilisez la commande dédiée pour éviter les erreurs de format ou de sécurité :

hermes config set OPENROUTER_API_KEY sk-or-votre-cle-ici

Cette instruction écrit la clé dans ~/.hermes/.env, un fichier caché qui reste séparé des autres réglages, comme le nom du modèle. Le fichier config.yaml, dans le même dossier, contient les paramètres opérationnels. Cette séparation limite les risques si vous échangez des configurations ou si vous faites un commit accidentel dans un dépôt Git.

Ne modifiez jamais le fichier .env à la main pour y inscrire la clé.
Avertissement de sécurité

Pour vérifier immédiatement la connectivité, exécutez hermes model : l’agent doit lister les modèles disponibles via OpenRouter. Si une erreur d’authentification apparaît, contrôlez le préfixe sk-or- et assurez-vous que votre clé est active dans le tableau de bord OpenRouter.

Étape 4 : sélectionner un premier modèle

Par défaut, l’agent utilisera un modèle défini dans le fichier config.yaml. Ouvrez ce fichier avec votre éditeur et repérez la section model. Pour un démarrage efficace, spécifiez un modèle à large contexte et aux bonnes performances agentiques, par exemple :

model: « anthropic/claude-4.6-sonnet »

Les tâches agentiques, comme la planification, l’utilisation d’outils et la mémorisation, exigent un contexte d’au moins 64 000 tokens. C’est pourquoi les modèles comme Claude 4.6 Sonnet ou GPT-5.5 sont recommandés. En pratique, la plupart des modèles récents proposent cette capacité, mais vérifiez la fiche technique sur OpenRouter avant de valider.

Une fois la modification sauvegardée, testez l’agent avec une instruction simple :

hermes run « Liste les fichiers du dossier courant »

Si tout fonctionne, l’agent répond dans le terminal et exécute éventuellement une commande shell si vous l’avez autorisé (les permissions se règlent dans la configuration).

Étape 5 : mettre en place le routage avancé

OpenRouter ne se contente pas de fournir un catalogue ; il route vos requêtes vers le fournisseur le plus pertinent selon des critères que vous définissez. Dans config.yaml, ajoutez ou modifiez le bloc routing :

• provider: « openrouter » (déjà renseigné après l’étape 3)
• sort: « price » pour privilégier le fournisseur le moins cher.
• Remplacez par « throughput » si la vitesse de génération est votre priorité.
• Utilisez « latency » pour minimiser le délai de réponse (temps d’aller-retour).

Ces réglages globaux s’appliquent à tous les modèles. Pour un contrôle encore plus fin, vous pouvez ajouter des suffixes directement au nom du modèle :

• anthropic/claude-4.6-sonnet:floor force le fournisseur le moins coûteux pour cette requête, sans toucher au reste de la configuration.
• :nitro équivaut à sort: throughput, idéal pour une session interactive où la fluidité prime.

Pour économiser sur des tâches d’arrière-plan peu urgentes, privilégiez :floor dans vos scripts.
Astuce d’optimisation

Gestion des listes blanches et noires de fournisseurs

Vous pouvez restreindre les fournisseurs autorisés dans le fichier YAML, par exemple :

only: [« openai », « anthropic »] ou ignore: [« fournisseur-lent »]. Cette option est utile si vous avez des exigences de conformité ou si vous souhaitez éviter un prestataire spécifique après un incident.

Chaînes de repli (fallbacks)

Pour garantir la continuité de service, définissez une liste de modèles de secours dans l’ordre souhaité :

fallback_models:
– « google/gemini-2.5 »
– « meta-llama/llama-3.1-70b-instruct »

Si OpenRouter ne peut pas joindre le modèle principal (défaillance du fournisseur, dépassement de capacité), la requête bascule automatiquement sur le premier modèle de la liste, puis sur le suivant. L’agent ne reste jamais inactif.