
FlashRAG
一键复现主流RAG算法,快速搭建实验流水线
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3604
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3.10+(源码克隆安装时要求)
- pip 包管理工具
- git(用于克隆仓库)
- conda(可选,用于安装 faiss)
- 可选 GPU 环境(安装 vllm 等加速组件时使用)
安装与启动步骤
-
1pip 快速安装
无需下载源码,直接用 pip 安装 FlashRAG 预发布版本,适合只想调用工具包的用户。
pip install flashrag-dev --pre -
2克隆源码安装
需要改代码或开发时使用;克隆后进入目录以可编辑模式安装,需 Python 3.10+。
git clone https://github.com/RUC-NLPIR/FlashRAG.git cd FlashRAG pip install -e . -
3安装全部额外依赖
README 提供了一键安装 full 依赖的方式,适用于不想逐个挑选组件的场景。
pip install flashrag-dev[full] -
4按需安装可选组件
想加速推理装 vllm,想用向量检索模型装 sentence-transformers,想用 BM25 装 pyserini。
pip install vllm>=0.4.1 pip install sentence-transformers pip install pyserini -
5确认安装结果
上述安装命令执行完毕且无报错即安装成功;faiss 无法用 pip 安装,需按 README 用 conda 命令单独安装。
如何确认成功
安装命令全部执行成功且无报错,环境中已存在 flashrag-dev 包即可开始使用。
常见问题
Q:安装 faiss 时报错怎么办?
A:README 说明 faiss 无法通过 pip 正常安装,必须改用 conda 命令安装,具体命令请查看官方 Installation 章节(节选中被截断)。
Q:对 Python 版本有要求吗?
A:源码克隆安装方式明确要求 Python 3.10+,pip 安装方式 README 未额外说明版本限制。
Q:想提升推理速度怎么办?
A:按 README 安装 vllm(pip install vllm>=0.4.1)即可获得更快的生成速度。
Q:做 BM25 检索需要装什么?
A:需要安装 pyserini,命令为 pip install pyserini。
Q:有没有一次性装齐依赖的办法?
A:可以执行 pip install flashrag-dev[full] 安装全部额外依赖。
注意事项
- README 节选中 faiss 的 conda 安装命令被截断,请到官方仓库 Installation 章节获取完整命令,不要凭猜测执行。
- pip 安装使用的是预发布版本,命令中带 --pre 参数。
- 项目采用 MIT 许可证,可自由用于研究用途。
- 本次节选未包含 Quick Start 的详细使用说明,实际跑实验请参考官方仓库文档。
核心亮点
- 内置36+种RAG算法和12个基准数据集,开箱即用,省去复现成本
- 组件高度模块化,支持自定义检索器、生成器和流水线,灵活性强
- 提供标准化评估脚本,与LlamaIndex等框架对比结果可靠,论文级严谨
不足之处
- 文档和社区生态仍在成长,部分高级功能的教程不够详尽
- 对非Python用户不友好,且依赖较多,环境配置稍复杂
适用场景
- 学术研究中快速复现RAG基线算法并进行对比实验
- 工业界原型验证,快速搭建RAG流水线测试业务效果
- 教学场景,用于RAG技术原理演示和课程实验
替代项目
LlamaIndex、LangChain、RAGFlow
上一篇:knowledge
同类项目推荐
RustXNG
开源
给本地 AI agent 用的自托管搜索后端
Self-hosted metasearch and grounding engine for AI agents, based on SearXNG. Rust, J···
Vane
开源
输入问题,直接获取带引用的精准答案。
Vane is an AI-powered answering engine.
ksor
开源
给 AI 和人都能用的受治理知识底座,让回答有据可查
KSoR (Knowledge System of Record) is an open-source SDK for building governed, autho···
CORTEX-AI-SUPER-RAG
开源
让企业文档秒变带出处的问答助手,权限内精准找答案
CORTEX RAG is an enterprise retrieval and knowledge assistant that helps teams find ···
m_flow
开源
像大脑一样记忆和联想,让 RAG 更聪明
A bio-inspired cognitive memory engine — a new paradigm for Graph RAG.
AI-Catalog
开源
一份清单,逛遍全网 AI 工具,省下搜索时间。
Huge AI models catalog. A curated list of AI tools, platforms, and resources across ···
OptiSearch
开源
在 Google 搜索结果里直接看 AI 答案,省去切换标签页。
OptiSearch | AI answer in Google
Search-o1
开源
让推理模型边想边搜,减少幻觉,答案更靠谱
Search-o1: Agentic Search-Enhanced Large Reasoning Models [EMNLP 2025]
meilisearch
开源
几分钟接入毫秒级搜索,还带 AI 混合检索
A lightning-fast search engine API bringing AI-powered hybrid search to your sites a···