Prérequis système avant l'installation
Hermes Agent fonctionne sur les distributions Linux courantes : Ubuntu 20.04 et supérieur, Debian 11+, Fedora 37+, Arch Linux et leurs dérivés. Avant de commencer, assurez-vous que votre système dispose d'une connexion Internet active et que les outils de base sont présents. Vérifiez la version de Python disponible avec `python3 --version` : Python 3.9 ou supérieur est recommandé, même si l'installateur gère lui-même la plupart des dépendances.
Vous aurez également besoin des droits suffisants pour écrire dans votre répertoire personnel. L'installation ne nécessite pas de privilèges root : tout s'installe sous `~/.hermes/` par défaut. Si votre distribution utilise un pare-feu restrictif, assurez-vous que les connexions HTTPS sortantes vers les fournisseurs de modèles sont autorisées. Aucune configuration réseau particulière n'est requise au-delà de cela.
- Python 3.9 ou supérieur (`python3 --version`)
- curl disponible sur le système
- Connexion Internet HTTPS active
- Accès en écriture au répertoire personnel
- Distribution Linux 64 bits récente
Lancer l'installateur officiel
La méthode d'installation recommandée par NousResearch est l'installateur officiel, accessible via une commande curl. Ouvrez un terminal et exécutez : `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`. Cette commande télécharge le script d'installation, vérifie les dépendances nécessaires et place les binaires dans un emplacement accessible depuis votre PATH. L'installateur affiche chaque étape dans le terminal pour que vous puissiez suivre la progression.
Une fois l'installation terminée, fermez et rouvrez votre terminal, ou rechargez votre profil shell avec `source ~/.bashrc` (ou `~/.zshrc` selon votre shell). Vérifiez ensuite que la commande hermes est disponible avec `which hermes`. Si la commande n'est pas trouvée, vérifiez que le répertoire d'installation a bien été ajouté à votre variable PATH par l'installateur. Il est également possible d'installer via PyPI avec `pip install hermes-agent`, mais l'installateur officiel reste la voie privilégiée car il configure l'environnement complet.
- `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`
- Recharger le shell après installation
- Vérifier avec `which hermes`
- Alternative PyPI : `pip install hermes-agent`
Configuration initiale avec hermes setup
Après l'installation, lancez `hermes setup` pour démarrer l'assistant de configuration interactif. Cette commande vous guide à travers les étapes essentielles : choix du fournisseur de modèle, saisie de la clé API correspondante, et paramètres de base de l'agent. Le fichier de configuration est créé automatiquement à l'emplacement `~/.hermes/config.yaml`. Vous n'avez pas besoin de créer ce fichier manuellement.
Pour sélectionner ou changer le modèle utilisé par Hermes, la commande dédiée est `hermes model`. Elle affiche les modèles disponibles pour votre fournisseur configuré et vous permet d'en choisir un. Si vous souhaitez connaître l'emplacement exact de votre fichier de configuration ou du fichier de variables d'environnement, utilisez respectivement `hermes config path` et `hermes config env-path`. Ces commandes évitent toute ambiguïté sur les chemins selon votre système.
- `hermes setup` — assistant de configuration interactif
- `hermes model` — sélection du modèle
- `hermes config path` — chemin du fichier de configuration
- `hermes config env-path` — chemin du fichier d'environnement
- Configuration stockée dans `~/.hermes/config.yaml`
Vérifier l'installation avec hermes doctor
La commande `hermes doctor` est l'outil de diagnostic intégré d'Hermes Agent. Elle inspecte l'ensemble de l'environnement : présence des dépendances, validité de la configuration, accessibilité du fournisseur de modèle et état des composants installés. Chaque vérification est affichée avec un statut clair, ce qui permet d'identifier immédiatement les éléments qui nécessitent une attention.
Si `hermes doctor` signale une erreur liée à la clé API, relancez `hermes setup` pour la corriger. Si une dépendance système manque, l'outil indique généralement comment la résoudre. Prenez l'habitude de lancer `hermes doctor` après chaque mise à jour ou modification de configuration importante : c'est le moyen le plus rapide de s'assurer que l'environnement est cohérent avant de travailler.
- `hermes doctor` — diagnostic complet de l'environnement
- Vérifie les dépendances, la configuration et la connectivité
- Affiche des statuts clairs pour chaque composant
- À relancer après toute modification importante
Effectuer un premier test fonctionnel
Une fois `hermes doctor` sans erreur, vous pouvez effectuer un premier appel pour confirmer que l'agent répond correctement. Lancez une requête simple depuis le terminal pour vérifier la chaîne complète : connexion au fournisseur, réception de la réponse et affichage dans le terminal. Ce test de bout en bout valide que l'installation est opérationnelle dans votre environnement spécifique.
Si le premier test échoue, consultez les journaux situés dans `~/.hermes/logs/` pour obtenir des détails sur l'erreur. Les logs sont structurés et horodatés, ce qui facilite l'identification du problème. La section dépannage de ce site détaille une méthodologie complète pour résoudre les erreurs courantes rencontrées après l'installation.
- Lancer une requête simple pour valider la chaîne complète
- Consulter `~/.hermes/logs/` en cas d'erreur
- Vérifier la connectivité réseau si la réponse échoue
- Relancer `hermes doctor` pour confirmer l'état
Maintenir Hermes Agent à jour
Pour mettre à jour Hermes Agent vers la dernière version disponible, utilisez la commande `hermes update`. Cette commande vérifie la version courante, télécharge les mises à jour disponibles et les applique sans nécessiter de réinstallation complète. Il est recommandé de lancer `hermes doctor` après chaque mise à jour pour s'assurer que l'environnement reste cohérent.
Les mises à jour peuvent introduire de nouvelles commandes, modifier des comportements existants ou ajouter la prise en charge de nouveaux fournisseurs de modèles. Consultez la documentation officielle sur https://hermes-agent.nousresearch.com/docs et le dépôt https://github.com/NousResearch/hermes-agent pour suivre les changements entre versions et anticiper les éventuels ajustements de configuration.
- `hermes update` — mise à jour vers la dernière version
- Lancer `hermes doctor` après la mise à jour
- Consulter le dépôt GitHub pour les notes de version
- Documentation officielle : https://hermes-agent.nousresearch.com/docs
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.