mempalace-evolve  by a2328275243

Self-evolving memory palace for AI agents

Created 1 month ago
333 stars

Top 82.0% on SourcePulse

GitHubView on GitHub
Project Summary

MemPalace Evolve provides a self-evolving, persistent memory system for local AI agents. It addresses the challenge of long-term knowledge retention by organizing project decisions, preferences, and experiences into an auditable, iterative knowledge base. This system benefits users integrating memory into tools like Claude Code, Cursor, or custom AI agents, enabling more consistent and informed AI behavior.

How It Works

The system structures AI interactions into retrievable, auditable, and iterative long-term memory. Core components include organizing project decisions, stable preferences, error patterns, and reusable experiences. A key design choice is the memory review process (memory-candidates -> reviewed -> promote-reviewed), which filters transient data like logs or checkpoints, ensuring only validated insights are promoted to stable memory, thereby maintaining memory quality and relevance.

Quick Start & Requirements

  • Installation:
    • Python package: git clone https://github.com/a2328275243/mempalace-evolve.git && cd mempalace-evolve && python -m pip install -e .
    • Windows Installer: Download DreamSeed-Code-Setup.exe from Releases.
  • Prerequisites: Python 3.x required for package installation. MCP support (python -m pip install -e ".[mcp]") is recommended for Claude Code/Cursor integration. DreamSeed Code installer requires Windows.
  • Usage: mempalace doctor (check install), mempalace remember "..." --room ... (add memory), mempalace recall "..." (retrieve memory), mempalace setup (configure for clients), mempalace serve --port 8765 (HTTP API).
  • Resources: GitHub repository link: https://github.com/a2328275243/mempalace-evolve.git.

Highlighted Details

  • Persistent Memory: Stores and organizes project decisions, preferences, error patterns, and reusable experiences.
  • AI Agent Integration: Supports Claude Code, Cursor (via MCP), and custom agents via Python SDK or HTTP API.
  • DreamSeed Code: Bundled Windows desktop/terminal environment offering integrated project management, model handling, and memory auditing.
  • Memory Governance: Implements a review pipeline (memory-candidates to promote-reviewed) ensuring memory quality and preventing clutter from transient data.
  • Model Agnostic: Compatible with various model providers including OpenAI-compatible, Ollama, Gemini, and others.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or roadmap were found in the provided text.

Licensing & Compatibility

The provided text does not specify the software license, making commercial use compatibility unclear.

Limitations & Caveats

The DreamSeed Code installer is exclusively for Windows. The mandatory review process for promoting memories to long-term storage may introduce friction for rapid, unstructured data logging. Lack of explicit licensing information poses a potential adoption blocker for commercial applications.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
164 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.