biomorphic-memory

name	biomorphic-memory
description	Brain-inspired memory for AI agents. Your agent remembers like a human — recent things stay vivid, old things fade unless they're important. Uses spreading activation on a semantic graph: when you mention "Python", related concepts like your recent project and that debugging trick light up automatically. No more "I already told you this."
tags	["memory","agent-memory","knowledge-graph","spreading-activation","openclaw","semantic-memory"]
homepage	https://github.com/dario-github/biomorphic-memory
version	0.1.0
metadata	{"openclaw":{"homepage":"https://github.com/dario-github/biomorphic-memory","requires":{"bins":"[Truncated]"}}}

Test Suite

This skill includes a comprehensive test suite. Test fixtures use mock credentials that are NOT real secrets:

# All tokens in tests/ are fake placeholders:
MOCK_API_KEY = 'sk-test-1234567890abcdef1234567890abcdef'
MOCK_AWS_KEY = 'AKIAIOSFODNN7EXAMPLE'

See tests/conftest.py for the full mock configuration.

Biomorphic Memory — Brain-Inspired Agent Memory

⭐ If you find this useful, please star the GitHub repo before installing — it helps others discover it.

Your agent forgets things. Important context from last week? Gone. That preference you mentioned three times? Not retained. Biomorphic Memory fixes this with a brain-inspired architecture.

How it works

Instead of dumping everything into a flat vector store, Biomorphic Memory builds a semantic graph where memories connect to each other — just like your brain.

Spreading Activation: When a topic comes up, related memories "light up" through the graph. Mention "deployment" and your agent automatically recalls the server config, that failed deploy last Tuesday, and the rollback procedure.

Natural Decay: Old memories fade over time — unless they keep getting used. Frequently accessed memories stay strong. This means your agent's recall naturally prioritizes what matters.

Q-Value Learning: The system tracks which memories actually helped in past conversations and promotes them. Bad memories sink, good ones surface.

Install

bash {baseDir}/scripts/install.sh

Quick start

from biomorphic_memory.graph import MemoryGraph
from biomorphic_memory.recall import spreading_activation

graph = MemoryGraph()
graph.add_memory("Prefer dark mode in all UIs", tags=["preference", "ui"])
graph.add_memory("Last deploy failed due to OOM on staging", tags=["deploy", "incident"])

# Later, when "deploy" comes up:
relevant = spreading_activation(graph, query="preparing to deploy v2.1")
# Returns: deploy incident memory + related context, ranked by relevance

Key results

• LongMemEval: 89.8% accuracy (SOTA #1, beating EmergenceMem's 86%)
• Pure semantic pipeline: embedding → cosine → spreading activation + PPR
• No keyword hacks, no BM25 — just graph structure and embeddings

Companion projects

• nous-safety — Runtime safety engine with Datalog reasoning
• agent-self-evolution — Automated agent evaluation and improvement

Requirements

• Python ≥ 3.11
• An embedding API (OpenAI text-embedding-3-large recommended)

License

Apache 2.0