A single-file memory layer for AI agents that packages raw documents, embeddings, search indices, and metadata into a single portable .mv2 file instead of managing complex RAG pipelines or server-hosted vector databases. Designed around video codec principles, MemVid treats memory as an append-only sequence of immutable frames with timestamps and checksums, delivering sub-5ms local retrieval, crash resilience, and complete time-travel inspection across agent sessions.
What it does
Packs data, vector embeddings, and search indices into self-contained, portable single-file memory capsules (.mv2) with zero external database dependencies.
Structures memory using Smart Frames—an append-only sequence of immutable frames with timestamps and checksums providing crash safety and past-state inspection.
Delivers sub-5 ms local retrieval via Smart Recall using predictive caching and local hybrid semantic/graph search.
Enables time-travel debugging allowing developers and agents to rewind, replay, or branch memory states across sessions.
Provides living memory evolution with adaptive compression that upgrades and compacts memory segments over time without service interruption.
How it works
Architecture Diagram
Rather than standing up an external vector database and coordinating remote embedding calls, you embed MemVid directly into your agent via Python (memvid-core), Rust, or CLI. As your agent observes events, executes tools, and interacts with users, MemVid writes memory chunks into immutable Smart Frames inside a local .mv2 file. Retrieval queries hit the integrated local index directly in process with sub-5 ms latency, while historical frames can be replayed or branched for auditability and session resumption.
Best for
Autonomous, long-running AI agents and offline-first edge applications that require zero-infrastructure local memory persistence.
Developers building enterprise knowledge bases, support agents, or codebase assistants who need auditable, timeline-inspectable memory capsules.
Teams wanting to ship self-contained agent memory artifacts (.mv2) across environments without provisioning or syncing cloud vector databases.
Watch out for
Development idle for ~3.5 months: The repository has been quiet since July 2026 with 34 open issues, representing a mature-but-idle state rather than active daily maintenance.
Unverified vendor performance claims: Benchmark metrics (including sub-0.025 ms P50 latency, +35% LoCoMo score, and 1,372× throughput) are self-reported vendor claims; reproducible evaluation code is published, but independent third-party verification is lacking.
File size and in-process memory trade-offs: Packing embeddings and search structures into a single file trades infrastructure simplicity for single-file size and process memory footprint; large enterprise corpora result in massive files to transfer and back up.
Young ecosystem and migration cost: The Rust core and Python/CLI wrapper ecosystems are still young with evolving APIs, and replacing existing multi-tenant vector databases is an architectural migration rather than a simple drop-in swap.
What you need: Local Rust or Python environment (pip install memvid-core or CLI). Cost: free, open source (Apache-2.0).