uajy-academic-rag-chatbot

上传手册就能对话问答,学生查规章秒出答案

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 2 🐛 待处理 1
GitHub ↗
GitHub 星标 ★ 452
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源项目,需自备Gemini API密钥,定价信息待确认

项目预览

uajy-academic-rag-chatbot 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队BenyRonald77
定价模式🏷️完全免费
价格说明开源项目,需自备Gemini API密钥,定价信息待确认
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
GitHub 星标★ 452
上线时间2026-08-31 00:00:00
代码更新2026-09-17
仓库体积68.4 MB
本站数据更新2026-11-04
维护状态维护中
收录时间2026-09-14
浏览次数2

项目介绍

这是一个面向印尼阿特玛贾亚大学学术手册场景的生产级 RAG 聊天机器人。它把厚重的学术规章文档转成可对话的问答助手,解决学生和教职工查学籍、课程、毕业要求时逐页翻 PDF 效率低的问题。核心流程是文档切分后向量化,用 FAISS 做相似度检索,再把命中的上下文交给 Google Gemini 2.5 Flash 生成回答,前端用 Streamlit 搭建,部署和交互门槛都很低。项目强调生产可用,包含检索增强、上下文拼接和流式对话等工程细节,适合作为高校或企业知识库问答的参考实现。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-14 · 当前星标 ★ 452

使用教程

难度:进阶 约 40 分钟 部署方式:本地安装 6 步

环境要求

  • Python 3.11 或 3.12
  • 一个可用的对话模型 Key

安装与启动步骤

  1. 1拉仓库

    校园问答场景的完整实现,含索引与评测两部分。

    git clone https://github.com/BenyRonald77/uajy-academic-rag-chatbot.git
  2. 2装依赖

    用独立环境装,避免与系统里的 torch 冲突。

    pip install -r requirements.txt
  3. 3先空跑一次索引

    加 --dry-run 只检查文档解析与切片,不写向量。

    python ingestion/build_index.py --dry-run
  4. 4正式建索引

    把校规、培养方案这类 PDF 放进 data 目录再跑。

    python ingestion/build_index.py --yes
  5. 5起问答界面

    用 streamlit 起,本地端口直接访问。

    python -m streamlit run app/main_streamlit.py
  6. 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

上一篇:awesome-llm

下一篇:Awesome-Auto-Research-Tools

同类项目推荐

PandaWiki 开源

用 AI 搭建智能知识库,创作、问答、搜索一步到位

PandaWiki 是一款 AI 大模型驱动的开源知识库搭建系统,帮助你快速构建智能化的 产品文档、···

★ 10457 2026-08-09
asreview 开源

让 AI 帮你优先读最该读的文献,综述筛选省时数倍

Active learning for systematic reviews

★ 1063 2026-09-16
Ataru 开源

把本地代理历史变成秒级可搜的记忆库

High-performance AI memory retrieval for local agent history — a Rust search core (···

★ 361 2026-09-12
AgenticRAG-Survey 开源

一图看懂智能体RAG,快速入门前沿技术

Agentic-RAG explores advanced Retrieval-Augmented Generation systems enhanced with A···

★ 1744 2026-08-09
nextjs-openai-doc-search 开源

用自然语言提问,秒级获取带引用的文档答案

Template for building your own custom ChatGPT style doc search powered by Next.js, O···

★ 1725 2026-08-09
pgrag 开源

在 Postgres 里跑通 RAG 全流程,但已停更,仅作参考。

Deprecated/unmaintained Postgres extensions to support end-to-end Retrieval-Augmente···

★ 101 2026-08-09
Vinaya-Journal 开源

越写越懂你的本地智能日记,隐私安全可检索

A secure, local RAG journal that understands you better the more you write.

★ 172 2026-08-09
textbook-to-note 开源

把 PDF 教材变成可搜索、带引用的 AI 笔记

Turn your own PDF textbooks into an AI-searchable knowledge base and structured, ful···

★ 110 2026-09-12
MRAG 开源

多角度检索,让大模型回答复杂问题更全面

Official Implementation of "Multi-Head RAG: Solving Multi-Aspect Problems with LLMs"

★ 242 2026-08-09