Hermes Agent sur Windows : l'installation qui marche vraiment (WSL2)

• Pourquoi Windows natif ne suffit pas ?
• Comment activer WSL2 correctement ?
• Que faire si wsl --install échoue avec une erreur de virtualisation ?
• Faut-il régler la mémoire allouée à WSL2 ?
• Faut-il s'inquiéter du réseau entre Windows et WSL2 ?
• Une fois WSL2 prêt, que faire ?
• Comment sauvegarder son installation WSL2 avant de bricoler la configuration ?
• WSL2 ou VPS Linux : lequel choisir pour un usage sérieux ?

Pourquoi Windows natif ne suffit pas ?¶

Le support Windows natif d'Hermes Agent existe, mais l'équipe du projet le qualifie elle-même d'expérimental : certaines dépendances Python ne compilent pas proprement, le sandbox Docker se comporte différemment, et une partie de la communauté ne le teste tout simplement pas. WSL2 — le sous-système Linux de Windows — est la cible réellement utilisée et testée. C'est là-dessus que nous avons fait l'installation réelle décrite dans notre guide des 6 pièges, le 1er août 2026.

Ce guide-ci ne répète pas ces 6 pièges. Il couvre ce qui vient avant : bien configurer WSL2 lui-même, pour ne pas ajouter une septième source de blocage avant même d'avoir lancé install.sh.

Comment activer WSL2 correctement ?¶

Deux commandes suffisent, dans un PowerShell lancé en administrateur. La première installe WSL2 et Ubuntu par défaut :

Copierwsl --install

Après le redémarrage demandé, vérifiez la version active — c'est l'erreur la plus fréquente à ce stade : une distribution qui tourne encore en WSL1 (héritée d'une install antérieure) plutôt qu'en WSL2, ce qui casse silencieusement le sandbox Docker plus tard.

Copierwsl -l -v

La colonne VERSION doit afficher 2 pour Ubuntu. Si elle affiche 1, convertissez avec wsl --set-version Ubuntu 2 — comptez plusieurs minutes, l'opération réencode le disque virtuel.

Que faire si wsl --install échoue avec une erreur de virtualisation ?¶

Sur certaines machines, la commande s'arrête avec un message évoquant la virtualisation matérielle non disponible. La cause est presque toujours la même : la virtualisation (VT-x sur Intel, AMD-V sur AMD) est désactivée dans le BIOS ou l'UEFI de la carte mère — un réglage usine fréquent sur les PC vendus avec Windows préinstallé, notamment en entreprise.

La vérification est rapide : ouvrez le Gestionnaire des tâches, onglet Performances, et regardez la ligne « Virtualisation ». Si elle indique « Désactivée », il faut l'activer dans le BIOS (généralement sous un menu « Advanced » ou « CPU Configuration », le nom exact varie selon le fabricant) avant de relancer wsl --install.

Deux fonctionnalités Windows doivent aussi être actives — WSL2 ne les active pas toujours seul selon la version de Windows :

Copierdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Un redémarrage est nécessaire après ces deux commandes.

Faut-il régler la mémoire allouée à WSL2 ?¶

Oui, presque toujours. Par défaut, WSL2 s'alloue jusqu'à 50 % de la RAM de la machine (ou 8 Go, selon la valeur la plus basse) — un réglage pensé pour un usage généraliste, pas pour faire tourner en continu un agent, son sandbox Docker, et le dashboard web. Sur une machine à 16 Go, cela laisse Hermes Agent se battre avec le reste de Windows pour 8 Go partagés.

La solution est un fichier .wslconfig, à créer dans votre dossier utilisateur Windows (C:\Users\VotreNom\.wslconfig, pas dans WSL2 lui-même) :

Copier[wsl2]
memory=6GB
processors=4

Redémarrez WSL2 pour appliquer (wsl --shutdown depuis PowerShell, puis rouvrez un terminal Ubuntu). Sans ce réglage, nous avons observé des ralentissements nets dès que le sandbox Docker et le build du dashboard (voir notre guide des 6 pièges, piège n°3) tournaient en même temps.

Un détail lié : processors ne devrait pas dépasser le nombre de cœurs physiques réellement disponibles sur votre machine, moins un ou deux réservés à Windows lui-même. Une valeur trop haute ne plante rien, mais WSL2 se met alors à se disputer les cœurs avec Windows, ce qui produit exactement le ralentissement que ce réglage est censé éviter.

Faut-il s'inquiéter du réseau entre Windows et WSL2 ?¶

Sur les versions récentes de Windows 11, WSL2 utilise par défaut un mode réseau « miroir » qui simplifie beaucoup les choses : un service lancé dans Ubuntu sur localhost:PORT est directement joignable depuis un navigateur Windows sur localhost:PORT, sans configuration supplémentaire. C'est ce qui permet d'accéder au dashboard web d'Hermes Agent depuis Windows sans manipulation réseau particulière.

Sur des versions plus anciennes de Windows, ou si le mode miroir n'est pas actif, WSL2 fonctionne avec sa propre adresse IP virtuelle, différente de localhost. Dans ce cas, hostname -I depuis le terminal Ubuntu affiche l'IP à utiliser depuis le navigateur Windows. Un symptôme fréquent : le dashboard répond bien à curl localhost:PORT depuis WSL2 lui-même, mais reste inaccessible depuis le navigateur Windows — un problème réseau, pas un problème Hermes Agent.

Une fois WSL2 prêt, que faire ?¶

À partir de ce point, l'installation d'Hermes Agent proprement dite suit exactement le chemin que nous avons documenté en détail — install.sh, le piège du script postinstall qui se bloque, le choix entre le wizard interactif et hermes config set, le build du dashboard qui exige Node 22, la séquence stricte hermes gateway install puis start. Nous ne les répétons pas ici : notre guide complet des 6 pièges les couvre un par un, avec les messages d'erreur exacts.

Un point spécifique à Windows mérite d'être signalé avant de vous y lancer : les performances disque. Si votre projet ou vos fichiers de travail vivent sur /mnt/c/... (c'est-à-dire sur le disque Windows monté dans WSL2), les opérations de fichiers sont nettement plus lentes que sur le système de fichiers natif de WSL2 (~/). La raison est technique mais concrète : /mnt/c/ passe par une couche de traduction entre le noyau Linux de WSL2 et le système de fichiers NTFS de Windows, protocole par protocole. Pour un simple fichier texte, la différence ne se voit pas. Pour un sandbox Docker qui lit et écrit en continu — exactement ce que fait Hermes Agent —, elle devient perceptible. Gardez ~/.hermes et le code cloné dans le système de fichiers Linux natif — pas sur /mnt/c/.

Comment sauvegarder son installation WSL2 avant de bricoler la configuration ?¶

Avant de toucher au .wslconfig ou à ~/.hermes/config.yaml, une sauvegarde complète de la distribution ne coûte qu'une commande. wsl --export génère une archive de tout le système de fichiers Ubuntu, agent compris :

Copierwsl --export Ubuntu ubuntu-backup.tar

En cas de mauvaise manipulation, wsl --unregister Ubuntu puis wsl --import Ubuntu C:\WSL\Ubuntu ubuntu-backup.tar restaurent l'état exact sauvegardé. Comptez quelques minutes pour l'export selon la taille du disque — largement rentabilisées la première fois qu'une modification de configuration tourne mal.

Si vous découvrez seulement maintenant ce qu'est réellement Hermes Agent, notre guide complet répond aux questions de fond avant même de parler installation. Et si vous hésitez entre une installation locale sur votre machine Windows et un serveur dédié, notre comparatif des offres VPS détaille les deux options avec des coûts réels.

WSL2 ou VPS Linux : lequel choisir pour un usage sérieux ?¶

WSL2 convient très bien pour développer, tester, ou faire tourner votre agent quand votre PC est allumé. Pour un usage sérieux — un agent qui doit répondre 24 h/24, même PC éteint — WSL2 n'est pas la bonne cible : il s'arrête avec Windows. Un VPS Linux dédié devient alors nécessaire.