MuninnDB Documentation

MuninnDB is the world's first cognitive database. Instead of storing rows or documents, it stores engrams — memory traces that decay, learn associations, and trigger notifications when they become relevant.

What is MuninnDB?

Traditional databases are passive: you query them, they respond. They store data without any concept of time, relevance, or learning. Every record sits in your database with equal weight whether it was created yesterday or three years ago.

MuninnDB is different at the storage engine level. It implements three cognitive primitives that make memory behavior emerge from the database itself:

• Decay — Memories fade over time using the Ebbinghaus forgetting curve. Old, unused engrams drift toward a low-relevance floor. Fresh, accessed engrams stay prominent.
• Hebbian Learning — When two engrams are retrieved together repeatedly, their association strengthens automatically. "Neurons that fire together, wire together" — implemented as database math.
• Semantic Triggers — Subscribe to a context string. MuninnDB pushes a notification when a matching memory becomes relevant. No polling required.

These aren't application-layer features. They're built into how the storage engine reads and writes data. Every ACTIVATE query is both a retrieval and a learning event.

Key Concepts

• Engram — The fundamental unit of storage. A concept, content, confidence score, relevance score, and weighted associations to other engrams.
• ACTIVATE — The primary query type. Provide a context string, get back the N most cognitively relevant engrams.
• Vault — A namespace for engrams. Each AI agent or user typically gets their own vault.
• Confidence — A Bayesian posterior (0.0–1.0) tracking how reliable an engram is. Updated by reinforcements and contradictions.
• Relevance — The current Ebbinghaus decay score. Continuous, not static.

Protocols

MuninnDB exposes four interfaces:

• MBP (Muninn Binary Protocol) — TCP on port 8747. Fastest, lowest latency. Use for production agents.
• gRPC — Port 8748. Standard Protobuf interface. Good for polyglot teams.
• REST — Port 8749. HTTP/JSON. Easy integration, good for testing.
• MCP — Model Context Protocol. 11 tools for Claude, Cursor, and any MCP-compatible agent.

Open Source

MuninnDB core is licensed under Apache 2.0. The source is available at github.com/scrypster/muninndb. No cloud account required. Run it anywhere.