Installer Hermes Agent sous Linux : le chemin court pour un solopreneur

Tu veux un agent IA qui fait des trucs concrets. Pas un chatbot qui répond, pas un outil qui promet. Un agent qui exécute des tâches, vérifie ses sorties, et te rend du temps.

La première étape, c’est l’installation. Et c’est là que beaucoup s’arrêtent parce qu’ils ne savent pas si ça a marché.

Voici le chemin le plus court pour installer Hermes Agent sur Linux, vérifier que tout fonctionne, et savoir quoi faire si ça coince.

Communauté Kavyro

Le vrai sujet n’est pas d’ajouter un agent de plus.

Si tu veux construire un système d’agents utile, il te faut surtout une structure claire, de bons arbitrages et des retours terrain. C’est exactement ce qu’on partage dans Kavyro.

Cas concrets
Arbitrages utiles
Questions réelles
Accès gratuit

Rejoindre la communauté

Tu arrives avec ton sujet, tu repars avec plus de clarté.

Ce dont tu as besoin

Une machine Linux récente, un terminal, et une connexion internet. C’est tout. Pas de Docker, pas de GPU, pas de config YAML à écrire avant d’avoir vu l’agent répondre.

Si tu es sur macOS ou WSL2, la même commande fonctionne. Si tu es sur Windows natif, ce n’est pas le chemin : la documentation officielle ne couvre pas ce cas pour l’installateur automatique.

L’installation en une commande

Ouvre un terminal et lance :

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Cette commande télécharge et exécute le script d’installation officiel. Elle configure Hermes Agent dans ton environnement, ajoute le binaire à ton PATH, et prépare le répertoire de configuration.

Une fois le script terminé, recharge ton shell :

source ~/.bashrc

Ou, si tu utilises zsh :

source ~/.zshrc

Sans cette étape, ton terminal ne trouvera pas la commande hermes. C’est l’erreur numéro un.

Le test qui prouve que ça marche

N’ouvre pas un fichier de configuration. Ne crée pas un profil. Lance une conversation :

hermes chat -q "Bonjour, quel est ton nom et que peux-tu faire ?"

Si Hermes répond avec son nom et une description de ses capacités, l’installation est fonctionnelle. Tu as un agent IA qui tourne sur ta machine.

Si la commande n’est pas trouvée, ton shell n’a pas été rechargé. Si Hermes répond mais avec une erreur de modèle ou de provider, c’est un problème de configuration, pas d’installation.

Ce que tu viens de vérifier

Tu as validé trois choses :

• Le binaire hermes est installé et dans ton PATH.
• Le mode requête unique (chat -q) fonctionne : tu envoies une tâche, tu reçois une réponse, le processus s’arrête.
• L’agent peut dialoguer avec un modèle.

C’est le strict minimum. Pas de session interactive, pas de skills, pas de cron. Juste la preuve que le socle tient.

Si ça ne marche pas

Voici les trois échecs les plus fréquents et leur diagnostic :

• hermes: command not found : le shell n’a pas été rechargé. Ferme et rouvre ton terminal, ou relance source ~/.bashrc.
• Erreur de provider ou de modèle : le fichier de configuration par défaut pointe vers un modèle qui n’est pas accessible. Vérifie ~/.hermes/config.yaml et assure-toi qu’un provider est configuré.
• Le script d’installation échoue : vérifie que curl est installé (sudo apt install curl sur Debian/Ubuntu) et que ta connexion internet fonctionne.

Si l’erreur persiste, la documentation officielle de démarrage couvre ces cas. Ne passe pas trois heures à debugger avant d’avoir lu la page Quickstart.

La suite logique

Une fois l’installation vérifiée, tu as deux directions :

• Configurer un minimum viable avant de brancher des automatisations : choisir un modèle, créer un premier profil, tester une tâche simple.
• Passer directement à ta première automatisation si tu sais déjà ce que tu veux déléguer.

Ne saute pas la vérification. Un agent qui n’a jamais répondu à une vraie conversation n’est pas installé, il est juste téléchargé.

Passe à la suite. La formation Hermes Agent couvre la configuration, les profils, et les premières automatisations avec des cas concrets de solopreneur. Faire une demande d’accès →