If you find this project helpful, please give us a ⭐️ on GitHub for the latest update.
How to install telemem?
teleai-uagi/telemem
$git clone https://github.com/teleai-uagi/telememInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install telemem by running `git clone https://github.com/teleai-uagi/telemem`, then use it for the current task and follow its documentation at https://github.com/teleai-uagi/telemem.
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 |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
