Docs
Everything to evaluate, install, and operate Heartwood Memory. A full hosted docs portal is on the way — for now, deep references live in the repository.
Quickstart
Install, remember, and recall under policy in minutes.
Integration guides
Markdown import, warm recall, MCP server, bulk API, and end-to-end onboarding.
Concepts
Typed memory, provenance, policy-before-ranking, faithfulness, deletion lineage.
Python & TypeScript API
Full reference for remember, recall, explain_recall, approve, forget.
Deployment
Docker runtime, MCP server, and embedded usage beside your stack.
Governance & trust suite
The executable gates behind every claim — run them yourself.
Key custody
Envelope encryption, crypto-shred DEKs, and KMS/HSM-compatible custody.
Install and run
Pick a surface and go. The core is open source and self-hosted — your data never leaves your environment.
The embedded library. Remember and recall in a few lines, governed by default.
python -m pip install "heartwood-memory[recall,mcp]"
from heartwood import Heartwood
hw = Heartwood(path="./heartwood.db", tenant="tenant:acme")
hw.remember(
"Refunds over $500 require finance approval.",
subject="policy:refunds",
created_by="agent:support",
)
results = hw.recall("what is the refund policy?", principal_id="agent:support")