Hermes Agent


type: rapport projet: Hermes Agent date: 2026-09-18 statut: en_cours tags:

  • ia
  • agent
  • setup

Rapport Hermes Agent Setup

ProjetHermes Agent (Nous Research) — agent IA open source auto-améliorant
Date2026-09-18
Statut⏳ En cours — Phase 1 terminée, Phase 2 en attente du terminal hôte
CibleInstallation 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
  • 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)

  1. 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, sudo n’est utilisé qu’opportunément pour git/outils de build, flags --skip-setup, --skip-browser, --skip-computer-use existants.
  2. J’ai lancé l’installeur dans le sandbox :
    bash /tmp/hermes-install.sh --skip-setup --skip-browser --skip-computer-use
  3. 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.
  4. 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écessite systemctl, 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-browser et --skip-computer-use pour 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 cherche g++ ou clang++ 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 runtime org.freedesktop.platform n’embarque pas de toolchain compilateur, et le sandbox ne peut pas déclencher dnf de 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/uv partiellement installé survit pour le passage hôte.

5. Tableau de statut

ÉlémentStatutPriorité
Installeur inspecté avant exécution✅ Fait—
uv + Python 3.11 installés dans ~/.hermes✅ Fait—
Installation cœur Hermes (terminal hôte)⏳ En attenteHaute
Modèle configuré (local = gratuit)⏳ En attenteHaute
Service gateway / auto-démarrage⏳ En attenteMoyenne
Canal connecté (WhatsApp / Telegram)⏳ En attenteMoyenne
Rapports bilingues maintenus🔁 Mise à jourMoyenne

6. Tableau identifiants / config

ÉlémentValeurNotes
HERMES_HOME~/.hermesDonnées, config, sessions, logs
Dossier d’installation (non-root)~/.hermes/hermes-agentPar 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.16Copie sandbox dans ~/.var/app/... ; l’hôte réutilisera ou retéléchargera via uv
Clés API⏳ À définir au hermes setupPrivilé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

  1. 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é.
  2. 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.
  3. 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.
  4. Un disque à 99 % est un vrai risque d’installation — Hermes a besoin de 1,5–3 Go ; vérifier df -h avant et pendant.
  5. 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).