ai-pdf-chatbot-langchain
合同报告丢进去，想问哪页问哪页，秒出答案
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 16585
使用教程
环境要求
- Node.js 与 Yarn（README 全程使用 yarn 安装依赖和启动服务）
- OpenAI API Key（用于 LLM 问答）
- Supabase 项目（用于存储 PDF 向量嵌入）
- 本地端口 2024 与 3000 可用
安装与启动步骤
-
1克隆仓库
把项目克隆到本地并进入 monorepo 根目录，后续所有安装命令都在根目录执行。
git clone https://github.com/mayooear/ai-pdf-chatbot-langchain.git cd ai-pdf-chatbot-langchain -
2安装依赖
在 monorepo 根目录一次性安装前后端依赖，README 说明根目录装完即可，无需重复安装。
yarn install -
3配置环境变量
在 backend 和 frontend 下分别按各自的 .env.example 创建环境变量文件，填写 OpenAI、Supabase 等密钥。README 未给出具体变量清单，请以 .env.example 为准。
-
4启动后端服务
进入 backend 目录以开发模式启动 LangGraph，默认监听 2024 端口，并会跳转到 LangGraph Studio UI。
cd backend yarn langgraph:dev -
5启动前端服务
另开一个终端进入 frontend 目录启动 Next.js 开发服务器，默认监听 3000 端口。
cd frontend yarn dev -
6上传 PDF 并提问
浏览器打开 http://localhost:3000，用页面底部的上传按钮上传一个小体积 PDF，等摄取完成后再在输入框提问。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
NEXT_PUBLIC_LANGGRAPH_API_URL | 是 | 前端访问后端 LangGraph 服务的地址，部署时必须指向已部署的后端 URL | http://localhost:2024 |
如何确认成功
浏览器打开 http://localhost:3000 能看到聊天界面，后端 LangGraph 默认运行在 2024 端口并可打开其 Studio UI。
常见问题
Q：后端和前端分别在哪个端口？
A：README 说明 LangGraph 开发服务器默认端口为 2024，Next.js 开发服务器默认端口为 3000，浏览器访问 http://localhost:3000 使用聊天界面。
Q：上传 PDF 后没有正常回答怎么办？
A：先用 LangGraph Studio UI 确认工作流运行正常，再通过页面底部按钮上传体积较小的 PDF；摄取完成后才会把文本与嵌入写入 Supabase 供检索使用。
Q：怎么部署到线上？
A：后端可部署到 LangGraph Cloud 或按官方自托管指南部署，前端可部署到 Vercel、Netlify 等支持 Next.js 的平台，并确保 NEXT_PUBLIC_LANGGRAPH_API_URL 指向部署后的后端地址。
Q：项目还在维护吗？
A：README 明确说明项目已不再积极维护，仅作为参考保留，不保证回应新的 issue 或 PR。
注意事项
- 项目已停止积极维护，仅供学习 RAG 与文档对话应用参考。
- 必须同时运行后端 LangGraph 与前端 Next.js 两个服务才能完整使用。
- 环境变量需在 backend 和 frontend 两处分别配置，具体变量名以各自的 .env.example 为准。
- 前端部署后记得把 NEXT_PUBLIC_LANGGRAPH_API_URL 改为线上后端地址。
核心亮点
- 基于 LangChain 和 LangGraph 构建，支持复杂的 agent 工作流和状态管理，而非简单的检索问答
- 使用 Next.js 全栈框架，前后端一体化，部署体验好，便于快速搭建生产级应用
- 支持 PDF 文档解析与对话，结合向量检索和 LLM 生成，提供引用来源，回答可追溯
不足之处
- 深度依赖 OpenAI 和 LangChain 生态，若更换模型或框架需较大改动
- PDF 解析质量受限于底层库，复杂排版（如表格、扫描件）可能效果不佳
- 文档/社区待观察
适用场景
- 企业内部文档智能问答，如员工手册、规章制度查询
- 学术论文阅读辅助，快速定位关键信息并生成摘要
- 法律或金融领域合同审阅，通过对话提取条款要点
替代项目
quivr、gpt4-pdf-chatbot-langchain、pdfGPT
上一篇：eliza
同类项目推荐
auto
开源
把 LLM 的重复活儿编译成微成本 wasm，一次搞定不再重跑
the agi compiler: records llm agent behavior, proves what repeats, and compiles it i···
Polaris
开源
让 AI 代理帮你自动做科研，加速发现新知识
Toward Autonomous Scientific Discovery
ResearcherSkill
开源
让 AI 代理在你睡觉时自动跑实验，优化代码
Asks what to optimise and how to measure it, then runs experiments on its own branch···
zhtw-mcp
开源
给 AI 装上繁体中文语法纠错，输出更道地台湾腔
A linguistic linter for Traditional Chinese (zh-TW)
Jumping-Agent-platform
开源
像玩游戏一样，轻松搭建你的 AI 智能体。
Build your own AI agent through gameplay.
agentcraft
开源
用 Java 快速搭建可落地的 AI 智能体
Manage your real AI agents, using Minecraft as your interface!
mem0
开源
给 AI 装上记性，聊过的事下次还记得
The Memory Layer for AI Agents - Drop-in memory infrastructure for AI agents and app···
openfang
开源
像操作系统一样管理你的 AI 智能体，让多智能体协作更稳更高效。
Open-source Agent Operating System
awesome-deepseek-harness
开源
一站式发现 DeepSeek 智能体插件与工具，省去大海捞针。
DeepSeek Harness (DSH) ecosystem: curated plugins, tools, and infrastructure from ds···