Premiers pas avec Hermes Agent

Introduction

Vous avez installe Hermes Agent. Cette page vous guide dans vos premiers echanges: lancer une conversation, executer une tache rapide, reprendre une session, choisir un modele et comprendre les bases de la securite.

L'objectif est de vous rendre operationnel en moins de 10 minutes.

Lancer sa premiere conversation

Ouvrez un terminal et tapez:

hermes chat

Vous entrez dans une session interactive. Hermes Agent vous repond, peut executer des commandes sur votre machine, lire et ecrire des fichiers, et utiliser les outils configures.

Pour quitter, tapez /quit ou Ctrl+C.

Premier exemple

Une fois dans la session, essayez:

Quels fichiers y a-t-il dans le dossier courant ? Resume leur contenu.

Hermes Agent va lister les fichiers, les lire, et vous fournir un resume. C'est un bon test pour verifier que tout fonctionne.

Mode one-shot: une tache, une reponse

Pour executer une tache sans session interactive, utilisez le mode one-shot:

hermes -z "Liste les 5 plus gros fichiers du dossier /var/log"

Le flag -z (ou --oneshot) envoie une instruction unique. Hermes Agent l'execute et affiche uniquement la reponse finale, sans interface interactive. Ce mode est ideal pour les scripts et l'automatisation.

Reprendre une session precedente

Hermes Agent conserve l'historique de vos sessions. Pour reprendre la derniere:

hermes -c

Pour reprendre une session specifique par son nom:

hermes -c "mon projet"

Pour voir la liste de toutes vos sessions:

hermes sessions list

Choisir un modele

Lors du premier demarrage, hermes setup vous a fait choisir un modele. Pour en changer:

hermes model

Cette commande ouvre un selecteur interactif. Vous pouvez aussi specifier un modele pour une session unique:

hermes chat --model anthropic/claude-sonnet-4

Les providers disponibles dependent de votre configuration. Les plus courants sont OpenRouter, Anthropic, Nous Portal et OpenAI.

Definir un dossier de travail

Hermes Agent travaille dans le dossier ou vous lancez la commande. Pour travailler sur un projet specifique:

cd /chemin/vers/mon-projet
hermes chat

L'agent aura acces aux fichiers de ce dossier. Vous pouvez aussi changer de dossier en cours de session avec la commande /workspace.

Securite: approbation des commandes

Par defaut, Hermes Agent vous demande confirmation avant d'executer une commande potentiellement dangereuse (ecriture hors du projet, commandes systeme sensibles, etc.).

Trois modes d'approbation sont disponibles:

• Smart (defaut): l'agent evalue le risque et demande confirmation pour les actions sensibles
• Manual: chaque commande necessite votre approbation
• Yolo (--yolo): aucune confirmation demandee, a utiliser avec precaution

Pour une session sans confirmation:

hermes chat --yolo

Questions couvertes

q-031: Comment lancer sa premiere conversation avec Hermes Agent ?

Ouvrez un terminal et tapez hermes chat. Vous entrez dans une session interactive. Tapez votre message et appuyez sur Entree. Hermes Agent repond et peut executer des actions. Pour quitter, utilisez /quit.

q-032: Comment executer une tache en mode one-shot avec Hermes Agent ?

Utilisez le flag -z (ou --oneshot): hermes -z "votre instruction". L'agent execute la tache et affiche uniquement la reponse finale. Ce mode est concu pour les scripts, les pipes et l'automatisation. Les outils, la memoire et les regles sont charges normalement.

q-033: Comment reprendre une session Hermes Agent precedente ?

Utilisez hermes -c pour reprendre la session la plus recente, ou hermes -c "nom" pour une session specifique. Vous pouvez aussi utiliser hermes --resume <session_id> avec l'identifiant exact. La commande hermes sessions list affiche l'historique complet.

q-034: Comment choisir un modele lors du premier demarrage ?

Lancez hermes setup pour l'assistant de configuration initiale, ou hermes model pour changer de modele a tout moment. Le selecteur interactif liste les modeles disponibles selon vos providers configures. Pour une session unique, utilisez hermes chat --model provider/modele.

q-035: Comment donner un dossier de travail a Hermes Agent ?

Placez-vous dans le dossier souhaite avec cd avant de lancer hermes chat. L'agent herite du repertoire de travail courant. En cours de session, utilisez /workspace pour changer de dossier. Les fichiers du projet sont automatiquement accessibles.

q-036: Comment autoriser ou refuser une commande dangereuse ?

Quand Hermes Agent detecte une commande a risque, il affiche la commande et attend votre reponse. Tapez y (yes) pour autoriser, n (no) pour refuser, ou a (always) pour autoriser toutes les commandes similaires dans cette session. Le mode par defaut est "smart": seules les commandes vraiment sensibles declenchent une demande.

q-037: Comment demander a Hermes Agent d'utiliser un outil precis ?

Decrivez ce que vous voulez faire, pas l'outil. Hermes Agent choisit le bon outil automatiquement. Par exemple, dites "telecharge cette page web" plutot que "utilise web_extract". Si vous voulez vraiment forcer un outil, mentionnez-le explicitement: "utilise l'outil web_search pour chercher...".

q-038: Comment lire les usages de tokens et le cout d'une session ?

Pendant une session, tapez /usage pour voir le nombre de tokens consommes et une estimation du cout. Utilisez /usage reset pour remettre les compteurs a zero. En mode one-shot, ajoutez --usage-file rapport.json pour sauvegarder les statistiques dans un fichier JSON.

q-039: Comment demarrer Hermes Agent en TUI plutot qu'en interface classique ?

Utilisez le flag --tui: hermes --tui. L'interface TUI (Text User Interface) offre une experience plus moderne avec des panneaux, des raccourcis clavier et une navigation amelioree. Pour en faire le mode par defaut, configurez display.interface: tui dans votre config.yaml.

q-040: Quelle premiere tache permet de verifier que Hermes Agent fonctionne vraiment ?

Demandez a Hermes Agent de lister et resumer les fichiers du dossier courant: "Liste les fichiers de ce dossier et donne un resume de leur contenu". L'agent va utiliser les outils search_files et read_file, ce qui valide que les outils de base, le modele et le terminal fonctionnent correctement.

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)
• Security guide (https://hermes-agent.nousresearch.com/docs/user-guide/security)

Liens internes proposes

• Installer Hermes Agent
• Configurer Hermes Agent
• Depannage
• Securite
• Modeles et providers