项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-09 · 当前星标 ★ 1575
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Docker Engine 或 Docker Desktop
- Docker Compose v2,且带 Buildx
- macOS 或 Linux 上的 make
- 足够的磁盘空间与时间(首次构建要下载容器镜像、Python 依赖和 RAG 模型)
- 可选:NVIDIA GPU 与 Container Toolkit,用于加速 OCR、ASR 和视觉语言处理
安装与启动步骤
-
1初始化配置
生成平台、数据库、对象存储、LLM Gateway,以及 LightRAG、解析、MCP 和前端所需的 .env 文件,务必先执行此步。
make init -
2启动依赖中间件
本地运行完整 RAG 栈时使用,会拉起中间件以及 LightRAG 和 Atomic RAG 服务,首次拉取耗时较长。
make dev-deps-up -
3启动前端网关
建议单独开一个终端运行,启动统一 Gateway,所有对外 API 都通过这个网关暴露。
make dev-gateway -
4启动前端应用
再开一个终端执行,启动前端应用;网关与应用需分别运行,不要挤在同一个终端。
make dev-frontend -
5访问控制台
浏览器打开本地地址进入前端界面,能看到页面即表示栈已跑起来。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
deploy/.env | 是 | 平台、数据库、对象存储和 LLM Gateway 的配置 | make init 自动生成 |
deploy/.env.rag | 是 | LightRAG、向量嵌入与文档解析相关配置 | make init 自动生成 |
deploy/.env.mcp | 是 | MCP 服务相关配置 | make init 自动生成 |
前端 .env 文件 | 是 | Shell、核心业务、生态管理、平台管理与 Dev Gateway 的前端配置 | make init 自动生成 |
如何确认成功
浏览器打开 http://localhost:8080 能正常显示前端页面,即表示 Docker Compose 栈启动成功。
常见问题
Q:首次构建为什么特别慢?
A:首次构建会下载容器镜像、Python 依赖和 RAG 模型,需要较大的磁盘空间和较长时间,属于正常现象,请保证网络稳定并耐心等待。
Q:怎样本地跑完整 RAG 栈?
A:在 make init 之后执行 make dev-deps-up,它会同时启动中间件、LightRAG 和 Atomic RAG。
Q:没有 make 命令怎么办?
A:README 的 Docker 要求中只列出了 macOS 或 Linux 上的 make,其他系统需自备 make 环境后再按同样步骤执行。
Q:解析速度不够快怎么办?
A:可选用 NVIDIA GPU 与 Container Toolkit 加速 OCR、ASR 和视觉语言处理;显存需求取决于所选模型,CPU 解析仅适合评估和轻负载。
注意事项
- make init 会写入 deploy/.env、deploy/.env.rag、deploy/.env.mcp 及多个前端 .env 文件,其中含凭据,注意不要提交到仓库。
- 完整部署还需 PostgreSQL 15、Redis 7、对象存储,向量检索依赖 Milvus、etcd、MinIO,本体图谱默认打包 Neo4j 集成。
- make dev-gateway 与 make dev-frontend 要在不同终端分别启动,否则会互相阻塞。
- README 节选中未给出获取源码的命令,执行前请先按官方仓库说明准备好项目目录。
核心亮点
- 多模态解析覆盖视频/音频/文档,内置ASR和OCR,开箱即用
- 本体驱动知识建模,比纯向量检索更有语义深度,支持复杂关系查询
- LLM Wiki 自动生成知识条目,降低人工维护成本,易扩展
不足之处
- 项目较新,文档和社区生态尚待完善
- 本体建模和知识图谱配置有一定学习门槛,上手不轻松
适用场景
- 企业知识库建设,整合内部视频会议、PDF、PPT等多源资料
- 构建行业垂直领域的专家问答系统,如医疗、法律、工程
- 为AI Agent提供结构化长期记忆,支持复杂推理和任务规划
替代项目
LlamaIndex、Haystack、txtai
上一篇:quivr
下一篇:KnowAgenticRAG
同类项目推荐
Aix-DB
开源
一句话问数据,自动出图出结论
Aix-DB 基于 LangChain/LangGraph 框架,结合 MCP Skills 多智能体协作架构,实现自然语言···
AI-Search
开源
每天自动聚合AI新闻,静态站零成本上线
AI industry news hub that auto-aggregates high quality sources daily — fully static···
php-rag
开源
用 PHP 给 LLM 接上你的文档库,问答更精准
This application uses LLMs like DeepSeek, GPT-5, Claude, Gemini or Llama, Mixtral (l···
Medical-Graph-RAG
开源
让医疗AI回答有据可查,告别凭空捏造
A Graph RAG System for Evidenced-based Medical Information Retrieval [ACL 2025]
fojin
开源
一站式检索万部佛典,AI 问答直达经义
Buddhist Digital Text Platform — 10,500+ texts, 613 sources, trilingual cross-canon···
langextract
开源
从杂乱文本中精准抽取结构化数据,并可视化追溯来源
A Python library for extracting structured information from unstructured text using ···
Ataru
开源
把本地代理历史变成秒级可搜的记忆库
High-performance AI memory retrieval for local agent history — a Rust search core (···
wdoc
开源
把杂乱文档变成可对话的知识库,一键总结和问答
Summarize and query from a lot of heterogeneous documents. Any LLM provider, any fil···
serverless-rag-demo
开源
在AWS上快速搭建RAG问答系统,无需管理服务器。
Amazon Bedrock Foundation models with Amazon Opensearch Serverless as a Vector DB
