Hermes Desktop

What Hermes Desktop does

Hermes Desktop is an Electron application for users who are not comfortable with the command line. It runs five stages automatically: detect the environment, install prerequisites including Docker Desktop when it is missing, deploy the Hermes Agent container on port 8642, deploy an Open WebUI container on port 3004, and run health checks. Afterwards Open WebUI is at http://127.0.0.1:3004 and the Hermes API at http://127.0.0.1:8642.

For networks where Docker registries are slow, it tries mirrors in order: Alibaba Cloud, Tencent Cloud, DaoCloud, USTC and NetEase, with ghcr.io and docker.io as fallbacks, and it shows live pull logs and deployment progress. Retry and one-click repair buttons handle stuck steps, and an offline installer is recommended when pulls fail. The README gives manual docker pull and tag commands. Windows 10 and 11 are supported today, with macOS and Linux on the roadmap. The stack is Electron 33, React 19, Vite and a pnpm and Turbo monorepo.

Key features

• One-click deployment of Hermes Agent and Open WebUI containers
• Automatic Docker Desktop download and install when missing
• Ordered China registry mirrors with automatic switching
• Live pull logs and deployment progress
• Retry current step and one-click repair buttons
• Health checks after deployment

When to use it

• Setting up Hermes Agent on Windows without writing Docker commands
• Deploying from a network where ghcr.io and Docker Hub are slow or blocked
• Getting a chat interface for Hermes through Open WebUI at a local address

Who it is for: Windows users, especially in mainland China, who want Hermes Agent running in Docker without using the command line.

How it fits with Hermes Agent

Built for Hermes Agent: it deploys the Hermes Agent container and connects it to Open WebUI.

Requirements: Windows 10 or 11 and Docker Desktop, which the app installs automatically if it is missing

Note: Only Windows 10 and 11 are supported; macOS and Linux support is listed as in development.

FAQ