Faire tourner Hermes
Hermes Agent v0.8.0 s'installe en environ 60 secondes sur Linux, macOS ou WSL2. Une commande curl et l'installeur gère uv, Python 3.11, Node.js, ripgrep et ffmpeg pour toi.
checklist Prérequis système
Seul git est requis au départ — Python 3.11, Node.js v22, uv, ripgrep et ffmpeg sont installés par le script
Linux, macOS, WSL2 sous Windows ou Android via Termux. Windows natif non supporté.
2 Go de RAM minimum ; plus si tu fais tourner des modèles locaux
~1 Go pour l'agent, son venv, les modules Node et les skills intégrés
Optionnel : Docker, SSH, Daytona, Singularity ou Modal pour l'exécution sandboxée de commandes
Connexion internet requise pour les API de modèles hébergés. Les modèles locaux via un endpoint compatible OpenAI fonctionnent hors ligne.
La ligne unique de la documentation officielle. Recommandé pour la plupart des utilisateurs sur Linux, macOS ou WSL2. Documentation d'installation arrow_forward
WSL2 (Windows)
Windows natif n'est pas supporté. Lance ceci dans un shell WSL2 après 'wsl --install'.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
Seul git est requis au départ — l'installeur gère uv, Python 3.11, Node.js v22, ripgrep et ffmpeg.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified Vérifier l'installation
Lance les commandes de vérification listées dans la documentation officielle.
hermes version Affiche la version installée (devrait être 0.8.0 ou ultérieure).
hermes doctor Lance un diagnostic — Python, uv, dépendances, fichiers de configuration et connectivité.
hermes status Affiche ta configuration actuelle : fournisseur de modèle, outils activés et gateways connectées.
settings Configuration initiale
Après l'installation, recharge ton shell puis lance les trois commandes de configuration de la documentation.
Choisis un fournisseur de modèle
Lance 'hermes model' pour choisir un fournisseur. Le README liste Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI et les endpoints personnalisés. Anthropic et Mistral sont aussi des dépendances.
Active les outils souhaités
Lance 'hermes tools' pour configurer lesquels des 47 outils intégrés sont activés. Tu peux en ajouter ou en retirer plus tard.
Lance l'assistant de configuration complet
Lance 'hermes setup' pour parcourir l'assistant complet, y compris les clés API et les connexions aux gateways de chat (Telegram, Discord, Slack, WhatsApp, Signal, Email).
Envoie un message test
Essaie 'hermes chat -q "Salut ! Quels outils as-tu de disponible ?"' — directement du quickstart officiel.
.env — La configuration vit dans ~/.hermes/ — config.yaml pour les réglages principaux, .env pour les clés API, plus des sous-répertoires pour les sessions, logs, mémoires, skills et tâches cron. Voir la référence des variables d'environnement sur hermes-agent.nousresearch.com/docs/reference/environment-variables.
cloud Déploiement VPS / Serveur
Hermes tourne sur n'importe quel VPS Linux avec 2 Go de RAM et ~1 Go de disque. La même commande en une ligne fonctionne en SSH.
Connecte-toi en SSH à ton serveur
N'importe quelle distribution Linux fonctionne — Ubuntu, Debian, CentOS, Arch, etc.
ssh user@your-server-ip Lance l'installeur
Le script détecte automatiquement ta distribution, installe Python 3.11 via uv et configure toutes les dépendances.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Active un backend de sandbox
Sur une infrastructure partagée, configure un des backends de sandbox (Docker, SSH, Daytona, Singularity ou Modal) pour que les commandes shell de Hermes s'exécutent en isolation. Voir le README pour la configuration spécifique à chaque backend.
Configure ta clé API et lance
Choisis un fournisseur de modèle et démarre Hermes. Utilise tmux ou screen pour la persistance — le processus tourne au premier plan.
hermes model && hermes Tip — Pour un daemon persistant, lance Hermes dans tmux/screen ou écris un fichier unit systemd. Consulte la documentation officielle pour la configuration en daemon.
system_update_alt Mettre à jour Hermes
Le README documente un outil de mise à jour intégré : 'hermes update'. Il n'y a pas de paquet PyPI publié ni d'image Docker, donc les autres chemins de mise à jour passent par git. Guide de mise à jour arrow_forward
hermes update cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]" curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # Aucune image Docker officielle n'est publiée pour le moment Voir github.com/NousResearch/hermes-agent/releases pour le contenu de chaque version.
delete_forever Désinstaller Hermes
Hermes s'installe dans ~/.hermes/hermes-agent/ et crée un lien symbolique du binaire dans ~/.local/bin/hermes. La suppression se fait en deux commandes. Notes de désinstallation arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # Pas d'image Docker officielle à supprimer Supprimer les données utilisateur (optionnel)
Ceci supprime tes sessions, mémoires, skills, tâches cron et clés API. Sauvegarde ce dont tu as besoin d'abord.
rm -rf ~/.hermes # Lance dans ton shell WSL — Windows natif non supporté build Dépannage
Tiré du tableau de dépannage de la documentation d'installation et des erreurs courantes du script. Plus de conseils de dépannage arrow_forward
Besoin d'aide ?
Rejoins le Discord Nous Research pour le support d'installation et le dépannage communautaire.