Hermes Agent · Claude

Monte ton assistant IA personnel, ton propre Jarvis

Un agent qui tourne chez toi, qui sait qui tu es, se sert de ta boîte mail et de ton agenda, et te répond sur Telegram ou à la voix. 9 étapes, zéro ligne de code.

Mot-clé : JARVIS Un week-end Débutant
En bref

Ce guide te fait monter un vrai assistant personnel en un week-end avec Hermes Agent, un agent open source et gratuit de Nous Research. Tu choisis le modèle (Claude, GPT ou Gemini), tu lui apprends qui tu es, tu le branches à ton mail, ton agenda et tes fichiers, puis tu lui parles depuis Telegram, à l'écrit ou à la voix.

Pour qui : ceux qui veulent un assistant qui fait le travail au lieu d'expliquer comment le faire, sans savoir programmer.

  1. La machine : ton ordi pour commencer, un serveur à 5 € par mois ensuite
  2. Le cerveau : ton modèle et ta clé API
  3. Installer Hermes Agent
  4. Lui apprendre qui tu es
  5. Le brancher à tes outils
  6. Mémoire longue avec Letta (optionnel)
  7. Lui écrire des skills
  8. Le sortir du terminal : Telegram et voix
  9. L'interface
ASTUCE
Le budget, sans enrobage : Hermes Agent ne coûte rien. Tu paies la consommation du modèle, quelques euros par mois en usage perso. Pour qu'il reste allumé en permanence, ajoute un petit serveur (VPS) autour de 5 € par mois. Tu peux très bien commencer sans.

Étape 1 · La machine

Commence sur ton ordinateur (Mac, Windows ou Linux) : le travail lourd est fait par le modèle dans le cloud, pas par ton processeur. Quand tout tourne et que tu veux y accéder tout le temps depuis ton téléphone, passe sur un VPS (Hetzner, Contabo, OVH), avec Ubuntu 22.04 ou plus récent et 2 Go de RAM. Sur Windows, WSL2 reste le chemin le plus éprouvé : ouvre PowerShell en administrateur, lance wsl --install, redémarre, puis utilise l'appli Ubuntu.

Commande 01Vérifie que tu as git et curl
git --version
curl --version

Étape 2 · Le cerveau

Choisis ton fournisseur et récupère ta clé API avant l'installation : Anthropic (console.anthropic.com > Settings > API Keys), OpenAI (platform.openai.com/api-keys), Google (aistudio.google.com/apikey) ou OpenRouter (openrouter.ai/keys), qui donne accès à des centaines de modèles avec une seule clé. Tous demandent de créditer le compte avant que la clé fonctionne.

ATTENTION
Avant de le laisser tourner, fixe un plafond de dépense mensuel dans la console de ton fournisseur. Créditer 10 € suffit largement pour un week-end de tests. Ta clé API ne se partage jamais et ne se met jamais en ligne.

Étape 3 · Installer Hermes Agent

Commande 02Installation (Mac, Linux, WSL2)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Commande 03Installation (Windows, PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
ATTENTION
L'étape que tout le monde oublie : ferme complètement ton terminal et rouvres-en un (ou lance source ~/.zshrc sur Mac, source ~/.bashrc sur Linux). Sans ça, tu récoltes un command not found.
Commande 04Configure, puis vérifie que ça tourne
hermes setup
hermes --version
hermes

hermes setup propose une configuration rapide, complète ou minimale : pour une première fois, prends la rapide ou la complète et colle ta clé de l'étape 2. Tape ensuite hermes et dis-lui bonjour : s'il te répond, tu as un agent. Si quelque chose coince, hermes doctor diagnostique seul ce qui manque.

Étape 4 · Lui apprendre qui tu es

Hermes range ce qu'il sait dans des fichiers texte du dossier ~/.hermes/ : SOUL.md (sa personnalité), memories/USER.md (ton profil, environ 1 400 caractères) et memories/MEMORY.md (ses notes, qu'il remplit seul). Le plus simple : raconte-lui qui tu es dans ta première conversation, il met ses fichiers à jour tout seul.

Code 05Ta première présentationRemplace les crochets par tes infos.
Je m'appelle [ton prénom] et je gère [ton activité].
Mes clients sont [type de client] et mes journées passent sur [tes tâches].
Parle-moi en français, direct, sans détour. Quand je te demande
quelque chose, donne-moi d'abord ton plan en 3 lignes et attends
mon feu vert avant d'agir.
ASTUCE
Plus tu es précis dans USER.md, moins tu auras à le corriger : tes horaires, tes trois priorités du mois, et surtout la liste des décisions qu'il n'a pas le droit de prendre sans te demander.

Étape 5 · Le brancher à tes outils

Le navigateur est inclus : il ouvre des sites, lit des pages et remplit des formulaires. Pour Gmail et Google Agenda, demande-lui simplement de t'aider à connecter Google Workspace : il te guide pour créer le projet Google Cloud, activer les API et autoriser l'accès. Il peut aussi lire tes fichiers, utiliser des serveurs MCP (Notion, bases de données), programmer des tâches et chercher sur le web.

Code 06À écrire dans Hermes
aide-moi à connecter mon compte Google Workspace
ATTENTION
Avant de connecter ta boîte mail : commence en lecture seule et garde l'approbation des commandes activée, pour qu'il te demande confirmation avant d'envoyer ou de supprimer quoi que ce soit. Pour aller plus loin, Hermes sait confiner son terminal dans Docker.

Étape 6 · Mémoire longue avec Letta (optionnel)

Hermes a déjà sa mémoire. Letta (l'ancien MemGPT) ajoute une mémoire avancée avec recherche sémantique. C'est l'étape la plus technique : elle demande Docker et une clé OpenAI, utilisée uniquement pour la recherche. Si c'est ta première fois, passe directement à l'étape 7.

Commande 07Lancer ton serveur Letta
docker run -d --name letta \
  -v ~/.letta/.persist/pgdata:/var/lib/postgresql/data \
  -p 8283:8283 \
  -e OPENAI_API_KEY="ta_cle_api" \
  letta/letta:latest

Étape 7 · Lui écrire des skills

Une skill est un dossier avec un fichier SKILL.md qui décrit une procédure réutilisable. Pioche dans le catalogue, ou écris la tienne : chaque skill devient une commande avec un slash, par exemple /devis. Tu peux aussi lui demander de transformer une tâche qu'il vient de réussir en skill.

Commande 08Le catalogue de skills
hermes skills browse
hermes skills search facture
hermes skills install auteur/skills/nom
Code 09Exemple de skill à toiÀ enregistrer dans ~/.hermes/skills/devis/SKILL.md
---
name: devis
description: À utiliser quand on demande de rédiger un devis ou une proposition commerciale. Suivre le modèle maison et les conditions tarifaires habituelles.
version: "1.0.0"
---

# Instructions
1. Demander le nom du client et le type de prestation
2. Partir du modèle rangé dans references/modele.md
3. Signaler les lignes qui s'écartent des conditions standard
ASTUCE
Les trois skills à monter en premier : ta proposition commerciale avec tes tarifs, le compte rendu que tu refais chaque semaine, et ton ton de voix pour répondre aux messages clients.

Étape 8 · Telegram et la voix

Dans Telegram, écris à @BotFather, envoie /newbot et garde le token qu'il te donne (ne le partage jamais). Écris ensuite à @userinfobot pour récupérer ton identifiant numérique : il garantit que toi seul peux parler à ton agent. WhatsApp, Discord, Slack et Signal suivent la même logique.

Commande 10Brancher Telegram
hermes gateway setup
hermes gateway start
hermes gateway status
Commande 11Ajouter la voix
pip install "hermes-agent[voice]"

Dans ~/.hermes/config.yaml, le moteur de voix par défaut est Edge : gratuit, sans clé, avec des voix françaises (par exemple fr-FR-DeniseNeural). ElevenLabs sonne mieux mais se facture à l'usage. Dans Hermes, /voice on active le micro et /voice tts la lecture à voix haute. Pour de vraies bulles vocales dans Telegram, installe ffmpeg.

ATTENTION
Garde l'appairage par identifiant activé. Sans lui, n'importe qui tombant sur ton bot pourrait donner des ordres à un agent qui a accès à tes mails et à tes fichiers.

Étape 9 · L'interface

Commande 12Le tableau de bord intégré
hermes dashboard
Code 13Ou ton propre écranÀ demander à Claude ou à ton agent.
Conçois un panneau de contrôle type HUD pour mon assistant personnel : état du système, 5 derniers messages, gros bouton d'enregistrement vocal, indicateurs de tâches en attente. Style sombre, minimaliste, une seule page.
ASTUCE
Et surtout, donne-lui un nom : ouvre SOUL.md et donne-lui un nom, un ton et une façon de te saluer. Trois lignes, et il cesse d'être un programme de plus sur ta machine.

Si ça bloque

command not found: hermes : tu n'as pas relancé le terminal. Ferme-le complètement et rouvres-en un, ou lance source ~/.zshrc.

401 invalid api key : la clé a été collée incomplète ou avec un espace. Génère-en une nouvelle et repasse par hermes setup. insufficient credits : recharge ton compte chez le fournisseur.

Le bot Telegram reste muet : lance hermes gateway status et vérifie que tu as mis ton identifiant numérique, pas ton pseudo. Pour tout le reste : hermes doctor, puis hermes update chaque semaine.

Les sources officielles

Télécharger le guide complet en PDF17 pages, avec les 7 erreurs courantes et les commandes de référence.

Cette ressource s'ouvre avec ton email

Laisse ton email une seule fois : tu débloques cette ressource et tout Le QG, et tu reçois La Matrice chaque semaine. Gratuit.

Questions fréquentes

Combien coûte un assistant IA personnel avec Hermes Agent ?

Hermes Agent est gratuit (licence MIT). Tu paies la consommation du modèle, quelques euros par mois en usage perso, et environ 5 € par mois si tu veux un serveur allumé en permanence. Fixe un plafond de dépense chez ton fournisseur.

Faut-il savoir coder ?

Non. Il faut copier des commandes dans un terminal, le guide explique chaque étape. En cas d'erreur, la commande hermes doctor diagnostique ce qui manque.

Quel modèle choisir ?

Claude, GPT ou Gemini avec ta propre clé API, ou OpenRouter pour accéder à des centaines de modèles avec une seule clé. Tu peux changer à tout moment avec hermes model.

La suite

À tester aussi