spatial-hierarchy memory organization with palace metaphor
Organizes persistent AI memory using a five-level spatial hierarchy (Wing → Room → Hall → Tunnel → Drawer) derived from the Method of Loci, enabling structured navigation and metadata filtering beyond flat vector search. Wings represent high-level entities (projects/people), Rooms are topic domains, Halls connect rooms within wings, Tunnels cross-reference related rooms across wings, and Drawers store verbatim text chunks. This metaphorical structure maps directly to ChromaDB vector storage and SQLite knowledge graph, allowing both semantic retrieval and relational fact tracking.
Unique: Uses classical Method of Loci spatial metaphor mapped to dual-backend storage (ChromaDB + SQLite knowledge graph), enabling both semantic vector retrieval and temporal entity-relationship tracking within a hierarchical structure. Most vector-only memory systems use flat collections; MemPalace adds explicit spatial hierarchy with cross-wing tunnels for multi-project reasoning.
vs alternatives: Outperforms flat vector memory systems by enabling structured navigation and metadata filtering before search, reducing irrelevant context injection; achieves 96.6% R@5 on LongMemEval without external APIs unlike cloud-dependent alternatives.
verbatim text storage with semantic indexing
Stores raw, uncompressed conversation and code text chunks (Drawers) in ChromaDB vector store while preserving original formatting and reasoning context. Unlike summarization-based systems that lose critical decision rationale, MemPalace indexes full text with embeddings for semantic retrieval while maintaining the complete original source. Each Drawer is a verbatim chunk with metadata tags (Wing, Room, timestamp, source) enabling both vector similarity search and metadata filtering.
Unique: Explicitly rejects AI-driven summarization in favor of raw verbatim storage indexed with embeddings. This design choice preserves original reasoning and 'why' behind decisions that summarization would lose. Most memory systems (Pinecone, Weaviate, LangChain) assume summarization is beneficial; MemPalace treats it as information loss.
vs alternatives: Preserves full context fidelity for reasoning tasks while maintaining semantic search speed, unlike pure transcript storage (no indexing) or summarization-based systems (context loss).
cli interface for palace operations and configuration
Provides command-line interface (mempalace/cli.py) for all palace operations: initialization, mining, search, memory management, and configuration. CLI supports interactive onboarding flow for first-time setup, guided room/wing assignment during mining, and batch operations for large-scale ingestion. Configuration is stored in YAML/JSON files enabling reproducible palace setups and version control of memory schemas.
Unique: Provides comprehensive CLI covering entire palace lifecycle (init, mine, search, manage) with interactive onboarding and guided room assignment. Most memory systems are Python-only; MemPalace CLI enables non-technical users to operate memory palaces.
vs alternatives: Enables standalone CLI usage without Python coding vs. Python-only libraries; interactive onboarding reduces setup friction for new users.
benchmark evaluation with longmemeval scoring
Includes built-in benchmarking suite (tests/test_*.py, benchmarks/) that evaluates memory recall performance using LongMemEval metrics (R@5, R@10, etc.). Benchmarks measure retrieval accuracy on standardized test sets, enabling performance comparison across embedding models, compression levels, and hierarchy configurations. MemPalace achieves 96.6% R@5 on LongMemEval, operating entirely on-device without external APIs.
Unique: Includes built-in LongMemEval benchmarking suite achieving 96.6% R@5 on standardized test set, operating entirely on-device without external APIs. Most memory systems don't publish benchmark results; MemPalace makes evaluation reproducible and transparent.
vs alternatives: Provides standardized benchmark evaluation vs. ad-hoc testing; 96.6% R@5 score demonstrates high recall without cloud dependencies.
local-first architecture with zero external api dependencies
Operates entirely on-device using local ChromaDB and SQLite backends, with no external API calls for embeddings, storage, or inference. Embedding models can be local (e.g., sentence-transformers) or cloud-based (OpenAI, Anthropic), but the system functions without them. This architecture enables offline operation, data privacy (no data leaves the device), and cost efficiency (no per-query API charges).
Unique: Explicitly designed as local-first with zero external API dependencies for core operations (storage, indexing, search). Most memory systems (Pinecone, Weaviate, cloud RAG) require external services; MemPalace operates entirely on-device.
vs alternatives: Enables offline operation and data privacy vs. cloud-dependent systems; eliminates per-query API costs vs. cloud services; suitable for air-gapped environments.
multi-platform chat export normalization
Normalizes conversation exports from multiple platforms (Claude, ChatGPT, Slack) into unified internal format via convo_miner.py and normalize.py. Handles variations in speaker identification, timestamp formats, message structure, and metadata across platforms. Normalized conversations are then chunked, embedded, and stored as Drawers with consistent metadata (author, timestamp, source platform).
Unique: Implements unified normalization pipeline for Claude, ChatGPT, and Slack exports, handling platform-specific format variations. Most memory systems assume single-platform input; MemPalace normalizes multi-platform conversations.
vs alternatives: Reduces manual data preparation vs. platform-specific importers; supports multiple platforms in single pipeline.
hierarchical context filtering with cross-wing tunnels
Enables context retrieval scoped to specific hierarchy levels (Wing, Room, Hall) with optional cross-wing tunnel traversal for related content. Queries can be constrained to a single Wing (project) for focused context, or expanded across Wings via Tunnels (cross-project connections) for broader reasoning. This enables both narrow, focused context retrieval and broad, multi-project reasoning without requiring separate queries.
Unique: Implements explicit cross-wing Tunnel connections for multi-project reasoning, enabling both focused (single-Wing) and broad (multi-Wing via Tunnels) context retrieval. Most memory systems use flat collections; MemPalace's Tunnels enable structured multi-project navigation.
vs alternatives: Enables both focused and broad context retrieval without separate queries vs. systems requiring query reformulation; Tunnels provide explicit cross-project relationships vs. implicit semantic similarity.
configuration system with yaml/json schemas
Manages palace configuration (storage paths, embedding models, entity definitions, room routing rules) via YAML/JSON files with schema validation. Configuration is versioned and can be stored in version control, enabling reproducible palace setups and team collaboration. Supports environment variable substitution for sensitive values (API keys, database paths).
Unique: Implements configuration system with YAML/JSON schemas and environment variable substitution, enabling version-controlled, reproducible palace setups. Most memory systems use hardcoded or environment-only configuration; MemPalace supports declarative configuration files.
vs alternatives: Enables version control and team collaboration on configuration vs. environment-only or hardcoded settings; schema validation prevents misconfiguration.
+9 more capabilities