hermes-agent

hermes-agent

Application Docker from rorar's Repository

Vue d'ensemble

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

Exigences

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.

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:9119]
Réseau
bridge
Coquille
bash
Paramètres supplémentaires
--shm-size=1g --user 0:0 --hostname=hermes-agent --restart=unless-stopped

Configuration du modèle

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

Cible
9119
Défaut
9119
Path: ConfigPathrw

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

Cible
/opt/data
Défaut
/mnt/user/appdata/hermes-agent
Variable: TZVariable

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

Cible
TZ
Défaut
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).

Cible
API_SERVER_ENABLED
Défaut
true
Variable: API_SERVER_HOSTVariable

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

Cible
API_SERVER_HOST
Défaut
0.0.0.0
Variable: API_SERVER_PORTVariable

Port for the API server.

Cible
API_SERVER_PORT
Défaut
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

Cible
API_SERVER_KEY
--- Matrix ---Variable

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

Variable: MATRIX_HOMESERVERVariable

Matrix homeserver URL.

Cible
MATRIX_HOMESERVER
Défaut
https://matrix-client.matrix.org
Variable: MATRIX_ACCESS_TOKENVariable

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

Cible
MATRIX_ACCESS_TOKEN
Variable: MATRIX_USER_IDVariable

Matrix user ID. Not required if MATRIX_ACCESS_TOKEN is set.

Cible
MATRIX_USER_ID
Variable: MATRIX_PASSWORDVariable

Matrix password. Not required if MATRIX_ACCESS_TOKEN is set.

Cible
MATRIX_PASSWORD
Variable: MATRIX_RECOVERY_KEYVariable

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

Cible
MATRIX_RECOVERY_KEY
Variable: MATRIX_DEVICE_IDVariable

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

Cible
MATRIX_DEVICE_ID
Défaut
HERMES_BOT
Variable: MATRIX_HOME_ROOMVariable

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

Cible
MATRIX_HOME_ROOM
Variable: MATRIX_ALLOWED_USERSVariable

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

Cible
MATRIX_ALLOWED_USERS
Variable: MATRIX_ENCRYPTIONVariable

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

Cible
MATRIX_ENCRYPTION
Défaut
true
Variable: MATRIX_REQUIRE_MENTIONVariable

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

Cible
MATRIX_REQUIRE_MENTION
Défaut
false
Variable: MATRIX_REACTIONSVariable

Show emoji reactions during message processing.

Cible
MATRIX_REACTIONS
Défaut
true
Variable: MATRIX_AUTO_THREADVariable

Auto-create threads for responses in rooms.

Cible
MATRIX_AUTO_THREAD
Défaut
true
Variable: MATRIX_FREE_RESPONSE_ROOMSVariable

Comma-separated room IDs that respond without mention.

Cible
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.

Cible
TELEGRAM_BOT_TOKEN
Variable: TELEGRAM_ALLOWED_USERSVariable

Comma-separated list of allowed Telegram user IDs.

Cible
TELEGRAM_ALLOWED_USERS
--- Discord ---Variable

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

Variable: DISCORD_BOT_TOKENVariable

Discord bot token.

Cible
DISCORD_BOT_TOKEN
Variable: DISCORD_GUILD_IDVariable

Discord guild/server ID.

Cible
DISCORD_GUILD_ID
--- Slack ---Variable

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

Variable: SLACK_BOT_TOKENVariable

Slack Bot Token (xoxb-...).

Cible
SLACK_BOT_TOKEN
Variable: SLACK_APP_TOKENVariable

Slack App Token (xapp-...).

Cible
SLACK_APP_TOKEN
--- LLM Provider ---Variable

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

Variable: OPENAI_API_KEYVariable

OpenAI API key.

Cible
OPENAI_API_KEY
Variable: OPENROUTER_API_KEYVariable

OpenRouter API key.

Cible
OPENROUTER_API_KEY
Variable: ANTHROPIC_API_KEYVariable

Anthropic API key (for Claude).

Cible
ANTHROPIC_API_KEY
Variable: GOOGLE_API_KEYVariable

Google AI API key (for Gemini).

Cible
GOOGLE_API_KEY
Variable: DEEPSEEK_API_KEYVariable

DeepSeek API key.

Cible
DEEPSEEK_API_KEY
Variable: GROQ_API_KEYVariable

Groq API key (for Groq Whisper STT).

Cible
GROQ_API_KEY
Variable: OLLAMA_BASE_URLVariable

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

Cible
OLLAMA_BASE_URL
Variable: OPENAI_BASE_URLVariable

Custom OpenAI-compatible API base URL.

Cible
OPENAI_BASE_URL
Variable: GLM_API_KEYVariable

z.ai / ZhipuAI GLM API key.

Cible
GLM_API_KEY
Variable: KIMI_API_KEYVariable

Kimi / Moonshot API key.

Cible
KIMI_API_KEY
Variable: MINIMAX_API_KEYVariable

MiniMax global API key.

Cible
MINIMAX_API_KEY
Variable: MINIMAX_CN_API_KEYVariable

MiniMax China endpoint API key.

Cible
MINIMAX_CN_API_KEY
Variable: KILOCODE_API_KEYVariable

Kilo Code API key.

Cible
KILOCODE_API_KEY
Variable: XIAOMI_API_KEYVariable

Xiaomi MiMo API key.

Cible
XIAOMI_API_KEY
Variable: HF_TOKENVariable

Hugging Face Inference Providers token.

Cible
HF_TOKEN
Variable: DASHSCOPE_API_KEYVariable

Alibaba DashScope API key.

Cible
DASHSCOPE_API_KEY
Variable: OPENCODE_ZEN_API_KEYVariable

OpenCode Zen API key.

Cible
OPENCODE_ZEN_API_KEY
Variable: OPENCODE_GO_API_KEYVariable

OpenCode Go API key.

Cible
OPENCODE_GO_API_KEY
Variable: AI_GATEWAY_API_KEYVariable

Vercel AI Gateway API key.

Cible
AI_GATEWAY_API_KEY
Variable: TAVILY_API_KEYVariable

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

Cible
TAVILY_API_KEY
Variable: EXA_API_KEYVariable

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

Cible
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).

Cible
SUDO_PASSWORD
Variable: HERMES_UIDVariable

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

Cible
HERMES_UID
Défaut
99
Variable: HERMES_GIDVariable

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

Cible
HERMES_GID
Défaut
100
Variable: UMASKVariable

UMASK for files created by the container.

Cible
UMASK
Défaut
000
Variable: HERMES_HOMEVariable

Home directory for Hermes config and data.

Cible
HERMES_HOME
Défaut
/opt/data

Catégories

Télécharger les statistiques

1,704,496
Total des téléchargements

Détails

Référentiel
nousresearch/hermes-agent:latest
Dernière mise à jour2026-05-28
Première vue2026-04-13

Exécutez hermes-agent sur Unraid.

hermes-agent est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.