Mem0

1.0.4 · active · verified Sun Mar 01

Memory layer for AI agents and assistants. PyPI package is mem0ai but imports as mem0. Two distinct usage modes: Memory class (OSS, self-hosted) and MemoryClient class (managed platform). v1.0.0 introduced breaking changes to response format.

Warnings

breaking v1.0 changed all response formats. add() and get_all() now return a dict with a 'results' key, not a flat list. Code iterating directly over the return value breaks with TypeError.
Fix: Access results via memory.add(...)["results"] and memory.get_all(...)["results"].
breaking output_format='v1.0' is removed server-side. Passing it raises DeprecationWarning then 400 Bad Request from the platform API.
Fix: Remove all output_format parameters. v1.1 format is now the only format.
gotcha Package name is mem0ai but import name is mem0. pip install mem0ai, then from mem0 import Memory.
Fix: pip install mem0ai && from mem0 import Memory
gotcha MemoryClient.add() defaults to async_mode=True in v1.0+. Calling search() immediately after add() may return empty results as memory has not yet been stored.
Fix: Pass async_mode=False to block until memory is stored before querying.
gotcha OSS Memory() with no config calls OpenAI by default. Fails with AuthenticationError if OPENAI_API_KEY is not set.
Fix: Set OPENAI_API_KEY or pass a config dict to Memory() specifying an alternative LLM provider.
gotcha Graph memory features require pip install mem0ai[graph]. Importing graph-related classes without this extra raises ImportError.
Fix: pip install mem0ai[graph]

Install

pip install mem0ai Python (core)
pip install mem0ai[graph] Python (with graph memory support)

Imports

Memory
```
from mem0 import Memory
```
Package is mem0ai but module is mem0. Common codegen error.
MemoryClient
```
from mem0 import MemoryClient
```
MemoryClient is for the managed platform (needs MEM0_API_KEY). Memory is for OSS self-hosted. They are not interchangeable.

Quickstart

OSS self-hosted usage with Memory class. For platform usage, replace Memory() with MemoryClient(api_key=...).

from mem0 import Memory

memory = Memory()  # requires OPENAI_API_KEY by default

memory.add(
    [{"role": "user", "content": "I like basketball."}],
    user_id="alice"
)

results = memory.search(query="sports", user_id="alice", limit=3)
for r in results["results"]:
    print(r["memory"])

view raw JSON →