用知识图谱增强 RAG，让 AI 回答更准更懂关系
GraphRAG-SDK 是一个用于构建生成式 AI 应用的 Python 开发工具包，旨在通过图检索增强生成（GraphRAG）技术，帮助开发者快速搭建准确、可扩展的 AI 应用。它解决了传统 RAG 在复杂关系推理和全局理解上的不足，将知识图谱与向量检索结合，提供更精准的上下文检索能力。核心能力包括：图构建与存储、混合检索（向量+图遍历）、可插拔的 LLM 接口、以及面向生产环境的性能优化。该 SDK 设计为模块化，支持多种图数据库和向量数据库，便于集成到现有 AI 工作流中。目前项目处于早期阶段，但已具备完整的文档和示例，适合技术团队探索下一代 RAG 应用。
1检查 Python 版本
GraphRAG-SDK 要求 Python 3.10+，版本过低需先升级 Python 环境。
python --version2启动 FalkorDB
用 Docker 拉取并后台启动 FalkorDB 图数据库，同时映射图数据库端口和浏览器界面端口。
docker run -d -p 6379:6379 -p 3000:3000 --name falkordb falkordb/falkordb:latest3安装 SDK
通过 pip 安装 graphrag-sdk 及 litellm 扩展，litellm 用于对接大模型接口。
pip install graphrag-sdk[litellm]4安装 PDF 支持
若需要摄取 PDF 文档，改用 pdf 扩展安装；该扩展会在写入图库前清洗非法控制字符。
pip install graphrag-sdk[litellm,pdf]5配置 API Key
把 OpenAI API Key 写入环境变量，SDK 调用 LLM 时会读取它。请替换成你自己的真实密钥。
export OPENAI_API_KEY="sk-xxxxxxxx"6确认容器运行
查看 falkordb 容器是否处于 Up 状态，以及 6379、3000 两个端口是否已正确映射。
docker ps| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | 调用 LLM 所需的 OpenAI 密钥，SDK 从环境变量读取 | sk-xxxxxxxx |
6379 | 是 | FalkorDB 主服务端口，SDK 连接图数据库使用 | 6379:6379 |
3000 | 否 | FalkorDB 浏览器界面端口，用于可视化查看图谱 | 3000:3000 |
执行 docker ps，看到名为 falkordb 的容器状态为 Up，且 6379、3000 端口处于映射状态，即表示环境就绪。
Q：只装 graphrag-sdk 够用吗？
A：不够。README 的快速开始使用 pip install graphrag-sdk[litellm]，需要带上 litellm 扩展才能对接大模型接口。
Q：要处理 PDF 文档怎么办？
A：把安装命令换成 pip install graphrag-sdk[litellm,pdf]，该扩展会清洗 ID 和字符串属性中的非法控制字符，避免 FalkorDB 的 Cypher 解析报错。
Q：必须本地装 FalkorDB 吗？
A：README 直接给出 docker run 方式启动 falkordb/falkordb:latest 镜像，这是官方示例中最省事的做法。
Q：端口 6379 或 3000 被占用怎么办？
A：修改 docker run 中 -p 的宿主机端口映射，例如 -p 16379:6379，避免与已有的 Redis 等服务冲突。
Microsoft GraphRAG、LlamaIndex、LangChain
GraphRAG-SDK 是搜索知识领域的开源项目，由 FalkorDB 开发，2024 年首次发布。
在全站 13,090 个收录项目中，它的 GitHub 星标数（1,000）位列前 30%，在搜索知识分类中处于中上游。
项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可免费使用和部署。
它主要面向的使用场景是：企业知识库智能问答，需要处理多实体复杂关系。同类可对比的替代方案包括 Microsoft GraphRAG、LlamaIndex、LangChain。
firecrawl
开源
网页抓取像喝水一样简单，开发者省下整周加班
The web data API to search, scrape, and interact at scale.
contoso-chat
开源
一键跑通 Azure RAG 应用，从代码到评估部署全流程
This sample has the full End2End process of creating RAG application with Prompty an···
graphify
开源
整个代码库画成一张图，找问题一眼定位
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···
ragflow
开源
让大模型用上你的私有知识，搭建可靠的企业级RAG应用
RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fu···