
ApeRAG
把知识图谱塞进 RAG,多跳问答和复杂检索一次搞定
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1319
使用教程
环境要求
- CPU >= 2 核
- 内存 >= 4 GiB
- 已安装 Docker
- 已安装 Docker Compose
安装与启动步骤
-
1克隆仓库
从 GitHub 拉取 ApeRAG 源码到本地,需要能访问 GitHub。
git clone https://github.com/apecloud/ApeRAG.git -
2进入项目目录
切换到刚克隆下来的 ApeRAG 目录,后续命令都在此目录执行。
cd ApeRAG -
3生成环境变量文件
把 envs/env.template 复制为 .env,README 未列出具体必填项,按需修改。
cp envs/env.template .env -
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
下一篇:bilibili-rag
同类项目推荐
IncarnaMind
开源
拖入多个 PDF/TXT,立即用大模型对话提问,答案带出处。
From messy files to a checked report. A free, open-source desktop app for macOS, Win···
denser-retriever
开源
让 AI 应用检索更准,企业级 RAG 集成更简单。
An enterprise-grade AI retriever designed to streamline AI integration into your app···
azure-search-openai-demo-csharp
开源
用 C# 在 Azure 上快速搭一个带引用的文档问答应用
A sample app for the Retrieval-Augmented Generation pattern running in Azure, using ···
crypto-rag
开源
印尼语加密问答,实时行情+知识库一次答全
Asisten crypto berbahasa Indonesia: RAG pengetahuan 267 topik + data pasar realtime ···
arxiv-mcp-server
开源
用自然语言搜索和分析 arXiv 论文,快速获取研究要点
A local MCP server for agent literature work. Original-LaTeX section reads, BibTeX f···
xiaoyaosearch
开源
说句话发张图,电脑里的文件秒找到
小遥搜索,听懂你的话、看懂你的图,用AI找到本地任何文件。让搜索像聊天一样简单。Xiaoya···
adk-vertex-ai-rag-engine
开源
两分钟搭好文档语义搜索问答 Agent
A RAG agent using Google's ADK & Vertex AI that lets set up semantic search across ···
awesome-ai-web-search
开源
一份清单,带你玩转AI搜索工具。
List of software that allows searching the web with the assistance of AI: https://hf···
local-deep-researcher
开源
本地跑通搜索到报告,隐私数据不出门
Fully local web research and report writing assistant