项目截图
概览
Graphiti 作为时序上下文图引擎,旨在克服静态、批处理导向的 RAG 系统的局限性。它持续将用户交互和企业数据整合到可查询的图中,无需完全重新计算。其核心创新在于双时态跟踪:事实被分配有效时间窗口,当新信息取代旧信息时,旧事实会自动失效而非被删除。该图由实体(具有演化摘要的节点)、事实/关系(具有时态有效性的边)、片段(原始数据溯源)和自定义类型(通过 Pydantic 模型定义的本体)组成。它支持增量更新以及结合语义搜索、BM25 关键词搜索和图遍历的混合检索。
主要功能
- 具有双时态有效性窗口的时态事实管理
- 从派生事实到原始源数据的片段与溯源跟踪
- 通过 Pydantic 模型支持的规定和学习的本体
- 无需批量重新计算的增量图构建
- 结合语义、关键词 (BM25) 和图遍历的混合检索
- 保留完整时态历史的自动事实失效机制
- 可插拔的图数据库后端
- 用于 AI 助手集成的模型上下文协议 (MCP) 服务器
要求、安装和快速入门
用法
模型兼容性与使用场景
默认使用 OpenAI 进行 LLM 推理和嵌入。通过#通过附加组件支持 Anthropic、Google Gemini 和 Groq。兼容任何兼容 OpenAI 的 `/v1` 端点(包括8包括 DeepSeek、Together、OpenRouter、Ollama、vLLM、llama.cpp、LM Studio),使用 `OpenAIGenericClient`。通过其 v1 API 兼容层支持 Azure OpenAI。缺乏强大结构化输出支持的较小模型可能会导致不正确的模式和数据摄取失败。
许可证与风险说明
在 Apache-2.0 许可证下授权。
Editorial verification 2026-08-09: repository URL, owner, description, license and repository statistics were reviewed. License metadata: Apache-2.0. README was fetched for the channel draft; re-check repository dependencies, releases and model terms before production use.
发布与维护
截至 v0.17.0,用户可以实例化自定义数据库驱动,并使用 `graph_driver` 参数将其传递给 Graphiti 构造函数。由于上游项目不再维护,Kuzu 后端已被弃用。