Skip to main content

Overview

Mem0Storage integrates with the Mem0 memory platform. Supports both the hosted Mem0 Platform and self-hosted Mem0 Open Source deployments.

Install

Install the Mem0 storage optional dependency group:
uv pip install "upsonic[mem0-storage]"

Basic Usage

from upsonic import Agent, Task
from upsonic.storage.memory import Memory
from upsonic.storage.mem0 import Mem0Storage

storage = Mem0Storage(
    api_key="your_mem0_api_key",
    org_id="your_org_id",
    project_id="your_project_id"
)

memory = Memory(
    storage=storage,
    session_id="session_001",
    user_id="user_123",
    full_session_memory=True,
    summary_memory=True,
    user_analysis_memory=True,
    model="openai/gpt-4o"
)

agent = Agent("openai/gpt-4o", memory=memory)

result1 = agent.do(Task("My name is Alice"))
result2 = agent.do(Task("What's my name?"))
print(result2)  # "Your name is Alice"

Parameters

ParameterTypeDefaultDescription
memory_clientMemory | MemoryClient | NoneNonePre-existing Mem0 client
api_keystr | NoneNoneMem0 Platform API key
hoststr | NoneNoneMem0 Platform host URL
org_idstr | NoneNoneOrganization ID (Platform)
project_idstr | NoneNoneProject ID (Platform)
configMemoryConfig | NoneNoneConfig for self-hosted Mem0
session_tablestr | None"upsonic_sessions"Session table name (metadata)
user_memory_tablestr | None"upsonic_user_memories"User memory table name (metadata)
default_user_idstr"upsonic_default"Default user ID for Mem0 operations
idstr | Noneauto-generatedStorage instance ID