Workspace 3 colonnes style Claude avec Hermes WebUI (2026)
Introduction
L'application Web de Claude a mis en page une mise en page que de nombreux utilisateurs expérimentés refusent d'abandonner : historique à gauche, conversation au centre et Artefacts/fichiers à droite. Le problème réside dans l'abonnement à 20 $/mois et les limites de débit de session – ce qui convient pour les discussions informelles, pénible pour les agents, les boucles d'outils et les recherches quotidiennes.
Hermes WebUI (plus de 10 000 étoiles GitHub en 2026) est une interface Web communautaire pour Hermes Agent — l'environnement d'exécution d'agent auto-améliorable de Nous Research. Vous ne réécrivez pas le code de l'agent. Vous exécutez une commande Docker (ou docker compose up) et obtenez une interface en mode sombre à trois volets avec cartes d'appel d'outils en direct et un navigateur de fichiers Workspace qui semble plus proche de l'interface utilisateur du produit de Claude qu'un terminal brut.
Ce guide est un tutoriel pratique Hermes WebUI pour les lecteurs qui souhaitent une interface utilisateur de chat IA auto-hébergée et une interface open source de style Claude sans payer de frais SaaS par siège. Nous couvrons l'architecture, l'installation, la sécurité et six pièges courants.
Si vous exécutez déjà des agents ailleurs, consultez notre Guide orchestration multi-agents OpenClaw — Hermes propose aussi hermes claw migrate. Grands dépôts : Visualisation Understand Anything.
Qu'est-ce que Hermes WebUI (et ce que ce n'est pas)
| Couche | Projet | Rôle |
|---|---|---|
| UI | nesquena/hermes-webui | Application WebReact, port 8787, UX | à trois colonnes
| Agent | NousResearch/hermes-agent | Exécution de l'outil, compétences, passerelle (Telegram/Discord), mémoire |
| Config | ~/.hermes/config.yaml |
Modèles, clés API, listes autorisées d'outils |
| Espace de travail | ~/workspace (par défaut) |
Fichiers que l'agent lit/écrit — affichés dans le volet de droite |
Hermes WebUI est pas un clone de l'API Claude hébergé. Vous apportez vos propres clés de modèle (Anthropic, OpenRouter, Nous Portal, points de terminaison locaux, etc.) via hermes model — même flexibilité que la CLI, documentée sur hermes-agent.nousresearch.com/docs.
Fonctionnalités de l'interface utilisateur qui correspondent au modèle mental « Espace de travail Claude »
Disposition en trois colonnes
| Colonne | Contenu typique |
|---|---|
| Gauche | Liste des conversations, historique des sessions, changement rapide |
| Centre | Chat en streaming, démarque, interruption et redirection |
| Droite | Workspace — arborescence de fichiers en direct, aperçus, sorties de style artefact |
Mode sombre et transparence des outils
Contrairement à une bulle de discussion plate, Hermes WebUI étend les appels d'outils en temps réel (commandes shell, modifications de fichiers, recherche) sous forme de cartes que vous pouvez numériser sans fouiller dans les journaux. Cela reflète la raison pour laquelle les utilisateurs expérimentés de Claude restent dans l'application Web au lieu des scripts API uniquement.
Navigateur de fichiers Workspace
Le volet de droite correspond à votre répertoire /workspace monté (chemin d'accès de l'hôte configurable). Les agents qui écrivent des graphiques, du code ou des rapports s'affichent immédiatement dans le navigateur – plus proche des fichiers de projet Claude Artifacts + que de la vue à fil unique de ChatGPT.
Démo officielle et captures d'écran : Hermes WebUI sur GitHub et le site de démonstration communautaire .
Claude / ChatGPT web vs Hermes WebUI (matrice de décision)
| Facteur | Claude web (20$/mois) | ChatGPT Plus | Hermes WebUI (auto-hébergé) |
|---|---|---|---|
| Mise en page | 3 colonnes + artefacts | Centré sur un seul thread | 3 colonnes + Navigateur de l'espace de travail |
| Limites de débit | Limites de session | Majuscules du modèle | Votre matériel + quotas API uniquement |
| Résidence des données | Nuage anthropique | Cloud OpenAI | Votre machine / VPS |
| Outils d'agent | Lié au produit | Plugins/GPT | 40+ Outils Hermes, cron, sous-agents |
| Effort de configuration | Zéro | Zéro | Docker + clés API (~15 min) |
| Mobile | Application officielle | Application officielle | Navigateur vers votre serveur (tunnel SSH) |
Chemin recommandé :
- Si vous n'avez besoin que de discussions occasionnelles et valorisez zéro opération → gardez Claude/ChatGPT.
- Si vous atteignez les limites, avez besoin d'un travail d'agent volumineux ou souhaitez Telegram + web sur le même agent → Agent Hermes + WebUI.
- Si vous migrez depuis OpenClaw → exécutez
hermes claw migratepuis attachez WebUI (voir Hermes docs).
Prérequis
| Exigence | Remarques |
|---|---|
| Docker | Docker Desktop (Mac/Windows) ou moteur sous Linux |
| Disque | ~2 à 5 Go pour les images ; plus pour les caches de modèles si local |
| Clé API | Anthropic, OpenRouter ou Nous Portal configuration à une touche |
| Facultatif : Hermes CLI | curl -fsSL .../install.sh | bash si vous n'utilisez pas d'image tout-en-un |
Sur les Mac Apple Silicon, les montages de liaison utilisent votre véritable UID (id -u — souvent 501, et non 1000). Les exemples Docker ci-dessous définissent explicitement WANTED_UID / WANTED_GID.
Étape par étape : installation de Docker (chemin rapide)
Étape 1 — Installer la configuration de l'agent Hermes (première fois uniquement)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | coup
source ~/.bashrc # ou ~/.zshrc
Assistant de configuration Hermes : fournisseur de modèles + clés API
Ignorer si vous utilisez uniquement l'image WebUI tout-en-un avec ~/.hermes.
Étape 2 — Extrayez l'image WebUI
docker pull ghcr.io/nesquena/hermes-webui:latest
Étape 3 — Exécuter un conteneur (one-liner officiel)
docker run -d \
-e WANTED_UID=$(id -u) -e WANTED_GID=$(id -g) \
-v ~/.hermes:/home/hermeswebui/.hermes \
-e HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui \
-v ~/espace de travail:/espace de travail \
-p 127.0.0.1:8787:8787 \
ghcr.io/nesquena/hermes-webui:latest
Ouvrir http://localhost:8787.
Étape 4 — Définir le modèle dans l'interface utilisateur ou CLI
numéro de modèle Hermes par ex. anthropique:claude-sonnet-4-6 ou openrouter route
WebUI lit ~/.hermes/config.yaml à partir du volume monté.
Étape 5 — Accès à distance sécurisé (facultatif)
La liaison par défaut est localhost uniquement (127.0.0.1:8787). Pour un VPS :
# Sur le serveur : définissez HERMES_WEBUI_PASSWORD dans compose/.env, liez 0.0.0.0 uniquement derrière le proxy inverse
ssh -N -L 8787:127.0.0.1:8787 utilisateur@votre-serveur
Puis parcourez http://localhost:8787 localement. Pour connaître les bases de SSH sur un boîtier Mac/Linux sans tête, consultez notre Guide SSH Mac mini M4.
Étape 6 — Docker Compose (production)
git clone https://github.com/nesquena/hermes-webui
cd hermes-webui
cp .env.docker.exemple .env
# Corrigez l'UID/GID sur macOS si nécessaire
docker compose -d
Voir docs/docker.md dans le dépôt pour les configurations à deux conteneurs (agent + interface utilisateur) et les notes de mise à niveau.
Étape 7 — Agent de test de fumée + UI
Demandez dans le volet central : « Listez les fichiers dans l'espace de travail et créez hello.md.
Vous pouvez exécuter CLI ( Symptôme : Le navigateur tourne sur :8787. Fix : Vérifiez les journaux du conteneur ( Symptôme : L'agent démarre mais la configuration est manquante ; liste de modèles vide. Fix : Passer Symptôme : Le chat se bloque, pas de diffusion en continu. Fix : Validez la clé API dans Symptôme : Vous avez modifié la liaison en Fix: Définissez Hermes WebUI est le chemin gratuit et auto-hébergé le plus proche d'un espace de travail à trois colonnes de style Claude pour les utilisateurs expérimentés d'agents : historique, chat et fichiers dans une seule vue - ainsi que des cartes d'outils transparentes que Docker peut lancer en quelques minutes sur le port 8787. Commencez avec le Architecture : comment WebUI communique avec l'agent
Navigateur (:8787)
│
▼
Hermès WebUI (Node/React)
│ API WebSocket / HTTP
▼
Processus Hermes Agent (outils, LLM, mémoire)
│
├── ~/.hermes/ (config, sessions, compétences)
└── ~/workspace/ (fichiers du projet → colonne de droite)
hermes), gateway (hermes gateway) et WebUI sur le même État ~/.hermes — choisissez l'interface par appareil. Détails : Documents d'architecture.Dépannage
Interface utilisateur vide ou « impossible de se connecter » après
docker rundocker logs <id>), confirmez le mappage des ports et assurez-vous que rien d'autre n'utilise 8787. Sous Linux, essayez curl -s http://127.0.0.1:8787.Autorisation refusée sur
~/.hermes mountWANTED_UID / WANTED_GID hôte correspondant id -u / id -g. Utilisateurs macOS : modifiez .env dans composer — les valeurs par défaut supposent l'UID 1000.WebUI affiche l'espace de travail mais l'agent ne répond pas
~/.hermes/config.yaml, exécutez hermes doctor sur l'hôte, vérifiez le quota du fournisseur. Testez la CLI : hermes dans le terminal en premier.Port exposé sans mot de passe
0.0.0.0:8787 pour l'accès au réseau local.HERMES_WEBUI_PASSWORD et placez nginx/Caddy avec TLS devant. N'exposez jamais raw :8787 à l'Internet public.FAQ
hermes claw migrate, passerelle vers Telegram/Discord. Choisissez Hermes si vous voulez la boucle d'agent Nous, pas seulement un wrapper de chat.docs/docker.md.docker run officiel, montez ~/.hermes et ~/workspace, configurez votre modèle avec hermes setup, puis testez avec de vraies tâches d'écriture de fichiers. Dépôts officiels : nesquena/hermes-webui · NousResearch/hermes-agent.
Poursuivre avec les ressources Hermes officielles
Runbooks Docker, configuration des modèles et notes d'architecture sont dans les dépôts upstream. Utilisez-les avec ce guide pour déployer ou mettre à jour Hermes WebUI.