youtu-graphrag

环境要求

• Docker 环境（README 推荐的首选部署方式，按 Docker 官方文档安装）
• 本地 Python 运行环境（用于执行 setup_env.sh 的本地部署方式）
• 可用的网络，用于拉取镜像依赖与项目代码
• 可用的 LLM 接口，用于图检索增强问答的推理与生成

安装与启动步骤

1. 1获取项目代码

   克隆仓库并进入项目根目录，后续 Docker 构建与脚本执行都在该目录下进行。

   git clone https://github.com/TencentCloudADP/youtu-graphrag.git
   cd youtu-graphrag

   复制

2. 2安装 Docker

   README 建议优先用 Docker 部署，若本机没有 Docker，请先按官方文档安装并确认服务已启动。

   docker --version

   复制

3. 3构建镜像

   使用仓库自带 Dockerfile 构建名为 youtu_graphrag、标签 v1 的镜像，首次构建需下载依赖，耗时较长。

   docker build -t youtu_graphrag:v1 .

   复制

4. 4启动容器

   以守护进程方式运行镜像，并把容器内 8000 端口映射到宿主机 8000，便于访问 demo 服务。

   docker run -d -p 8000:8000 youtu_graphrag:v1

   复制

5. 5本地环境初始化

   不使用 Docker 时，可运行仓库内 setup_env.sh 完成本地环境配置，需在项目根目录执行并有执行权限。

   ./setup_env.sh

   复制

6. 6查阅完整指南

   README 指向 FULLGUIDE-CN.md，高级配置与详细用法都在该文档中，部署前建议先通读。

关键配置

如何确认成功

执行 docker ps 确认容器状态为 Up，并在浏览器访问 http://localhost:8000 查看服务是否响应。

常见问题

注意事项

• README 仅推荐 Docker 作为首选部署方式，未给出镜像加速或离线构建方案。
• 容器对外服务的具体 API 路径未在 README 节选中说明，需查阅 FULLGUIDE-CN.md。
• 项目论文已被 ICLR 2026 接收，企业版可通过腾讯云 ADP 平台使用。
• executable 权限不足时，运行 setup_env.sh 前需自行赋予可执行权限。