Practical overview
When it fits
Use Telemem when an agent needs to retain conversational context beyond a single exchange, or when a project needs the additional character-memory or video pipeline. The core package is for text memory; MCP and video support are optional extras.
Who it is for
- Developers adding persistent memory to conversational AI agents.
- Teams building role-play, companion or multi-persona assistants that need separate character profiles.
- Developers who want an optional video-memory and question-answering pipeline.
Documented uses
- Save conversation details and retrieve them later through a natural-language query.
- Reduce semantically similar memories before storage.
- Keep character or persona information available across interactions.
- Index video-derived frames and captions for retrieval and question answering.
Requirements & limits
The repository specifies the Apache-2.0 license and documents installation through pip. The README shows separate core, MCP, video and all-extras packages.
- The default
Memory()configuration inherits provider settings from mem0ai; the quick-start example sets an OpenAI API key. - A local Qwen and FAISS configuration is shown separately and must be loaded explicitly.
- Video and MCP capabilities are installed as optional extras rather than being part of the core text-memory install.
- The README describes Mem0-style imports and matching
add()andsearch()shapes, but compatibility should be assessed against the specific APIs an application uses.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Add dialogue memory and retrieve a relevant detail
Use Telemem's documented Python example to store a conversation and search it with a question.
Before you start
- Python environment with the Telemem core package installed.
- OpenAI API key for the default provider configuration, or an explicitly loaded alternative configuration.
Steps
Install the core package with the command below.
pip install telememSet
OPENAI_API_KEYfor the default provider settings, or load a configuration file withload_configand pass it toMemory.Import
telemem as mem0and create aMemoryinstance.Call
memory.addwith messages and auser_id, then callmemory.searchwith a question and the sameuser_id.Read matching items from the returned
resultscollection.
Expected outcome
The example stores a multi-turn exchange and returns matching memory text for a later question.
Guide limitations
- The shown default configuration uses provider settings inherited from mem0ai and requires an OpenAI API key.
- The README's local Qwen and FAISS path requires explicitly loading the repository configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- TeleAI-UAGI/telemem · Official homepage title · retained in its source language
Related options
Mem0 — Telemem presents itself as a Mem0-style drop-in replacement and documents the `import telemem as mem0` pattern.
Explore project →
