Help & Troubleshooting

Find solutions to common problems, understand error codes, and get help from the community.

Quick Diagnosis

Run these commands to identify issues:

# Check file health
memvid verify knowledge.mv2 --deep

# View file stats
memvid stats knowledge.mv2 --json

# Check for locks
lsof knowledge.mv2

File is locked

Another process has the file open. Find it with lsof knowledge.mv2 or open in read-only mode:

mem = use('basic', 'knowledge.mv2', read_only=True)

Search returns no results

Check the search mode and verify content exists:

memvid stats knowledge.mv2  # Check frame count
memvid find knowledge.mv2 --query "test" --mode lex  # Try lexical

Capacity exceeded

Upgrade your plan or delete old content:

memvid tickets sync knowledge.mv2 --memory-id YOUR_ID

Import errors

Reinstall the SDK:

pip install --upgrade memvid-sdk  # Python
npm install @memvid/sdk           # Node.js