lelin1997/minimem

<p align="center"> <img src="https://img.shields.io/badge/status-beta-orange" alt="Status"> <img src="https://img.shields.io/badge/license-MIT-green" alt="License"> <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-blue" alt="Node"> <img src="https://img.shields.io/badge/TypeScript-5.8-blue" alt="TypeScript"> </p>

🧠 MiniMem

A Self-Hosted Personal Memory System — The Central Memory for AI Agents

MiniMem gives AI agents persistent, structured, and retrievable memory. Built for single-machine self-hosting (sqlite + 127.0.0.1 + single API token), it uses a L1→L4 four-layer memory pyramid and a Dream Engine to automatically distill raw experiences into structured knowledge during nightly sleep cycles. Multi-tenant / JWT / domain isolation is deferred to v0.3+ — see roadmap.

---

✨ Features

• 🧩 L1→L4 Memory Pyramid — From raw experiences to mental models, layered compression with increasing abstraction
• 🌙 Dream Engine — 4-phase nightly pipeline: Audit → Compile (Knowledge Compile) → Dream → Cleanup
• 📝 Knowledge Compile — LLM-driven knowledge synthesis: generates bi-directionally linked knowledge pages with version history
• 🔗 MCP Protocol — Native Model Context Protocol support (stdio + Streamable HTTP)
• 🧭 Vector Retrieval — In-memory HNSW index + FTS5 full-text search + conditional indexing
• 📦 Surface Files — Agent-readable Markdown files (me/soul/work/social/life profiles)
• 💡 Inspiration Engine (experimental) — Cross-domain memory collision for creative sparks
• 🔄 Version Control — Snapshots + branching + rollback for safe memory evolution
• 🌡️ Temperature Decay — Tiered compression with configurable decay models (linear/logarithmic/ebbinghaus)

---

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│                    MiniMem                           │
│                                                     │
│  ┌─────────┐  ┌──────────┐  ┌──────