v0.1.0

v0.1.0 — Initial Release

Unified memory gateway for AI agents. One interface, multiple memory providers.

Highlights

• Protocol-based architecture — four memory store protocols (FactStore, HistoryStore, DocumentStore, GraphStore) using Python's @runtime_checkable Protocol
• Three providers — Mem0, Zep, and Chroma supported out of the box
• Composable — mix and match providers in a single Memio client
• Async-first — all operations use async/await
• Zero production dependencies — install only the providers you need

Providers

Store	Mem0	Zep	Chroma
FactStore	✅	✅	-
HistoryStore	-	✅	-
DocumentStore	-	-	✅
GraphStore	✅	✅	-

Install

pip install memio              # core
pip install memio[mem0]        # + Mem0 provider
pip install memio[zep]         # + Zep provider
pip install memio[chroma]      # + Chroma provider
pip install memio[all]         # all providers

Quick Example

from memio import Memio, Message
from memio.providers.mem0 import Mem0FactAdapter
from memio.providers.zep import ZepHistoryAdapter
from memio.providers.chroma import ChromaDocumentAdapter
import chromadb

client = Memio(
    facts=Mem0FactAdapter(api_key="..."),
    history=ZepHistoryAdapter(api_key="..."),
    documents=ChromaDocumentAdapter(
        client=chromadb.EphemeralClient(),
        collection_name="my-docs",
    ),
)

fact = await client.facts.add(content="likes coffee", user_id="alice")
results = await client.facts.search(query="coffee", user_id="alice")

Documentation

Full documentation at y3zai.github.io/memio

License

MIT