Tu veux installer Hermes, mais les instructions passent de PowerShell à Linux, puis parlent de modèle et de clé d’API. Pour avancer sans mélanger les étapes, nous allons d’abord choisir le bon terminal, installer le programme, puis essayer une conversation.
Le parcours utilise Ubuntu : directement sur un PC Linux, ou dans WSL2 sous Windows. WSL2 permet de faire fonctionner un environnement Linux sur ton ordinateur Windows. Une fois Ubuntu ouvert, les deux chemins se rejoignent.
Prévois une connexion Internet et un compte autorisé à installer des logiciels. Le chemin Windows ci-dessous vise Windows 11 ; pour une autre version ou une machine administrée par ton organisation, vérifie les prérequis Microsoft. Sur Linux, les commandes de préparation sont celles d’Ubuntu.
Tu n’as pas besoin d’une carte graphique particulière pour installer l’agent. Une première conversation demande en revanche un modèle accessible : un fournisseur avec un compte ou une clé d’API, ou un serveur de modèle local déjà prêt. Tu peux terminer l’installation et choisir le modèle plus tard.
Ce tutoriel est vérifié à partir des sources officielles citées. Les commandes et résultats attendus constituent un parcours à reproduire ; aucune installation sur une machine Windows ou Linux vierge n’a été exécutée pour cette révision.
1. Choisir où tu vas installer Hermes
Sous Windows, nous retenons WSL2 pour retrouver l’environnement Linux utilisé dans les exercices de cette série. Windows natif est également pris en charge : si tu préfères rester dans les outils et les chemins Windows, suis le guide officiel Windows natif. Ce choix a son propre parcours ; il ne faut pas lui appliquer les commandes Ubuntu ci-dessous.
Si Ubuntu fonctionne déjà sur ton PC Linux, passe directement à l’étape 3. Si tu as déjà Ubuntu sous WSL2, vérifie simplement sa version à l’étape 2, puis ouvre-le.
Le bon terminal, au bon endroit
Parcours Ubuntu / WSL2 de ce tuto : choisis uniquement le départ qui te concerne.
Deux départs, une même suite : les commandes Linux du tutoriel.
Si tu utilises déjà Hermes dans cet environnement, ne relance pas une installation pour suivre ce tuto. Vérifie d’abord la commande à l’étape 3 ; le parcours de mise à jour convient mieux à une installation existante.
2. Préparer Ubuntu sous Windows, si nécessaire
Cette étape concerne seulement Windows. Ouvre PowerShell en administrateur : menu Démarrer, recherche « PowerShell », puis « Exécuter en tant qu’administrateur ».
Commence par regarder si une distribution Linux existe déjà :
wsl --list --verbose
Si Ubuntu apparaît avec VERSION 2, garde cette installation et ouvre Ubuntu depuis le menu Démarrer. Le mot Stopped signifie seulement que la distribution est arrêtée.
Si WSL ou Ubuntu n’est pas encore installé, lance :
wsl --install -d Ubuntu
Redémarre si Windows le demande, puis ouvre Ubuntu. Au premier lancement, crée le nom d’utilisateur Linux et son mot de passe. Ils appartiennent à Ubuntu ; ce ne sont pas nécessairement ceux de ton compte Windows. Quand le terminal demande ce mot de passe, les caractères ne s’affichent pas pendant la saisie : c’est normal.
Relance ensuite wsl --list --verbose dans PowerShell pour vérifier la version de cette distribution. Une version par défaut égale à 2 ne suffit pas à prouver qu’une distribution existante utilise WSL2.
VERSION 2. Tu peux ouvrir Ubuntu et y saisir une commande. À partir de l’étape suivante, tu travailles dans ce terminal Ubuntu, plus dans PowerShell.Si une ancienne distribution indique VERSION 1, sauvegarde ses fichiers utiles avant toute conversion, puis suis les commandes Microsoft pour passer de WSL1 à WSL2. Le nom à utiliser est celui affiché dans ta liste. Ne supprime pas une distribution pour recommencer l’installation.
3. Préparer le terminal Ubuntu
À partir d’ici, le parcours est commun au PC Linux et à Ubuntu sous WSL2. Ouvre un terminal Ubuntu avec ton compte habituel, puis exécute :
cd ~
pwd
whoami
command -v hermes
pwd affiche ton dossier personnel Linux, généralement sous /home/. whoami affiche ton utilisateur ; pour ce parcours, il ne doit pas être root. La dernière commande cherche une installation d’Hermes déjà accessible. L’absence de sortie pour cette dernière ligne est normale avant une première installation. Si elle affiche un chemin, passe à l’étape 5 pour examiner l’installation existante.
Travaille dans ton dossier personnel Linux pour cet essai. Sous WSL, les fichiers Windows restent accessibles via des chemins comme /mnt/c/, mais nous n’en avons pas besoin ici.
Installe les outils nécessaires au téléchargement :
sudo apt update && sudo apt install -y git curl ca-certificates
sudo peut demander le mot de passe de ton compte Ubuntu. Attends la fin de la commande ; si elle échoue, résous ce problème avant de poursuivre. Ces commandes sont destinées à Ubuntu, pas à toutes les distributions Linux.
4. Télécharger puis lancer l’installation officielle
Nous utilisons le script indiqué dans la documentation d’installation Hermes. Il prépare le programme et ses dépendances. L’option --non-interactive reporte les assistants de configuration et l’installation du service de messagerie : nous choisirons nous-mêmes le modèle à l’étape 6.
Le bloc suivant crée un fichier temporaire, y télécharge le script officiel, puis l’exécute. Les && empêchent de passer à la suite si une commande échoue. Le téléchargement seul n’installe pas Hermes : c’est la ligne bash qui lance le script.
install_script="$(mktemp)" &&
curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o "$install_script" &&
bash "$install_script" --non-interactive
Exécute ce bloc avec ton compte habituel, sans ajouter sudo devant le script. Il télécharge et exécute du code du projet officiel : utilise cette adresse exacte. Si tu veux examiner le script avant de le lancer, sa source est consultable sur GitHub.
Laisse l’installation se terminer et lis son bilan. Elle peut aussi télécharger des composants pour des fonctions facultatives, comme le navigateur. Un message de téléchargement manquant mérite d’être conservé, même si les autres étapes se terminent. Tu n’as pas besoin de configurer une messagerie ni un service en arrière-plan pour le premier essai.
En cas d’échec, garde le nom de l’étape concernée et le chemin du journal indiqué. Ne supprime pas le dossier de données d’Hermes pour tenter de réparer l’installation.
5. Vérifier que la commande est disponible
Ferme le terminal puis ouvre un nouveau terminal Ubuntu, afin de prendre en compte les chemins ajoutés pendant l’installation. Vérifie :
command -v hermes
hermes --version
La première ligne doit afficher un chemin vers la commande ; la seconde, des informations de version. Tu peux ensuite lire le diagnostic :
hermes doctor
Ce rapport aide à repérer des problèmes de configuration et de dépendances. Lis ce qu’il signale : un modèle pas encore configuré n’est pas la même chose qu’une commande introuvable ou qu’un composant facultatif absent. Le diagnostic ne remplace pas un essai de conversation, ni un test de chaque outil.
Si hermes reste introuvable après ouverture d’un nouveau terminal, reprends les indications de fin d’installation concernant le chemin de la commande. Si tu étais revenu dans PowerShell, ouvre d’abord Ubuntu : l’installation réalisée ici appartient à Linux.
6. Choisir le modèle qui répondra
Hermes est l’agent ; le modèle produit les réponses. Pour sélectionner un fournisseur et un modèle, lance :
hermes model
Suis les choix proposés par ta version. Pour un fournisseur distant, prépare l’accès demandé et vérifie ses conditions d’utilisation et de facturation. Saisis les identifiants dans l’assistant prévu à cet effet, pas dans une consigne de conversation ni dans une capture partagée.
Si tu préfères un modèle local et que tu n’as pas encore de serveur prêt, tu peux t’arrêter ici : l’installation de l’agent reste acquise. Le tuto Hermes avec llama.cpp explique comment préparer et vérifier le serveur, puis connecter Hermes. Reviens ensuite pour le premier échange.
Le modèle doit être joignable depuis l’environnement où Hermes tourne. Sous WSL2, un serveur lancé dans Windows n’est pas automatiquement équivalent à un serveur lancé dans Ubuntu. Pour un premier essai local, suivre le même environnement que dans le tuto llama.cpp évite d’ajouter cette difficulté.
7. Essayer une conversation simple
Une fois le modèle sélectionné, démarre Hermes depuis le même terminal Ubuntu :
hermes
Attends l’invite de conversation, puis colle cette demande dans Hermes, pas dans le terminal qui lance les commandes :
La consigne demandant de ne pas utiliser d’outil ne les désactive pas techniquement. Pour vérifier leur utilisation séparément, continue avec le tuto des premiers outils.
Si quelque chose bloque, repars du dernier résultat observé :
| Ce que tu observes | Où regarder d’abord |
|---|---|
hermes est introuvable | Bon terminal, fin de l’installation et chemin de la commande. |
| La version s’affiche, mais le modèle refuse l’accès | Fournisseur, modèle choisi et authentification. |
| La connexion au modèle échoue | Adresse du serveur, disponibilité et accès depuis Ubuntu. |
| Le chat répond, mais un outil manque | Configuration de cet outil ; ne réinstalle pas tout pour ce seul constat. |
Tu as maintenant trois repères distincts : le programme démarre, le modèle est configuré, une réponse arrive. Pour approfondir, le tuto de configuration propose un premier réglage réversible ; le tuto de diagnostic aide à isoler un problème.
Les voies macOS, Windows natif, Desktop et l’installation manuelle restent décrites dans la documentation officielle. Les commandes et leur rôle sont aussi détaillés dans la référence CLI Hermes.