Mnemosyne Maintenance

Use when: upgrading Mnemosyne, diagnosing slow/hung consolidation (mnemosyne_sleep), fixing missing embeddings, or troubleshooting import/version mismatches.

Triggers

• mnemosyne_sleep hanging for >2 minutes
• Diagnose reports "fastembed not available" or "sqlite_vec not available" despite being installed
• Version mismatch: pip shows newer version than runtime
• Embeddings_available=NO when deps are present

Core troubleshooting (in order)

1. Run diagnostics:

• mnemosyne_diagnose
• Look for: missing fastembed, sqlite_vec, ctransformers; embeddings_available status; mnemosyne_version