Hermes Agent + Obsidian : le brancher sans être dev

En résumé

• Hermes Agent lit et écrit dans un vault Obsidian sans plugin : un vault est un dossier de fichiers texte, et Hermes sait travailler sur des fichiers.
• La mémoire intégrée de Hermes est minuscule (deux petits fichiers). Le vault sert à tout ce qui ne tient pas dedans : vos projets, vos clients, vos décisions.
• Si Hermes tourne sur un serveur, le vault doit s'y trouver aussi. Chez moi, c'est GitHub qui fait le lien entre mon ordinateur et le serveur, avec un envoi automatique toutes les 30 minutes.
• Comptez environ 39 € par mois : 20 € d'abonnement ChatGPT, 19 € de serveur. Obsidian, GitHub et Discord sont gratuits pour cet usage.
• L'ordre compte : rangez vos notes d'abord, branchez l'agent ensuite.

Mémoire de Hermes ou vault Obsidian : qui retient quoi

On lit partout que Hermes « se souvient de tout ». C'est vrai, mais dans une limite que peu de guides précisent.

La mémoire intégrée de Hermes tient dans deux fichiers. D'après la documentation officielle, MEMORY.md est plafonné à 2 200 caractères et USER.md à 1 375 caractères. C'est à peu près une page de texte au total. Hermes y note vos préférences, votre façon de travailler, quelques faits sur son environnement. Ces deux fichiers sont relus au début de chaque conversation.

Une page ne suffit pas pour contenir le suivi de vos clients, vos notes de lecture ou l'historique d'un projet. C'est le rôle du vault : des centaines de notes que Hermes ne charge pas en entier, mais dans lesquelles il va chercher quand vous le lui demandez.

La distinction a une conséquence pratique. Si vous arrêtez Hermes demain, votre vault reste entier et lisible. C'est ce que j'appelle une mémoire qu'on possède.

Avant de brancher : ranger le vault

Un agent posé sur des notes en vrac ne les range pas. Il cherche dans le désordre, et il en ajoute.

Avant de connecter quoi que ce soit, il faut que vous sachiez vous-même où se trouve une information. Mon vault suit une organisation simple : une Inbox pour ce qui arrive, un journal quotidien, des projets, des responsabilités durables, des ressources et des archives.

Le dossier le plus important pour l'agent est l'Inbox. C'est le seul endroit où il écrit librement chez moi. Tout le reste demande une instruction explicite.

Hermes est arrivé dans un vault où je savais déjà me repérer sans lui. Les captures non triées avaient leur dossier, chaque journée avait sa note, et le reste suivait une organisation proche de PARA. Le jour du branchement, la question « où Hermes a-t-il le droit d'écrire ? » avait donc une réponse toute prête : l'Inbox.

Avec un vault vide, je ne commencerais pas par l'agent. Je prendrais mes notes un temps dans une seule Inbox et une note du jour, pour repérer où je perds de l'information. La structure, la sauvegarde et la revue de la semaine viendraient ensuite. L'agent en dernier.

J'ai détaillé la méthode dans Organiser avant d'automatiser : la méthode en cinq temps.

Les façons de connecter Hermes à Obsidian

Il existe plusieurs voies. Pour quelqu'un qui débute, une seule compte.

La voie simple : la compétence Obsidian fournie avec Hermes. Hermes est livré avec une compétence (« skill ») qui lit, liste, cherche, crée et complète des notes directement dans le dossier du vault. Aucun plugin Obsidian n'est nécessaire. On lui indique où se trouve le vault avec un réglage nommé OBSIDIAN_VAULT_PATH, placé dans le fichier ~/.hermes/.env. Sans ce réglage, Hermes cherche dans ~/Documents/Obsidian Vault.

Les autres voies (plugins communautaires, couches de mémoire à installer) ajoutent des fonctions, et autant de pièces à entretenir. Je conseille de commencer par la voie simple et de n'ajouter une pièce que le jour où un besoin précis la justifie.

Le branchement pas à pas, avec Hermes sur un serveur

Le cas le plus courant pose une difficulté : Hermes tourne sur un serveur loué (un VPS), alors que vos notes sont sur votre ordinateur. Hermes ne peut lire que les fichiers présents sur sa propre machine. Il faut donc une copie du vault sur le serveur, tenue à jour dans les deux sens.

Chez moi, cette copie passe par GitHub. Voici le montage.

1. Le vault devient un dépôt GitHub privé. Un dépôt est un dossier dont chaque modification est enregistrée et datée.
2. Sur mon ordinateur, le plugin Obsidian Git envoie et récupère les changements toutes les 30 minutes. Je n'ai aucune commande à taper. Il m'arrive aussi de lancer l'envoi à la main quand je veux que l'agent voie une note tout de suite.
3. Sur le serveur, le même dépôt est copié dans un dossier. C'est ce dossier que Hermes lit. Le serveur récupère les changements depuis GitHub à intervalle régulier, et une fois de plus juste avant de modifier quoi que ce soit dans le vault.
4. On indique à Hermes le chemin de ce dossier (le réglage OBSIDIAN_VAULT_PATH vu plus haut).
5. Quand Hermes écrit une note, il l'enregistre et l'envoie sur GitHub. Au prochain passage du plugin, elle apparaît dans Obsidian sur mon ordinateur.

Ce montage donne un avantage que la synchronisation classique n'a pas : un historique. Chaque modification de l'agent est datée et peut être annulée. Si Hermes modifie une note que vous vouliez garder telle quelle, vous revenez à la version précédente.

Trois demandes pour vérifier que ça marche

Ne passez pas à l'usage quotidien avant d'avoir réussi ces trois tests, dans cet ordre.

1. Lecture. « Liste les dossiers à la racine de mon vault. » Si la réponse correspond à ce que vous voyez dans Obsidian, Hermes regarde au bon endroit.
2. Recherche. « Retrouve la note où je parle de [un sujet précis]. » Vérifiez qu'il cite une note qui existe, et pas un résumé plausible.
3. Écriture. « Crée dans l'Inbox une note de test avec la date du jour. » Attendez le prochain passage du plugin, puis ouvrez Obsidian : la note doit y être.

Ajoutez un quatrième test, que presque personne ne fait : demandez-lui quelque chose qu'il n'a pas le droit de faire, par exemple supprimer une note. Un système bien réglé refuse ou vous demande une validation.

Trois usages d'indépendant au quotidien

Le premier usage est le mien. Les deux suivants sont des exemples illustratifs : les noms, les demandes et les résultats sont reconstitués.

Capturer un lien. Un article repéré sur mon téléphone part dans Discord, sans que j'ouvre Obsidian. Hermes va lire la page, rédige quelques lignes de synthèse et dépose le tout dans l'Inbox, avec l'adresse d'origine et la date. Il me répond en indiquant l'emplacement de la note. Elle attend là jusqu'à ma revue de la semaine : vingt à trente minutes pendant lesquelles je garde, je relie ou je jette.

Préparer un rendez-vous. « Résume mes trois derniers échanges avec Claire et la décision prise en mai. » Hermes va chercher les notes du projet et rend une demi-page, avec le nom des notes utilisées.

Reprendre un projet. « Où en suis-je sur l'offre atelier, et qu'est-ce qui reste à trancher ? » La réponse vaut ce que valent vos notes : si la dernière décision n'a jamais été écrite, Hermes ne peut pas la deviner.

Les erreurs fréquentes

Je n'ai pas eu de panne sur mon installation. Les erreurs ci-dessous sont celles que signalent le plus souvent la documentation et les autres guides.

• Hermes ne trouve pas le vault. Le chemin indiqué n'est pas le bon. Demandez-lui de lister le dossier qu'il voit réellement, et comparez.
• Hermes est installé dans un conteneur et ne voit pas le dossier. Un conteneur est une boîte isolée du reste du serveur : le dossier du vault doit lui être explicitement rendu accessible.
• Il lit le vault dans le terminal, mais pas depuis Discord. Le service qui reçoit vos messages ne tourne pas avec le même profil que celui qui a accès au vault.
• Les réponses ralentissent et la consommation grimpe. Hermes lit trop de fichiers à la fois. Des dossiers par projet et des notes de synthèse courtes règlent le problème.
• Une sauvegarde qu'on n'a jamais restaurée. Voir une copie sur GitHub ne prouve pas qu'on sait reconstruire le système. C'est une correction que j'ai dû faire après ma première mise en place chez un client : je raconte les quatre dans Mise en place d'un agent IA : 4 corrections après livraison.

Garder la main

Brancher un agent sur ses notes, c'est lui donner un accès en écriture à sa mémoire de travail. Chez moi, la règle tient en trois lignes :

• Écriture libre : l'Inbox, et seulement l'Inbox.
• Sur demande explicite : modifier une note déjà classée.
• Jamais seul : publier, envoyer, supprimer, changer la configuration.

Le détail de cette organisation est dans Comment mon agent IA travaille avec Obsidian sans décider à ma place et dans Permissions d'un agent IA : comment décider ce qu'il peut faire ?.

Ce que ça coûte par mois

Il n'y a pas de facturation à l'usage dans ce montage : l'agent utilise l'abonnement ChatGPT, pas une clé d'API. C'est ce qui rend le coût prévisible.

Questions fréquentes

Faut-il installer un plugin Obsidian pour Hermes ?

Non. La compétence Obsidian de Hermes travaille directement sur les fichiers du vault. Le seul plugin que j'utilise est Obsidian Git, et il sert à la synchronisation, pas à Hermes.

Le vault remplace-t-il la mémoire de Hermes ?

Non, les deux se complètent. La mémoire intégrée retient qui vous êtes et comment vous travaillez. Le vault contient ce que vous savez.

Hermes peut-il modifier ou supprimer mes notes ?

Techniquement, il peut modifier tout fichier auquel il a accès. C'est pour cela qu'il faut des règles écrites, des accès limités et un historique qui permet de revenir en arrière.

Est-ce que ça marche depuis Discord ou un téléphone ?

Oui. Vous écrivez à Hermes depuis Discord, il travaille sur la copie du vault présente sur le serveur. Vous n'avez pas besoin d'avoir Obsidian ouvert.

Faut-il savoir coder ?

Non, mais il faut accepter de suivre des étapes dans un terminal et de vérifier chaque résultat. Aucune ligne de programme n'est à écrire.

Obsidian ou Notion ?

Obsidian stocke vos notes en fichiers texte sur votre machine, ce qui permet à Hermes de les lire sans intermédiaire. Notion garde les données sur ses serveurs et impose de passer par une connexion supplémentaire.

Pour aller plus loin

Ce montage est celui que j'utilise chaque jour, et celui que détaille ma formation, étape par étape, avec les fichiers de départ et les vérifications.

Voir la formation Système IA personnel (157 €)

Vous préférez ne rien installer ? Je peux mettre le système en place pour vous.