Mneme

Highlights

• @mneme/embedder-local v0.0.1 ships. Pass new LocalEmbedder() into new Mneme({ embedder }) and recall() upgrades from lexical BM25 to true semantic search via Xenova/all-MiniLM-L6-v2 running on-device. No API key, no third-party requests.
• @mneme/sdk v0.0.2 wires the new embedder option end-to-end. Cosine similarity over stored embeddings when configured, FTS5 BM25 fallback when not.
• ADR 0004 documents the embedding strategy: model choice, single-embedder-per-store, separate-package design, integration-test gate.
• Operating procedure proven on the wire: PR #1 (ADR 0003) and PR #2 (this) shipped through the branch → conventional commit → PR → CI → squash-merge loop, linear history maintained.

What's in the repo today

• packages/protocol — open spec types (v0.1 draft)
• packages/sdk — local SQLite-backed reference SDK
• packages/embedder-local — on-device embeddings via @huggingface/transformers
• tests/conformance — cross-implementation v0.1 conformance suite
• docs/protocol/v0.1.md — public wire spec
• brand/ — brand system
• decisions/ — 4 ADRs

Still out of scope (see ARCHITECTURE.md)

• Encryption envelope (next)
• CRDT sync engine
• MCP server
• Hosted Mneme Cloud API

Known issue

@mneme/embedder-local integration tests are gated behind MNEME_RUN_INTEGRATION=1. Bun 1.3.x crashes on process exit when onnxruntime-node unloads — tests themselves pass. See ADR 0004 §4.

Try it

git clone https://github.com/ppserapiao/mneme
cd mneme
bun install
bun test                                                    # 47 pass, 2 skip
MNEME_RUN_INTEGRATION=1 bun test packages/embedder-local    # 4 pass, real model