mirror of
https://github.com/EKKOLearnAI/hermes-web-ui.git
synced 2026-05-25 13:30:14 +00:00
ekko
9a9416c99c
* feat: support profile-aware group chat bridge flows * feat: route cron jobs through hermes cli * Fix group chat routing and isolate bridge tests * Add Grok image-to-video media skill * Default Grok videos to media directory * Fix bridge profile fallback and cron repeat clearing * Refine bridge chat and gateway platform handling * Filter bridge tool-call text deltas * Preserve structured bridge chat history * Prepare beta release build artifacts * Fix Windows run profile resolution * Fix Windows path compatibility checks * Fix profile-scoped model page display * Hide Windows subprocess windows for jobs and updates * Hide Windows file backend subprocess windows * Avoid Windows gateway restart lock conflicts * Treat Windows gateway lock as running on startup * Force release Windows gateway lock on restart * Tighten Windows gateway lock cleanup * Update chat e2e source expectation * Bump package version to 0.5.30 --------- Co-authored-by: Codex <codex@openai.com>
3.1 KiB
3.1 KiB
Docker Compose Guide
This repository ships an environment-variable driven Docker Compose setup.
Quick Start
Pull pre-built image (Recommended)
WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d
docker compose logs -f hermes-webui
Open: http://localhost:6060
Build from source
docker compose up -d --build
docker compose logs -f hermes-webui
Services
This compose file runs a single service:
hermes-webui— Web UI dashboard with integrated Hermes Agent runtime (pre-built image or built from source)
The Web UI container is built on the nousresearch/hermes-agent base image and uses the Hermes CLI / agent bridge runtime for chat execution. It does not start or manage a separate Hermes gateway process.
Environment Variables
All key runtime settings are configured from compose variables.
| Variable | Default | Description |
|---|---|---|
PORT |
6060 |
Web UI listen port |
BIND_HOST |
0.0.0.0 |
Optional Web UI bind host. Defaults to IPv4 for stable WSL/Windows access. Set :: explicitly if you want IPv6 listening. |
HERMES_BIN |
/opt/hermes/.venv/bin/hermes |
Path to Hermes CLI binary |
HERMES_AGENT_IMAGE |
nousresearch/hermes-agent:latest |
Hermes Agent base image (used only during build) |
WEBUI_IMAGE |
hermes-web-ui-local:latest |
Web UI image (set to ekkoye8888/hermes-web-ui to use pre-built) |
HERMES_DATA_DIR |
./hermes_data |
Hermes runtime data directory |
AUTH_DISABLED |
false |
Set to true to disable login authentication |
Override variables directly from shell:
PORT=16060 \
AUTH_DISABLED=true \
docker compose up -d
Or create a .env file in the project root:
WEBUI_IMAGE=ekkoye8888/hermes-web-ui
PORT=6060
AUTH_DISABLED=false
Data Persistence
| Path | Description |
|---|---|
${HERMES_DATA_DIR} (./hermes_data) |
Hermes runtime data (sessions, config, profiles) |
${HERMES_DATA_DIR}/hermes-web-ui |
Web UI data (auth token, etc.) |
- Hermes data persists in
./hermes_data, mapped to/home/agent/.hermesin the container. - Web UI data persists in
./hermes_data/hermes-web-ui/, mapped to/home/agent/.hermes-web-uiin the container. - When
AUTH_DISABLED=false, the auth token is auto-generated on first run and printed to container logs. - Deleting the token file and restarting will generate a new one.
Port Mapping
| Port | Description |
|---|---|
${PORT} (6060) |
Web UI dashboard |
No Hermes gateway ports are exposed by this compose setup.
Code Runtime Behavior
- Hermes CLI binary comes from
HERMES_BINenv (packages/server/src/services/hermes-cli.ts). - If
HERMES_BINis not provided, code falls back tohermesinPATH. - Profile-specific chat runs are handled through the Hermes agent bridge.
- The Web UI does not automatically start or manage a Hermes Agent gateway process on startup.
Common Operations
Recreate:
docker compose up -d --force-recreate
View auth token:
docker compose logs hermes-webui | grep token
# or
cat ./hermes_data/hermes-web-ui/.token
Stop:
docker compose down