Dossier
Installer Hermes Agent
Guide d'installation de Hermes Agent sur Linux, macOS, Windows WSL2 et Android Termux. Prerequis, verification, mise a jour et desinstallation.
Sur cette page
Introduction
Cette page regroupe les procedures d'installation de Hermes Agent sur les plateformes officiellement supportees. Vous trouverez ici les prerequis communs, les guides par systeme d'exploitation, et les operations de maintenance: verification, mise a jour et desinstallation.
Hermes Agent est distribue comme un package Python installable via pip, ou directement depuis le depot Git. L'installation ne necessite pas de droits administrateur dans la plupart des cas.
Choisir sa plateforme
- Installer sur Linux: distributions Debian, Ubuntu, Fedora, Arch et autres
- Installer sur macOS: Apple Silicon (M1/M2/M3/M4) et Intel
- Installer sur Windows avec WSL2: sous-systeme Linux sur Windows
- Installer sur Android avec Termux: environnement Linux minimal sur mobile
Prerequis communs
Avant d'installer Hermes Agent, verifiez que votre environnement dispose de:
- Python 3.10 ou superieur (voir question q-025)
- pip a jour (
pip install --upgrade pip) - git (pour l'installation depuis le depot)
- Un acces Internet pour telecharger les dependances
Verification de l'installation
Une fois l'installation terminee, utilisez la commande hermes doctor pour verifier que tout fonctionne correctement. Cette commande controle:
- la version de Python
- la presence des dependances
- la configuration de base
- l'acces aux providers configures
Un hermes doctor qui passe sans erreur confirme que l'installation est operationnelle.
Maintenance
Mise a jour
Pour mettre a jour Hermes Agent vers la derniere version:
hermes updateCette commande met a jour le code et les dependances. Si vous avez installe depuis Git, elle synchronise avec le depot upstream.
Desinstallation
Pour desinstaller proprement Hermes Agent:
hermes uninstallCette commande supprime l'environnement virtuel, les binaires et les fichiers de configuration. Les donnees utilisateur (sessions, skills, profils) sont conservees par defaut. Utilisez hermes uninstall --full pour tout supprimer.
Questions couvertes
q-025: Quelle version de Python faut-il pour Hermes Agent ?
Hermes Agent necessite Python 3.10 ou superieur. La version 3.10 est le minimum officiellement supporte. Les versions 3.11, 3.12 et 3.13 sont compatibles. Verifiez votre version avec python3 --version avant l'installation.
q-026: Comment verifier que l'installation de Hermes Agent est correcte ?
Lancez hermes doctor. Cette commande integree effectue un diagnostic complet: version de Python, dependances, configuration, providers. Si toutes les etapes passent, l'installation est operationnelle. En cas d'erreur, le diagnostic indique la cause probable.
q-027: Comment installer Hermes Agent sans droits administrateur ?
L'installation standard de Hermes Agent ne necessite pas de droits administrateur. L'outil s'installe dans un environnement virtuel Python local a votre utilisateur. Aucun sudo n'est requis. Si vous rencontrez une erreur de permission, creez d'abord un environnement virtuel avec python3 -m venv ~/hermes-venv puis activez-le avant l'installation.
q-028: Comment installer Hermes Agent avec Docker ?
Hermes Agent propose une image Docker officielle. Consultez la documentation Docker pour les instructions detaillees. L'approche Docker isole l'agent dans un conteneur et simplifie le deploiement sur serveur.
q-029: Comment mettre a jour une installation Hermes Agent existante ?
Executez hermes update. Si vous avez installe via pip, la commande met a jour le package et ses dependances. Si vous avez clone le depot Git, elle synchronise avec la branche upstream. Apres la mise a jour, lancez hermes doctor pour verifier l'integrite.
q-030: Comment desinstaller Hermes Agent proprement ?
Utilisez hermes uninstall. Par defaut, seuls les fichiers d'installation sont supprimes: l'environnement virtuel, les binaires, les fichiers de configuration systeme. Les donnees personnelles (sessions, skills, profils, memories) restent dans ~/.hermes/. Pour une desinstallation complete incluant les donnees, utilisez hermes uninstall --full.
Sources
- Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
- Depot NousResearch/hermes-agent, commit b4f8c491 (https://github.com/NousResearch/hermes-agent)
- CLI commands reference (https://hermes-agent.nousresearch.com/docs/reference/cli-commands)
- Platform Support (https://hermes-agent.nousresearch.com/docs/getting-started/platform-support)
Liens internes proposes
Preuves et limites
Architecture, corpus officiel et observations publiques sont ingérés au build. Une validation humaine reste nécessaire pour les affirmations publiées.