TrueMemory
installs/mo · pypistarsforks
How to install TrueMemory?
buildingjoshbetter/truememory
$git clone https://github.com/buildingjoshbetter/TrueMemory---
README.md
| 1 | <p align="center"> |
| 2 | <img src="assets/charts/hero-banner.png" alt="TrueMemory" width="800"> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="https://github.com/buildingjoshbetter/TrueMemory"><img src="https://img.shields.io/github/stars/buildingjoshbetter/TrueMemory?style=social" alt="Stars"></a> |
| 7 | <a href="https://pepy.tech/projects/truememory"><img src="https://img.shields.io/badge/dynamic/json?url=https://pepy.tech/api/v2/projects/truememory&query=$.total_downloads&label=installs&color=39FF14&labelColor=white&style=flat" alt="PyPI Installs"></a> |
| 8 | – |
| 9 | <a href="./i18n/README.zh-CN.md"><img alt="简体中文" src="https://img.shields.io/badge/简体中文-d9d9d9"></a> |
| 10 | <a href="./i18n/README.ru.md"><img alt="Русский" src="https://img.shields.io/badge/Русский-d9d9d9"></a> |
| 11 | – |
| 12 | <a href="https://arxiv.org/abs/2605.04897"><img src="https://img.shields.io/badge/arXiv-2605.04897-b31b1b" alt="arXiv"></a> |
| 13 | <a href="https://discord.gg/ZJ74JB2gVW"><img src="https://img.shields.io/badge/Discord-Join%20us-5865F2?logo=discord&logoColor=white" alt="Discord"></a> |
| 14 | </p> |
| 15 | |
| 16 | <p align="center"> |
| 17 | <img src="https://img.shields.io/badge/LoCoMo-93.0%25-blueviolet" alt="LoCoMo"> |
| 18 | <img src="https://img.shields.io/badge/LongMemEval-92.0%25-blue" alt="LongMemEval"> |
| 19 | <img src="https://img.shields.io/badge/BEAM--1M-76.6%25_(SOTA)-orange" alt="BEAM-1M"> |
| 20 | </p> |
| 21 | |
| 22 | <p align="center"> |
| 23 | <a href="#the-problem">Why</a> · <a href="#quick-start">Quick Start</a> · <a href="#how-truememory-compares">Compare</a> · <a href="#tiers">Tiers</a> · <a href="#benchmarks">Benchmarks</a> · <a href="#python-api">API</a> · <a href="#docs">Docs</a> · <a href="#faq">FAQ</a> · <a href="https://discord.gg/ZJ74JB2gVW">Discord</a> |
| 24 | </p> |
| 25 | |
| 26 | <p align="center"> |
| 27 | <img src="assets/terminal-demo.svg" alt="TrueMemory terminal demo" width="750"> |
| 28 | </p> |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | ## Why TrueMemory |
| 33 | |
| 34 | **It finds signal in the noise.** Your AI sees thousands of messages. TrueMemory figures out which ones actually matter and throws away the rest. No manual tagging, no prompt engineering. It just knows. |
| 35 | |
| 36 | **It gets sharper over time.** It's not a static database. It's a living memory that grows with you. It resolves contradictions when you change your mind, updates stale facts, and consolidates what it knows. The longer you use it, the better it gets. |
| 37 | |
| 38 | **It works without you thinking about it.** TrueMemory automatically captures memories from your conversations and automatically injects the right ones into your next session. You never have to store or search for anything manually. It just happens. |
| 39 | |
| 40 | **It's 100% local.** One SQLite file on your machine. Your memories never leave your device. No cloud, no API keys needed. Your data is yours. (Anonymous usage telemetry is the only exception — never memory content — and one env var turns it off. [Details](#faq).) |
| 41 | |
| 42 | > **Without TrueMemory:** "What framework are we using?" Asked for the 12th time this week. Your agent starts every session with amnesia. It doesn't know your name, your stack, or anything you told it yesterday. |
| 43 | > |
| 44 | > **With TrueMemory:** Your agent already knows you use FastAPI, prefer Pydantic v2, and that your auth middleware lives in `src/auth/`. It remembers your corrections, your preferences, and your decisions. Across every session, forever. |
| 45 | |
| 46 | <p align="center"><a href="https://discord.gg/ZJ74JB2gVW"><strong>Join the Discord</strong></a> to see what others are building with TrueMemory.</p> |
| 47 | |
| 48 | --- |
| 49 | |
| 50 | ## How TrueMemory Compares |
| 51 | |
| 52 | | System | LoCoMo | LongMemEval | Local-first | Auto-capture | License | |
| 53 | |--------|--------|-------------|:-----------:|:------------:|---------| |
| 54 | | **TrueMemory Pro** | **93.0%** | **92.0%** | ✅ | ✅ | AGPL-3.0 | |
| 55 | | **TrueMemory Base** | **92.0%** | **84.1%** | ✅ | ✅ | AGPL-3.0 | |
| 56 | | Mem0 | 61.4% | — | Partial | ❌ | Apache-2.0 | |
| 57 | | Supermemory | 65.4% | — | ❌ | ❌ | Cloud API | |
| 58 | | MemOS | 75.8% | — | ✅ | ❌ | Apache-2.0 | |
| 59 | | ReadAgent | 79.5% | — | ❌ | ❌ | Research | |
| 60 | |
| 61 | > All benchmarks independently reproducible. Scripts included in [`benchmarks/`](benchmarks/ |
People who liked this also viewed
6 picksType
- excel-mcpA Model Context Protocol (MCP) server for working with Excel (.xlsx) files without requiring Microsoft Excel. Enables AI assistants to create, read, modify, and format spreadsheets using openpyxl, fully in Python and cross-platform.MCP ServersOct 2025
- memories-with-lessons-mcp-serverI enhance the existing memory mcp server from the official mcp github, so big thanks and credits for creating thisMCP ServersFeb 2025
- anytype-mcpAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.MCP ServersJul 2026
- mcp-server-kubernetesMCP Server for kubernetes management commandsMCP ServersJul 2026
- thoughtboxThoughtbox is an intention ledger for agents. Evaluate AI's decisions against its decision-making.MCP ServersJul 2026
- google-drive-mcpA Model Context Protocol (MCP) server that provides secure integration with Google Drive, Docs, Sheets, Slides and Calendar. It allows Claude Desktop and other MCP clients to manage files in Google Drive through a standardized interface.MCP ServersJul 2026
