feat: add CerebroCortex memory provider plugin

Brain-analogous AI memory with associative networks, ACT-R/FSRS decay,
spreading activation, and LLM-powered dream consolidation.

Features:
- 5 tools: cc_remember, cc_recall, cc_todo, cc_message, cc_health
- Automatic prefetch (relevant memories injected before each turn)
- Background sync (significant user messages auto-stored)
- Session end summaries
- Built-in memory mirroring (MEMORY.md writes → CerebroCortex)
- Delegation capture (subagent results stored as memories)
- Multi-agent messaging (send_message/check_inbox)
- Zero cloud dependencies — SQLite + ChromaDB + igraph, all local

Install: pip install cerebro-cortex
Repo: https://github.com/buckster123/CerebroCortex
Closes #7896
This commit is contained in:
buckster123 2026-04-11 21:45:47 +02:00
parent af9caec44f
commit 20cfccdf1f
3 changed files with 610 additions and 0 deletions

View file

@ -0,0 +1,106 @@
# CerebroCortex Memory Provider
Brain-analogous AI memory for Hermes Agent with associative networks,
biologically-inspired decay, and dream consolidation.
## What it does
CerebroCortex replaces simple key-value memory with a system modeled on
how biological memory actually works:
- **6 memory types** — episodic, semantic, procedural, affective,
prospective (TODOs), schematic (patterns)
- **Associative graph** — memories link together via 9 typed/weighted
link types. Search spreads activation through the graph, surfacing
related memories you didn't explicitly search for
- **Natural decay** — ACT-R power-law activation + FSRS spaced-repetition.
Frequently-used memories stay sharp, noise fades automatically
- **Dream engine** — Offline LLM-powered consolidation: pattern extraction,
schema formation, pruning, cross-domain discovery
- **Multi-agent messaging** — send_message/check_inbox for agent-to-agent
communication through shared memory
All data is local (SQLite + ChromaDB + igraph). No cloud services required.
Runs on hardware as minimal as a Raspberry Pi 5 (4GB).
## Install
```bash
pip install cerebro-cortex
```
## Setup
```bash
hermes memory setup
# Select "cerebrocortex" from the list
```
Or manually in `~/.hermes/config.yaml`:
```yaml
memory:
provider: cerebrocortex
```
## Tools
| Tool | Description |
|------|-------------|
| `cc_remember` | Store a memory (auto-classifies, deduplicates, links) |
| `cc_recall` | Semantic search with graph activation and decay scoring |
| `cc_todo` | Store/list/resolve TODOs and reminders |
| `cc_message` | Cross-agent messaging (send/inbox) |
| `cc_health` | System health and statistics |
## Automatic features
- **Prefetch** — Before each turn, relevant memories are recalled and
injected as context
- **Sync** — Significant user messages are auto-stored in background
- **Session end** — Session summary saved automatically
- **Memory mirror** — Built-in MEMORY.md/USER.md writes are mirrored
to CerebroCortex for searchability
- **Delegation capture** — Subagent task/result pairs stored as memories
## Configuration
| Key | Description | Default |
|-----|-------------|---------|
| `agent_id` | Agent identifier for multi-agent setups | `HERMES` |
| `data_dir` | Data directory path | `~/.cerebro-cortex/` |
Set via `hermes memory setup` or in config.yaml:
```yaml
plugins:
cerebrocortex:
agent_id: HERMES
data_dir: ~/.cerebro-cortex/
```
## Multi-agent
Multiple Hermes instances can share a CerebroCortex store:
```yaml
# Instance 1
plugins:
cerebrocortex:
agent_id: HERMES-PRIMARY
# Instance 2
plugins:
cerebrocortex:
agent_id: HERMES-RESEARCH
```
Agents communicate via `cc_message`:
- `cc_message(action="send", to="HERMES-RESEARCH", content="...")`
- `cc_message(action="inbox")`
## Links
- [CerebroCortex repo](https://github.com/buckster123/CerebroCortex)
- [PyPI](https://pypi.org/project/cerebro-cortex/)
- [Integration report](https://github.com/buckster123/CerebroCortex/blob/main/HERMES_INTEGRATION_REPORT.md)