Hermes Atlas
Memory & knowledge

Brainstack

yepyhun/Brainstack

Hermes-native composite memory provider combining profile, session, temporal graph and corpus recall

In short

Brainstack is a memory kernel for Hermes Agent, built as a composite MemoryProvider that combines profile memory, session continuity, a temporal knowledge graph and corpus retrieval under one memory owner. It adapts ideas from Hindsight, Graphiti and MemPalace.

What Brainstack does

Brainstack gives Hermes a structured memory model instead of one memory blob. It is a composite MemoryProvider for persistent agents, covering profile memory, session continuity, temporal graph truth and corpus retrieval under a single memory owner inside Hermes. The README tags it Hermes-native, local-first and donor-grounded, and credits three memory projects: Hindsight for bounded continuity and after-turn learning, Graphiti for temporal graph relations and conflict handling, and MemPalace for large-corpus retrieval with cited evidence.

A query first passes a risk and intent check, then pulls from the matching shelves: profile, continuity, graph, corpus, and a bounded transcript fallback adapted from Hermes-LCM. A control plane packs the smallest useful evidence set for Hermes, and after-turn learning writes new information back to the right shelf. A wizard installs the integration, doctor checks and optional compatibility support. An optional Hermes Proactive Extension for heartbeat-style proactivity is installed only on request.

Key features

  • Composite MemoryProvider with profile, continuity, graph and corpus shelves
  • Temporal graph memory that tracks how facts change over time
  • Large-corpus retrieval with source and chunk identity and cited evidence
  • Query routing that packs the smallest useful evidence set instead of stuffing transcripts
  • After-turn learning that writes to the right shelf
  • Installer wizard with doctor checks and an optional proactive extension

When to use it

  • Running an always-on Hermes agent that needs long-horizon memory
  • Keeping stable preferences and changing facts in separate stores
  • Recalling from a large document corpus with cited evidence

Who it is for: Developers building always-on, Hermes-based second-brain systems who need more than transcript search.

How it fits with Hermes Agent

Hermes-native: it plugs in as a Hermes MemoryProvider and keeps runtime ownership in Hermes.

Note: GitHub reports the license as NOASSERTION, so read the license text before reuse.

FAQ

What is Brainstack?

Brainstack is a memory kernel for Hermes Agent. It splits memory into profile, continuity, graph and corpus shelves under one Hermes MemoryProvider instead of using a single memory store.

How does Brainstack answer a query?

It checks risk and intent, recalls from the profile, continuity, graph and corpus shelves as needed, and packs a small evidence set for Hermes. Raw transcript text is used only as a bounded fallback.

Is Brainstack free and open source?

The repository is public, but GitHub reports its license as NOASSERTION, meaning it could not identify the license type. Read the license text in the repository before reusing the code.

Similar memory for Hermes Agent

All memory

Related guides: SOUL.md for Hermes Agent: what it is and how to write one · Run multiple Hermes agents with profiles