Migration Guides

Fresh

Guides for migrating between Mem0 versions and deployment models.

OSS to Platform Migration

Moving from self-hosted Mem0 Open Source to the managed Mem0 Platform.

Key Changes

Aspect	OSS	Platform
Client import	from mem0 import Memory	from mem0 import MemoryClient
Initialization	Memory()	MemoryClient(api_key="...")
Configuration	Full config dict	API key only
Infrastructure	Self-managed	Managed by Mem0

Migration Steps

1. Get API Key: Sign up at app.mem0.ai and create a project
2. Update imports: Change Memory to MemoryClient
3. Update initialization: Replace config dict with API key
4. Update method calls: Platform uses slightly different parameter names

# Before (OSS)
from mem0 import Memory
m = Memory()
m.add(messages, user_id="alice")
results = m.search("query", user_id="alice")

# After (Platform)
from mem0 import MemoryClient
client = MemoryClient(api_key="your-api-key")
client.add(messages, user_id="alice")
results = client.search("query", filters={"user_id": "alice"})

v0 to v1 Migration

Breaking Changes in v1

• Async by default: Platform operations are async. Use async_mode=False for synchronous behavior.
• Reranker support: Built-in reranker configuration
• Azure OpenAI support: Native Azure integration
• Filter syntax: New v2 filter format with AND/OR operators

Filter Migration

# v0 filters
results = client.search("query", user_id="alice")

# v1 filters
results = client.search("query", filters={
    "AND": [{"user_id": "alice"}]
})

API Changes

Renamed Parameters

v0	v1	Notes
user_id (direct)	filters.user_id	In search operations
agent_id (direct)	filters.agent_id	In search operations
session_id (direct)	filters.session_id	In search operations

New Features in v1

• Memory expiration dates
• Custom categories at project level
• Batch update/delete operations
• Memory export
• Webhook support
• Graph memory (managed)

Troubleshooting Migration

Issue	Solution
ModuleNotFoundError	Run pip install --upgrade mem0ai
Auth errors	Verify API key format and permissions
Missing memories	Export from OSS first, then import to Platform
Filter errors	Update to v2 filter syntax with AND/OR operators