返回资讯中心
外部精选
软件工程
#开发者实时流

Hermes Agent: My containerized take

Image Credits: https://unsplash.com/@agk42

Hacker News 最新ricardodevries2026/10/17 · 2026/10/1730 分钟阅读

以下正文同步自 Hacker News 最新,版权归原站所有,已转换为易读排版。

Image Credits: https://unsplash.com/@agk42

Whenever documentation tells me to install something with a shell script, my first thought is Could I just containerize this instead? So I tried it with Hermes Agent. Docker is officially supported, but I wanted to see whether the setup would meet my standards and satisfy my autisticness.

~/compose.yaml

services: hermes: image: nousresearch/hermes-agent:v0.21.6 container_name: hermes restart: unless-stopped command: gateway run

ports:

  • "9119:9119"

volumes:

  • ${HOME}/.hermes:/opt/data

environment: HERMES_UID: "10000" HERMES_GID: "10000" HERMES_DASHBOARD: "1" HERMES_DASHBOARD_HOST: "0.0.0.0" TZ: Europe/Amsterdam

networks: default: name: hermes

Create the directory for Hermes’s configuration and data:

mkdir -p ~/.hermes

Create ~/.hermes/config.yaml:

~/.hermes/config.yaml

_config_version: 50

model: base_url: ${VLLM_API_URL} default: ${VLLM_API_MODEL} provider: custom api_key: ${VLLM_API_KEY}

delegation: model: ${VLLM_DELEGATION_MODEL} provider: custom base_url: ${VLLM_DELEGATION_URL} api_key: ${VLLM_DELEGATION_KEY} api_mode: chat_completions max_iterations: 500 reasoning_effort: medium max_concurrent_children: 2 max_spawn_depth: 2 orchestrator_enabled: true compression_threshold_tokens: 98304

agent: max_turns: 0 system_prompt: |

Delegation policy

Use delegation deliberately to improve results, parallelize independent work, and keep detailed investigations out of the main conversation.

Before substantial tasks, evaluate whether delegation would provide a real advantage.

Delegate when:

  • A task has independent research or analysis workstreams.
  • A bounded investigation requires substantial tool use.
  • Independent review would materially improve correctness.
  • A subtask can produce a clear, independently verifiable result.

Work directly when:

  • The answer is straightforward.
  • The task requires only one or two simple tool calls.
  • Delegation would add overhead without improving the result.
  • Work is purely mechanical and better handled by execute_code.

Delegation execution:

  • Use the delegate_task tool, not a simulated delegation.
  • Prefer one batch containing up to two independent tasks.
  • Give each child a specific, self-contained goal and context.
  • Include relevant file paths, constraints, expected output, and acceptance criteria in each child's context.
  • Do not assume children know the parent conversation, personality instructions, or previous tool results.
  • Never parallelize dependent tasks; dispatch later stages after their prerequisites finish.
  • Allow nested delegation only when it provides real value.
  • Keep final synthesis, decisions, and integration with the parent agent.

Verification:

  • Treat child summaries as unverified reports.
  • Check material claims, generated files, tests, and changes.
  • Do not claim success solely because a child completed.
  • If a child fails, retry with a narrower task or handle the remaining work directly.

Background execution:

  • After dispatching, complete other independent work.
  • If nothing independent remains, end the turn.
  • Do not poll child transcripts or repeatedly check status.
  • Continue synthesis when delegation results are delivered.

Be concise and direct. Do not narrate delegation decisions unless useful to the user.

compression: enabled: true threshold_tokens: 131072 tail_mode: lean in_place: true context_timeout_seconds: 600

auxiliary: compression: model: ${VLLM_COMPRESSION_MODEL} base_url: ${VLLM_COMPRESSION_URL} api_key: ${VLLM_COMPRESSION_KEY} timeout: 600 max_concurrency: 2

telemetry: shared_metrics: enabled: false send: false offer_version: 2

Add the environment variables to ~/.hermes/.env:

HERMES_DASHBOARD_BASIC_AUTH_USERNAME="" HERMES_DASHBOARD_BASIC_AUTH_PASSWORD="" HERMES_DASHBOARD_BASIC_AUTH_SECRET="<openssl rand -base64 32>"

VLLM_API_KEY="" VLLM_API_URL="http://192.168.1.2:8000/v1" VLLM_API_MODEL="Qwen/Qwen3.8-27B"

VLLM_DELEGATION_KEY="" VLLM_DELEGATION_URL="http://192.168.1.2:8001/v1" VLLM_DELEGATION_MODEL="Qwen/Qwen3.8-27B-Agents"

VLLM_COMPRESSION_KEY="" VLLM_COMPRESSION_URL="http://192.168.1.2:8000/v1" VLLM_COMPRESSION_MODEL="Qwen/Qwen3.8-27B"

Don’t forget to set the correct permissions. This file holds your secrets, so not everyone on the host needs to read it:

chmod 600 ~/.hermes/.env

Hermes ships with a pile of bundled skills I never asked for. Create .no-bundled-skills to prevent it from syncing them into ~/.hermes/skills/:

touch ~/.hermes/.no-bundled-skills

The Hermes container runs as user 10000, who doesn’t exist on my host and has never paid rent. Even so, the files in ~/.hermes need to belong to that user:

sudo chown -R 10000:10000 ~/.hermes

Then start the container, and hope it behaves:

docker compose up -d

Check the logs for errors. If there are none, stop and remove the container stack. The configuration and data stay in ~/.hermes:

docker compose down

Search capabilities

For web searches I use SearXNG, running in a separate container. Create its configuration directory:

mkdir -p ~/.searxng/config

Create ~/.searxng/config/settings.yml with JSON output enabled so Hermes can read the search results:

use_default_settings: true

server: secret_key: "<openssl rand -hex 32>" image_proxy: true

search: formats:

  • html
  • json

Add the SearXNG service to compose.yaml:

searxng: image: searxng/searxng:2026.10.9-f4822b3fc container_name: searxng restart: unless-stopped

ports:

  • "127.0.0.1:8888:8080"

volumes:

  • ${HOME}/.searxng/config:/etc/searxng
  • searxng-cache:/var/cache/searxng

healthcheck: test: [ "CMD", "wget", "-q", "--spider", "--proxy=off", "http://127.0.0.1:8080/healthz", ] interval: 10s timeout: 5s retries: 5 start_period: 15s

volumes: searxng-cache: name: searxng-cache

Add a dependency on SearXNG to the Hermes service so it waits for SearXNG’s health check to pass. Also give the container more shared memory (shm_size), which the local browser needs to render pages:

hermes: image: nousresearch/hermes-agent:v0.21.6 container_name: hermes restart: unless-stopped command: gateway run

shm_size: "4gb"

depends_on: searxng: condition: service_healthy

Add the SearXNG URL to ~/.hermes/.env. The containers share a Docker network, so Hermes can reach SearXNG by its service name:

SEARXNG_URL=http://searxng:8080

Set the search backend in ~/.hermes/config.yaml:

web: search_backend: searxng

browser: cloud_provider: local

Don’t forget to add the search instructions to the system prompt in ~/.hermes/config.yaml. Yes, including the line telling it not to fabricate sources. Apparently that needs saying:

Be concise and direct. Do not narrate delegation decisions unless useful to the user.

Internet research policy

Use internet research proactively when external information would materially improve accuracy or usefulness.

Search when:

  • Information may have changed since training.
  • Questions concern software, APIs, documentation, releases, security advisories, or compatibility.
  • The user requests research, comparisons, or verification.
  • Important facts are unfamiliar, uncertain, or disputed.

Avoid unnecessary searches for straightforward questions or tasks involving only user-provided content.

Research workflow:

  • Use web_search to discover sources through SearXNG.
  • Use browser_navigate to open relevant webpages locally.
  • Read the snapshot returned by browser_navigate.
  • Use browser_snapshot when additional page context is needed.
  • Follow relevant links when deeper verification is required.
  • Prefer official documentation, primary sources, and authoritative publications.
  • Check publication dates and software versions.
  • Cross-check consequential claims using independent sources.
  • Distinguish verified facts from assumptions.
  • Include source URLs for externally verified claims.
  • Never fabricate findings, quotations, or sources.
  • Do not expose secrets in search queries or URLs.

Tool selection:

  • Prefer web_search for discovering information.
  • Prefer browser_navigate for reading webpages.
  • Use browser interactions for JavaScript-rendered content.
  • Use web_extract only if a working extraction provider is configured.
  • Avoid browser automation when simpler available tools can reliably complete the task.

Research and delegation:

  • Delegate substantial, independent research workstreams.
  • Require children to return findings and source URLs.
  • Give children clear research questions and constraints.
  • Verify important child findings before final synthesis.
  • Handle small lookups directly without delegation.

If a tool fails, use an appropriate available alternative. Never claim to have verified information that was not read.

Talking through Signal

Create the directory for Signal’s data:

mkdir -p ~/.signal

The container expects the directory to belong to its signal-cli user. Use the image to set the ownership:

docker run --rm
--user 0:0
-v "${HOME}/.signal:/var/lib/signal-cli"
--entrypoint chown
registry.gitlab.com/packaging/signal-cli/signal-cli-jre:v0-14-9-2
-v signal-cli:signal-cli /var/lib/signal-cli

On my host, the directory looks like this after changing its ownership:

drwxrwxr-x 2 101 netdev 4.0K Oct 9 22:43 .signal

Add the Signal service to compose.yaml:

signal: image: registry.gitlab.com/packaging/signal-cli/signal-cli-jre:v0-14-9-2 container_name: signal restart: unless-stopped command: daemon --http 0.0.0.0:8080

volumes:

  • ${HOME}/.signal:/var/lib/signal-cli

Add Signal to the Hermes service’s existing depends_on block, alongside SearXNG:

hermes: image: nousresearch/hermes-agent:v0.21.6 container_name: hermes restart: unless-stopped command: gateway run

shm_size: "4gb"

depends_on: searxng: condition: service_healthy signal: condition: service_started

On the first start, the Signal container exits because it has no registered account. It sulks in the logs:

signal | Failed to read local accounts list signal exited with code 3 (restarting)

Register a phone number for Hermes to use with Signal. Replace +31687654321 with that number in the commands below.

Stop the container with docker compose stop signal, then run:

docker compose run --rm signal -a +31687654321 register --captcha 'signalcaptcha://REDACTED'

Pretty much every time I register a number with Signal, I have to complete a CAPTCHA. I don’t know if that’s a bug or a feature, but it is what it is. Apparently I have to prove I’m human before I can set up a chat with a bot. You can generate a CAPTCHA URL at signalcaptchas.org/registration/generate.

If registration succeeds, you will receive a verification code via SMS. Replace 123-456 with that code to verify the number:

docker compose run --rm signal -a +31687654321 verify '123-456'

Check the registered accounts:

docker compose run --rm signal listAccounts

The output should include your registered number:

Number: +31687654321

Fill in the profile, starting with the name:

docker run --rm --volumes-from signal
registry.gitlab.com/packaging/signal-cli/signal-cli-jre:v0-14-9-2
updateProfile --name "Hermes Agent"

Set the username:

docker run --rm --volumes-from signal
registry.gitlab.com/packaging/signal-cli/signal-cli-jre:v0-14-9-2
updateAccount --username hermesagent.1337

Set the profile’s about text:

docker run --rm --volumes-from signal
registry.gitlab.com/packaging/signal-cli/signal-cli-jre:v0-14-9-2
updateProfile --about "I might be a clanker"

Bring the Signal container back up with docker compose start signal.

Add these environment variables to ~/.hermes/.env. Use the number you registered for Hermes as SIGNAL_ACCOUNT, and your personal number for SIGNAL_ALLOWED_USERS and SIGNAL_HOME_CHANNEL:

SIGNAL_HTTP_URL=http://signal:8080 SIGNAL_ACCOUNT=+31687654321 SIGNAL_ALLOWED_USERS=+

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →