Quelle commande utiliser après l'installation ?

Lancez `hermes setup` pour configurer le modèle et les principaux réglages, puis testez un chat court.

Faut-il connecter Telegram immédiatement ?

Non. Validez d'abord le fonctionnement local ; un canal supplémentaire complique le diagnostic si la base n'est pas stable.

Où vérifier les commandes actuelles ?

La documentation officielle Hermes Agent et l'aide de la CLI sont les références à consulter avant de copier une configuration.

Installer Hermes Agent : tutoriel du premier démarrage

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é.

Pas de théorie. Que des étapes, du code, et le résultat attendu à chaque fois.

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) :


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

Windows (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.


hermes setup
hermes model
hermes doctor

hermes setup ouvre l'assistant de configuration, hermes model permet de choisir ou modifier le provider et hermes doctor contrôle les dépendances et la configuration. Suivez les options affichées par votre version plutôt que de recopier un ancien fichier de configuration.

Alternatives si vous ne voulez pas passer par Nous Portal :

OpenRouter : configurez une clé via l'assistant ou la variable OPENROUTER_API_KEY
OpenAI ou Anthropic : utilisez hermes auth ou la méthode proposée par hermes model selon le provider
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 la configuration

Les réglages vivent dans le dossier Hermes du profil actif. Utilisez hermes config, hermes config path et hermes config check pour les lire et les vérifier avant toute modification manuelle. Les profils isolent leurs modèles, leurs sessions, leurs skills et leur mémoire : contrôlez toujours le profil actif avant de diagnostiquer un réglage ignoré.

Étape 3 : Lancer votre premier échange


hermes chat

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


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 :


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

2. L'agent peut manipuler des fichiers :


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

3. L'agent se souvient de vous :


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 :


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.

Créez un bot Telegram via @BotFather
Conservez le token dans le gestionnaire de secrets ou le fichier d'environnement du bon profil
Lancez hermes gateway setup et choisissez Telegram
Vérifiez avec hermes gateway status, puis démarrez ou redémarrez le gateway

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, puis hermes model et hermes doctor.

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 :

Sources : Documentation officielle Hermes Agent, Guide d'installation, Quickstart.

Dernière mise à jour : juillet 2026.

Installer Hermes Agent et lancer votre premier agent