Avant de commencer : comprendre ce que vous installez
Hermes Agent est un runtime agentique qui s'installe sur votre machine et orchestre des interactions entre un modèle de langage, des outils et votre environnement de travail. Ce n'est pas une application web que vous utilisez dans un navigateur : c'est un outil en ligne de commande qui s'exécute localement et qui peut, selon sa configuration, accéder à des fichiers, des APIs et d'autres ressources de votre système.
Avant d'installer, il est utile de savoir quel modèle vous allez utiliser et où il s'exécutera. Si vous utilisez un modèle distant via une API, vous aurez besoin d'une clé d'accès et d'une connexion réseau. Si vous préférez un modèle local pour des raisons de confidentialité, vous aurez besoin de l'espace disque et des ressources matérielles correspondants. Ces choix influencent la configuration initiale.
- Hermes Agent est un outil en ligne de commande, pas une application web
- Il peut accéder à des fichiers et des ressources locales selon sa configuration
- Décider du modèle (local ou distant) avant de commencer l'installation
L'installation : suivre les instructions officielles
L'installation d'Hermes Agent suit la procédure décrite dans la documentation officielle et le dépôt GitHub. Il est fortement recommandé de suivre ces instructions à la lettre plutôt que d'improviser, notamment pour les dépendances système. Les raccourcis pris lors de l'installation sont souvent la cause de problèmes difficiles à diagnostiquer plus tard.
Installer dans un environnement isolé — un environnement virtuel Python, un conteneur, ou une machine dédiée — est une bonne pratique qui facilite la maintenance et évite les conflits avec d'autres logiciels. Cette isolation n'est pas obligatoire, mais elle simplifie considérablement les mises à jour et le diagnostic des problèmes.
- Suivre la documentation officielle sans improviser
- Préférer un environnement isolé pour l'installation
- Vérifier les dépendances système avant de commencer
La configuration initiale avec hermes setup
Une fois l'installation terminée, `hermes setup` lance un assistant de configuration interactif qui vous guide à travers les paramètres essentiels : choix du modèle, configuration du gateway, paramètres de base de la mémoire et des outils. Cette étape crée les fichiers de configuration qui seront utilisés par toutes les commandes suivantes.
Prenez le temps de lire chaque question posée par `hermes setup` avant de répondre. Les valeurs par défaut sont conçues pour un usage général, mais elles ne correspondent pas forcément à votre contexte. En particulier, la configuration du gateway — qui détermine où le modèle s'exécute — mérite une attention particulière si vous travaillez avec des données sensibles.
- `hermes setup` crée les fichiers de configuration initiaux
- Lire chaque question avant de répondre, ne pas accepter les défauts sans réflexion
- La configuration du gateway détermine où le modèle s'exécute
Configurer le gateway avec hermes gateway setup
Le gateway est le composant qui fait le lien entre Hermes Agent et le modèle de langage. `hermes gateway setup` permet de configurer ce lien : URL de l'API, clé d'authentification, modèle par défaut, paramètres de timeout et de retry. Cette configuration est distincte de `hermes setup` et peut être modifiée indépendamment.
Si vous utilisez plusieurs modèles selon les tâches, le gateway peut être reconfiguré avec `hermes gateway setup` sans avoir à relancer la configuration complète. La commande `hermes gateway status` permet à tout moment de vérifier que le gateway est correctement configuré et que la connexion au modèle fonctionne.
- `hermes gateway setup` configure la connexion au modèle
- `hermes gateway status` vérifie que la connexion fonctionne
- Le gateway peut être reconfiguré sans relancer `hermes setup`
Vérifier l'installation avec hermes doctor
`hermes doctor` est la commande de diagnostic qui vérifie l'ensemble de la configuration : présence des fichiers nécessaires, validité des paramètres, accessibilité du modèle, état des outils configurés. C'est la commande à exécuter après chaque modification de configuration et avant toute utilisation sérieuse de l'agent.
Les messages produits par `hermes doctor` sont classés par sévérité : erreurs bloquantes, avertissements et informations. Les erreurs bloquantes doivent être résolues avant d'aller plus loin. Les avertissements signalent des configurations sous-optimales qui ne bloquent pas le fonctionnement mais peuvent causer des problèmes plus tard. Ne pas ignorer les avertissements lors de la première installation.
- `hermes doctor` vérifie l'ensemble de la configuration
- Exécuter après chaque modification de configuration
- Résoudre les erreurs bloquantes avant de continuer
- Ne pas ignorer les avertissements lors de la première installation
Les erreurs courantes lors de l'installation
Les problèmes les plus fréquents lors de l'installation sont : des dépendances manquantes ou dans une version incompatible, une clé API incorrecte ou expirée, un gateway mal configuré qui pointe vers un endpoint inexistant, et des permissions système insuffisantes pour accéder aux répertoires de configuration. `hermes doctor` détecte la plupart de ces problèmes et indique comment les corriger.
Un problème moins visible mais fréquent est la configuration du modèle avec `hermes model` : si le modèle spécifié n'est pas disponible via le gateway configuré, les commandes semblent fonctionner mais produisent des erreurs lors de la première interaction réelle. Vérifier explicitement que le modèle est accessible via `hermes gateway status` après avoir configuré `hermes model`.
- Dépendances manquantes : vérifier les prérequis système
- Clé API incorrecte : vérifier dans la configuration du gateway
- Modèle non disponible : vérifier avec `hermes gateway status`
- Permissions insuffisantes : vérifier les droits sur les répertoires de configuration
Après l'installation : les premières étapes recommandées
Une fois `hermes doctor` sans erreur bloquante, les premières étapes recommandées sont : tester une interaction simple pour vérifier que le modèle répond correctement, explorer les outils disponibles avec `hermes mcp list`, et lire la documentation des commandes que vous allez utiliser. Ne pas chercher à configurer des outils complexes ou des skills avant d'avoir validé le fonctionnement de base.
La progression pédagogique recommandée est : fonctionnement de base → ajout d'un premier outil simple → test de l'outil → création d'un premier skill simple → validation du skill. Chaque étape doit être maîtrisée avant de passer à la suivante. Cette progression peut sembler lente, mais elle évite d'accumuler des problèmes de configuration difficiles à démêler.
- Tester une interaction simple avant d'ajouter des outils
- `hermes mcp list` affiche les outils disponibles
- Progression recommandée : base → outil simple → skill simple → validation
- Maîtriser chaque étape avant de passer à la suivante
Sources et méthode
Cette page est une synthèse éditoriale indépendante. Les capacités et commandes doivent être vérifiées dans les sources officielles avant une utilisation en production.