Client¶

The Memio class is the main entry point for using memio.

memio.client.Memio ¶

Unified memory gateway for AI agents.

Composes one or more memory stores into a single client. Each store is validated against its protocol at initialization.

Parameters:

Name	Type	Description	Default
`facts`	`FactStore \| None`	A FactStore implementation for structured facts.	`None`
`history`	`HistoryStore \| None`	A HistoryStore implementation for conversation history.	`None`
`documents`	`DocumentStore \| None`	A DocumentStore implementation for document storage.	`None`
`graph`	`GraphStore \| None`	A GraphStore implementation for knowledge graphs.	`None`

Raises:

Type	Description
`ValueError`	If no memory stores are provided.
`TypeError`	If a store does not implement its expected protocol.

Example

from memio import Memio
from memio.providers.mem0 import Mem0FactAdapter

client = Memio(facts=Mem0FactAdapter(api_key="..."))
fact = await client.facts.add(content="likes coffee", user_id="alice")