type: rapport projet: Hermes Agent date: 2026-09-18 statut: en_cours tags:
- ia
- agent
- setup
Rapport Hermes Agent Setup
| Projet | Hermes Agent (Nous Research) — agent IA open source auto-améliorant |
| Date | 2026-09-18 |
| Statut | ⏳ En cours — Phase 1 terminée, Phase 2 en attente du terminal hôte |
| Cible | Installation locale sur ma machine Fedora, en complément d’OpenClaw |
1. Setup & contraintes
- Machine : Fedora Linux (la même machine que le vault Obsidian).
- Limitation sandbox : j’agis dans le sandbox Flatpak d’Obsidian (
org.freedesktop.platform). Le sandbox partage mon vrai home (/home/sambasene) en lecture/écriture, mais il n’a pas :- ❌ De compilateur C++ (pas de
g++,clang++,cc,gcc,make,cmake) - ❌ De
sudo— impossible d’installer des paquets système (ex.dnf install gcc-c++) - ❌ De
systemctl— impossible d’enregistrer des services gateway - ✅ curl, bash, git, node — disponibles ; home accessible en écriture ; réseau OK
- ❌ De compilateur C++ (pas de
- Avertissement disque : seulement ~4,2 Go libres sur
/home(99 % plein) — Hermes a besoin de ~1,5–3 Go, à surveiller pendant l’installation.
2. Étapes chronologiques
Phase 1 — Tentative dans le sandbox (2026-09-18, depuis Claudian dans Obsidian)
- J’ai téléchargé et inspecté l’installeur officiel avant de l’exécuter (installation responsable) :
curl -sSL -o /tmp/hermes-install.sh https://hermes-agent.nousresearch.com/install.sh→ 3945 lignes- Vérifié : installation dans
~/.hermes, les installations root utilisent le layout FHS,sudon’est utilisé qu’opportunément pour git/outils de build, flags--skip-setup,--skip-browser,--skip-computer-useexistants.
- J’ai lancé l’installeur dans le sandbox :
bash /tmp/hermes-install.sh --skip-setup --skip-browser --skip-computer-use - Résultats :
- ✅ uv 0.12.17 installé dans
~/.hermes/bin/ - ✅ Python 3.11.16 installé via uv (dans le dossier scoped Flatpak
~/.var/app/md.obsidian.Obsidian/bin/python3.11) - ✅ Git 2.55.0, Node v24.20.0 détectés
- ❌ Pas de compilateur C++ → l’installeur sort (EXIT=1). Il refuse de continuer car les modules Node natifs (node-pty) doivent être compilés.
- ✅ uv 0.12.17 installé dans
- Relancé une fois avec un log complet pour confirmer le point d’arrêt → même résultat, arrêt dur.
Blocage identifié : l’installeur s’arrête net sans compilateur C++, et le sandbox ne peut pas en fournir (pas de sudo). → Je dois lancer l’installation sur mon vrai terminal hôte.
Phase 2 — Installation terminal hôte (EN ATTENTE — je l’exécute)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
L’installeur détectera le compilateur manquant et proposera d’installer gcc-c++ via sudo dnf, puis continuera. Colle la sortie dans Hermes Setup Results.md (racine du vault).
Phase 3 — Configuration (EN ATTENTE)
hermes setup— choisir le modèle (Ollama local si possible, pour rester gratuit), connecter les canaux (WhatsApp/Telegram), configurer la mémoire.- Décider du service gateway :
hermes gateway(nécessitesystemctl, terminal hôte).
Phase 4 — Vérification (EN ATTENTE)
hermes --version, démarrage de l’agent, premier message via un canal.
3. Erreurs
- ❌ J’ai supposé que le sandbox pouvait installer Hermes directement. Le home est accessible en écriture et le réseau fonctionne, donc j’ai tenté l’installation moi-même dans le Flatpak d’Obsidian — elle est allée loin (uv + Python installés) mais s’est arrêtée net sur le compilateur C++ manquant.
- ✅ Correctif : déléguer l’étape privilégiée à mon terminal hôte (Phase 2) ; le sandbox n’a ni
sudo, ni compilateur, et ne pourra jamais les fournir. - ❌ J’ai sous-estimé la pression disque : 99 % plein avant de commencer ; les téléchargements du sandbox ont coûté ~200 Mo et l’espace libre est tombé à ~4,2 Go.
- ✅ Atténuation : j’ai passé
--skip-browseret--skip-computer-usepour garder l’installation légère ; je prévois de nettoyer le disque avant/après.
4. Constats root-cause
- L’installeur Hermes considère « compilateur C++ manquant » comme fatal, pas un simple avertissement — car il doit compiler
node-pty(module Node natif) pour l’interface terminal. Le test chercheg++ouclang++dans le PATH (lignes ~887–894 de install.sh). - Réalité du sandbox Flatpak :
command -v gcc g++ cc clang clang++ make cmake→ rien ;sudo→ rien. Le runtimeorg.freedesktop.platformn’embarque pas de toolchain compilateur, et le sandbox ne peut pas déclencherdnfde l’hôte. - Le partage du home est réel : les fichiers que j’écris dans le sandbox atterrissent sur le vrai
/home/sambasene, donc~/.hermes/bin/uvpartiellement installé survit pour le passage hôte.
5. Tableau de statut
| Élément | Statut | Priorité |
|---|---|---|
| Installeur inspecté avant exécution | ✅ Fait | — |
uv + Python 3.11 installés dans ~/.hermes | ✅ Fait | — |
| Installation cœur Hermes (terminal hôte) | ⏳ En attente | Haute |
| Modèle configuré (local = gratuit) | ⏳ En attente | Haute |
| Service gateway / auto-démarrage | ⏳ En attente | Moyenne |
| Canal connecté (WhatsApp / Telegram) | ⏳ En attente | Moyenne |
| Rapports bilingues maintenus | 🔁 Mise à jour | Moyenne |
6. Tableau identifiants / config
| Élément | Valeur | Notes |
|---|---|---|
| HERMES_HOME | ~/.hermes | Données, config, sessions, logs |
| Dossier d’installation (non-root) | ~/.hermes/hermes-agent | Par défaut |
Commande hermes | ~/.local/bin/hermes (prévu) | Installée par l’étape « path » |
| uv | ~/.hermes/bin/uv (0.12.17) | Déjà installé |
| Python géré | 3.11.16 | Copie sandbox dans ~/.var/app/... ; l’hôte réutilisera ou retéléchargera via uv |
| Clés API | ⏳ À définir au hermes setup | Privilégier les modèles locaux Ollama → pas de clés = gratuit |
7. Commandes réutilisables
# Installation (terminal hôte, gère gcc-c++ via sudo dnf)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# Installation légère / non interactive (si besoin)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-setup --skip-browser --skip-computer-use
# Configurer le modèle + les canaux
hermes setup
# Lancer
hermes # TUI
hermes gateway # gateway multi-canaux (comme OpenClaw)
8. Dernier instantané de vérification
$ ls ~/.hermes/bin → uv, uvx (de la Phase 1)
$ hermes --version → (en attente Phase 2)
Disque : 4,2 Go libres / 291 Go (99 % utilisé)
9. Travail optionnel / futur
- Ajouter les outils navigateur plus tard :
hermes --ensure browser(nécessite Playwright + libs système) - Ajouter Computer Use plus tard :
hermes computer-use install - Connecter le canal WhatsApp (reprendre le flux de messagerie OpenClaw de People/_Messaging Protocol)
- Nettoyer le disque avant de continuer si l’espace libre passe sous ~3 Go
10. Leçons apprises
- Inspecter les scripts d’installation avant de les pipe dans bash — l’installeur Hermes est transparent et bien flaggé (
--skip-setup,--skip-browser) ; le lire d’abord a évité un run interactif cassé. - Sandbox Flatpak = pas de compilateur, pas de sudo, jamais. Toute installation qui compile du natif (node-gyp, node-pty, etc.) doit passer par le terminal hôte ; le sandbox ne peut que préparer des téléchargements user-space.
- Un « home accessible en écriture » ne signifie pas « je peux installer ». Le sandbox partage mon home, donc les installations partielles (uv, Python) persistent — mais les étapes privilégiées/système sont réservées à l’hôte.
- Un disque à 99 % est un vrai risque d’installation — Hermes a besoin de 1,5–3 Go ; vérifier
df -havant et pendant. - L’installeur enchaîne proprement sur relance — il a retrouvé son uv et son Python au deuxième run et a évité de les retélécharger (idempotent de conception).