MemPalace.Core 0.5.0-preview.1

MemPalace.NET

A .NET port of MemPalace — local-first AI memory that stores everything verbatim, searches semantically, and organizes knowledge through a wings / rooms / drawers hierarchy. No cloud calls by default, powered by ONNX embeddings.

🎯 Status: Preview — v0.1.0 is production-ready for local development and experimentation.

Why MemPalace.NET?

• Local-first by default — ONNX embeddings via ElBruno.LocalEmbeddings (no API keys, no cloud calls)
• Microsoft.Extensions.AI — swap embedders and LLMs with zero lock-in
• Microsoft Agent Framework — each agent gets its own memory diary
• MCP server — expose your palace as Model Context Protocol tools (Claude Desktop, VS Code, etc.)
• Temporal knowledge graph — track entity relationships with validity windows
• SQLite backend — managed BLOB storage, cosine similarity, clear upgrade path to vector stores

Quick Start

# Install the CLI tool
dotnet tool install -g mempalacenet --version 0.1.0-preview.1

# Initialize a new palace
mempalacenet init ~/my-palace

# Mine project files
mempalacenet mine ~/my-code --wing work --mode files

# Mine conversation transcripts
mempalacenet mine ~/my-convos --wing personal --mode convos

# Semantic search
mempalacenet search "how do I handle auth errors?"

# Hybrid search with reranking
mempalacenet search "latest React patterns" --hybrid --rerank

# Start MCP server (for Claude Desktop, VS Code, etc.)
mempalacenet mcp --palace ~/my-palace

# Run an agent
mempalacenet agents run scribe --wing research --mode local

Architecture

MemPalace.NET is a modular .NET solution with clear separation of concerns:

Documentation

Full documentation lives in docs/:

• Architecture — solution layout, component contracts, dependency graph
• Concepts — wings, rooms, drawers, verbatim storage, embedder identity
• Backends — writing custom backends, conformance tests
• AI Integration — embedder selection, reranking, M.E.AI seams
• Mining — ingestion pipeline, custom miners, .gitignore respect
• Search — semantic vs hybrid strategies, RRF fusion, temporal boosting
• Knowledge Graph — temporal triples, pattern queries, invalidation
• MCP Server — tool reference, VS Code / Claude Desktop setup
• Agents — Agent Framework integration, diary management, agent discovery
• CLI — command reference, configuration, examples
• Benchmarks — reproducibility, dataset sources, R@5 parity

Development

# Clone
git clone https://github.com/elbruno/mempalacenet
cd mempalacenet

# Build
dotnet build src/

# Test (129 tests, all green)
dotnet test src/

# Pack NuGet packages
dotnet pack src/ -c Release

Roadmap

v0.1.0 (current) ships core memory operations, search, MCP server, and agents.

Post-v0.1:

• Upgrade to sqlite-vec or Qdrant for >100K vectors
• BM25 keyword search (currently token overlap)
• LongMemEval R@5 parity validation (target ≥ 91%)
• Conversation context summaries (mempalace wake-up)

Credits

• Original project: MemPalace (Python)
• Author: Bruno Capuano
• Default embedder: ElBruno.LocalEmbeddings (ONNX)

License

MIT — same spirit as the original MemPalace.

Community

We welcome contributions from the community! Here's how to get involved:

• Contributing Guidelines — how to submit pull requests, report issues, and contribute code
• Code of Conduct — our commitment to fostering an open and welcoming environment
• Security Policy — how to report security vulnerabilities responsibly
• Issues — report bugs or request features
• Discussions — ask questions, share ideas, and connect with the community

Got questions? Open a discussion or reach out to @elbruno.