hermes-agent-desktop

What hermes-agent-desktop does

The image combines three projects: openclaw_computer for the remote desktop, NousResearch/hermes-agent, and the community Hermes WebUI. Port 7860 serves a Debian 12 KDE desktop over noVNC, port 8648 serves the Hermes WebUI for chat, configuration and operations, and port 8642 exposes the Hermes gateway as an OpenAI-compatible API. Chrome and fcitx5 Chinese input are preinstalled.

LLM providers are configured through environment variables passed to docker run, or by editing /root/hermes-data/.env inside the container. The README lists OpenAI, Anthropic, OpenRouter, Google Gemini, DeepSeek, Ollama Cloud, Zhipu GLM, Kimi, MiniMax, Hugging Face and a local Ollama. The noVNC approach was chosen so the image works on cloud platforms such as ModelScope and Hugging Face that put a single HTTP port behind a proxy. The README is written in Chinese.

Key features

• Debian 12 KDE desktop in the browser through noVNC on port 7860
• Hermes WebUI on port 8648 for chat, configuration and operations
• Hermes gateway as an OpenAI-compatible API on port 8642
• Chrome and fcitx5 Chinese input preinstalled
• Provider keys set through docker run environment variables or a .env file

When to use it

• Trying Hermes Agent in a full Linux desktop without installing anything locally
• Deploying Hermes on single-port cloud platforms such as ModelScope or Hugging Face
• Giving Hermes a browser and desktop to work in

Who it is for: Users, especially Chinese-reading ones, who want Hermes Agent with a web UI and a graphical desktop in one container.

How it fits with Hermes Agent

It packages upstream Hermes Agent together with the community Hermes WebUI and a remote desktop inside a single image.

How to install hermes-agent-desktop

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

docker run -d --name hermes-agent -p 7860:7860 -p 8648:8648 -p 8642:8642 -e OPENAI_API_KEY=sk-xxx -e GATEWAY_ALLOW_ALL_USERS=true ghcr.io/comedy1024/hermes-agent-desktop:latest

Requirements: Docker and an API key for at least one supported LLM provider (a local Ollama needs no key)

Note: The image runs everything as root inside the container, and the quick start sets GATEWAY_ALLOW_ALL_USERS=true, which the README says is needed or the gateway rejects all requests.

FAQ