Installer Hermes Agent sur macOS

Introduction

Ce guide detaille l'installation de Hermes Agent sur macOS, que vous utilisiez un Mac avec processeur Apple Silicon (M1, M2, M3, M4) ou Intel. 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: macOS est souvent livre avec une version ancienne de Python. Installez une version recente via Homebrew: brew install python@3.12
• pip a jour: python3 -m pip install --upgrade pip
• git: installe via Xcode Command Line Tools (xcode-select --install) ou Homebrew (brew install git)
• Un terminal (Terminal.app, iTerm2, etc.) 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

Note sur Apple Silicon

Hermes Agent fonctionne nativement sur Apple Silicon (M1/M2/M3/M4). Aucune configuration supplementaire n'est necessaire. Les performances sont optimales avec Python 3.11+ installe via Homebrew, qui fournit des binaires compiles pour arm64.

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 ~/.zshrc (le shell par defaut sur macOS):

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 Windows avec WSL2