Skip to content

Expose HERMES_WEBUI_GATEWAY_API_KEY as a form field #49

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cori merged 1 commit into from
Jun 13, 2026
+17 −7
Merged

Expose HERMES_WEBUI_GATEWAY_API_KEY as a form field #49

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 13 additions & 5 deletions apps/hermes-webui/config.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
"utilities"
],
"description": "Hermes WebUI is a lightweight, dark-themed web interface that connects to your existing Hermes Agent gateway, sharing sessions and history with the CLI and other interfaces. It provides near-complete parity with the CLI experience via a three-panel layout with session management, chat, and workspace file browsing. Use it in any browser, or pair it with the Hermes Agent Mobile iOS app by setting a password.",
"tipi_version": 3,
"tipi_version": 4,
"version": "0.51.345",
"source": "https://github.com/nesquena/hermes-webui",
"website": "https://github.com/nesquena/hermes-webui",
Expand All @@ -21,21 +21,29 @@
"amd64"
],
"created_at": 1780963200000,
"updated_at": 1781136000000,
"updated_at": 1781308800000,
"dynamic_config": true,
"form_fields": [
{
"type": "text",
"label": "Gateway URL",
"hint": "URL of your existing Hermes Agent gateway (e.g. http://192.168.1.10:8642)",
"hint": "URL of your existing Hermes Agent gateway (e.g. http://192.168.1.10:8642). Use the gateway port (default 8642), not the dashboard port (9119).",
"required": true,
"env_variable": "HERMES_WEBUI_GATEWAY_BASE_URL",
"default": ""
},
{
"type": "password",
"label": "Password",
"hint": "Password for web UI access. Required when using Hermes Agent Mobile (iOS app).",
"label": "Gateway API Key",
"hint": "Bearer token matching the gateway's API_SERVER_KEY (from ~/.hermes/.env on the gateway host). Required if the gateway has API_SERVER_KEY set.",
"required": false,
"env_variable": "HERMES_WEBUI_GATEWAY_API_KEY",
"default": ""
},
{
"type": "password",
"label": "WebUI Password",
"hint": "Password to log in to this web UI (separate from the gateway key). Required when using Hermes Agent Mobile (iOS app).",
"required": false,
"env_variable": "HERMES_WEBUI_PASSWORD",
"default": ""
Expand Down
1 change: 1 addition & 0 deletions apps/hermes-webui/docker-compose.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
{ "key": "HERMES_WEBUI_CHAT_BACKEND", "value": "gateway" },
{ "key": "HERMES_WEBUI_SKIP_ONBOARDING", "value": "1" },
{ "key": "HERMES_WEBUI_GATEWAY_BASE_URL", "value": "${HERMES_WEBUI_GATEWAY_BASE_URL}" },
{ "key": "HERMES_WEBUI_GATEWAY_API_KEY", "value": "${HERMES_WEBUI_GATEWAY_API_KEY}" },
{ "key": "HERMES_WEBUI_PASSWORD", "value": "${HERMES_WEBUI_PASSWORD}" },
{ "key": "HERMES_WEBUI_DEFAULT_MODEL", "value": "${HERMES_WEBUI_DEFAULT_MODEL}" }
],
Expand Down
5 changes: 3 additions & 2 deletions apps/hermes-webui/metadata/description.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,9 @@ A lightweight browser interface for [Hermes Agent](https://github.com/nesquena/h

| Field | Description |
|---|---|
| **Gateway URL** | URL of your already-running Hermes Agent gateway (e.g. `http://192.168.1.10:8642`). Required. |
| **Password** | Protects the UI with HTTP authentication. Required when connecting from Hermes Agent Mobile. |
| **Gateway URL** | URL of your already-running Hermes Agent gateway (e.g. `http://192.168.1.10:8642`). Use the **gateway** port (default `8642`), not the **dashboard** port (`9119`). Required. |
| **Gateway API Key** | Bearer token that matches the gateway's `API_SERVER_KEY` (typically set in `~/.hermes/.env` on the gateway host). Required if the gateway enforces auth — without it, sessions and model lists silently come back empty and chat messages fail. |
| **WebUI Password** | Protects this UI with HTTP authentication (separate from the gateway key). Required when connecting from Hermes Agent Mobile. |
| **Default Model** | Override the agent's default model (e.g. `claude-sonnet-4-6`). Leave blank to use the agent's own default. |

## Usage with Hermes Agent Mobile (iOS)
Expand Down
Loading