Unofficial Hermes Agent Helm Chart for Hermes Agent

Community Helm chart that packages Hermes Agent for Kubernetes with state-safety guardrails

What Unofficial Hermes Agent Helm Chart does

The chart renders Hermes' Deployment, storage, secrets, service, ingress and optional Istio resources directly in its default direct-deployment mode, and also exposes an API-first operator-ready mode with tenant CRDs for clusters running a compatible controller. Because Hermes stores mutable state under HERMES_HOME, the chart enforces replicaCount: 1 and strategy.type: Recreate whenever persistence is enabled, and recommends one Helm release per tenant rather than scaling a single release horizontally.

Configuration layers include structured YAML (config.values), raw templated YAML (config.raw), and standard environment and secret injection, while bootstrap.enabled seeds config.yaml and an optional SOUL.md into HERMES_HOME on first run. The README states plainly, in both modes, that this chart is independent of the upstream Hermes project.

Key features

Single-writer state safety enforced through replica count and update strategy
Direct-deployment mode rendering Hermes' full Kubernetes resource set
Operator-ready mode with tenant CRDs for clusters running a compatible controller
Layered configuration through structured values, raw YAML and environment injection
Bootstrap support for seeding config.yaml and SOUL.md on first run

When to use it

Running a single-tenant Hermes Agent gateway reliably inside a Kubernetes cluster
Giving a platform team a reviewable, state-safe default deployment for Hermes
Bootstrapping Hermes configuration and persona files through Helm-managed resources

Who it is for: Platform teams who need to run Hermes Agent on Kubernetes without hand-writing the Deployment, storage and secret manifests themselves.

How it fits with Hermes Agent

The chart exists specifically to deploy Hermes Agent on Kubernetes and is explicit that it is an independent, unofficial community project.

How to install Unofficial Hermes Agent Helm Chart

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

helm install hermes . \
  --namespace hermes \
  --create-namespace

Note: This is an unofficial, community-maintained chart, independent of the upstream Hermes Agent project.

FAQ

What is Unofficial Hermes Agent Helm Chart?

It is a community Helm chart that packages Hermes Agent for Kubernetes, with single-writer state safety and both a direct-deployment mode and an API-first operator-ready mode.

Does it work with Hermes Agent?

Yes, it exists specifically to deploy Hermes Agent, running its gateway as the default command inside the rendered Kubernetes Deployment.

How do I install this Helm chart?

Run helm install hermes . with the --namespace hermes --create-namespace flags from a checkout of the chart, then supply your API key and model settings through Helm values.