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 部署。它文件齊全、開源，適合需要自託管知識庫助手作為服務的企業。