hermes-brain-memory

Brain Memory provider for Hermes Agent — one local-first memory shared across all your AI agents. The same human-readable Markdown store in ~/.brain/ is read and written by Claude Code, Codex, OpenCode, and OpenClaw, so Hermes remembers what your other agents learned — and vice versa.

Memories are plain Markdown files with YAML frontmatter (greppable, diffable, editable). They decay over time, strengthen with use (spaced reinforcement), and connect through an associative network with spreading activation. The model decides what to remember via explicit tools; the brain CLI scores recall deterministically.

Zero pip dependencies — this package and the provider it installs are Python stdlib only.

Install

# 1. The brain CLI (once, if you don't already use Brain Memory)
npm install -g brain-memory

# 2. This package + the provider
pip install hermes-brain-memory       # or: uv tool install / pipx install hermes-brain-memory
hermes-brain-memory install           # copies the provider into $HERMES_HOME/plugins/brain

Activate

hermes config set memory.provider brain
hermes memory setup        # optional guided configuration
hermes memory status       # verify: "brain" should show as installed & available

Or set it directly in $HERMES_HOME/config.yaml (usually ~/.hermes/config.yaml):

memory:
  provider: brain

Only one external memory provider can be active at a time; Hermes' built-in MEMORY.md/USER.md memory keeps running alongside.

What it does

No transcript dumping: sync_turn does lightweight in-memory topic tracking only. Nothing leaves the machine unless you enable Brain's own sync (Brain Cloud or a private Git remote).

Installer commands

hermes-brain-memory install [--force]   # copy/update the provider (idempotent; --force overwrites)
hermes-brain-memory uninstall           # remove it ($HERMES_HOME/plugins/brain only — ~/.brain is untouched)
hermes-brain-memory status              # install state, brain CLI, active memory.provider

HERMES_HOME (or --hermes-home PATH) selects the Hermes profile to install into; default ~/.hermes.

Configuration

Stored in $HERMES_HOME/brain.json (written by hermes memory setup); environment variables override.

Requirements

• Hermes Agent (a version with pluggable memory providers)
• The brain CLI from the brain-memory npm package
• Python 3.10+ — no pip dependencies

Docs & source

• Brain Memory: brainmemory.ai
• Source & full integration docs: github.com/omelas-tech/brain (integrations/hermes/)
• Hermes memory providers: hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers

License

MIT © Omelas