Mnemosyne: Fully Local Agent Memory, No Cloud at All

The Stack

Steps

1. 1

   Install and run a real store → recall round-trip

   One pip install, then store a fact and recall it by keyword with the mnemosyne CLI. Without the optional embedding extra Mnemosyne falls back to FTS5 keyword retrieval, so this round-trip works completely offline with no key. CI runs exactly this.

   python3 -m venv .venv
   .venv/bin/pip install -q "mnemosyne-memory==3.7.0"
   .venv/bin/mnemosyne store "User prefers dark mode interfaces" preference 0.9 >/dev/null
   OUT=$(.venv/bin/mnemosyne recall "interface preferences" 3)
   if printf '%s' "$OUT" | grep -q "dark mode"; then
     echo "mnemosyne round-trip OK: recalled the stored fact in keyword mode"
   else
     echo "recall missed the stored fact: $OUT"; exit 1
   fi

2. 2

   Turn on semantic recall (the model step, not checked by CI)

   Install the fastembed extra (or point it at a local model) for semantic search and the sleep-cycle consolidation. Those run embeddings, which are non-deterministic, so CI never claims them.