Universal memory layer for AI applications. Self-host in 5 minutes.
Project description
Remembra
The memory layer for AI that actually works.
Persistent memory with entity resolution, temporal decay, and graph-aware recall.
Self-host in 5 minutes. No vendor lock-in.
Documentation • Website • Quick Start • Why Remembra? • Twitter • Discord
🚀 What's New in v0.7.0
- Conversation Ingestion — Auto-extract memories from chat history
- Sleep-Time Compute — Background consolidation during idle time
- PII Detection — Automatic redaction of sensitive data
- Anomaly Detection — Protection against memory poisoning
- TypeScript SDK — First-class JavaScript support
The Problem
Every AI app needs memory. Your chatbot forgets users between sessions. Your agent can't recall decisions from yesterday. Your assistant asks the same questions over and over.
The current solutions suck:
- Mem0: $249/mo for graph features, self-hosting docs are trash
- Zep: Academic, complex to deploy
- Letta: Research-grade, not production-ready
- LangChain Memory: Too basic, no persistence
The Solution
from remembra import Memory
memory = Memory(user_id="user_123")
# Store — entities and facts extracted automatically
memory.store("Had a meeting with Sarah from Acme Corp. She prefers email over Slack.")
# Recall — semantic search finds relevant memories
result = memory.recall("How should I contact Sarah?")
print(result.context)
# → "Sarah from Acme Corp prefers email over Slack."
# It knows "Sarah" and "Acme Corp" are entities. It builds relationships.
# It persists across sessions, reboots, context windows. Forever.
⚡ Quick Start
Option 1: Docker (Recommended)
# Start the server
docker run -d -p 8787:8787 remembra/remembra
# Install SDK
pip install remembra
# Use it
python -c "from remembra import Memory; m = Memory(); m.store('Hello world')"
Option 2: MCP Server (Claude Code / Cursor)
# Install
pip install remembra[mcp]
# Add to Claude Code
claude mcp add remembra -e REMEMBRA_URL=http://localhost:8787 -- remembra-mcp
# Now Claude has persistent memory across all sessions!
Option 3: TypeScript / JavaScript
npm install remembra
import { Remembra } from 'remembra';
const memory = new Remembra({ url: 'http://localhost:8787' });
await memory.store('User prefers dark mode');
const result = await memory.recall('preferences');
🔥 Why Remembra?
Feature Comparison
| Feature | Remembra | Mem0 | Zep | Letta |
|---|---|---|---|---|
| Self-host in 5 min | ✅ One command | ❌ Complex | ⚠️ Moderate | ❌ Research |
| Entity Resolution | ✅ Free | 💰 $249/mo | ✅ | ❌ |
| Temporal Features | ✅ TTL + Decay | ❌ | ✅ | ✅ |
| Conversation Ingestion | ✅ v0.7 | ✅ | ❌ | ❌ |
| Sleep-Time Compute | ✅ v0.7 | ❌ | ❌ | ✅ |
| PII Detection | ✅ Built-in | ❌ | ❌ | ❌ |
| MCP Server | ✅ Native | ✅ | ✅ | ❌ |
| TypeScript SDK | ✅ | ✅ | ✅ | ❌ |
| Pricing | Free / $29 / $99 | $19 → $249 | $25+ | Free |
| License | MIT | Apache 2.0 | Apache 2.0 | Apache 2.0 |
Core Features
🧠 Smart Extraction — LLM-powered fact extraction from raw text
👥 Entity Resolution — "Adam", "Mr. Smith", "my husband" → same person
⏱️ Temporal Memory — TTL, decay curves, historical queries
🔍 Hybrid Search — Semantic + keyword for accurate recall
🔒 Security — PII detection, anomaly monitoring, audit logs
📊 Dashboard — Visual memory browser, entity graphs, analytics
📖 Documentation
| Resource | Description |
|---|---|
| Quick Start | Get running in 5 minutes |
| Python SDK | Full Python reference |
| TypeScript SDK | JavaScript/TypeScript guide |
| MCP Server | Claude Code / Cursor setup |
| REST API | API reference |
| Self-Hosting | Docker deployment guide |
🛠️ MCP Server
Give Claude Code or Cursor persistent memory with one command:
pip install remembra[mcp]
claude mcp add remembra -e REMEMBRA_URL=http://localhost:8787 -- remembra-mcp
Available Tools:
| Tool | Description |
|---|---|
store_memory |
Save facts, decisions, context |
recall_memories |
Semantic search across memories |
forget_memories |
GDPR-compliant deletion |
ingest_conversation |
Auto-extract from chat history |
health_check |
Verify connection |
🏗️ Architecture
┌─────────────────────────────────────────────────────────────┐
│ Your Application │
├──────────┬──────────────┬───────────────────────────────────┤
│ Python │ TypeScript │ MCP Server (Claude/Cursor) │
│ SDK │ SDK │ remembra-mcp │
├──────────┴──────────────┴───────────────────────────────────┤
│ Remembra REST API │
├──────────────┬──────────────┬───────────────┬───────────────┤
│ Extraction │ Entities │ Retrieval │ Security │
│ (LLM) │ (Graph) │ (Hybrid) │ (PII/Audit) │
├──────────────┴──────────────┴───────────────┴───────────────┤
│ Storage Layer │
│ Qdrant (vectors) + SQLite (metadata/graph) │
└─────────────────────────────────────────────────────────────┘
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
# Clone
git clone https://github.com/remembra-ai/remembra
cd remembra
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Start dev server
remembra-server --reload
📄 License
MIT License — Use it however you want.
⭐ Star History
If Remembra helps you, please star the repo! It helps others discover the project.
Built with ❤️ by DolphyTech
remembra.dev • docs • twitter • discord
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file remembra-0.7.2.tar.gz.
File metadata
- Download URL: remembra-0.7.2.tar.gz
- Upload date:
- Size: 215.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cfb0441e3f2362e00fb46be1b18b09640e8dd0fbbba509ce43cd74e3826f47d9
|
|
| MD5 |
0c67bd9ea194a4d40de9c5a4006624c3
|
|
| BLAKE2b-256 |
c3d82e2c0730a25b241bd9006e45ebb48f7c0a7638ec11da4eec01153a48c9ca
|
File details
Details for the file remembra-0.7.2-py3-none-any.whl.
File metadata
- Download URL: remembra-0.7.2-py3-none-any.whl
- Upload date:
- Size: 257.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2f9284d11416e4d9bd2d8c29db24c513f36f4d2118d08132d27b88f4c021e323
|
|
| MD5 |
f739ebc12040936daef0371906f93f45
|
|
| BLAKE2b-256 |
fa3e9e7302aefc16ba26ecb800a8f2540b345463b444a00d09a32f10f30de348
|