Interfaces Hermes Agent : CLI, TUI, dashboard Web, Desktop, ACP et API OpenAI

Introduction

Hermes Agent propose six interfaces differentes, chacune adaptee a un contexte d'utilisation specifique. Du terminal au navigateur, de l'application desktop a l'API REST, vous choisissez comment interagir avec votre agent.

Cette page compare les interfaces, explique leurs cas d'usage et repond aux questions essentielles pour choisir et configurer la bonne interface.

Les six interfaces

Questions couvertes

q-131: Quelle difference entre CLI, TUI, dashboard Web et application desktop ?

Quand utiliser chaque interface :

• CLI : vous etes en SSH sur un serveur, vous voulez legerete et rapidite
• TUI : vous voulez une interface terminal enrichie avec barres de progression et apercus
• Dashboard Web : vous preferez le navigateur, vous voulez des widgets et un explorateur de fichiers
• Desktop : vous voulez l'experience la plus complete, avec side-by-side previews et notifications systeme

q-132: Comment lancer le dashboard Web de Hermes Agent ?

hermes dashboard

Le dashboard est accessible a http://localhost:8642 par defaut. Options :

hermes dashboard --host 0.0.0.0 --port 8080    # Ecouter sur toutes les interfaces
hermes dashboard --no-browser                    # Ne pas ouvrir le navigateur

Le dashboard offre : historique des conversations, gestion des crons, explorateur de fichiers, configuration visuelle, monitoring des sous-agents, et tableau Kanban.

q-134: Comment se connecter a un backend Hermes distant depuis Desktop ?

Hermes Desktop peut se connecter a un gateway distant. Configuration :

1. Lancez le gateway sur le serveur distant : hermes gateway run
2. Dans Desktop, allez dans Parametres > Connexion
3. Entrez l'URL du gateway distant (ex: https://hermes.mon-serveur.com)
4. Authentifiez-vous via le flux OAuth PKCE (RFC 8252) : Desktop ouvre votre navigateur systeme pour l'authentification

Le flux PKCE utilise votre navigateur systeme (pas de webview integree, pas de cookies de session). C'est le meme mecanisme que les applications OAuth modernes.

q-135: Comment utiliser Hermes Agent comme serveur ACP ?

Le protocole ACP (Agent Communication Protocol) permet d'integrer Hermes Agent dans des editeurs et plateformes compatibles ACP :

hermes acp

Options :

hermes acp --setup    # Configuration initiale
hermes acp --check    # Verifier la compatibilite

L'integration ACP permet a des editeurs comme Zed ou des plateformes comme Buzz d'utiliser Hermes Agent comme backend d'agent directement dans leur interface.

q-136: Comment exposer Hermes Agent derriere une interface compatible OpenAI ?

Le serveur API de Hermes Agent expose un endpoint compatible avec l'API OpenAI :

hermes api-server

Cela demarre un serveur HTTP sur http://localhost:8642 (port configurable) avec les endpoints :

• POST /v1/chat/completions : compatible OpenAI Chat Completions
• GET /v1/models : liste des modeles disponibles
• GET /health : health check

Cela permet d'utiliser n'importe quel frontend compatible OpenAI (Open WebUI, LibreChat, etc.) avec Hermes Agent comme backend.

q-137: Comment personnaliser le theme et les skins de Hermes Agent ?

Skins CLI/TUI :

/skin                    # Lister les skins disponibles
/skin <nom>              # Appliquer un skin

Les skins sont stockes dans ~/.hermes/skins/. Vous pouvez creer vos propres skins en copiant et modifiant un skin existant.

Themes dashboard :

Le dashboard Web supporte des themes personnalisables (palettes, typographie, layouts) via des plugins de theme. Voir la documentation d'extension du dashboard.

Themes Desktop :

L'application Desktop herite des skins et themes configures. Les plugins Desktop peuvent ajouter des panneaux, des pages et des commandes via le Desktop Plugin SDK.

q-138: Comment controler Hermes Agent depuis un navigateur ?

Deux options :

1. Dashboard Web : hermes dashboard puis ouvrez http://localhost:8642
2. API OpenAI : hermes api-server puis utilisez un frontend compatible (Open WebUI, LibreChat, etc.)

Pour un acces distant securise, placez le dashboard ou l'API derriere un reverse proxy (Nginx, Caddy) avec TLS et authentification (voir q-140).

q-139: Quelle interface choisir pour un serveur sans ecran ?

Pour un serveur headless (VPS, Raspberry Pi, NAS), les options recommandees sont :

1. Gateway + plateforme de messagerie : installez le gateway et connectez Telegram ou Discord. Vous interagissez avec l'agent depuis votre telephone.
2. CLI via SSH : ssh monserveur puis hermes. Leger, efficace, aucune interface graphique necessaire.
3. API OpenAI : exposez l'API et utilisez un frontend Web heberge ailleurs.

Le dashboard Web et Desktop ne sont pas adaptes aux serveurs sans ecran (ils necessitent un navigateur ou un environnement graphique).

q-140: Comment securiser l'acces distant a une interface Hermes Agent ?

Pour exposer une interface Hermes Agent sur Internet, appliquez ces mesures :

1. Reverse proxy avec TLS : placez Nginx ou Caddy devant le dashboard ou l'API
2. Authentification : ajoutez une couche d'auth (HTTP Basic, OAuth, Authelia)
3. Firewall : limitez l'acces aux IPs autorisees
4. Gateway avec allowlists : pour les plateformes de messagerie, configurez les allowlists
5. Pas d'exposition directe : ne jamais exposer hermes dashboard ou hermes api-server directement sur 0.0.0.0 sans reverse proxy

Exemple de configuration Nginx :

server {
    listen 443 ssl;
    server_name hermes.mon-domaine.com;

    ssl_certificate /etc/letsencrypt/live/hermes.mon-domaine.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/hermes.mon-domaine.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8642;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    auth_basic "Hermes Agent";
    auth_basic_user_file /etc/nginx/.htpasswd;
}

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• Guide CLI (https://hermes-agent.nousresearch.com/docs/user-guide/cli)
• Guide Desktop (https://hermes-agent.nousresearch.com/docs/user-guide/desktop)
• Guide ACP (https://hermes-agent.nousresearch.com/docs/user-guide/features/acp)
• Guide API Server (https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server)
• Guide de securite (https://hermes-agent.nousresearch.com/docs/user-guide/security)
• Depot NousResearch/hermes-agent, commit b4f8c491

Liens internes proposes

• Hermes Desktop
• Configurer Hermes Agent
• Securite
• Deploiement et operations
• Canaux et gateway
• FAQ
• Sources