Hermes Atlas
Desktop apps, web UIs & dashboards

Hermes WebUI Desktop

hermes-webui/hermes-desktop-rust

Cross-platform Tauri desktop app for hermes-webui with SSH tunnel mode, native tabs and notifications

In short

Hermes WebUI Desktop is a cross-platform desktop app for hermes-webui that runs a Hermes agent's web UI as a native app on Windows, Linux and macOS. It supports remote servers through a built-in SSH tunnel.

What Hermes WebUI Desktop does

Hermes WebUI Desktop is a cross-platform desktop shell for hermes-webui, the web interface for Hermes Agent. It runs the web UI as a real app on Windows, Linux and macOS, built with Tauri 2 on the system webview and Rust, at about 11 MB with no bundled browser. It is the cross-platform sibling of hermes-swift-mac, which the README says remains the flagship app on macOS.

The app needs a running hermes-webui server. In Direct mode it opens http://localhost:8787 by default and monitors /health. In SSH Tunnel mode it maintains an ssh -N -L 8787:127.0.0.1:8787 tunnel to a remote server, shows tunnel status and requires key-based SSH authentication. Other features include native tabs on macOS and a browser-style tab bar on Windows and Linux, multiple windows, window chrome that follows the web UI theme, pasting screenshots into the composer and background-response notifications. Builds on the Releases page include a Windows installer, MSI and portable zip, a Linux AppImage and .deb, and a macOS universal dmg.

Key features

  • Direct mode with /health monitoring and SSH Tunnel mode with live status
  • Native tabs on macOS and a browser-style tab bar on Windows and Linux
  • Multi-window support
  • Window chrome that follows the web UI theme
  • Clipboard image paste into the chat composer
  • Background-response notifications

When to use it

  • Using Hermes Agent's web UI as a desktop app on Windows or Linux
  • Reaching a Hermes server on a VPS or homelab over an SSH tunnel
  • Running several conversations in separate tabs

Who it is for: Hermes Agent users who run hermes-webui and want it as a desktop application, locally or against a remote server.

How it fits with Hermes Agent

Built for Hermes Agent's hermes-webui interface: the app is a shell that connects to a running hermes-webui server.

Requirements: A running hermes-webui server, plus WebView2 on Windows, WebKitGTK 4.1 on Linux or macOS 12 or newer. SSH tunnel mode needs key-based SSH authentication.

Note: The Windows installer is unsigned, so SmartScreen warns on first run, and the app only works with a running hermes-webui server.

FAQ

What is Hermes WebUI Desktop?

Hermes WebUI Desktop is a Tauri-based desktop app that wraps hermes-webui, the web interface for Hermes Agent. It runs on Windows, Linux and macOS.

What do I need to run Hermes WebUI Desktop?

You need a running hermes-webui server, either on the same machine or reachable remotely. Windows needs the WebView2 runtime and Linux needs WebKitGTK 4.1.

How does Hermes WebUI Desktop connect to a remote Hermes server?

In SSH Tunnel mode you enter the username, host and ports in Preferences, and the app maintains an ssh port forward to 8787 for you. Key-based SSH authentication is required because there is no terminal for password prompts.

Similar interfaces for Hermes Agent

All interfaces

Related guides: Connect Hermes agents on several machines with Hermes Desktop · How to install Hermes Agent