Démarrage rapide de l’agent Hermes : de l’installation aux premiers pas

Pourquoi Hermes mérite d’être pris en considération

Si vous avez déjà installé un nouvel outil d’IA, regardé le binaire atterrir dans votre PATH, et vous êtes quand même retrouvé avec quelque chose de techniquement présent mais pratiquement inutile, vous comprenez déjà le problème que ce guide de démarrage rapide de Hermes Agent résout. Une installation terminée prouve seulement que des fichiers ont été copiés. Elle ne prouve pas que l’agent peut inspecter un dépôt, parler à un vrai modèle, utiliser des outils en toute sécurité, ou reprendre le travail plus tard.

C’est pourquoi Hermes mérite d’être pris en considération. Lorsqu’il fonctionne correctement, il cesse de ressembler à « ChatGPT dans un terminal » et commence à se comporter comme un agent opérationnel. Il peut inspecter des fichiers, utiliser des outils de terminal, rester dans un espace de travail, et faire avancer la session au lieu d’agir comme si chaque invite repartait de zéro.

Cela en fait un bon choix pour les développeurs, les auto-hébergeurs et les utilisateurs orientés terminal qui veulent de l’aide pour de vraies tâches : résumer une base de code, vérifier un dépôt sur une machine personnelle, ou l’exécuter sur un petit VPS d’AlexHost, AvaHost, ou tout autre fournisseur sans se lancer directement dans une pile d’automatisation plus importante. À la fin de ce guide, vous aurez Hermes installé, configuré, testé sur une première tâche sûre, et repris avec succès.

Ce qu’est Hermes — et ce que ce guide va réellement vous aider à faire

Avant d’exécuter des commandes, gardez trois termes distincts. La plupart des confusions lors de la première utilisation viennent du fait de les regrouper en une vague idée de « l’IA ».

Le tableau suivant vous donne le modèle mental de travail pour ce tutoriel :

Cet article vise un seul état de réussite : une seule session Hermes sûre et fonctionnelle que vous pouvez démarrer, tester et reprendre. Ce n’est pas un guide de déploiement en production. Ce n’est pas une visite complète des fonctionnalités. C’est le chemin le plus court et le plus fiable vers « Hermes fonctionne sur ma machine, et je peux le prouver ».

📝 Remarque : Installer Hermes n’est pas la même chose que configurer Hermes. Le binaire peut être présent et rester inutilisable jusqu’à ce que vous exécutiez hermes model et le connectiez à un fournisseur et un modèle.

Vous remarquerez peut-être que la documentation officielle propose également hermes setup. C’est valide, mais ce guide sépare intentionnellement l’installation de hermes model afin que vous puissiez voir exactement où se produit la plupart des succès ou des échecs lors de la première utilisation. Nous restons également en mode CLI classique en priorité pour la reproductibilité, bien que hermes –tui existe et utilise les mêmes sessions sous-jacentes. Hors du champ de ce guide de démarrage rapide : la configuration de la passerelle, cron, MCP, la mise en réseau de modèles locaux, le routage multi-fournisseurs et le renforcement pour la production.

Règles de sécurité avant de donner à Hermes l’accès au shell

Avant de tester un agent avec accès au terminal, décidez où il est autorisé à se tromper. Pour cet article, cela signifie une machine hors production, une VM, un dépôt jetable, ou au minimum un espace de travail à faible risque où une commande accidentelle ne gâcherait pas votre journée.

⚠️ Avertissement : Gardez les approbations en mode sécurisé par défaut pour tout ce guide de démarrage rapide, et n’utilisez pas –yolo. Hermes demande confirmation avant les commandes risquées ; c’est une fonctionnalité de sécurité, pas une friction inutile.

Utilisez cette liste de contrôle rapide avant de continuer :

• Commencez sur une machine ou un espace de travail à faible risque.
• Gardez les invites d’approbation activées.
• Évitez les dépôts de production personnels pour le premier test.
• Attendez-vous à ce que la tâche de preuve reste en lecture seule.
• Traitez les backends de terminal Docker et SSH comme des étapes de renforcement ultérieures, pas comme des exigences du premier jour.

La première vraie tâche de preuve dans ce guide reste dans ~/.hermes/hermes-agent, ce qui garde la démonstration pertinente pour Hermes tout en évitant les projets sensibles. Une fois que le flux CLI de base est stable, vous pouvez vous orienter vers un isolement plus fort avec Docker ou des backends distants. Pour la première heure, sûr et vérifiable vaut mieux qu’ambitieux.

Avant l’installation : prérequis, chemins pris en charge, et un problème avec WSL2

Pour les utilisateurs courants, la situation prise en charge est simple : Linux, macOS et WSL2 sont les chemins à privilégier en premier. Windows natif existe, mais il est encore en bêta précoce, donc si vous êtes sur Windows, la recommandation pratique reste WSL2.

Sur Ubuntu 24.04 ou WSL2, commencez par vous assurer que git et curl sont disponibles :

Si la deuxième ligne renvoie votre chaîne de distribution ainsi qu’une sortie de version fonctionnelle pour les deux outils, vos prérequis de base sont en place. Sur macOS, la vérification équivalente consiste généralement à confirmer git –version et curl –version avant d’utiliser le même installateur Hermes.

📝 Remarque : Windows natif est encore un chemin en bêta précoce, donc préférez WSL2 si vous êtes sur Windows.
💡 Conseil : Dans WSL2, gardez Hermes et vos dépôts de travail sous ~ plutôt que sous /mnt/c pour éviter des opérations Git plus lentes et un comportement étrange des permissions de fichiers.

La bonne nouvelle est que Hermes ne vous demande pas d’assembler manuellement une grande pile de dépendances au préalable. L’installateur git officiel gère uv, Python 3.11, Node.js 22, ripgrep et ffmpeg pour vous. Ce que vous devriez avoir de prêt avant le démarrage de l’assistant de configuration, c’est un compte fournisseur, ou au moins un plan testé pour un point de terminaison personnalisé. Choisissez également un modèle avec au moins 64K de contexte : les fenêtres de contexte plus petites ont tendance à s’effondrer une fois que l’agent commence à gérer simultanément le contexte de fichiers, la sortie des outils et les instructions en plusieurs étapes.

Installer Hermes Agent avec le chemin officiel en une seule ligne

Les prérequis étant réglés, exécutez l’installateur officiel exactement comme documenté :

Il s’agit désormais de plus qu’une simple étape d’installation. Hermes détecte la plateforme, prépare les dépendances dont il a besoin, puis continue immédiatement dans le flux de configuration de première utilisation. Dans l’exemple ci-dessus, l’installateur détecte Linux, vérifie la présence de uv, installe Python 3.11 si nécessaire, prépare Node.js 22 pour les outils de navigateur, et construit l’environnement de commande Hermes.

Si votre installation est effectuée en tant que root, vous pouvez voir des chemins tels que /usr/local/bin/hermes, /usr/local/lib/hermes-agent et /root/.hermes/. Pour une installation en tant qu’utilisateur normal, attendez-vous à la même structure sous votre propre répertoire personnel.

Le détail important est que l’installateur en une ligne se poursuit directement dans l’assistant de configuration. En d’autres termes, l’installation et la configuration de première utilisation forment un flux continu. Ne considérez pas la fin de l’installation du paquet comme la ligne d’arrivée, car Hermes n’est pas réellement utile tant que cet assistant de configuration n’est pas terminé.

La première décision concerne le fournisseur d’inférence. Dans cette exécution, OpenRouter est sélectionné, ce qui est un premier choix pratique car il donne accès à un large catalogue de modèles via un seul compte fournisseur. Si vous utilisez déjà un autre fournisseur pris en charge, choisissez-le à la place.

Une fois le fournisseur choisi, Hermes demande la clé API correspondante. Dans cet exemple, cela signifie OPENROUTER_API_KEY. Collez la clé, appuyez sur Entrée, et Hermes la stocke pour une utilisation future.

Si vous sautez cette étape, Hermes peut terminer l’installation, mais il ne sera pas encore prêt pour une vraie session d’agent. Vous devrez revenir et configurer le fournisseur plus tard.

Une fois la clé enregistrée, l’assistant passe à la sélection du modèle. Dans cette exécution, le modèle sélectionné est deepseek/deepseek-v4-pro. C’est un exemple concret valide, mais ce n’est pas votre seul choix : l’assistant vous permet également de saisir un nom de modèle personnalisé ou de passer et conserver le modèle actuel si vous relancez la configuration sur une installation existante.

Pour une première utilisation, la règle pratique est simple : choisissez un modèle auquel vous savez déjà pouvoir accéder, et assurez-vous qu’il dispose d’un contexte suffisant pour un vrai travail d’agent. Hermes est bien plus fiable avec des modèles offrant au moins une fenêtre de contexte de 64K. Les fenêtres de contexte plus petites peuvent sembler correctes lors d’un petit test, puis s’effondrer une fois que la sortie des outils, le contexte des fichiers et les instructions en plusieurs étapes commencent à s’accumuler.

Si vous souhaitez modifier ce choix plus tard, hermes model reste le moyen le plus rapide de relancer la sélection du fournisseur et du modèle sans réinstaller quoi que ce soit.

Ensuite, Hermes demande quelle partie de la configuration plus large vous souhaitez effectuer maintenant. Pour ce guide de démarrage rapide, l’option recommandée est la bonne : configuration rapide.

Cela permet à l’article de rester concentré sur le chemin essentiel : fournisseur, modèle, et les choix environnants minimaux nécessaires pour rendre Hermes utilisable.

L’écran suivant demande le backend de terminal. Pour une première utilisation, gardez le backend local actuel afin que Hermes s’exécute directement sur cette machine. Docker, SSH, Modal et d’autres backends sont utiles plus tard, mais ils ajoutent de la complexité avant même que vous ayez confirmé que le flux CLI de base fonctionne.

Hermes propose ensuite la configuration de la plateforme de messagerie. Pour ce guide de démarrage rapide, ignorez-la. Cela permet au guide de rester centré sur le flux d’agent CLI principal, et vous pourrez ajouter Telegram, Discord ou un autre chemin de messagerie plus tard avec hermes setup gateway.

Une fois l’assistant terminé, Hermes indique où il a stocké les fichiers importants.

La distinction principale à retenir est simple : config.yaml contient les paramètres non secrets, .env contient les clés API et autres secrets, et les répertoires de données contiennent les sessions, les journaux et l’état d’exécution associé. Dans cette capture d’écran, les chemins sont sous /root/.hermes/ car l’installation a été effectuée en tant que root. Pour une installation en tant qu’utilisateur normal, lisez ces chemins comme ~/.hermes/.

Hermes affiche ensuite le résumé court prêt à l’emploi, incluant les commandes que vous êtes le plus susceptible d’utiliser en premier.

À ce stade, Hermes est à la fois installé et configuré. La prochaine chose à faire est de vérifier que l’environnement est sain avant de passer à la première vraie tâche :

hermes doctor devrait confirmer les bases : aucun avis de sécurité actif, un environnement Python fonctionnel, et les paquets requis présents. C’est le signal de succès propre que vous souhaitez avant de continuer.

Si hermes n’est pas visible dans un nouveau shell, rechargez votre shell et vérifiez le chemin de la commande avant de continuer. Sur Bash, cela signifie généralement source ~/.bashrc ; sur Zsh, source ~/.zshrc. Si nécessaire, confirmez le lanceur avec command -v hermes.

Avec Doctor qui passe, l’installation n’est pas seulement terminée — Hermes est maintenant réellement prêt à être utilisé.

Exécutez votre première tâche d’agent sûre

Hermes étant maintenant installé, configuré et vérifié par hermes doctor, vous êtes prêt pour la première vraie démonstration. Le premier espace de travail le plus sûr et le plus significatif est votre répertoire personnel Hermes lui-même. Dans cette exécution, l’installation a été effectuée en tant que root, donc ce répertoire est /root/.hermes. Pour une installation en tant qu’utilisateur normal, le même endroit serait ~/.hermes.

Déplacez-vous dans ce répertoire, confirmez où vous êtes, puis lancez Hermes :

C’est un bon premier espace de travail car il est déjà présent, directement lié à l’outil que vous venez d’installer, et à faible risque comparé à l’introduction d’un agent dans un dépôt personnel ou de production. L’écran de démarrage est également une vérification de bon sens utile en soi : il montre Hermes se lançant correctement, le modèle actif dans le pied de page, et le fait que l’agent peut déjà voir ses outils disponibles et ses compétences intégrées.

Si vous préférez la nouvelle interface, hermes –tui est toujours disponible, mais ce guide reste en mode CLI classique en priorité car il est plus facile à reproduire étape par étape et les deux interfaces partagent les mêmes sessions.

Lorsque Hermes s’ouvre, donnez-lui une invite simple en lecture seule qui lui demande d’inspecter l’espace de travail actuel et d’identifier le point d’entrée. Dans cet exemple, l’invite cible explicitement /root/.hermes car l’installation a été effectuée en tant que root. Pour une installation en tant qu’utilisateur normal, pointez-la vers votre propre répertoire ~/.hermes à la place.

Utilisez l’invite suivante :

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

C’est exactement le type de première tâche que vous souhaitez : sûre, observable et facile à vérifier. Dans la capture d’écran ci-dessus, Hermes ne se contente pas de deviner. Il commence à lire des fichiers concrets tels que config.yaml, SOUL.md et .install_method, recherche des fichiers liés à Hermes, et inspecte le chemin du lanceur installé. Cette activité visible des outils est la vraie preuve que Hermes se comporte comme un agent plutôt que comme une boîte de chat à usage unique.

Un résultat sain devrait revenir avec un résumé concret lié à l’espace de travail et un point d’entrée vérifiable. Dans cette exécution, Hermes identifie le wrapper de commande installé à /usr/local/bin/hermes, explique qu’il mène au point d’entrée CLI Python, et résume l’environnement Hermes environnant en cinq points.

C’est le signal de succès à rechercher. La réponse est spécifique, ancrée dans les fichiers que Hermes a réellement inspectés, et facile à vérifier par rapport à ce que vous pouvez déjà voir sur le disque. Ne traitez pas le résultat comme de la magie — comparez le résumé avec les fichiers visibles et la structure du répertoire. Pour une première démonstration, sûr et vérifiable vaut bien mieux que spectaculaire.

Reprenez la session et confirmez que la configuration fonctionne vraiment

Le guide de démarrage rapide n’est pas terminé quand Hermes répond une fois. Il est terminé quand vous confirmez que la session peut être reprise.

Utilisez la commande de reprise ci-dessous ; -c est la forme abrégée pour la même action :

Le résultat attendu est que Hermes rouvre la session la plus récente ou vous donne un récapitulatif qui appartient clairement à la tâche que vous venez d’exécuter. C’est important car cela prouve que Hermes n’agit pas comme un chat jetable à usage unique. Il maintient une session de travail durable à laquelle vous pouvez revenir.

Utilisez cette liste de contrôle de succès compacte avant de continuer :

• Hermes installé et vérifié
• Fournisseur configuré
• Première réponse propre
• Première tâche de dépôt terminée
• Session reprise avec succès

Si la reprise ne fonctionne pas, assurez-vous d’abord d’utiliser le même profil, puis vérifiez les sessions disponibles avec hermes sessions list. Une fois que hermes –continue fonctionne, vous disposez de la base complète que ce tutoriel Hermes Agent visait à établir.

Quoi essayer ensuite une fois que le flux de base fonctionne

Une fois que le chat de base est stable, n’ajoutez qu’une nouvelle couche à la fois.

💡 Conseil : Résistez à l’envie d’activer immédiatement toutes les fonctionnalités avancées. Stabilisez d’abord un flux de travail propre, puis développez délibérément.

Voici le court menu des prochaines étapes sensées :

• Essayez hermes –tui si vous souhaitez la nouvelle interface de terminal par-dessus le même modèle de session.
• Exécutez hermes setup plus tard si vous souhaitez l’assistant de configuration plus complet après avoir compris les bases manuellement.
• Explorez hermes gateway setup si votre prochain objectif est l’intégration d’une plateforme de messagerie.
• Consultez hermes tools et hermes skills lorsque vous souhaitez une expansion contrôlée des capacités.
• Passez à un backend de terminal Docker ou SSH si l’agent va commencer à toucher des systèmes à enjeux plus élevés.
• Utilisez la documentation officielle pour les fournisseurs personnalisés et les points de terminaison de modèles locaux une fois que le chemin hébergé fonctionne déjà.

Si vous souhaitez des idées de suivi pour une utilisation réelle, voici quelques bonnes pistes à explorer ensuite : notes d’intégration de base de code, rédaction de journaux de modifications, planification sûre de refactorisation, explication de fichiers de configuration, résumés de révision de pull requests, listes de contrôle de maintenance VPS, rédaction de runbooks de déploiement, invites de triage de journaux, et identification des lacunes de documentation.

Pour des chemins plus approfondis, renvoyez vers l’extérieur plutôt que d’étirer ce guide de démarrage rapide en un second article : le guide de démarrage rapide, la documentation d’installation, le guide CLI, et le guide de sécurité sont les prochaines étapes appropriées.

Vous disposez maintenant d’un guide de démarrage rapide Hermes sûr et fonctionnel

L’étape importante n’est pas que Hermes soit installé. L’étape importante est que Hermes soit devenu utile. Vous disposez maintenant d’une base vérifiée : le binaire est présent, le fournisseur est configuré, la première réponse a fonctionné, la première tâche sûre est terminée, et la session a été reprise par la suite.

C’est le bon endroit pour s’arrêter et savourer la victoire. Gardez les approbations activées, développez une couche à la fois, et orientez-vous vers un isolement plus fort lorsque l’agent commence à effectuer des travaux à enjeux plus élevés. Si vous finissez par exécuter Hermes sur un poste de travail personnel, une machine de laboratoire, ou un VPS d’AlexHost, AvaHost, ou ailleurs, la règle reste la même : gagnez la confiance par petites étapes.