Zep

3.16.0 · active · verified Sun Mar 01

Long-term memory and context platform for AI assistants. Two separate PyPI packages: zep-cloud (managed platform) and zep-python (OSS/Community Edition). Not interchangeable. zep-python v2.x main branch now ships the Cloud SDK — OSS users need the oss branch build.

Warnings

breaking zep-cloud and zep-python are separate packages with incompatible client classes and different APIs. Installing the wrong one silently fails at runtime.
Fix: Use zep-cloud for managed platform. Use zep-python (oss branch build) for self-hosted Community Edition.
breaking zep-python v2.x main branch is now the Cloud SDK, not the OSS client. pip install zep-python installs the Cloud-flavoured SDK, breaking self-hosted setups.
Fix: Self-hosted users should use the oss branch build of zep-python or pin to zep-python < 2.0.0.
breaking Message field changed from 'role' to 'role_type' in zep-cloud SDK. Passing 'role' is silently ignored or raises a validation error.
Fix: Use role_type field: {"role_type": "user", "content": "..."}
gotcha Self-hosted Zep requires a running server process. pip install zep-python alone gives only a client library. All calls raise ConnectionError without the server running.
Fix: Run the Zep server via Docker before making any client calls: docker run -p 8000:8000 ghcr.io/getzep/zep:latest
gotcha LangChain integration classes (ZepChatMessageHistory, ZepVectorStore) moved from langchain-community into the zep-cloud package. Importing from langchain_community.memory.zep fails on newer installs.
Fix: Import LangChain integration classes directly from zep_cloud.langchain.

Install

pip install zep-cloud Python (Zep Cloud, managed)
pip install zep-python Python (Zep Community Edition, self-hosted)

Imports

Zep
```
from zep_cloud.client import Zep
```
zep_cloud and zep_python are different packages with different client classes. Using zep_python client against Zep Cloud endpoints will fail.
ZepClient
```
from zep.client import ZepClient
```
ZepClient is for self-hosted Community Edition only. Requires a running Zep server on localhost:8000 by default.

Quickstart

Zep Cloud client usage. For Community Edition, use ZepClient from zep-python pointed at your self-hosted server.

from zep_cloud.client import Zep

client = Zep(api_key="your-zep-api-key")

client.memory.add(
    "session_abc",
    messages=[
        {"role_type": "user", "content": "My name is Alice."},
        {"role_type": "assistant", "content": "Nice to meet you, Alice."}
    ]
)

memory = client.memory.get("session_abc")
print(memory.context)

view raw JSON →