name	mind-mem-development
description	MIND-Mem Python development guide
tags	["python","memory","MIND-Mem","pypi"]

MIND-Mem Development

Package

PyPI: pip install mind-mem
Source layout: src/mind_mem/
Tests: pytest, 3610 passing
CI: GitHub Actions, 3 OS × 4 Python versions (16 matrix jobs)

Architecture

BM25F retrieval with Porter stemming + RM3 query expansion
Hybrid BM25+Vector search with RRF fusion (sqlite-vec)
A-MEM block metadata evolution
9-type intent router with adaptive confidence weights
ConnectionManager: thread-safe SQLite pool with WAL
BlockStore protocol: decoupled block access
Delta-based snapshot rollback

MCP Server (81 tools)

Grouped surfaces (full list in docs/api-reference.md and src/mind_mem/mcp_server.py): recall, hybrid_search, prefetch, propose_update, approve_apply, rollback_proposal, scan, list_contradictions, reindex, index_stats, create_snapshot, list_snapshots, restore_snapshot, briefing, category_summary, cross_encoder_rerank, find_similar, memory_evolution, delete_memory, export_memory, import_memory, intent_classify, retrieval_diagnostics, get_mind_kernel, list_mind_kernels, verify_chain, audit_replay, tier_decay_apply, encrypt_status, alerts_subscribe, and more (57 total).

Key Files

src/mind_mem/mcp_server.py — MCP server (57 @mcp.tool entries)
src/mind_mem/retrieval/ — search engine (bm25, vector, hybrid)
src/mind_mem/governance/ — contradiction detection, drift analysis
src/mind_mem/blocks/ — block store, parser, evolution
tests/ — comprehensive test suite

Conventions

Python 3.10+, type hints everywhere
Docstrings: Google style
No dynamic allocation in hot paths
All SQL queries parameterized
Config: mind-mem.json (not mem-os.json)
Auth header: X-MindMem-Token

name	mind-mem-development
description	MIND-Mem Python development guide
tags	["python","memory","MIND-Mem","pypi"]