Skip to main content

Universal memory layer for AI applications. Self-host in 5 minutes.

Project description

Remembra Logo

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.

PyPI npm GitHub Stars License: MIT Documentation

DocumentationWebsiteQuick StartWhy Remembra?TwitterDiscord


🚀 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.

Star History Chart


Built with ❤️ by DolphyTech
remembra.devdocstwitterdiscord

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

remembra-0.7.2.tar.gz (215.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

remembra-0.7.2-py3-none-any.whl (257.3 kB view details)

Uploaded Python 3

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

Hashes for remembra-0.7.2.tar.gz
Algorithm Hash digest
SHA256 cfb0441e3f2362e00fb46be1b18b09640e8dd0fbbba509ce43cd74e3826f47d9
MD5 0c67bd9ea194a4d40de9c5a4006624c3
BLAKE2b-256 c3d82e2c0730a25b241bd9006e45ebb48f7c0a7638ec11da4eec01153a48c9ca

See more details on using hashes here.

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

Hashes for remembra-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2f9284d11416e4d9bd2d8c29db24c513f36f4d2118d08132d27b88f4c021e323
MD5 f739ebc12040936daef0371906f93f45
BLAKE2b-256 fa3e9e7302aefc16ba26ecb800a8f2540b345463b444a00d09a32f10f30de348

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page