Installer Hermes Agent sur Linux

Introduction

Ce guide detaille l'installation de Hermes Agent sur une distribution Linux. La procedure est identique pour Debian, Ubuntu, Fedora, Arch Linux et la plupart des autres distributions. L'installation se fait sans droits administrateur, dans un environnement virtuel Python.

Prerequis

Avant de commencer, assurez-vous d'avoir:

• Python 3.10 ou superieur: python3 --version
• pip a jour: python3 -m pip install --upgrade pip
• git: sudo apt install git (Debian/Ubuntu) ou sudo dnf install git (Fedora)
• Un terminal avec acces Internet

Installation

Methode 1: installation via pip (recommandee)

# 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

Methode 2: installation depuis le depot Git

# Cloner le depot
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Installer en mode developpement
pip install -e .

# Verifier l'installation
hermes doctor

Verification

Apres l'installation, lancez hermes doctor pour un diagnostic complet. Cette commande verifie:

• La version de Python et sa compatibilite
• La presence de toutes les dependances
• L'integrite de la configuration
• L'acces aux providers configures

Si hermes doctor passe sans erreur, l'installation est operationnelle.

Premier demarrage

Une fois l'installation verifiee, lancez l'assistant de configuration:

hermes setup

Cet assistant interactif vous guide pour:

• Configurer un provider de modele (OpenRouter, Anthropic, Nous Portal, etc.)
• Saisir votre cle API
• Choisir un modele par defaut

Apres la configuration, lancez votre premiere conversation:

hermes chat

Probleme frequent: commande hermes introuvable

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

1. L'environnement virtuel est active (source ~/hermes-venv/bin/activate)
2. Le PATH inclut le dossier bin de l'environnement virtuel

Pour rendre la commande disponible en permanence, 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 macOS
• Installer sur Windows avec WSL2