Installer Hermes Agent sur Windows avec WSL2

Introduction

Hermes Agent fonctionne sur Windows via le sous-systeme Linux WSL2 (Windows Subsystem for Linux). Cette approche offre un environnement Linux complet et performant, sans quitter Windows. Ce guide couvre l'installation de WSL2 puis celle de Hermes Agent.

Prerequis

• Windows 10 version 2004 ou superieure, ou Windows 11
• Droits administrateur pour installer WSL2 (une seule fois)
• Acces Internet

Etape 1: installer WSL2

Ouvrez PowerShell en tant qu'administrateur et executez:

wsl --install

Cette commande installe WSL2 avec Ubuntu par defaut. Redemarrez votre machine si demande.

Apres le redemarrage, une fenetre Ubuntu s'ouvre. Creez votre nom d'utilisateur et mot de passe Linux.

Pour verifier que WSL2 est bien actif:

wsl --version

Etape 2: preparer l'environnement Linux

Dans votre terminal Ubuntu (WSL2), mettez a jour les paquets et installez les prerequis:

sudo apt update
sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv git

Verifiez la version de Python:

python3 --version

Vous devez voir Python 3.10 ou superieur.

Etape 3: installer Hermes Agent

La procedure est identique a l'installation Linux standard:

# Creer un environnement virtuel
python3 -m venv ~/hermes-venv

# Activer l'environnement
source ~/hermes-venv/bin/activate

# Installer Hermes Agent
pip install hermes-agent

# Verifier l'installation
hermes doctor

Etape 4: premier demarrage

Lancez l'assistant de configuration:

hermes setup

Puis votre premiere conversation:

hermes chat

Acceder aux fichiers Windows depuis WSL2

Vos fichiers Windows sont accessibles depuis WSL2 dans /mnt/c/. Par exemple, votre dossier Documents est dans /mnt/c/Users/VotreNom/Documents/.

Pour travailler sur un projet Windows depuis Hermes Agent, naviguez vers le dossier correspondant avant de lancer hermes chat:

cd /mnt/c/Users/VotreNom/mon-projet
hermes chat

Probleme frequent: WSL2 ne trouve pas hermes

Si la commande hermes n'est pas reconnue, verifiez que:

1. Vous etes bien dans le terminal WSL2 (Ubuntu), pas dans PowerShell
2. L'environnement virtuel est active (source ~/hermes-venv/bin/activate)

Pour un acces permanent, ajoutez a votre ~/.bashrc:

export PATH="$HOME/hermes-venv/bin:$PATH"

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• Depot NousResearch/hermes-agent, commit b4f8c491 (https://github.com/NousResearch/hermes-agent)
• CLI commands reference (https://hermes-agent.nousresearch.com/docs/reference/cli-commands)
• Platform Support (https://hermes-agent.nousresearch.com/docs/getting-started/platform-support)

Liens internes proposes

• Installer Hermes Agent
• Premiers pas
• Depannage
• Installer sur Linux
• Installer sur macOS