
uajy-academic-rag-chatbot
上传手册就能对话问答,学生查规章秒出答案
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-14 · 当前星标 ★ 452
使用教程
环境要求
- Python 3.11 或 3.12
- 一个可用的对话模型 Key
安装与启动步骤
-
1拉仓库
校园问答场景的完整实现,含索引与评测两部分。
git clone https://github.com/BenyRonald77/uajy-academic-rag-chatbot.git -
2装依赖
用独立环境装,避免与系统里的 torch 冲突。
pip install -r requirements.txt -
3先空跑一次索引
加 --dry-run 只检查文档解析与切片,不写向量。
python ingestion/build_index.py --dry-run -
4正式建索引
把校规、培养方案这类 PDF 放进 data 目录再跑。
python ingestion/build_index.py --yes -
5起问答界面
用 streamlit 起,本地端口直接访问。
python -m streamlit run app/main_streamlit.py -
6跑评测对比三种配置
它内置评测脚本,能对比纯向量、混合、加重排三档。
python eval/run_eval.py
如何确认成功
问一个规范类问题时,回答里能指到具体的文件与页码,且换成「混合+重排」配置后引用准确率有可测的提升
注意事项
- 它把检索与生成分开:本地 FAISS 加 BM25 负责召回,模型只负责组织答案,这是减少编造的关键设计。
- PDF 排版差的文档解析会丢表格,先 dry-run 看切片质量再建索引。
- 评测需要标注集,没有标注就只能靠人工抽检。
- 校内规范这类内容有时效性,索引要定期重建。
- 回答仍可能误读条款,对外发布前加免责说明并给原文链接。
核心亮点
- 用 FAISS 做向量检索,本地索引查询快,不依赖外部向量数据库
- 前端 Streamlit 实现,几十行代码即可跑起可交互聊天界面
- 选用 Gemini 2.5 Flash,兼顾生成质量与响应速度,成本可控
不足之处
- 强依赖 Google Gemini API,离线或未配置密钥时无法使用
- 仅针对单一学校手册场景,换文档需重新处理,通用性有限
适用场景
- 高校把学生手册、培养方案做成问答机器人供新生查询
- 企业将内部规章制度、员工手册接入 RAG 对话助手
- 开发者学习 RAG 全流程,作为 Streamlit + FAISS + LLM 的入门模板
替代项目
LangChain、LlamaIndex、Danswer
同类项目推荐
PandaWiki
开源
用 AI 搭建智能知识库,创作、问答、搜索一步到位
PandaWiki 是一款 AI 大模型驱动的开源知识库搭建系统,帮助你快速构建智能化的 产品文档、···
asreview
开源
让 AI 帮你优先读最该读的文献,综述筛选省时数倍
Active learning for systematic reviews
Ataru
开源
把本地代理历史变成秒级可搜的记忆库
High-performance AI memory retrieval for local agent history — a Rust search core (···
AgenticRAG-Survey
开源
一图看懂智能体RAG,快速入门前沿技术
Agentic-RAG explores advanced Retrieval-Augmented Generation systems enhanced with A···
nextjs-openai-doc-search
开源
用自然语言提问,秒级获取带引用的文档答案
Template for building your own custom ChatGPT style doc search powered by Next.js, O···
pgrag
开源
在 Postgres 里跑通 RAG 全流程,但已停更,仅作参考。
Deprecated/unmaintained Postgres extensions to support end-to-end Retrieval-Augmente···
Vinaya-Journal
开源
越写越懂你的本地智能日记,隐私安全可检索
A secure, local RAG journal that understands you better the more you write.
textbook-to-note
开源
把 PDF 教材变成可搜索、带引用的 AI 笔记
Turn your own PDF textbooks into an AI-searchable knowledge base and structured, ful···
MRAG
开源
多角度检索,让大模型回答复杂问题更全面
Official Implementation of "Multi-Head RAG: Solving Multi-Aspect Problems with LLMs"