Guide d'installation

Installer Hermes Agent sur macOS

Faites fonctionner Hermes Agent sur votre Mac en 30 à 60 minutes. Ce guide couvre l'installation, la configuration initiale et votre premier flux de travail local — aucune dépendance infonuagique requise.

Prérequis

  • macOS 14 (Sonoma) ou version ultérieure
  • Accès au terminal (Terminal.app, iTerm2 ou similaire)
  • Python 3.10+ installé (python3 --version pour vérifier)
  • Une clé API d'au moins un fournisseur de modèle (voir le guide des fournisseurs de modèles)
  • Environ 500 Mo d'espace disque libre

Étape 1 : Installer Hermes Agent

Ouvrez le terminal et exécutez :

# Créer le répertoire Hermes
mkdir -p ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent

# Cloner depuis GitHub
git clone https://github.com/NousResearch/hermes-agent.git .

# Configurer un environnement virtuel Python
python3 -m venv venv
source venv/bin/activate

# Installer
pip install -e .

Vérifiez que l'installation a fonctionné :

hermes --version

Étape 2 : Exécuter la configuration guidée

Hermes est livré avec un assistant de configuration qui vous guide à travers la configuration du modèle et du fournisseur :

hermes setup

L'assistant vous demandera :

  • Fournisseur : Choisissez OpenRouter (départ le plus facile), Anthropic, OpenAI ou un chemin de modèle local
  • Modèle : Choisissez un modèle par défaut — Claude Haiku ou GPT-4o mini sont de bons points de départ
  • Clé API : Collez votre clé (stockée dans ~/.hermes/.env avec des permissions restreintes)

Si vous sautez la configuration, Hermes vous la demandera lors de la première exécution.

Étape 3 : Lancer votre première conversation

# Assurez-vous que l'environnement virtuel est actif
source ~/.hermes/hermes-agent/venv/bin/activate

# Démarrer une session interactive
hermes

Essayez une requête simple pour vérifier que tout fonctionne :

Quelle est la date et l'heure actuelles sur mon Mac?

Hermes devrait répondre. En cas d'erreur, vérifiez votre clé API dans ~/.hermes/.env et que votre fournisseur/modèle sont correctement configurés dans ~/.hermes/config.yaml.

Étape 4 : Configurer votre premier outil

Hermes est livré avec des outils intégrés. Activez-en un pour tester un vrai flux de travail :

# Lister les outils disponibles
hermes tools

# Essayer l'outil de fichiers — demandez à Hermes de lire un fichier
hermes
> Lis ~/Documents et dis-moi ce qu'il y a dedans

Outils de départ courants pour les utilisateurs Mac :

  • Outils de fichiers : Lire/écrire des fichiers locaux
  • Apple Notes : Lire et créer des notes (voir le guide Apple Notes)
  • Terminal : Exécuter des commandes shell (à utiliser avec prudence — Hermes demande avant d'exécuter des commandes)
  • Outils Web : Rechercher sur le Web et récupérer des pages

Étape 5 : Ajouter un flux de travail récurrent

Une fois à l'aise, configurez une tâche cron qui s'exécute quotidiennement :

hermes cron create \
  --name "daily-brief" \
  --schedule "0 8 * * *" \
  --prompt "Résume les actualités en IA et automatisation pertinentes pour les PME canadiennes. Garde ça sous 300 mots."

Vérifiez vos tâches planifiées :

hermes cron list

Conseils spécifiques à macOS

  • Agent en arrière-plan : Exécutez hermes gateway start pour garder Hermes en cours d'exécution comme service d'arrière-plan accessible depuis les plateformes de messagerie.
  • Lancer au démarrage : Ajoutez hermes gateway start à un fichier plist launchd ou exécutez-le depuis un terminal qui reste ouvert.
  • Apple Silicon : Hermes Agent fonctionne nativement sur les puces de série M. Python 3.10+ depuis Homebrew ou python.org est recommandé.
  • Permissions : Lorsque Hermes accède à Calendrier, Rappels ou Notes via AppleScript, macOS peut demander une permission. Accordez-la pour les outils que vous souhaitez utiliser.

Prochaines étapes

Votre Mac dispose maintenant d'un agent IA fonctionnel. À partir d'ici :

macOS seulement. Ce guide est destiné aux utilisateurs Mac. Pour Linux, consultez le guide d'auto-hébergement. Pour Windows, utilisez WSL.