Perseus-Computing-LLC/mimir

Mimir

Persistent memory for AI agents. Structured entity model. SQLite + FTS5 + hybrid vector search. MCP-native. Fully local.

What is Mimir?

Mimir is a lightweight MCP JSON-RPC 2.0 stdio server that gives AI agents durable memory across sessions. Agents store structured entities, journal their decisions, manage transient state, generate embeddings, query with hybrid search, and ingest external data — all through 31 MCP tools.

It uses SQLite with FTS5 + dense vector search across three tables: entities (structured, idempotent), journal (append-only event log), and state (key-value with TTL). Optional Ollama integration enables RAG (mimir_ask) and embedding generation (mimir_embed). A built-in web dashboard provides visual exploration.

Works with any MCP host: Claude Desktop, Cursor, OpenClaw, Hermes Agent, Perseus, etc.

---

Quick Start

# Build from source
git clone https://github.com/Perseus-Computing-LLC/mimir.git
cd mimir
cargo build --release

# Linux/macOS: use cargo install to avoid macOS security kill (Killed: 9)
cargo install --path .

# Or copy manually (Linux only — macOS will kill the unsigned binary)
cp target/release/mimir ~/.local/bin/

# Or download the binary
curl -sSL https://github.com/Perseus-Computing-LLC/mimir/releases/download/v1.0.0/mimir-v1.0.0-linux-x86_64 -o mimir
chmod +x mimir && mv mimir ~/.local/bin/

Requirements: Rust 1.70+ (stable), a C compiler (rusqlite bundles SQLite).

---

Install

Mimir is a standalone Rust binary — no Python client needed. Download the latest release:

# Linux x86_64
curl -fsSL https://github.com/Perseus-Computing-LLC/mimir/releases/latest/download/mimir-x86_64-unkn