Hermes-Agent

Hermes-Agent

Docker-Anwendung from martial's Repository

Übersicht

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.

Anforderungen

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.

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:9119]
Netzwerk
docker
Shell
bash
Privilegiert
false

Konfiguration der Vorlage

Gateway PortPorttcp

Internal port for the Hermes Gateway and API server

Ziel
8642
Standard
8642
Wert
8642
Dashboard PortPorttcp

Internal port for the Hermes Dashboard

Ziel
9119
Standard
9119
Wert
9119
API_SERVER_ENABLEDVariable

Enable the API server

Standard
true
Wert
true
API_SERVER_HOSTVariable

Bind Host for the API server

Standard
0.0.0.0
Wert
0.0.0.0
API_SERVER_KEYVariable

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

Wert
bd3db74dd31a13c4f23c137eca542a1ae76d403d5dc6453926820e9e7b9e28a4
API_SERVER_CORS_ORIGINSVariable

CORS origins for the API server

Wert
*
HERMES_DASHBOARDVariable

Enable the Hermes Dashboard

Standard
true
Wert
true
HERMES_DASHBOARD_HOSTVariable

Bind Host for the Hermes Dashboard

Standard
0.0.0.0
Wert
0.0.0.0
HERMES_DASHBOARD_TUIVariable

Set to 1 to expose the in-browser Chat tab

Standard
1
Wert
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

Standard
1
Wert
1
HERMES_UIDVariable

UID to use for content

Standard
99
Wert
99
HERMES_GIDVariable

GID to use for content

Standard
100
Wert
100
HERMES_HOMEVariable

Home directory for Hermes data

Standard
/home/hermes/.hermes
Wert
/home/hermes/.hermes
HERMES_HOME Unraid locationPathrw

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

Ziel
/home/hermes/.hermes
Standard
/mnt/user/appdata/hermes-agent/hermes-home
Wert
/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)

Ziel
/opt/hermes
Standard
hermes_shared_volume
Wert
hermes_shared_volume

Kategorien

Statistik herunterladen

1,130,318
Downloads insgesamt

Einzelheiten

Repository
nousresearch/hermes-agent:latest
Zuletzt aktualisiert2026-05-13
Erstmals gesehen2026-04-13

Führen Sie Hermes-Agent auf Unraid aus.

Hermes-Agent ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.