getzep/zep:看清这个仓库的边界,它只是 Zep Cloud 的门厅
泽普 |示例、集成等等。它包含示例代码、框架集成以及用于使用 Zep Cloud(Zep 的托管代理内存平台)构建代理内存的工具。
秒懂
- 它是什么?
- 这个仓库不是 Zep 的产品本身,而是示例、集成和批量导入工具的集合。文章梳理它的目录结构、运行方式与维护成本,并指出它和 Graphiti 的分工。
- 适合谁用?
- 适合已经购买或准备试用 Zep Cloud 的团队,尤其是需要把 LangGraph、AutoGen、CrewAI 等框架接进 Zep 的开发者,或者有 Slack、邮件、JSON/CSV 历史数据要灌入的团队。不适合想自己托管记忆服务的用户,社区版已废弃,代码封存在 legacy/ 目录,别再指望它。
- 能商用吗?
- 可以。Apache-2.0 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
- 还在维护吗?
- 在维护。仓库最近一次提交在 2 天前。
- 用什么语言写的?
- 主要是 Python(依据 GitHub 的语言统计)。
以上回答依据项目的 GitHub 数据(最近同步于 2026年9月14日)和我们的分析,不构成法律意见。
开源项目深度解析
先分清仓库和产品,否则会踩空
读这个仓库之前要先把一件事钉死:getzep/zep 不是 Zep 的服务本体。README 第一句就写明,它包含的是构建 agent memory 的示例代码、框架集成和工具。真正的产品是 Zep Cloud,一个托管平台,需要去 getzep.com 注册。这个区分决定了你对待仓库内容的方式。你在这里找到的每一个集成包、每一段示例,最终都是向 Zep Cloud 的 API 发送数据,而不是在本地起一个服务。仓库里还有 legacy/ 目录,装着已废弃的 Zep Community Edition,官方声明不再支持。如果你带着「找个开源记忆方案自己部署」的预期进来,会在这里碰壁。这个仓库是门厅,不是房子。
目录结构:五个部分各管一段
仓库按用途分成五块。examples/ 是各语言的示例应用和代码片段,Python、TypeScript、Go 都有。integrations/ 是框架集成包,按「框架优先,语言其次」的规则组织,路径是 integrations/<framework>/<language>/,每个包独立构建、测试和发布。ingestion/ 里是 zep-ingest,负责批量数据导入,支持 Slack、文档、邮件、JSON/CSV 和事实三元组。ontology/ 放默认本体定义。benchmarks/ 和 zep-eval-harness/ 则是对记忆效果和导入检索的评测工具,前者跑 LoCoMo 和 LongMemEval 基准,后者是导入与检索的评估框架。这个划分说明了仓库的定位:它不试图成为单一 SDK,而是围绕 Zep Cloud 的接入生态。
集成矩阵:覆盖广,但深度参差
集成包的覆盖范围值得列出来。Python 侧有 Google ADK、Microsoft Agent Framework、Microsoft AutoGen、AG2、CrewAI、LangGraph、LiveKit、Pydantic AI、Strands Agents,一共九个。TypeScript 有 Google ADK、Mastra、Vercel AI SDK 三个。Go 目前只有 Google ADK 一个。这个覆盖有明显的不对称。Python 是 Zep 的主场,集成数量压倒性占优。TypeScript 和 Go 的选项少得多,如果你主力是 Mastra 或 Vercel AI SDK,有官方包可用,但选型空间小。Go 用户几乎只能靠 Google ADK 的包,其他 Go 框架得自己写桥接。README 指向 integrations/README.md 查看各包的发布状态,这意味着部分集成可能还处在未发布或预发布阶段,用之前要核对版本号。
zep-ingest:把历史数据灌进记忆系统
zep-ingest 是本仓库里最接近独立工具的组件,独立发布版本,最近三个 release 是 v0.3.0、v0.2.1、v0.2.0,节奏大约每两周一个版本。它的用途是批量导入,数据源包括 Slack、文档、邮件、JSON/CSV 和事实三元组。这意味着你可以把团队过去的聊天记录、邮件归档或结构化数据一次性灌入 Zep Cloud,而不是靠 agent 运行时逐步写入。版本号停留在 0.x,说明接口还没稳定。每次升级都可能带来破坏性变更,生产环境里锁版本是必要动作。批量导入的典型风险是数据格式映射错误,尤其是 Slack 和邮件的字段结构差异大,导入前需要先在小样本上跑通 eval harness。
和 Graphiti 的分工:别把两者搞混
README 里用一句话把另一个项目指了出来:想要支撑 Zep 的开源时序知识图谱框架,去看 Graphiti。这句话值得拆开读。Graphiti 是开源的,是 Zep 底层的知识图谱引擎。getzep/zep 不是。两者的边界是:Graphiti 给你图谱能力,你可以自己部署、自己控制;Zep Cloud 是托管服务,getzep/zep 仓库只是它的接入层。这个分工对选型有实际影响。如果你的需求是构建一个自托管的时序知识图谱,应该直接看 Graphiti,而不是在这个仓库里找答案。反过来,如果你不介意数据托管在 Zep Cloud,那 Graphiti 的部署成本可以省掉,直接用这里的集成包。两者不是替代关系,是上下游关系。
运行方式:依赖官方 SDK,仓库本身不提供运行时
要跑通这里的示例,先装官方 SDK。Python 用 pip install zep-cloud,TypeScript 用 npm install @getzep/zep-cloud,Go 用 go get github.com/getzep/zep-go/v3。三个语言的 SDK 各自独立,没有统一入口。安装完 SDK 之后,还需要 Zep Cloud 的账号和 API 凭证,因为所有示例最终都指向托管服务。integrations/CLAUDE.md 记录了集成包的开发约定,说明仓库对贡献者有明确的规范要求,包括代码风格和测试标准。这意味着如果你要自己加一个框架集成,需要先读那份约定文件,不能随手提 PR。仓库的 benchmarks/ 目录表明官方对记忆效果有量化手段,但 README 没有给出任何基准数字,实际效果需要自己跑 LoCoMo 或 LongMemEval 验证。
维护与许可:Apache-2.0 只覆盖代码,不覆盖服务
仓库采用 Apache-2.0 许可,最近一次推送是 2026 年 8 月 28 日,zep-ingest v0.3.0 同一天发布,说明项目仍在活跃维护。但 Apache-2.0 覆盖的是本仓库的代码,也就是示例、集成包和工具本身。Zep Cloud 是闭源托管服务,API 的可用性和价格由官方控制,不在开源许可范围内。集成包的独立发布机制意味着每个包有自己的版本节奏,升级时不能只更新仓库,要逐个包检查 release。legacy/ 目录里的社区版已经废弃,官方博客说明了开源策略的转向,这段历史提醒你:Zep 的开源重心已经移到 Graphiti,本仓库只是示例层,不要把它当作长期依赖的基础设施。
编辑结论
适合已经购买或准备试用 Zep Cloud 的团队,尤其是需要把 LangGraph、AutoGen、CrewAI 等框架接进 Zep 的开发者,或者有 Slack、邮件、JSON/CSV 历史数据要灌入的团队。不适合想自己托管记忆服务的用户,社区版已废弃,代码封存在 legacy/ 目录,别再指望它。首次使用前先确认三件事:目标框架的集成包是否已发布,版本号是否匹配你用的框架版本;zep-ingest 的输入格式是否覆盖你的数据源,尤其是事实三元组(fact triples)的 schema;以及你接受的许可范围,Apache-2.0 只覆盖本仓库代码,不覆盖 Zep Cloud 服务本身。这个仓库的价值在于缩短接入时间,不是替代产品文档。
社区笔记