telemem
installs/mo · pypistarsforks
How to install telemem?
teleai-uagi/telemem
$git clone https://github.com/TeleAI-UAGI/telememIf you find this project helpful, please give us a ⭐️ on GitHub for the latest update.
README.md
| 1 | <p align="center"> |
| 2 | <a href="https://github.com/TeleAI-UAGI/telemem"> |
| 3 | <img src="./assets/TeleMem.png" width="40%" /> |
| 4 | </a> |
| 5 | </p> |
| 6 | |
| 7 | <h1 align="center"> TeleMem: Building Long-Term and Multimodal Memory for Agentic AI </h1> |
| 8 | |
| 9 | <p align="center"> |
| 10 | <a href="https://arxiv.org/abs/2601.06037"> |
| 11 | <img src="https://img.shields.io/badge/arXiv-Paper-red" alt="arXiv"> |
| 12 | </a> |
| 13 | <a href="https://github.com/TeleAI-UAGI/telemem/actions/workflows/ci.yml"> |
| 14 | <img src="https://github.com/TeleAI-UAGI/telemem/actions/workflows/ci.yml/badge.svg" alt="CI"> |
| 15 | </a> |
| 16 | <a href="https://pypi.org/project/telemem/"> |
| 17 | <img src="https://img.shields.io/pypi/v/telemem?color=blue" alt="PyPI"> |
| 18 | </a> |
| 19 | <a href="https://github.com/TeleAI-UAGI/telemem"> |
| 20 | <img src="https://img.shields.io/github/stars/TeleAI-UAGI/TeleMem?style=social" alt="GitHub Stars"> |
| 21 | </a> |
| 22 | <a href="https://github.com/TeleAI-UAGI/TeleMem/blob/main/LICENSE"> |
| 23 | <img src="https://img.shields.io/badge/license-Apache%20License%202.0-blue" alt="License: Apache 2.0"> |
| 24 | </a> |
| 25 | <img src="https://img.shields.io/github/last-commit/TeleAI-UAGI/TeleMem?color=blue" alt="Last Commit"> |
| 26 | <img src="https://img.shields.io/badge/PRs-Welcome-red" alt="PRs Welcome"> |
| 27 | </p> |
| 28 | |
| 29 | <div align="center"> |
| 30 | |
| 31 | **If you find this project helpful, please give us a ⭐️ on GitHub for the latest update.** |
| 32 | |
| 33 | _🤝 Contributions welcome! Feel free to open an issue or submit a pull request._ |
| 34 | |
| 35 | </div> |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | <div align="center"> |
| 40 | <p> |
| 41 | <a href="README.md">English</a> | <a href="README-ZH.md">简体中文</a> |
| 42 | </p> |
| 43 | <p> |
| 44 | <a href="https://github.com/TeleAI-UAGI/Awesome-Agent-Memory"> <strong>📄 Awesome-Agent-Memory →</strong></a> |
| 45 | </p> |
| 46 | </div> |
| 47 | |
| 48 | TeleMem is an agent memory management layer that can be used as <mark>**a high-performance drop-in replacement for [Mem0](https://mem0.ai/)** with one line of code (`import telemem as mem0`)</mark>, deeply optimized for complex scenarios involving **multi-turn dialogues**, **character modeling**, **long-term information storage**, and **semantic retrieval**. |
| 49 | |
| 50 | Through its unique **context-aware enhancement mechanism**, TeleMem provides conversational AI with core infrastructure offering **higher accuracy**, **faster performance**, and **stronger character memory capabilities**. |
| 51 | |
| 52 | Building upon this foundation, TeleMem implements **video understanding, multimodal reasoning, and visual question answering** capabilities. Through a complete pipeline of video frame extraction, caption generation, and vector database construction, AI Agents can effortlessly **store, retrieve, and reason over video content** just like handling text memories. |
| 53 | |
| 54 | The ultimate goal of the TeleMem project is to _use an agent's hindsight to improve its foresight_. |
| 55 | |
| 56 | **TeleMem, where memory lives on and intelligence grows strong.** |
| 57 | |
| 58 | ### Why TeleMem? |
| 59 | |
| 60 | - 🎭 **Character memory done right** — the only open-source memory layer that automatically builds **isolated, per-character memory profiles**, built for role-play, companion AI, NPCs, and multi-persona assistants. |
| 61 | - 🎬 **Memory for video, not just text** — a full video → frames → captions → vector DB pipeline with **ReAct-style multi-step video QA**. |
| 62 | - 🏠 **Fully local by default** — runs end-to-end on your hardware (Qwen + FAISS); no cloud service, no paid tier, no data leaving your machine. |
| 63 | - 🔌 **mem0-compatible API** — `add()` / `search()` accept the same arguments and return the same `{"results": [...]}` shapes, so existing Mem0 code keeps working. |
| 64 | |
| 65 | --- |
| 66 | |
| 67 | ## 📢 Latest Updates |
| 68 | - **[2026-07-11] 🎉 TeleMem [v1.8.0](https://github.com/TeleAI-UAGI/telemem/releases/tag/v1.8.0) — the "claims = contracts" release: character-memory extraction fix, `infer=False`/`prompt`/`memory_type` now fully honored, offline contract test suite, telemetry disabled by default, and a [multi-NPC demo](examples/multi_npc.py)!** |
| 69 | - **[2026-06-12] 🎉 TeleMem [v1.7.1](https://github.com/TeleAI-UAGI/telemem/releases/tag/v1.7.1) is live on the [official MCP registry](https://registry.modelcontextproto |
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
