hermes-agent

Overview

Hermes Agent is a self-improving AI agent built by Nous Research. Features a built-in learning loop, memory system, and supports multiple messaging platforms (Telegram, Discord, Slack, WhatsApp, Matrix, Email, etc.). Stores all config, memory, sessions, and skills in /opt/data. Access the web dashboard at the same port as the gateway API (default: 9119). For detailed setup instructions, see the official docs: https://hermes-agent.nousresearch.com/docs

Requirements

Shared memory is set to 1GB for Playwright browser automation. If you run many concurrent browser tasks, increase --shm-size to 2g or 4g in Extra Parameters. To edit Extra Parameters, switch Basic View --> Advanced View.

Runtime arguments

Web UI: http://[IP]:[PORT:9119]
Network: bridge
Shell: bash
Extra Params: --shm-size=1g --user 0:0 --hostname=hermes-agent --restart=unless-stopped

Template configuration

Port: Web DashboardPorttcp

HTTP port for the web dashboard. After setup, configure Hermes to run the dashboard command. See: https://hermes-agent.nousresearch.com/docs/user-guide/features/web-dashboard

Target: 9119
Default: 9119

Path: ConfigPathrw

Persistent config directory for Hermes (.env, config.yaml, skills, memories, logs).

Target: /opt/data
Default: /mnt/user/appdata/hermes-agent

Variable: TZVariable

Timezone for scheduling. See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List

Target: TZ
Default: Europe/Berlin

--- API Server ---Variable

Docs: https://hermes-agent.nousresearch.com/docs

Variable: API_SERVER_ENABLEDVariable

Enable the built-in HTTP API server (required for dashboard and integrations).

Target: API_SERVER_ENABLED
Default: true

Variable: API_SERVER_HOSTVariable

Host address for the API server (0.0.0.0 for all interfaces).

Target: API_SERVER_HOST
Default: 0.0.0.0

Variable: API_SERVER_PORTVariable

Port for the API server.

Target: API_SERVER_PORT
Default: 8642

Variable: API_SERVER_KEYVariable

Bearer token for API authentication. Required when binding to non-localhost. Use the same value in Open WebUI. Generate with: openssl rand -hex 32

Target: API_SERVER_KEY

--- Matrix ---Variable

Docs: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/matrix

Variable: MATRIX_HOMESERVERVariable

Matrix homeserver URL.

Target: MATRIX_HOMESERVER
Default: https://matrix-client.matrix.org

Variable: MATRIX_ACCESS_TOKENVariable

Matrix access token (recommended). User ID is auto-detected from token.

Target: MATRIX_ACCESS_TOKEN

Variable: MATRIX_USER_IDVariable

Matrix user ID. Not required if MATRIX_ACCESS_TOKEN is set.

Target: MATRIX_USER_ID

Variable: MATRIX_PASSWORDVariable

Matrix password. Not required if MATRIX_ACCESS_TOKEN is set.

Target: MATRIX_PASSWORD

Variable: MATRIX_RECOVERY_KEYVariable

Matrix recovery key for cross-signing (for E2EE).

Target: MATRIX_RECOVERY_KEY

Variable: MATRIX_DEVICE_IDVariable

Matrix device ID (leave empty for auto-generated).

Target: MATRIX_DEVICE_ID
Default: HERMES_BOT

Variable: MATRIX_HOME_ROOMVariable

Matrix room ID for bot's home room (for cron notifications).

Target: MATRIX_HOME_ROOM

Variable: MATRIX_ALLOWED_USERSVariable

Comma-separated list of allowed Matrix user IDs (empty = deny all except self).

Target: MATRIX_ALLOWED_USERS

Variable: MATRIX_ENCRYPTIONVariable

Enable end-to-end encryption (requires libolm).

Target: MATRIX_ENCRYPTION
Default: true

Variable: MATRIX_REQUIRE_MENTIONVariable

Bot only responds when mentioned in rooms (DMs always respond).

Target: MATRIX_REQUIRE_MENTION
Default: false

Variable: MATRIX_REACTIONSVariable

Show emoji reactions during message processing.

Target: MATRIX_REACTIONS
Default: true

Variable: MATRIX_AUTO_THREADVariable

Auto-create threads for responses in rooms.

Target: MATRIX_AUTO_THREAD
Default: true

Variable: MATRIX_FREE_RESPONSE_ROOMSVariable

Comma-separated room IDs that respond without mention.

Target: MATRIX_FREE_RESPONSE_ROOMS

--- Telegram ---Variable

Docs: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram

Variable: TELEGRAM_BOT_TOKENVariable

Telegram bot token from @BotFather.

Target: TELEGRAM_BOT_TOKEN

Variable: TELEGRAM_ALLOWED_USERSVariable

Comma-separated list of allowed Telegram user IDs.

Target: TELEGRAM_ALLOWED_USERS

--- Discord ---Variable

Docs: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord

Variable: DISCORD_BOT_TOKENVariable

Discord bot token.

Target: DISCORD_BOT_TOKEN

Variable: DISCORD_GUILD_IDVariable

Discord guild/server ID.

Target: DISCORD_GUILD_ID

--- Slack ---Variable

Docs: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/slack

Variable: SLACK_BOT_TOKENVariable

Slack Bot Token (xoxb-...).

Target: SLACK_BOT_TOKEN

Variable: SLACK_APP_TOKENVariable

Slack App Token (xapp-...).

Target: SLACK_APP_TOKEN

--- LLM Provider ---Variable

Docs: https://hermes-agent.nousresearch.com/docs

Variable: OPENAI_API_KEYVariable

OpenAI API key.

Target: OPENAI_API_KEY

Variable: OPENROUTER_API_KEYVariable

OpenRouter API key.

Target: OPENROUTER_API_KEY

Variable: ANTHROPIC_API_KEYVariable

Anthropic API key (for Claude).

Target: ANTHROPIC_API_KEY

Variable: GOOGLE_API_KEYVariable

Google AI API key (for Gemini).

Target: GOOGLE_API_KEY

Variable: DEEPSEEK_API_KEYVariable

DeepSeek API key.

Target: DEEPSEEK_API_KEY

Variable: GROQ_API_KEYVariable

Groq API key (for Groq Whisper STT).

Target: GROQ_API_KEY

Variable: OLLAMA_BASE_URLVariable

Ollama base URL (e.g. http://host:11434).

Target: OLLAMA_BASE_URL

Variable: OPENAI_BASE_URLVariable

Custom OpenAI-compatible API base URL.

Target: OPENAI_BASE_URL

Variable: GLM_API_KEYVariable

z.ai / ZhipuAI GLM API key.

Target: GLM_API_KEY

Variable: KIMI_API_KEYVariable

Kimi / Moonshot API key.

Target: KIMI_API_KEY

Variable: MINIMAX_API_KEYVariable

MiniMax global API key.

Target: MINIMAX_API_KEY

Variable: MINIMAX_CN_API_KEYVariable

MiniMax China endpoint API key.

Target: MINIMAX_CN_API_KEY

Variable: KILOCODE_API_KEYVariable

Kilo Code API key.

Target: KILOCODE_API_KEY

Variable: XIAOMI_API_KEYVariable

Xiaomi MiMo API key.

Target: XIAOMI_API_KEY

Variable: HF_TOKENVariable

Hugging Face Inference Providers token.

Target: HF_TOKEN

Variable: DASHSCOPE_API_KEYVariable

Alibaba DashScope API key.

Target: DASHSCOPE_API_KEY

Variable: OPENCODE_ZEN_API_KEYVariable

OpenCode Zen API key.

Target: OPENCODE_ZEN_API_KEY

Variable: OPENCODE_GO_API_KEYVariable

OpenCode Go API key.

Target: OPENCODE_GO_API_KEY

Variable: AI_GATEWAY_API_KEYVariable

Vercel AI Gateway API key.

Target: AI_GATEWAY_API_KEY

Variable: TAVILY_API_KEYVariable

Tavily API key for AI-native web search, extract, and crawl.

Target: TAVILY_API_KEY

Variable: EXA_API_KEYVariable

Exa API key for AI-native web search and content retrieval.

Target: EXA_API_KEY

--- User & Permissions ---Variable

Docs: https://hermes-agent.nousresearch.com/docs

Variable: SUDO_PASSWORDVariable

Sudo password for the container (stored in plaintext - use with caution).

Target: SUDO_PASSWORD

Variable: HERMES_UIDVariable

UID for the hermes user inside container. Match to your Unraid user (default: nobody). Set to 0 for root.

Target: HERMES_UID
Default: 99

Variable: HERMES_GIDVariable

GID for the hermes user. Match to your Unraid users group.

Target: HERMES_GID
Default: 100

Variable: UMASKVariable

UMASK for files created by the container.

Target: UMASK
Default: 000

Variable: HERMES_HOMEVariable

Home directory for Hermes config and data.

Target: HERMES_HOME
Default: /opt/data

Links

Template Support Docker Hub Project

Details

Repository

nousresearch/hermes-agent:latest

Registry

https://hub.docker.com/r/nousresearch/hermes-agent/

Last Updated2026-05-28

First Seen2026-04-13

Run hermes-agent on Unraid.

hermes-agent is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS

hermes-agent

Overview

Requirements

Runtime arguments

Template configuration

Categories

Download Statistics

Links

Details

Run hermes-agent on Unraid.