Installer Hermes Agent et lancer votre premier agent

Ce tutoriel vous prend 30 minutes. À la fin, vous avez un agent IA qui tourne sur votre machine, connecté à un modèle, et vous lui avez déjà parlé.

Commencer l'installation →

Prérequis

  • Un terminal ouvert
  • Une connexion internet
  • 5 minutes devant vous pour l'installation
  • 20 minutes pour la configuration et le premier échange

Étape 1 : Installer Hermes Agent

Ouvrez un terminal et lancez :

Linux, macOS, WSL2, Android (Termux) :

bash

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (PowerShell) :

powershell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Ce que vous devez voir : le script télécharge les dépendances, installe Hermes Agent, et vous confirme que tout est prêt.

Si vous préférez une interface graphique, téléchargez Hermes Desktop qui installe à la fois l'application de bureau et la CLI.

Étape 2 : Configurer un modèle

Votre agent a besoin d'un cerveau. Le plus simple : passer par Nous Portal.

bash

hermes setup --portal

Cette commande ouvre une authentification OAuth dans votre navigateur. Vous vous connectez, vous autorisez, et c'est fait. Votre agent est connecté à un modèle et aux outils web, image, TTS et navigateur.

Alternatives si vous ne voulez pas passer par Nous Portal :

  • OpenRouter : créez un compte sur openrouter.ai, récupérez votre clé API, ajoutez-la dans ~/.hermes/.env sous OPENROUTER_API_KEY=votre-clé
  • OpenAI : même principe avec OPENAI_API_KEY=votre-clé
  • Anthropic : ANTHROPIC_API_KEY=votre-clé
  • Modèle local : consultez le guide LLM local sur Mac ou utilisez Ollama

Quel modèle choisir ?

Si vous débutez, ne vous compliquez pas la vie. Prenez le modèle par défaut proposé par Nous Portal. Il est optimisé pour Hermes Agent.

Si vous voulez choisir vous-même, voici un repère simple :

  • Usage quotidien, budget serré : un modèle léger type Claude Haiku ou GPT-4o-mini. Rapide, économique, suffisant pour la plupart des tâches
  • Tâches complexes, code, raisonnement : un modèle plus lourd type Claude Sonnet ou GPT-4o. Plus lent, plus cher, mais meilleur sur les problèmes difficiles
  • Confidentialité maximale : un modèle local via Ollama. Gratuit, rien ne sort de votre machine, mais la qualité dépend de votre matériel

Vous pourrez changer de modèle à tout moment avec hermes model.

Comprendre le fichier de configuration

Après le setup, jetez un oeil à ~/.hermes/config.yaml. C'est le fichier qui contrôle tout. Les sections principales :

yaml

model: "anthropic/claude-sonnet-4"  # votre modèle par défaut
toolsets: ["terminal", "file", "web"]  # les outils activés

Ne modifiez rien pour l'instant. Savoir que ce fichier existe et où il se trouve vous sera utile plus tard, quand vous voudrez activer Telegram, ajouter un serveur MCP, ou changer de modèle.

Étape 3 : Lancer votre premier échange

bash

hermes chat

Vous êtes maintenant face à votre agent. Tapez quelque chose de simple :

prompt

Bonjour. Quel modèle utilises-tu et quels outils sont disponibles ?

L'agent répond. Il vous dit quel modèle tourne, et liste les outils qu'il a à disposition (terminal, web, fichiers, etc.).

Félicitations. Votre premier agent est vivant.

Étape 4 : Vérifier que tout fonctionne

Testez trois capacités de base :

1. L'agent peut chercher sur le web :

prompt

Cherche les dernières actualités sur Hermes Agent et résume en 3 lignes.

2. L'agent peut manipuler des fichiers :

prompt

Crée un fichier test.txt dans le dossier courant avec la date du jour dedans.

3. L'agent se souvient de vous :

prompt

Retiens que je m'appelle [votre prénom] et que je travaille sur [votre projet].

Quittez la session (/quit ou Ctrl+C), relancez hermes chat, et demandez :

prompt

Qui suis-je et sur quoi je travaille ?

Si l'agent répond correctement, la mémoire fonctionne.

Étape 5 : Connecter l'agent à Telegram (optionnel mais recommandé)

Un agent dans un terminal, c'est bien. Un agent qui vous répond sur votre téléphone, c'est mieux.

  1. Créez un bot Telegram via @BotFather
  2. Récupérez le token
  3. Ajoutez dans ~/.hermes/config.yaml :
yaml

messaging:
  telegram:
    enabled: true
    token: "votre-token-telegram"
  1. Redémarrez Hermes : hermes chat (le gateway se lance automatiquement)

Votre agent est maintenant joignable sur Telegram. Envoyez-lui un message.

Problèmes fréquents

"command not found: hermes"

Le script d'installation n'a pas ajouté Hermes à votre PATH. Fermez et rouvrez votre terminal, ou ajoutez export PATH="$HOME/.hermes/bin:$PATH" à votre .bashrc ou .zshrc.

"No provider configured"

Vous n'avez pas configuré de modèle. Relancez hermes setup --portal ou ajoutez une clé API dans ~/.hermes/.env.

L'agent ne répond pas sur Telegram

Vérifiez que le token est correct, que le bot n'est pas bloqué, et que le gateway est bien lancé (visible dans les logs au démarrage de hermes chat).

"Rate limit" ou erreur 429

Votre fournisseur de modèle limite le nombre de requêtes. Passez à un abonnement payant ou changez de fournisseur.

Et maintenant ?

Votre agent tourne. Voici la suite logique :

Le parcours de formation complet → Le guide de référence → Le lab avancé →