io.github.TeleAI-UAGI/telemem

Official

by TeleAI-UAGI · Python

Long-term and multimodal memory for AI agents - character-aware, mem0-compatible, fully-local option

Multimodal long-term memory for AI agents with local-first and mem0-compatible options.

Topics

agentconversational-aillmlong-term-memorymem0memorymultimodalragsemantic-searchcharacter-memoryagent-memoryai-agentsfaissmcpmodel-context-protocolvideo-understanding

Install

Configuration

Environment variables

OPENAI_API_KEYsecret

API key for the default OpenAI LLM/embedder (not needed with a local TELEMEM_CONFIG)

TELEMEM_CONFIG

Path to a TeleMem YAML/JSON config, e.g. the fully-local Ollama + FAISS setup (config/config.ollama.yaml)

TELEMEM_DEFAULT_USER_ID

Default memory scope when tool calls omit user_id/agent_id/run_id (default: telemem-mcp)

claude_desktop_config.json

{
  "mcpServers": {
    "telemem": {
      "command": "uvx",
      "args": [
        "telemem"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "TELEMEM_CONFIG": "<YOUR_TELEMEM_CONFIG>",
        "TELEMEM_DEFAULT_USER_ID": "<YOUR_TELEMEM_DEFAULT_USER_ID>"
      }
    }
  }
}