Memos (Fork of Letta)

A fork of Letta with unified provider management

Memos is a modified version of Letta that unifies the provider system for better flexibility.

What Memos Changes

Compared to the original Letta, Memos includes the following modifications:

• Unified Provider System: All providers are created through the API and stored in the database
• Custom Provider Names: Use your own names for providers
• Hard Delete: Providers are truly deleted from the database

Documentation

See the docs/ folder for detailed documentation:

• LETTA_ARCHITECTURE_DEEP_DIVE.md - Complete analysis of Letta's architecture and implementation
• KETTA_PROVIDER_UNIFICATION_PLAN.md - The plan for unifying the provider system

Quick Start

Installation

# Clone the repository
git clone https://github.com/kosmoli/memos.git
cd memos

# Install dependencies
pip install -e .

# Or use uv (recommended)
uv pip install -e .

Running the Server

# Set up environment variables
cp .env.example .env
# Edit .env with your configuration

# Start the server
python -m letta.server.rest_api.server

The server will start on http://localhost:8283.

Compatibility with Letta

Memos aims to maintain API compatibility with Letta where possible, so existing Letta clients should work with Memos. However, there are behavioral differences:

1. Provider Management: All providers must be created via API (no auto-sync from environment)
2. Provider Handles: Handles use the provider's actual name (no openai-proxy prefix)
3. Provider Deletion: Deletion is permanent (hard delete)

Development

Branch Strategy

• main - Tracks upstream Letta changes
• memos - Our modifications and improvements

Syncing with Upstream

# Add Letta as upstream (if not already added)
git remote add letta https://github.com/letta-ai/letta.git

# Fetch upstream changes
git fetch letta main

# Review changes
git log HEAD..letta/main --oneline

# Cherry-pick specific fixes
git cherry-pick <commit-hash>

Running Tests

# Install test dependencies
pip install -e ".[test]"

# Run tests
pytest tests/

Contributing

Memos is an open source project. Contributions are welcome!

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Acknowledgments

• Letta - The original project
• Klui - The frontend UI for Memos

License

This project is licensed under the same license as Letta (see LICENSE).

---

Note: This is a fork of Letta. For the original project, visit https://github.com/letta-ai/letta