ApeRAG

把知识图谱塞进 RAG,多跳问答和复杂检索一次搞定

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 147 🐛 待处理 37 👀 关注 6
GitHub ↗
GitHub 星标 ★ 1319
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,免费使用,需自行部署

项目预览

ApeRAG 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队apecloud
定价模式🏷️完全免费
价格说明开源项目,免费使用,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型agents,context-engineering,graphrag,knowledge-graph,mcp
GitHub 星标★ 1319
上线时间2023-06-20 00:00:00
代码更新2026-10-29
仓库体积47.7 MB
本站数据更新2026-11-15
维护状态较活跃
收录时间2026-10-02
浏览次数2

项目介绍

ApeRAG 是一个面向生产环境的 GraphRAG 系统,把知识图谱、向量检索和多模态索引整合到一条流水线里,解决传统 RAG 只能做扁平文本相似度匹配、无法处理实体关系和复杂推理的问题。它支持对文档、图片等多模态内容建立索引,结合知识图谱抽取实体与关系,让检索结果既包含语义相似片段,也包含结构化关联信息。项目内置 AI Agent 能力,可让模型自主规划检索步骤、调用工具完成多跳问答。同时支持 MCP 协议,方便接入外部工具和数据源。部署层面提供面向 Kubernetes 的伸缩方案,适合从单机验证走向集群化生产。整体定位是给需要高质量知识问答、企业知识库和智能搜索的团队一套开箱可用的 GraphRAG 底座,而不是只停留在论文或 demo 阶段。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1319

使用教程

难度:入门 约 15 分钟 部署方式:Docker 4 步

环境要求

  • CPU >= 2 核
  • 内存 >= 4 GiB
  • 已安装 Docker
  • 已安装 Docker Compose

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 拉取 ApeRAG 源码到本地,需要能访问 GitHub。

    git clone https://github.com/apecloud/ApeRAG.git
  2. 2进入项目目录

    切换到刚克隆下来的 ApeRAG 目录,后续命令都在此目录执行。

    cd ApeRAG
  3. 3生成环境变量文件

    把 envs/env.template 复制为 .env,README 未列出具体必填项,按需修改。

    cp envs/env.template .env
  4. 4启动服务

    用 Docker Compose 后台启动全部容器,并始终拉取最新镜像。

    docker-compose up -d --pull always

关键配置

配置项必填说明示例
.env是环境变量配置文件,由 envs/env.template 复制而来cp envs/env.template .env
docray.enabled否K8s 部署时是否启用 doc-ray 服务,默认开启false

如何确认成功

浏览器打开 http://localhost:3000/web/ 看到 Web 界面,或访问 http://localhost:8000/docs 看到 API 文档。

常见问题

Q:必须用 Docker 部署吗?

A:README 的 Quick Start 只给出 Docker Compose 方式,是最简单的启动途径;生产环境还提供 Kubernetes + Helm 部署。

Q:启动后浏览器打不开怎么办?

A:确认容器已启动、3000 和 8000 端口未被占用,并检查 docker-compose 日志排查失败服务。

Q:生产环境怎么部署?

A:README 推荐使用 Kubernetes,通过 deploy/aperag 下的 Helm chart 安装,依赖 PostgreSQL、Redis、Qdrant、Elasticsearch。

注意事项

  • README 未说明 .env 中具体要填哪些变量,部署前建议先查看 envs/env.template 内容。
  • Kubernetes 部署默认包含 doc-ray 服务,需要 4 核以上 CPU 和 8GB 以上内存,可设置 docray.enabled: false 关闭。
  • K8s 方式依赖 PostgreSQL、Redis、Qdrant、Elasticsearch,可用 KubeBlocks 脚本自动部署或用已有实例。

核心亮点

  • 同时支持向量检索与知识图谱,能处理多跳关系和实体关联类问题,比纯向量 RAG 更适合复杂知识库
  • 内置 AI Agent 与 MCP 协议支持,可让模型自主规划检索、调用外部工具,扩展性强
  • 提供 K8s 部署方案,面向生产环境设计,具备横向扩展能力,不是单机玩具

不足之处

  • GraphRAG 索引构建依赖实体抽取和关系建模,对文档质量与 LLM 成本敏感,大规模数据下开销较高
  • 项目星标约 1300,生态和社区案例仍在成长,长期维护与文档完善度待观察

适用场景

  • 企业知识库问答:把内部文档、Wiki、PDF 建成图谱,支持跨文档多跳检索
  • 智能客服与售后:结合产品手册和工单历史,回答需要关联多个实体的问题
  • 多模态资料检索:对图文混排的研报、手册建立索引,按语义和关系查找内容

替代项目

Microsoft GraphRAG、LightRAG

上一篇:CORTEX-AI-SUPER-RAG

下一篇:bilibili-rag

同类项目推荐

IncarnaMind 开源

拖入多个 PDF/TXT,立即用大模型对话提问,答案带出处。

From messy files to a checked report. A free, open-source desktop app for macOS, Win···

★ 858 2026-08-09
denser-retriever 开源

让 AI 应用检索更准,企业级 RAG 集成更简单。

An enterprise-grade AI retriever designed to streamline AI integration into your app···

★ 295 2026-08-09
azure-search-openai-demo-csharp 开源

用 C# 在 Azure 上快速搭一个带引用的文档问答应用

A sample app for the Retrieval-Augmented Generation pattern running in Azure, using ···

★ 846 2026-11-09
crypto-rag 开源

印尼语加密问答,实时行情+知识库一次答全

Asisten crypto berbahasa Indonesia: RAG pengetahuan 267 topik + data pasar realtime ···

★ 465 2026-10-02
arxiv-mcp-server 开源

用自然语言搜索和分析 arXiv 论文,快速获取研究要点

A local MCP server for agent literature work. Original-LaTeX section reads, BibTeX f···

★ 3280 2026-08-09
xiaoyaosearch 开源

说句话发张图,电脑里的文件秒找到

小遥搜索,听懂你的话、看懂你的图,用AI找到本地任何文件。让搜索像聊天一样简单。Xiaoya···

★ 1024 2026-08-09
adk-vertex-ai-rag-engine 开源

两分钟搭好文档语义搜索问答 Agent

A RAG agent using Google's ADK & Vertex AI that lets set up semantic search across ···

★ 109 2026-11-08
awesome-ai-web-search 开源

一份清单,带你玩转AI搜索工具。

List of software that allows searching the web with the assistance of AI: https://hf···

★ 1518 2026-08-09
local-deep-researcher 开源

本地跑通搜索到报告,隐私数据不出门

Fully local web research and report writing assistant

★ 9410 2026-09-12