apecloud/ApeRAG

ApeRAG: Production-ready GraphRAG with multi-modal indexing, AI agents, MCP support, and scalable K8s deployment

ApeRAG – 生产就绪的检索增强生成平台

ApeRAG 是一个开源系统，让您可以构建能够对您自己的文档进行搜索和推理的 AI 应用程序。它结合了多种检索技术（向量相似度、全文、基于图谱、基于摘要和基于视觉）与 AI 代理，这些代理可以自动选择正确的来源、执行查询并返回自然语言答案。该项目提供 FastAPI 后端、React Web UI 和完整的 Kubernetes/Helm 部署脚本，使其适用于本地实验和企业级生产环境。

核心功能 (如 README 中所述)

功能	描述
混合索引类型	提供五种内置索引 – 向量、全文、图谱、摘要、视觉 – 系统可以检索文本、嵌入、图谱关系、简洁摘要或图像内容。
智能 AI 代理	代理通过模型上下文协议 (MCP) 公开，可以自动发现相关集合、执行混合搜索，甚至执行网络搜索来回答问题。
带实体标准化的图谱 RAG	使用经过大幅修改的 LightRAG 引擎，合并重复实体，产生更干净的知识图谱和更好的关系推理。
多模态文档处理	处理 PDF、Word 文件、表格、公式和图像；视觉支持让系统能够分析图表和图片。
MinerU 文档解析器	一个可选的解析服务 (doc-ray)，可提取复杂结构（表格、公式），并支持可选的 GPU 加速。
生产级部署	针对 PostgreSQL、Redis、Qdrant、Elasticsearch 和 Neo4j 的 Helm chart 和 KubeBlocks 集成；包含审计日志、模型管理和图谱可视化。
MCP 集成	公开一个 `/mcp/` 端点，以便外部 LLM 助手可以使用模型上下文协议直接查询知识库。
开发者友好的技术栈	FastAPI 后端、异步 Celery 工作节点、React 前端、详尽的文档以及用于快速 Docker-Compose 启动的 Makefile。

典型使用案例

企业知识库 – 将内部文档、手册和支持工单转化为可搜索的 AI 助手。
产品文档门户 – 让用户以自然语言提问，并从 PDF、代码文档和图表中获取答案。
研究图书馆 – 结合文本、表格和图表；代理可以检索相关论文并总结研究结果。
客户支持机器人 – 跨常见问题解答、聊天记录和产品图像进行混合搜索，以提供准确且具备上下文意识的回复。

入门指南 (本地 Docker-Compose)

git clone https://github.com/apecloud/ApeRAG.git
cd ApeRAG
cp envs/env.template .env               # 设置您的 API 密钥、数据库密码等。
# 启动所有服务 (API, 前端, 数据库, 可选的 doc-ray)
docker-compose up -d --pull always

Web UI: http://localhost:3000/web/
OpenAPI 文档: http://localhost:8000/docs
README 中提供了 MCP 客户端配置示例；只需将客户端指向 http://localhost:8000/mcp/ 并提供 API 密钥即可。

生产部署 (Kubernetes)

准备 K8s 集群 (v1.20+)，安装 kubectl 和 Helm 3。
部署数据库 – 使用现有的 PostgreSQL/Redis/Qdrant/Elasticsearch 实例，或让提供的 KubeBlocks 脚本启动它们。

安装 Helm chart:

helm install aperag ./deploy/aperag --namespace default --create-namespace

公开服务 – 通过端口转发进行测试，或配置 Ingress 以处理外部流量。
可选的 doc-ray 服务 – 在 values.yaml 中启用 (docray.enabled: true) 或禁用以节省资源。

该 chart 处理所有必要的容器（API、前端、Celery 工作节点、doc-ray 等）并注入正确的连接字符串。

扩展 / 贡献

仓库包含一份 开发指南 (docs/en-US/development-guide.md)，引导您在本地设置代码库、运行单元测试以及添加新的代理。
LightRAG 组件在 MIT 授权下开源；修改内容记录在 aperag/graph/changelog.md 中。
社区频道：README 中列出了 Discord 和飞书 QR 码。

授权

Apache License 2.0 – 宽松授权，允许商业使用和修改。

总结： ApeRAG 是一个全栈、面向生产的 RAG 平台，结合了多种检索模式与 AI 代理，并提供简单的 Docker-Compose 启动和可扩展的 Kubernetes 部署。它文档齐全、开源，适合需要自托管知识库助手作为服务的企业。