Aller au contenu

Hermes WebUI — Guide d'utilisation (FR)

Résumé

Guide complet en français de Hermes WebUI v0.51.x, l'interface web native pour Hermes Agent. Couvre la navigation (3 panneaux : Sidebar / Chat / Workspace), la gestion des sessions, les skills, les tâches cron, la mémoire, les commandes slash et la configuration avancée. Adapté au setup shared/architecture/hermes-acces-vps-hetzner (VPS Hetzner + Docker + Caddy).

Contenu structuré

Présentation

Hermes WebUI est une interface communautaire légère (Python + JS vanilla, pas de framework) conçue spécifiquement pour Hermes Agent. Streaming via SSE. Accessible depuis navigateur, téléphone, tablette.

Accès : http://178.105.46.57:3001 — mot de passe : variable HERMES_WEBUI_PASSWORD (pas de nom d'utilisateur).

Interface — 3 panneaux

┌─────────────┬──────────────────────────┬──────────────────┐
│  Sidebar    │       Chat (centre)      │  Workspace       │
│  (gauche)   │                          │  (droite)        │
│ Navigation  │  Conversations           │  Fichiers        │
│ Sessions    │  Streaming               │  Prévisualisation│
│ Panneaux    │  Outils                  │  Édition         │
└─────────────┴──────────────────────────┴──────────────────┘
Icône Panneau Description
Chat Sessions de conversation
Tasks Tâches cron planifiées
Skills Compétences d'Hermes
Memory Mémoire de l'agent
Todos Liste des tâches en cours
Analytics Statistiques d'utilisation
Spaces Gestion des workspaces
Settings Paramètres (en bas)

Panneau Chat #streaming

  • Nouvelle conversation : bouton + ou Cmd/Ctrl + K
  • Pendant une réponse : les outils exécutés s'affichent en temps réel (ls -la, etc.)
  • Commandes dangereuses : carte d'approbation avec 4 choix (une fois / session / toujours / refuser)
  • Anneau de contexte : cercle en bas à droite — indique l'usage tokens, rouge = limite proche

Actions sur les messages (au survol) : Copier / Modifier / Régénérer

Gestion des Sessions

Action Comment
Renommer Double-cliquer sur le titre
Épingler Reste en haut de la liste
Archiver Cacher sans supprimer
Dupliquer Copie de la session
Exporter JSON Sauvegarde complète
Exporter Markdown Transcription lisible
Importer JSON Restaurer une session
  • Groupées par : Aujourd'hui / Hier / Plus tôt
  • Ajouter #tag dans le titre pour des étiquettes colorées filtrables
  • Recherche par titre (sidebar) ou contenu (Ctrl+K)

Panneau Skills

Lister / Rechercher / Prévisualiser / Créer / Modifier / Supprimer les skills Hermes.

Panneau Tasks (Cron) #cron

Créer une tâche : nom + prompt + schedule (expression cron) + delivery (Telegram, Discord, local…)

Expression Fréquence
* * * * * Chaque minute
0 * * * * Chaque heure
0 9 * * * Tous les jours à 9h
0 9 * * 1 Tous les lundis à 9h
0 9 1 * * Le 1er du mois à 9h

Actions sur une tâche : lancer maintenant / pause / reprendre / modifier / supprimer / voir historique.

Panneau Memory

Fichier Contenu
MEMORY.md Notes de l'agent sur le contexte utilisateur
USER.md Profil utilisateur — préférences, informations

Panneau Workspace (droite)

Navigation arborescence + fil d'Ariane. Prévisualisation :

Type Rendu
Texte / Code Coloration syntaxique (Prism.js)
Markdown HTML avec tableaux
Images Inline (PNG, JPG, GIF, SVG, WEBP)
Mermaid Rendu graphique

Actions : Éditer / Créer fichier / Créer dossier / Renommer / Supprimer.

Paramètres (Settings)

Onglet Contenu
Préférences Modèle LLM, touche d'envoi, thème (Dark/Light/Slate/Solarized/Monokai/Nord/OLED), langue
Conversation Export/import/effacement de l'historique
Système Version, changement de mot de passe

Commandes Slash

Taper / pour l'autocomplétion.

Commande Description
/help Afficher l'aide
/clear Effacer la conversation
/new Nouvelle conversation
/model <nom> Changer de modèle LLM
/workspace <nom> Changer de workspace
/compress [sujet] Compresser le contexte
/usage Utilisation des tokens
/theme Changer le thème

Raccourcis clavier

Raccourci Action
Cmd/Ctrl + K Nouvelle conversation
Entrée Envoyer (configurable)
Ctrl+Entrée Envoyer (configurable)
Escape Fermer / annuler
Tab Sélectionner autocomplétion

Configuration avancée — Variables d'environnement

Variable Défaut Description
HERMES_WEBUI_HOST 127.0.0.1 Adresse d'écoute
HERMES_WEBUI_PORT 8787 Port du serveur
HERMES_WEBUI_PASSWORD vide Mot de passe d'accès
HERMES_WEBUI_DEFAULT_WORKSPACE ~/workspace Dossier de travail
HERMES_WEBUI_AGENT_DIR auto Chemin vers hermes-agent
HERMES_WEBUI_STATE_DIR ~/.hermes/webui-mvp Stockage des sessions
HERMES_HOME ~/.hermes Répertoire base Hermes

Dépannage

# WebUI ne répond pas
docker exec hermes-telegram curl http://localhost:8787/health
docker exec hermes-telegram cat /tmp/webui.log
docker compose up -d --force-recreate hermes-telegram

# Mot de passe oublié
# Modifier HERMES_WEBUI_PASSWORD dans docker-compose.yml puis :
docker compose up -d --force-recreate hermes-telegram
  • Workspace introuvable : /opt/projets dans le conteneur = /home/kanmaber/projets sur l'hôte
  • Modèle non disponible : vérifier les clés API dans data/.env ou via Dashboard (port 2019) > Keys
  • Saisie vocale : nécessite HTTPS ou localhost (Web Speech API)

Mobile

Sidebar via menu hamburger, navigation par boutons bas d'écran, fichiers via panneau coulissant. Interface responsive. Sessions synchronisées entre tous les appareils (stockage serveur).

Points clés

  • Interface 3 panneaux : Sidebar / Chat / Workspace — tout accessible sans quitter la page
  • Anneau de contexte : indicateur visuel de consommation tokens en temps réel
  • Sessions persistantes côté serveur — synchronisation automatique PC/téléphone
  • Tâches cron configurables directement depuis l'interface (panel Tasks)
  • Variable HERMES_WEBUI_STATE_DIR contrôle où sont stockées les sessions

Liens connexes