Memvid Documentation - Single-file AI Memory for AI Agents
Complete documentation for Memvid - a single-file memory layer for AI agents with instant retrieval, hybrid search (BM25 + vector), entity extraction, and time-travel debugging. Zero infrastructure, works offline.
Ship a single .mv2 file that holds your data, indexes, and crash recovery. Copy it, sync it, commit it to git. No servers. No infrastructure. Just one file.
CLI
Node.js
Python
npm install -g memvid-climemvid create knowledge.mv2echo "Alice works at Anthropic as a Senior Engineer." | memvid put knowledge.mv2memvid find knowledge.mv2 --query "who works at AI companies"memvid state knowledge.mv2 "Alice"# { employer: 'Anthropic', role: 'Senior Engineer' }
import { create, use } from '@memvid/sdk';import { existsSync } from 'fs';// create() for NEW files, use() for EXISTING filesconst mem = existsSync('knowledge.mv2') ? await use('basic', 'knowledge.mv2') : await create('knowledge.mv2', 'basic');await mem.put({ title: 'Team Info', label: 'notes', text: 'Alice works at Anthropic...' });const results = await mem.find('who works at AI companies', { k: 5, mode: 'lex' });const alice = await mem.state('Alice');// { slots: { employer: 'Anthropic', role: 'Senior Engineer' } }
from memvid_sdk import create, useimport os# create() for NEW files, use() for EXISTING filespath = 'knowledge.mv2'mem = use('basic', path) if os.path.exists(path) else create(path)mem.put(title='Team', label='info', metadata={}, text='Alice works at Anthropic...')results = mem.find('who works at AI companies', k=5, mode='lex')alice = mem.state('Alice')# {'slots': {'employer': 'Anthropic', 'role': 'Senior Engineer'}}
create() will OVERWRITE existing files! Note the different parameter order:
Extract structured facts and query them instantly:
# Extract facts from documentsmemvid enrich knowledge.mv2 --engine rules# Query entity state (O(1) lookup)memvid state knowledge.mv2 "Alice"# employer: Anthropic# role: Senior Engineer# location: San Francisco
Ask natural language questions with sourced answers:
export OPENAI_API_KEY=sk-...memvid ask knowledge.mv2 --question "What is Alice's role?" --use-model openai# Answer: Alice is a Senior Engineer at Anthropic in San Francisco.# Sources: [Meeting Notes, Team Directory]
