Guides Hermes Agent : installation, configuration et démarrage

Guides Hermes Agent : installation, configuration et démarrage

Cette page fait partie du guide pratique francophone consacré à Hermes Agent. Elle répond à l'intention de recherche : trouver le bon tutoriel.

Le contenu s'appuie sur la documentation officielle Hermes Agent associée à cette page. L'objectif n'est pas de remplacer la documentation de Nous Research, mais de fournir une lecture claire en français, structurée pour aller vite, avec un maillage logique vers les pages complémentaires du même site.

À retenir

• Sujet principal : guide hermes agent.
• Type de page : hub.
• Cluster : guides.
• Source canonique : documentation officielle Hermes Agent.
• Aucun lien vers l'autre domaine n'est utilisé dans cette page.

Comment utiliser cette section

Cette section regroupe les pages du cluster guides. Commencez par cette page si vous voulez comprendre le sujet dans son ensemble, puis ouvrez les guides détaillés selon votre contexte.

Chaque page interne contient des liens vers les prérequis, les pages voisines et les suites logiques. Le but est de créer un parcours utile, pas une liste brute de pages SEO.

Base officielle

Hermes Agent can do a lot — CLI assistant, Telegram/Discord bot, task automation, RL training, and more. This page helps you figure out where to start and what to read based on your experience level and what you're trying to accomplish.

If you haven't installed Hermes Agent yet, begin with the Installation guide and then run through the Quickstart. Everything below assumes you have a working installation.

First-time users almost always want hermes setup --portal — one OAuth covers a model plus the four Tool Gateway tools (search/image/TTS/browser). See Nous Portal.

How to Use This Page

• Know your level? Jump to the experience-level table and follow the reading order for your tier.
• Have a specific goal? Skip to By Use Case and find the scenario that matches.
• Just browsing? Check the Key Features table for a quick overview of everything Hermes Agent can do.

By Experience Level

• Level — Goal — Recommended Reading — Time Estimate
• Beginner — Get up and running, have basic conversations, use built-in tools — Installation → Quickstart → CLI Usage → Configuration — ~1 hour
• Intermediate — Set up messaging bots, use advanced features like memory, cron jobs, and skills — Sessions → Messaging → Tools → Skills → Memory → Cron — ~2–3 hours
• Advanced — Build custom tools, create skills, train models with RL, contribute to the project — Architecture → Adding Tools → Creating Skills → Contributing — ~4–6 hours

By Use Case

Pick the scenario that matches what you want to do. Each one links you to the relevant docs in the order you should read them.

"I want a CLI coding assistant"

Use Hermes Agent as an interactive terminal assistant for writing, reviewing, and running code.

1. Installation
2. Quickstart
3. CLI Usage
4. Code Execution
5. Context Files
6. Tips & Tricks

Pass files directly into your conversation with context files. Hermes Agent can read, edit, and run code in your projects.

"I want a Telegram/Discord bot"

Deploy Hermes Agent as a bot on your favorite messaging platform.

1. Installation
2. Configuration
3. Messaging Overview
4. Telegram Setup
5. Discord Setup
6. Voice Mode
7. Use Voice Mode with Hermes
8. Security

For full project examples, see:

• Daily Briefing Bot
• Team Telegram Assistant

"I want to automate tasks"

Schedule recurring tasks, run batch jobs, or chain agent actions together.

1. Quickstart
2. Cron Scheduling
3. Batch Processing
4. Delegation
5. Hooks

Cron jobs let Hermes Agent run tasks on a schedule — daily summaries, periodic checks, automated reports — without you being present.

"I want to build custom tools/skills"

Extend Hermes Agent with your own tools and reusable skill packages.

1. Plugins
2. Build a Hermes Plugin
3. Tools Overview
4. Skills Overview
5. MCP (Model Context Protocol)
6. Architecture
7. Adding Tools
8. Creating Skills

For most custom tool creation, start with plugins. The Adding Tools

page is for built-in Hermes core development, not the usual user/custom-tool path.

"I want to train models"

Use reinforcement learning to fine-tune model behavior with Hermes Agent's RL training pipeline (powered by Atropos).

1. Quickstart
2. Configuration
3. Atropos RL Environments (external)
4. Provider Routing
5. Architecture

RL training works best when you already understand the basics of how Hermes Agent handles conversations and tool calls. Run through the Beginner path first if you're new.

"I want to use it as a Python library"

Integrate Hermes Agent into your own Python applications programmatically.

1. Installation
2. Quickstart
3. Python Library Guide
4. Architecture
5. Tools
6. Sessions

Key Features at a Glance

Not sure what's available? Here's a quick directory of major features:

• Feature — What It Does — Link
• Tools — Built-in tools the agent can call (file I/O, search, shell, etc.) — Tools
• Skills — Installable plugin packages that add new capabilities — Skills
• Memory — Persistent memory across sessions — Memory
• Context Files — Feed files and directories into conversations — Context Files
• MCP — Connect to external tool servers via Model Context Protocol — MCP
• Cron — Schedule recurring agent tasks — Cron
• Delegation — Spawn sub-agents for parallel work — Delegation
• Code Execution — Run Python scripts that call Hermes tools programmatically — Code Execution
• Browser — Web browsing and scraping — Browser
• Hooks — Event-driven callbacks and middleware — Hooks
• Batch Processing — Process multiple inputs in bulk — Batch Processing
• Provider Routing — Route requests across multiple LLM providers — Provider Routing

What to Read Next

Based on where you are right now:

• Just finished installing? → Head to the Quickstart to run your first conversation.
• Completed the Quickstart? → Read CLI Usage and Configuration to customize your setup.
• Comfortable with the basics? → Explore Tools, Skills, and Memory to unlock the full power of the agent.
• Setting up for a team? → Read Security and Sessions to understand access control and conversation management.
• Ready to build? → Jump into the Developer Guide to understand the internals and start contributing.
• Want practical examples? → Check out the Guides section for real-world projects and tips.

You don't need to read everything. Pick the path that matches your goal, follow the links in order, and you'll be productive quickly. You can always come back to this page to find your next step.

---

Points de vigilance

• Vérifiez toujours la version active de Hermes Agent avant d'appliquer une commande ou une configuration.
• Ne collez pas de clé API dans un chat public ou dans une page visible.
• Gardez les secrets dans les fichiers ou gestionnaires prévus pour cela.
• Si une fonctionnalité dépend d'un provider, d'un plugin ou d'une plateforme de messagerie, vérifiez que le composant est bien activé dans votre profil.
• Pour une installation de production, testez d'abord le flux complet sur une machine ou un profil isolé.

Exemple de parcours logique

1. Lire la page courante pour comprendre guide hermes agent.
2. Ouvrir le hub parent du cluster guides.
3. Passer ensuite aux pages complémentaires proposées dans « À lire ensuite ».
4. Revenir à la documentation officielle si vous avez besoin du détail exact ou d'une commande récemment modifiée.

FAQ rapide

Cette page remplace-t-elle la documentation officielle ?

Non. Elle sert de guide francophone structuré. Le lien vers la source officielle est disponible en bas de page.

Les commandes sont-elles garanties à jour ?

Elles sont basées sur la documentation officielle récupérée au moment de la génération. Pour un usage critique, vérifiez toujours la page officielle liée en bas.

Pourquoi autant de liens internes ?

Hermes Agent est un système modulaire. L'installation, les providers, les outils, la mémoire, les skills, la sécurité et les plateformes se répondent. Le maillage interne aide à suivre ce chemin sans tomber sur des pages orphelines.

Comment lire cette page efficacement

Commencez par identifier votre situation : installation locale, usage serveur, configuration d'un provider, connexion à une plateforme, automatisation ou usage développeur. Hermes Agent est modulaire : une fonctionnalité dépend souvent d'un autre bloc. Par exemple, une automatisation cron devient réellement utile quand le modèle, les outils et le canal de livraison sont déjà configurés.

Pour éviter les erreurs, avancez toujours dans cet ordre : vérifier le prérequis, appliquer la commande ou la configuration, relancer une session si nécessaire, puis tester avec une action simple. Si le résultat ne correspond pas à ce qui est attendu, revenez à la page officielle liée en bas et comparez la version de votre installation avec la documentation actuelle.

Bonnes pratiques

• Garder une configuration minimale tant que le premier test n'est pas validé.
• Ajouter les outils et plateformes progressivement.
• Séparer les profils si plusieurs usages doivent cohabiter.
• Documenter les procédures répétées dans des skills plutôt que dans de longs prompts.
• Vérifier les droits, tokens et scopes avant d'accuser le modèle ou Hermes Agent.
• Relancer la session après un changement de configuration important.

Erreurs fréquentes

La première erreur consiste à activer trop de choses trop tôt. Plus la configuration initiale est large, plus le diagnostic devient difficile. La deuxième erreur consiste à confondre un problème de provider avec un problème Hermes : si le modèle ne répond pas, vérifiez d'abord l'authentification, la clé API, le nom du modèle et le provider sélectionné. La troisième erreur consiste à oublier que certains changements ne s'appliquent qu'à une nouvelle session ou après redémarrage du gateway.

Suite recommandée

Après cette page, ouvrez les liens internes proposés dans la section « À lire ensuite ». Ils ont été choisis pour suivre une progression logique dans le même site, sans envoyer vers l'autre domaine.

Approfondissement (1)

Hermes Agent est conçu pour évoluer. Les commandes et configurations présentées ici peuvent changer avec les versions. Pour rester à jour, consultez régulièrement la documentation officielle liée en bas de page, et testez chaque mise à jour dans un environnement isolé avant de la déployer en production.

Les compétences avancées — orchestration multi-agents, skills personnalisées, intégrations MCP, automatisation cron — s'ajoutent progressivement. Ne tentez pas de tout configurer en une seule session. Construisez votre configuration brique par brique, en validant chaque étape.

Si vous rencontrez un comportement inattendu, vérifiez d'abord les points les plus simples : version installée, provider sélectionné, clés API valides, profil actif. La majorité des problèmes viennent d'un de ces quatre points. Seulement après les avoir éliminés, explorez les logs, les skills et la configuration avancée.

Pour aller plus loin, explorez les sections voisines du site. Chaque page est conçue pour répondre à une intention précise, et le maillage interne permet de construire une compréhension complète sans sauter d'étape. La documentation officielle reste la référence pour les détails techniques exacts, les signatures de commande et les valeurs de configuration.

Bonnes pratiques complémentaires : gardez un profil de test distinct du profil de production, sauvegardez vos configurations avant chaque changement majeur, et notez les commandes qui fonctionnent dans un fichier de référence local. Ces réflexes simples évitent la plupart des situations de blocage.