Web3Hermes

What Web3Hermes does

The UI is a lightweight dark-themed web app, with a light mode, built from Python and plain JavaScript with no build step, framework or bundler. The layout has three columns: sessions and navigation on the left, chat in the center, and a workspace file browser with inline preview on the right. Model, profile and workspace controls sit in the composer footer, a context ring shows token use at a glance, and settings live in a Hermes control center. The README says it aims for near 1:1 parity with the Hermes CLI.

This edition translates everything from the installer to daily use, defaults to Simplified Chinese and fixes a number of translation errors. Running python3 bootstrap.py detects Hermes Agent, runs the official installer if it is missing, prepares a Python environment, starts the server, waits for /health, opens the browser and launches a first-run wizard. Docker images, Docker Compose and a two-container setup with separate Agent and WebUI containers are also described, with port 8787 by default and an optional HERMES_WEBUI_PASSWORD.

Key features

• Three-column UI with sessions, chat and a workspace file browser
• Simplified Chinese interface from installer to daily use
• Bootstrap script that finds or installs Hermes Agent, starts the server and opens the browser
• Docker, Docker Compose and two-container deployment options
• Optional password protection through HERMES_WEBUI_PASSWORD
• Access from your own computer over an SSH tunnel

When to use it

• Using Hermes Agent from a browser in Chinese
• Running the UI in Docker next to a separate Hermes Agent container
• Browsing workspace files with inline previews while chatting with the agent

Who it is for: Chinese-speaking Hermes Agent users who prefer a browser UI to the terminal.

How it fits with Hermes Agent

It is a web UI for Hermes Agent, localized from nesquena/hermes-webui, and it reuses your existing Hermes Agent setup and models.

How to install Web3Hermes

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

git clone https://github.com/Web3CZ/Web3Hermes.git hermes-webui
cd hermes-webui
python3 bootstrap.py

Requirements: Python 3 on Linux, macOS or WSL2 (native Windows bootstrap is not supported); the bootstrap script installs Hermes Agent if it is missing

Note: This is a Chinese-language modification of nesquena/hermes-webui and was last updated in April 2026.

FAQ