{"id":85,"library":"zep-cloud","title":"Zep","description":"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.","status":"active","version":"3.16.0","language":"python","source_language":"en","source_url":"https://github.com/getzep/zep-python","tags":["memory","agents","llm","python","context","chat-history"],"install":[{"cmd":"pip install zep-cloud","lang":"bash","label":"Python (Zep Cloud, managed)"},{"cmd":"pip install zep-python","lang":"bash","label":"Python (Zep Community Edition, self-hosted)"}],"dependencies":[{"reason":"Managed platform client. Requires ZEP_API_KEY.","package":"zep-cloud","optional":true},{"reason":"Required only if using ZepChatMessageHistory or ZepVectorStore LangChain integration classes.","package":"langchain-core","optional":true}],"imports":[{"note":"zep_cloud and zep_python are different packages with different client classes. Using zep_python client against Zep Cloud endpoints will fail.","wrong":"from zep_python.client import ZepClient","symbol":"Zep","correct":"from zep_cloud.client import Zep"},{"note":"ZepClient is for self-hosted Community Edition only. Requires a running Zep server on localhost:8000 by default.","wrong":"from zep_cloud.client import Zep","symbol":"ZepClient","correct":"from zep.client import ZepClient"}],"quickstart":{"code":"from zep_cloud.client import Zep\n\nclient = Zep(api_key=\"your-zep-api-key\")\n\nclient.memory.add(\n    \"session_abc\",\n    messages=[\n        {\"role_type\": \"user\", \"content\": \"My name is Alice.\"},\n        {\"role_type\": \"assistant\", \"content\": \"Nice to meet you, Alice.\"}\n    ]\n)\n\nmemory = client.memory.get(\"session_abc\")\nprint(memory.context)","lang":"python","description":"Zep Cloud client usage. For Community Edition, use ZepClient from zep-python pointed at your self-hosted server."},"warnings":[{"fix":"Use zep-cloud for managed platform. Use zep-python (oss branch build) for self-hosted Community Edition.","message":"zep-cloud and zep-python are separate packages with incompatible client classes and different APIs. Installing the wrong one silently fails at runtime.","severity":"breaking","affected_versions":"all"},{"fix":"Self-hosted users should use the oss branch build of zep-python or pin to zep-python < 2.0.0.","message":"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.","severity":"breaking","affected_versions":"zep-python >= 2.0.0"},{"fix":"Use role_type field: {\"role_type\": \"user\", \"content\": \"...\"}","message":"Message field changed from 'role' to 'role_type' in zep-cloud SDK. Passing 'role' is silently ignored or raises a validation error.","severity":"breaking","affected_versions":"zep-cloud all versions"},{"fix":"Run the Zep server via Docker before making any client calls: docker run -p 8000:8000 ghcr.io/getzep/zep:latest","message":"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.","severity":"gotcha","affected_versions":"all"},{"fix":"Import LangChain integration classes directly from zep_cloud.langchain.","message":"LangChain integration classes (ZepChatMessageHistory, ZepVectorStore) moved from langchain-community into the zep-cloud package. Importing from langchain_community.memory.zep fails on newer installs.","severity":"gotcha","affected_versions":"all"}],"env_vars":{"optional":[{"name":"ZEP_BASE_URL","note":"Override for self-hosted server URL. Defaults to localhost:8000 for Community Edition."}],"required":[{"name":"ZEP_API_KEY","note":"Required for Zep Cloud. Not used by self-hosted Community Edition."}]},"last_verified":"2026-05-12T07:58:06.315Z","next_check":"2026-04-01T00:00:00.000Z","problems":[],"ecosystem":"pypi","meta_description":null,"install_score":100,"install_tag":"verified","quickstart_score":0,"quickstart_tag":"stale","pypi_latest":null,"install_checks":{"last_tested":"2026-05-12","tag":"verified","tag_description":"installs cleanly on critical runtimes, fast import, recently tested","results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":0.97,"mem_mb":16.9,"disk_size":"34.7M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":0.7,"mem_mb":16.9,"disk_size":"34M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":1.28,"mem_mb":18.6,"disk_size":"38.2M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":1.11,"mem_mb":18.6,"disk_size":"38M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":1.39,"mem_mb":18.4,"disk_size":"29.6M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":1.36,"mem_mb":18.3,"disk_size":"29M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":1.29,"mem_mb":19.1,"disk_size":"29.2M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":1.25,"mem_mb":19.1,"disk_size":"29M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":0.91,"mem_mb":17,"disk_size":"34.1M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"default","exit_code":0,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":0.84,"mem_mb":17,"disk_size":"34M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"default","exit_code":1,"wheel_type":null,"failure_reason":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null}]},"quickstart_checks":{"last_tested":"2026-05-12","tag":"stale","tag_description":"widespread failures or data too old to trust","results":[{"runtime":"python:3.10-alpine","exit_code":1},{"runtime":"python:3.10-slim","exit_code":1},{"runtime":"python:3.11-alpine","exit_code":1},{"runtime":"python:3.11-slim","exit_code":1},{"runtime":"python:3.12-alpine","exit_code":1},{"runtime":"python:3.12-slim","exit_code":1},{"runtime":"python:3.13-alpine","exit_code":1},{"runtime":"python:3.13-slim","exit_code":1},{"runtime":"python:3.9-alpine","exit_code":1},{"runtime":"python:3.9-slim","exit_code":1}]}}