Hermes Desktop Bridge

Français · English

Application Windows qui sert de pont entre Hermes Agent et un PC Windows distant.

Cet outil est un projet personnel développé sur mon temps libre. S'il vous est utile et que vous souhaitez soutenir son développement, vous pouvez m'offrir un Ko-fi : ko-fi.com/nthstudio. Merci !

Description

Hermes Desktop Bridge permet à Hermes Agent de dialoguer avec une machine Windows distante par des endpoints réseau simples. L'application lance un relais local vers cua-driver, expose un serveur HTTP pour les captures d'écran et affiche l'état du pont dans une interface graphique légère.

Elle permet à Hermes de :

• contrôler le bureau Windows via cua-driver ;
• récupérer des screenshots ;
• exposer des endpoints réseau simples ;
• afficher un état clair dans une interface graphique ;
• tourner en arrière-plan avec une icône près de l'horloge ;
• être installée et utilisée sur plusieurs PC Windows.

Fonctionnalités

• Relais CUA : écoute TCP sur le port 8765 et transmet les requêtes JSON-RPC à cua-driver mcp.
• Screenshots HTTP : expose des captures PNG du bureau sur le port 8766.
• Statut et logs : endpoints texte pour vérifier l'état du bridge et lire les logs.
• Interface graphique WPF : boutons Start, Stop, Restart, Screenshot, installation de cua-driver, ouverture des logs.
• Zone de notification : l'application peut rester active en arrière-plan avec une icône près de l'horloge.
• Usage multi-PC : chaque PC Windows peut lancer son bridge et être ciblé par Hermes via son adresse IP.

Endpoints

Par défaut, le bridge écoute sur toutes les interfaces réseau :

• tcp://<ip-du-pc>:8765 : relais CUA vers cua-driver mcp.
• http://<ip-du-pc>:8766/screenshot : capture d'écran PNG.
• http://<ip-du-pc>:8766/status : statut texte du bridge.
• http://<ip-du-pc>:8766/logs : logs texte.

Tout autre chemin HTTP sur le port 8766 renvoie aussi une capture d'écran.

Prérequis

• Windows 10 ou Windows 11.
• SDK .NET 8 pour compiler depuis les sources.
• cua-driver pour le contrôle du bureau Windows.

L'interface propose un bouton Install cua-driver. Si winget est disponible, il tente l'installation automatiquement ; sinon il ouvre la page de releases CUA.

Lancer depuis les sources

dotnet build HermesDesktopBridge.sln
dotnet run --project src/HermesDesktopBridge/HermesDesktopBridge.csproj

Publier une version Windows

dotnet publish src/HermesDesktopBridge/HermesDesktopBridge.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -p:EnableCompressionInSingleFile=true -p:DebugType=None -p:DebugSymbols=false -o artifacts/release/win-x64

L'exécutable publié se trouve ensuite dans :

artifacts/release/win-x64/HermesDesktopBridge.exe

Utilisation

1. Installer ou publier Hermes Desktop Bridge sur le PC Windows distant.
2. Lancer l'application.
3. Vérifier que le statut indique Running.
4. Installer cua-driver si l'interface indique qu'il est manquant.
5. Autoriser les ports 8765 et 8766 dans le pare-feu Windows si Hermes Agent est sur une autre machine.
6. Configurer Hermes Agent pour cibler l'adresse IP du PC Windows et les ports exposés.

Les logs sont écrits dans :

C:\ProgramData\HermesDesktopBridge\logs\bridge.log

Sécurité

Hermes Desktop Bridge expose des capacités sensibles : contrôle du bureau et captures d'écran. Utilisez-le uniquement sur un réseau de confiance, derrière un pare-feu, un VPN ou une configuration réseau maîtrisée. N'exposez pas les ports 8765 et 8766 directement sur Internet.

Architecture

• src/HermesDesktopBridge/BridgeService.cs : relais CUA, serveur HTTP, screenshots, logs, détection de cua-driver.
• src/HermesDesktopBridge/MainWindow.xaml : interface graphique principale.
• src/HermesDesktopBridge/TrayController.cs : icône de notification et menu de fond.
• src/HermesDesktopBridge/App.xaml.cs : démarrage de l'application, service et tray icon.

Licence

Hermes Desktop Bridge est distribué sous licence MIT. Voir LICENSE.