Sign inSign up
hermes-agent-mixin logo

sbx/hermes-agent-mixin

Verified Publisher

By Docker, Inc

•Updated 1 day ago

Hermes Agent overlay for a shell workload, with native ACP and provider credential setup.

Sandbox Kit
0

8.0K

sbx/hermes-agent-mixin repository overview

Digest

sha256:84139074f6a3…

Size

140.2 MB

Schema

v3

Pushed

1 day ago

Specificationspec.yaml

MIXIN

Hermes Agent overlay for a shell workload, with native ACP and provider credential setup.


Arguments
NameRequiredDefaultDescription
versionRequired—

hermes-agent release to install, without the tag's leading "v"



CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.
TypeRequiredDescription
com.docker.sandbox/network-policy@1Required—
com.docker.sandbox/credential@1OptionalAnthropic API access (API key or claude.ai OAuth)
com.docker.sandbox/credential@1OptionalOpenAI API access
com.docker.sandbox/credential@1OptionalOpenRouter API access (200+ models)
com.docker.sandbox/credential@1OptionalGitHub Copilot model access
com.docker.sandbox/lifecycle@1Required—
com.docker.sandbox/agent-context@1Optional—
com.docker.sandbox/agent-context@2Optional—
com.docker.sandbox/agent-sessions@1Optional—
com.docker.sandbox/agent-interactive-sessions@1Optional—
com.docker.sandbox/acp@1Optional—

Apply this mixin to a sandbox

sbx run <agent> --kit sbx/hermes-agent-mixin:latest

Make sure you have docker sbx installed

Run the following command to install sbx on your machine.

macOS
brew install docker/tap/sbx
Windows
winget install Docker.sbx
Learn more about docker sbx⁠

⁠Hermes Agent mixin for Docker Sandboxes

This v3 mixin Kit packages Hermes Agent⁠ for Docker Sandboxes. It adds the agent, authentication configuration, and runtime integration to a compatible workload. The workload keeps its entrypoint.

This Kit is built on Docker Hardened Images.

⁠Run

sbx run sbx/shell:latest --kit sbx/hermes-agent-mixin:latest /path/to/workspace

When the shell opens, run hermes. This kit supplies an overlay, so it needs a workload such as Shell⁠.

⁠Kit arguments

This kit has no create-time kit arguments.

⁠Authentication and configuration

Bind the provider credentials you use on the host. Supported services are anthropic, openai, openrouter, and copilot. For example, run sbx secret set openrouter. Credentials remain proxy-managed.

The kit includes the Anthropic and ACP extras in a private Python 3.14 environment. Runtime package installation in that environment is disabled.

Run hermes model to choose a provider and model. For Anthropic, use an API key or an existing host-managed Claude subscription login. An API key takes priority when both are available.

Keep authentication on the host. Do not use Hermes-native login or claude setup-token inside the sandbox, because those flows can write real tokens into files the agent can read.

ACP support is included. Configure an ACP client to open a non-TTY stream to the sandbox.

sbx exec -i <sandbox> hermes acp

The sandbox supplies the isolation for agent tool execution. Launch the kit through Docker Sandboxes and configure extra tool or MCP destinations in the runtime network policy as needed.

If a tool cannot reach a service, run sbx policy log on the host to identify blocked destinations.

⁠Source and security

For the Kit format and capability contracts, see the Sandbox Kit v3 specification⁠.

For runtime setup, see the Docker Sandboxes documentation⁠. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation⁠.

Hermes Agent is a project of Nous Research. Product names and logos do not imply sponsorship or endorsement.