OpenMemory (Python)

Python implementation of OpenMemory - Long-term memory for AI systems with cognitive architecture.

This is a reimplementation of OpenMemory in Python, maintaining the same cognitive memory architecture while enabling integration with Python-based AI systems.

Features

• Multi-sector memory - Episodic, semantic, procedural, emotional, and reflective memory types
• Automatic decay - Memories fade naturally unless reinforced
• Graph associations - Waypoint-based memory linking
• Pattern recognition - Regex-based sector classification
• User isolation - Per-user memory spaces
• Pluggable embeddings - OpenAI, Sentence-Transformers, or local models
• MCP Server - Built-in Model Context Protocol server

Installation

pip install -r requirements.txt

Quick Start

from openmemory import MemorySystem

# Initialize memory system
memory = MemorySystem(db_path="memory.db")

# Add a memory
result = memory.add_memory(
    content="User prefers dark mode in their IDE",
    user_id="user123"
)

# Query memories
results = memory.query(
    query="What are the user's preferences?",
    user_id="user123",
    k=5
)

for mem in results:
    print(f"Score: {mem.score:.3f} | {mem.content}")

Architecture

OpenMemory uses a cognitive architecture with five memory sectors:

• Episodic (decay: 0.015/day) - Time-based experiences
• Semantic (decay: 0.005/day) - Facts and knowledge
• Procedural (decay: 0.008/day) - How-to instructions
• Emotional (decay: 0.020/day) - Feelings and moods
• Reflective (decay: 0.001/day) - Insights and wisdom

Each memory is:

• Classified into sectors using pattern matching
• Embedded with sector-specific models
• Connected via waypoint graphs
• Tracked with salience scores (0-1)
• Subject to exponential decay

MCP Server

Run the MCP server:

python -m openmemory.mcp.server

Or use with Claude Desktop (add to config):

{
  "mcpServers": {
    "openmemory": {
      "command": "python",
      "args": ["-m", "openmemory.mcp.server"]
    }
  }
}

Development

# Install dev dependencies
pip install -r requirements-dev.txt

# Run tests
pytest tests/

# Format code
black openmemory/

License

MIT License - Copyright (c) 2025

Credits

Based on OpenMemory by CaviraOSS

Python reimplementation by @danielsimonjr