HermesAgent.ca
Tutoriel

Installer Hermes Agent | macOS, Linux, WSL

Installez Hermes Agent sur votre machine et faites-le fonctionner en moins de 10 minutes. Ce guide couvre macOS, Linux et Windows (WSL) avec des commandes terminal et les résultats attendus pour chaque étape.

En bref

Hermes Agent s'installe avec une seule commande terminal. Après l'installation, exécutez hermes setup pour choisir un modèle et un fournisseur, puis commencez à créer des compétences qui s'améliorent à chaque utilisation. Vous aurez un agent IA fonctionnel avec mémoire persistante et accès aux outils en moins de 10 minutes sur macOS, Linux ou WSL.

Aller à la commande d'installation →

Prérequis

Avant d'installer Hermes Agent, assurez-vous que votre système dispose de ces éléments de base. La plupart des machines de développement les possèdent déjà; si vous partez de zéro, chacun prend environ 2 minutes à installer.

ExigencePourquoiVérifier avec
Python 3.10+ Hermes fonctionne avec Python python3 --version
pip Gestionnaire de paquets pip3 --version
git Pour cloner la documentation de référence et les arborescences de travail git --version
Terminal Bash ou Zsh Toutes les commandes de ce guide supposent un shell de type Unix Vous lisez ceci, donc vous en avez un
Utilisateurs Windows : Ce guide suppose WSL 2 (Windows Subsystem for Linux). Ouvrez PowerShell en tant qu'administrateur et exécutez wsl --install, puis redémarrez et lancez le terminal Ubuntu. Toutes les commandes ci-dessous fonctionnent dans cet environnement Ubuntu. Windows natif (PowerShell/cmd) est également pris en charge par Hermes, mais présente des raccourcis et conventions de chemin différents — consultez la documentation officielle pour plus de détails.

Étape 1 : Installer Hermes Agent

Ouvrez votre terminal et exécutez la commande d'installation unique. Ce script détecte votre système d'exploitation, crée un environnement virtuel, installe les dépendances et lie la commande hermes à votre PATH.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Résultat attendu : L'installateur affiche la progression de chaque étape et se termine par un message de succès indiquant votre répertoire d'accueil Hermes (généralement ~/.hermes/). Vous verrez quelque chose comme :

Hermes Agent installed successfully
Home: /Users/you/.hermes
Run 'hermes' to start

Si l'installation se termine sans erreur, redémarrez votre terminal ou exécutez source ~/.bashrc (ou source ~/.zshrc sur macOS) pour que la commande hermes soit disponible. Ensuite, vérifiez :

hermes --version

Vous devriez voir un numéro de version. Si vous obtenez command not found, le shell n'a pas pris en compte la nouvelle entrée PATH — redémarrez votre terminal et réessayez.

Étape 2 : Configuration initiale

Exécutez l'assistant de configuration interactif pour choisir votre modèle d'IA, votre fournisseur et vos préférences de base.

hermes setup

L'assistant vous guide à travers :

  • Sélection du modèle — Choisissez un modèle. OpenRouter est le point de départ le plus facile : il vous donne accès à plus de 200 modèles via une seule clé API. Inscrivez-vous sur openrouter.ai pour une clé gratuite. Pour un guide détaillé, consultez le guide de configuration des modèles et fournisseurs.
  • Configuration du fournisseur — Hermes prend en charge plus de 20 fournisseurs (Anthropic, OpenAI, DeepSeek, Gemini, modèles locaux et plus). Vous pouvez en ajouter plus tard avec hermes config. Pour les modèles locaux, consultez le guide des modèles locaux.
  • Moteur de terminal — Gardez la valeur par défaut (local) sauf si vous souhaitez une isolation Docker/SSH.
  • Outils — Les outils par défaut sont l'accès aux fichiers, le terminal, la recherche Web et la mémoire. Vous pouvez ajouter le navigateur, la génération d'images et les plateformes de messagerie plus tard. Consultez le guide de la passerelle Telegram pour la configuration de messagerie et le guide Google Workspace pour connecter Gmail, Agenda et Drive.
Note sur la confidentialité — local vs infonuagique : Hermes Agent s'exécute sur votre machine, pas sur un serveur distant. Vos fichiers, commandes terminal et conversations restent sur votre ordinateur par défaut. Lorsque vous connectez un fournisseur infonuagique (comme OpenRouter ou Anthropic), vos requêtes et résultats d'outils sont envoyés à l'API de ce fournisseur pour traitement — comme pour tout outil de clavardage IA. Pour les travaux sensibles, vous pouvez connecter un modèle local (via Ollama ou llama.cpp) et tout garder sur l'appareil. Consultez le guide d'agent IA auto-hébergé pour les compromis liés à la résidence des données au Canada. (Cette page ne constitue pas un avis juridique.)

Après la configuration, vérifiez que tout fonctionne :

hermes doctor

hermes doctor vérifie votre environnement Python, votre fichier de configuration et votre clé API. Si quelque chose manque, il vous indique quoi corriger.

Configuration rapide : ignorer l'assistant

Si vous avez déjà une clé API et savez quel modèle vous voulez, vous pouvez configurer Hermes directement :

# Définir votre clé API (exemple OpenRouter)
hermes config set model.api_key sk-or-v1-...

# Définir le modèle
hermes config set model.default openai/gpt-4o

# Vérifier
hermes config

Les clés API sont stockées dans ~/.hermes/.env (non incluses dans git). Hermes ne stocke jamais les clés dans config.yaml.

Étape 3 : Première exécution

Démarrez Hermes en mode clavardage interactif :

hermes

Vous entrez dans une session de clavardage. Essayez une demande simple pour confirmer que tout fonctionne :

You: What files are in my home directory?

Hermes devrait répondre en listant les fichiers. Cela confirme que l'agent peut utiliser ses outils de terminal et de fichiers. Si ça fonctionne, vous êtes prêt.

Pour une requête unique sans entrer en mode interactif :

hermes chat -q "Summarize the last 3 files I modified"

Étape 4 : Configurez votre première compétence

Maintenant que Hermes fonctionne, la prochaine étape est de lui enseigner un flux de travail réutilisable. Les compétences sont la façon dont Hermes Agent s'améliore avec le temps — chaque compétence est une procédure documentée que l'agent charge dans les sessions futures pour ne jamais avoir à réapprendre une tâche.

Hermes est livré avec des dizaines de compétences prêtes à l'emploi pour les flux de travail courants :

hermes skills list        # Voir les compétences installées
hermes skills browse       # Parcourir le catalogue de compétences
hermes skills install ID   # Installer une compétence depuis le hub

Quelques compétences utiles pour commencer :

  • obsidian — Lire, rechercher et créer des notes dans votre coffre Obsidian
  • google-workspace — Automatisation de Gmail, Agenda, Drive, Docs et Sheets
  • apple-notes — Gérer Apple Notes depuis le terminal
  • himalaya — Envoyer et lire des courriels via IMAP/SMTP depuis le terminal
  • github-pr-workflow — Cycle de vie complet des PR GitHub depuis le terminal

Lorsque Hermes résout un problème que vous n'avez jamais posé auparavant, il peut enregistrer cette approche comme une nouvelle compétence — ainsi, la prochaine fois, il sait déjà quoi faire. C'est la partie auto-améliorante de Hermes Agent. En savoir plus sur les compétences Hermes Agent →

Une fois à l'aise avec les compétences, configurez des automatisations planifiées pour exécuter des tâches récurrentes automatiquement. Pour un guide complet sur la connexion des outils de productivité, consultez le guide Apple Notes et le guide des secrets et clés API. Pour comprendre comment Hermes devient plus intelligent au fil du temps, lisez l'explication sur la mémoire persistante.

Foire aux questions

Puis-je utiliser Hermes Agent gratuitement?

Oui. L'agent lui-même est open source (licence MIT). Vous ne payez que pour le modèle d'IA auquel vous le connectez. Si vous utilisez un modèle local avec Ollama ou llama.cpp, l'ensemble est gratuit. OpenRouter offre des crédits d'essai gratuits pour les nouveaux comptes, et de nombreux fournisseurs ont des niveaux gratuits.

Hermes Agent fonctionne-t-il sur Windows sans WSL?

Oui — Hermes fonctionne nativement sur Windows (PowerShell, cmd, Windows Terminal et git-bash). Cependant, WSL 2 offre l'expérience la plus fluide car les scripts d'installation et la plupart des compétences supposent un environnement de type Unix. Windows natif fonctionne mais présente quelques différences de raccourcis et de chemins. Consultez la documentation officielle pour les notes spécifiques à Windows.

Où Hermes stocke-t-il mes données?

Tout se trouve dans ~/.hermes/ sur votre machine : les conversations dans sessions/, les compétences dans skills/, les clés API dans .env et la configuration dans config.yaml. Rien n'est envoyé à Nous Research ni à aucun serveur hébergé par Hermes. Votre fournisseur de modèle voit les requêtes et les résultats d'outils lorsque vous faites des appels API — c'est la seule donnée qui quitte votre machine.

En quoi la mémoire persistante diffère-t-elle de l'historique de session?

L'historique de session est la transcription d'une conversation. La mémoire persistante correspond aux connaissances à long terme de Hermes sur vous, vos préférences, votre environnement et les leçons apprises — elle survit d'une session à l'autre et est injectée dans chaque nouvelle conversation. Par exemple, si vous dites à Hermes que vous préférez GitLab à GitHub, il se souvient de cette préférence de façon permanente. Comment fonctionne la mémoire persistante de Hermes Agent →

Que faire si j'ai déjà un outil de codage IA comme Claude Code ou Codex?

Hermes Agent complète ces outils plutôt que de les remplacer. Claude Code et Codex sont spécialisés pour le codage dans un éditeur. Hermes est un agent polyvalent qui fonctionne à travers le terminal, les plateformes de messagerie et le Web — il peut vérifier votre calendrier, envoyer des messages Telegram, gérer des fichiers et exécuter des tâches planifiées. De nombreux utilisateurs utilisent les deux : Hermes pour l'automatisation générale et Claude Code/Codex pour le codage dans l'éditeur. Qu'est-ce que Hermes Agent? Aperçu complet →

Prochaine étape : configurez votre première compétence

Hermes Agent s'améliore à mesure que vous l'utilisez. Choisissez une compétence dans le catalogue, installez-la et laissez Hermes apprendre votre flux de travail. Chaque problème résolu devient une compétence réutilisable qui rend l'agent plus intelligent.

Parcourir les compétences →

Guides Hermes Agent connexes