Hermes Desktop : application native, guide complet

Introduction

Hermes Desktop est l'application native de Hermes Agent, construite avec Electron. Elle offre l'experience la plus complete pour interagir avec votre agent : streaming des sorties d'outils, previews side-by-side, explorateur de fichiers, gestion des profils, des crons et des skills, le tout dans une interface graphique moderne.

Disponible sur macOS, Windows et Linux, Desktop peut se connecter a un backend local ou distant.

Question couverte

q-133: Comment installer et utiliser Hermes Desktop ?

Installation

Hermes Desktop est inclus dans l'installation standard de Hermes Agent. Pour le lancer :

hermes desktop

Options de lancement :

hermes desktop --cwd /chemin/vers/projet    # Definir le repertoire de travail
hermes desktop --hermes-root /opt/hermes    # Definir HERMES_HOME
hermes desktop --ignore-existing            # Ignorer une instance deja en cours

Au premier lancement, Desktop verifie la presence d'un backend Hermes local. Si hermes est installe, il se connecte automatiquement.

Fonctionnalites principales

Chat avec streaming

L'interface de chat affiche les reponses de l'agent en temps reel avec :

• Streaming du texte de l'assistant
• Affichage des appels d'outils et de leurs resultats
• Previews side-by-side pour le code, les images et les fichiers generes
• Barre de progression pour les taches longues

Explorateur de fichiers

Un panneau lateral permet de naviguer dans le systeme de fichiers, d'ouvrir des fichiers et de les attacher aux messages via la syntaxe @.

Gestion des profils

Desktop integre la gestion complete des profils Hermes :

• Creer, cloner, supprimer des profils
• Basculer entre profils
• Configurer les modeles et providers par profil

Gestion des crons

Visualisez, creez, modifiez et surveillez vos taches planifiees directement depuis l'interface graphique.

Skills et plugins

Parcourez le catalogue de skills, installez-en de nouvelles et gerez vos plugins.

Connexion a un backend distant

Desktop peut se connecter a un gateway Hermes Agent heberge sur un serveur distant :

1. Dans Desktop, allez dans Parametres > Connexion
2. Entrez l'URL du gateway (ex: https://hermes.mon-serveur.com)
3. Desktop ouvre votre navigateur systeme pour l'authentification OAuth PKCE
4. Une fois authentifie, Desktop communique avec le gateway distant

Le flux d'authentification utilise le protocole PKCE (RFC 8252) : pas de webview integree, pas de cookies de session partages. C'est le standard moderne pour les applications natives.

Plugins Desktop

Le Desktop Plugin SDK (@hermes/plugin-sdk) permet d'etendre l'application avec :

• Panneaux personnalises : ajoutez des vues dans la barre laterale
• Pages : creez des pages completes accessibles depuis la navigation
• Commandes de palette : ajoutez des actions dans la palette de commandes (Cmd+K)
• Raccourcis clavier : definissez vos propres keybindings
• Themes : personnalisez l'apparence

Les plugins s'installent via hermes plugins install et sont geres dans les parametres de Desktop.

Raccourcis clavier

Differences avec le dashboard Web

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• Guide Desktop officiel (https://hermes-agent.nousresearch.com/docs/user-guide/desktop)
• Desktop Plugin SDK (https://hermes-agent.nousresearch.com/docs/developer-guide/desktop-plugin-sdk)
• Guide Desktop Native Sign-In (https://hermes-agent.nousresearch.com/docs/guides/desktop-native-signin)
• Depot NousResearch/hermes-agent, commit b4f8c491

Liens internes proposes

• Interfaces Hermes Agent
• Configurer Hermes Agent
• Deploiement et operations
• Canaux et gateway
• FAQ
• Sources