Hermes Agent Template

The Hermes Agent template creates a ready-to-publish agent powered by Nous Research Hermes Agent. It runs as a daemon with persistent memory, self-improving skills, and cross-session recall.

Create

charm init my-hermes-agent --template hermes-agent

What You Get

my-hermes-agent/
├── charm.yaml           # lifecycle: daemon, adapter: hermes
├── .charmignore
├── requirements.txt     # charm-adapter-hermes dependency
└── src/
    ├── __init__.py
    └── main.py           # AIAgent instance — customize here

Prerequisites

Charm CLI installed.
An LLM API key (OpenRouter, OpenAI, or Anthropic).
For production: a daemon-capable runner (Fly.io backend configured).

Configuration

Set your API key before running:

export OPENROUTER_API_KEY="sk-or-..."

Changing the model

Edit src/main.py or set the environment variable:

export CHARM_HERMES_MODEL="anthropic/claude-sonnet-4-20250514"

Key charm.yaml fields

runtime:
  adapter:
    type: "hermes"
    entry_point: "src.main:agent"
  lifecycle: "daemon"       # persistent container on Fly.io

Run Locally

charm run --input '{"query": "Hello, who are you?"}'

Publish

charm validate .
charm push

Why Daemon?

Hermes agents store conversation history, auto-generated skills, and user models in an SQLite database. The daemon lifecycle ensures this data persists across interactions by mounting a shared workspace (CHARM_WORKSPACE_DIR). Without daemon mode, the database would be lost after each serverless invocation.

Agent Templates

Hermes Agent Template

Create

What You Get

Prerequisites

Configuration

Changing the model

Key charm.yaml fields

Run Locally

Publish

Why Daemon?

Further Reading

​Create

​What You Get

​Prerequisites

​Configuration

​Changing the model

​Key charm.yaml fields

​Run Locally

​Publish

​Why Daemon?

​Further Reading

Create

What You Get

Prerequisites

Configuration

Changing the model

Key charm.yaml fields

Run Locally

Publish

Why Daemon?

Further Reading