Hermes-Agent

Hermes-Agent

Docker 应用程序 from martial's Repository

概述

Hermes Agent is a local, self-improving AI agent built by Nous Research, with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, and builds a deepening model of who you are across sessions. This template uses the official Hermes Agent docker image, and it is configured to run the agent's Gateway and Dashboard using the HERMES_UID and HERMES_GID environment variables. It will expose the Dashboard WebUI on port 9119 and API acess on port 8642. This template uses a custom network for the additional services to see one another and a shared volume to store Hermes sources, which allows the other Hermes templates to access them. Please see https://github.com/mmartial/Unraid-templates/ for deployment notes. This template was built following the documentation from https://hermes-agent.nousresearch.com/docs/user-guide/docker. Please refer to the official documentation for available configuration options and instructions to use the agent, the dashboard, and the API. It is encouraged to spend time reading https://hermes-agent.nousresearch.com/docs/ to understand the project and its capabilities, and to configure it properly for your use case. Familiarity with docker exec might be required to configure the agent itself. The container should start with the name HermesAgent (use "docker container ls" to find the name of the running container), use the following command to get access to the hermes command (to configure/test it): docker exec --user 99:100 -it HermesAgent bash source .venv/bin/activate hermes Please see https://github.com/mmartial/Unraid-templates/issues/2#issuecomment-4327179027 for a note about the need to use a Docker shared volume, and https://github.com/mmartial/Unraid-templates/issues/8#issuecomment-4570170067 for details on steps required to update the shared docker volume when the underlying image is updated. It is also possible to disable autoamtic container update and instead use "hermes update" is another command line that can be run inside the container to update the shared volume with the latest sources from GirHub. Other Hermes templates are also available from the same maintainer. If a new variable is added to the official image and you want it added to the template, please let me know. If you encounter issues with this template (not the underlying application), please open an issue in the template repository.

要求

Important: the template requires a shared docker volume to share the hermes sources with the WebUI; if you have autoamtic container updates enabled, you will need to recreate the docker volume each time as described in the notes, or manually update hermes (and disable automatic updates for the container). This template's WebUI is the Hermes Dashboard. To access the gateway, connect to port 8642 (running in API server mode). Make sure to use the other "Hermes" components from the same maintainer.

运行时参数

网络用户界面
http://[IP]:[PORT:9119]
网络
docker
外壳
bash
特权
false

模板配置

Gateway PortPorttcp

Internal port for the Hermes Gateway and API server

目标
8642
默认值
8642
价值
8642
Dashboard PortPorttcp

Internal port for the Hermes Dashboard

目标
9119
默认值
9119
价值
9119
API_SERVER_ENABLEDVariable

Enable the API server

默认值
true
价值
true
API_SERVER_HOSTVariable

Bind Host for the API server

默认值
0.0.0.0
价值
0.0.0.0
API_SERVER_KEYVariable

API key for the API server. Generate one with: openssl rand -hex 32

价值
bd3db74dd31a13c4f23c137eca542a1ae76d403d5dc6453926820e9e7b9e28a4
API_SERVER_CORS_ORIGINSVariable

CORS origins for the API server

价值
*
HERMES_DASHBOARDVariable

Enable the Hermes Dashboard

默认值
true
价值
true
HERMES_DASHBOARD_HOSTVariable

Bind Host for the Hermes Dashboard

默认值
0.0.0.0
价值
0.0.0.0
HERMES_DASHBOARD_TUIVariable

Set to 1 to expose the in-browser Chat tab

默认值
1
价值
1
HERMES_DASHBOARD_INSECUREVariable

Set to 1 to bind without the OAuth auth gate. Only use on trusted networks behind a reverse proxy without the OAuth contract — the dashboard exposes API keys and session data

默认值
1
价值
1
HERMES_UIDVariable

UID to use for content

默认值
99
价值
99
HERMES_GIDVariable

GID to use for content

默认值
100
价值
100
HERMES_HOMEVariable

Home directory for Hermes data

默认值
/home/hermes/.hermes
价值
/home/hermes/.hermes
HERMES_HOME Unraid locationPathrw

Location where the container stores all user data (config, API keys, sessions, skills, memories)

目标
/home/hermes/.hermes
默认值
/mnt/user/appdata/hermes-agent/hermes-home
价值
/mnt/user/appdata/hermes-agent/hermes-home
Hermes Shared Source VolumePathrw

A Docker named volume (do not change: using a folder path will not work) that auto-populates from the image (target must be the same for all hermes templates)

目标
/opt/hermes
默认值
hermes_shared_volume
价值
hermes_shared_volume

类别

下载统计数据

1,130,318
下载总数

详细信息

存储库
nousresearch/hermes-agent:latest
最后更新2026-05-13
初见2026-04-13

在Unraid 上运行 Hermes-Agent 。

Hermes-Agent 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。