Quickstart: CLI

memvid --version

memvid create my-knowledge.mv2

✓ Created memory at my-knowledge.mv2
  Capacity: 1.0 GB (1073741824 bytes)
  Size: 4.0 MB
  Indexes: lexical | vector

memvid stats my-knowledge.mv2

echo "Memvid is a portable AI memory system. It stores embeddings, indices, and data in a single .mv2 file." | memvid put my-knowledge.mv2 --input - --title "What is Memvid"

# Add a single file with vector compression
memvid put my-knowledge.mv2 --input document.pdf --vector-compression

# Add all files in a directory
memvid put my-knowledge.mv2 --input ./documents/ --vector-compression

memvid put my-knowledge.mv2 \
  --input notes.md \
  --track "notes" \
  --tag "category=meeting" \
  --vector-compression

memvid find my-knowledge.mv2 --query "portable memory"

Found 1 result for "portable memory":

[1] Score: 0.95 | Frame: 1
    What is Memvid
    Memvid is a portable AI memory system. It stores embeddings...

memvid find my-knowledge.mv2 --query "memory" --json

# Using local model (tinyllama)
memvid ask my-knowledge.mv2 --question "What is Memvid and how does it work?"

# Using OpenAI (requires API key)
export OPENAI_API_KEY=your-key
memvid ask my-knowledge.mv2 --question "What is Memvid?" --use-model openai

# Using Anthropic
export ANTHROPIC_API_KEY=your-key
memvid ask my-knowledge.mv2 --question "What is Memvid?" --use-model claude

# Recent documents
memvid timeline my-knowledge.mv2 --limit 10

# Filter by time range
memvid timeline my-knowledge.mv2 --since 1704067200 --until 1706745600

# View a specific document
memvid view my-knowledge.mv2 --frame-id 1

# Basic verification
memvid verify my-knowledge.mv2

# Deep verification
memvid verify my-knowledge.mv2 --deep

# Confirm single-file integrity
memvid verify-single-file my-knowledge.mv2

# 1. Create the memory
memvid create docs.mv2

# 2. Ingest documentation with vector compression
memvid put docs.mv2 \
  --input ./docs/ \
  --vector-compression \
  --track "documentation"

# 3. Add API reference
memvid put docs.mv2 \
  --input ./api-reference/ \
  --vector-compression \
  --track "api"

# 4. Check stats
memvid stats docs.mv2

# 5. Search for information
memvid find docs.mv2 --query "authentication setup" --mode auto

# 6. Ask questions
export OPENAI_API_KEY=your-key
memvid ask docs.mv2 \
  --question "How do I configure OAuth?" \
  --use-model openai

# 7. Verify integrity
memvid verify docs.mv2 --deep

pip install memvid-sdk

from memvid_sdk import use

# Open read-only (for queries)
mem = use('basic', 'docs.mv2', read_only=True)

# Search
results = mem.find('authentication', k=5)
for hit in results['hits']:
    print(f"{hit['score']:.2f}: {hit['title']}")

# Ask questions
answer = mem.ask('How do I configure OAuth?', model='openai:gpt-4o')
print(answer['answer'])

npm install @memvid/sdk

import { use } from '@memvid/sdk';

// Open read-only
const mem = await use('basic', 'docs.mv2', { readOnly: true });

// Search
const results = await mem.find('authentication', { k: 5 });
results.hits.forEach(hit => {
  console.log(`${hit.score.toFixed(2)}: ${hit.title}`);
});

// Ask questions
const answer = await mem.ask('How do I configure OAuth?', {
  model: 'openai:gpt-4o-mini'
});
console.log(answer.answer);