paperless-ai

给扫描文档自动读内容、打标签、填元数据

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署办公效率 🍴 复刻 332 🐛 待处理 58 👀 关注 38

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 5979

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源免费，需自备API或本地模型

项目预览

paperless-ai 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类办公效率

开发团队clusterzx

官网地址https://clusterzx.github.io/paperless-ai

GitHubhttps://github.com/clusterzx/paperless-ai

定价模式🏷️完全免费

价格说明开源免费，需自备API或本地模型

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型ai,automation,gemma,llama,mistral,ollama,paperless,paperless-ngx,phi

GitHub 星标★ 5979

上线时间2024-12-01 00:00:00

代码更新2026-10-16

仓库体积17.5 MB

本站数据更新2026-10-29

维护状态较活跃

收录时间2026-10-29

浏览次数0

项目介绍

paperless-ai 是面向 Paperless-ngx 文档管理系统的自动化文档分析工具。它通过 OpenAI API、Ollama、DeepSeek-r1、Azure 及所有兼容 OpenAI 接口的模型服务，对已入库的扫描件和 PDF 自动完成内容理解、摘要生成与标签归类，解决人工逐份阅读、手动打标签效率低的问题。核心能力包括：批量拉取 Paperless-ngx 中的待处理文档，调用大模型提取标题、日期、对应人、文档类型等元数据并回写；按预设提示词自动生成标签与分类建议；支持本地模型部署以兼顾隐私；提供 Web 界面查看处理进度与结果，可配置定时任务持续处理新文档。项目以 JavaScript 编写，部署方式以容器为主，适合已使用 Paperless-ngx 的个人或小团队搭建无纸化归档流程。

Star 增长趋势

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

数据来源：GitHub API 逐日快照 · 收录于 2026-10-29 · 当前星标 ★ 5979

技术标签

ai automation gemma llama mistral

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：进阶约 20 分钟部署方式：Docker 7 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

已部署并运行可访问的 Paperless-ngx 实例（提供文档库与 API）
可用的模型服务：OpenAI 兼容接口（OpenAI、DeepSeek-r1、Azure 等）或本地 Ollama
Docker 运行环境（README 仅说明提供 Docker 支持与持久化卷）
Node.js 与 npm（README 给出 npm install 安装依赖）

安装与启动步骤

1准备前置服务

先确认 Paperless-ngx 可正常访问，并准备好 OpenAI 兼容接口或 Ollama 模型服务的地址与密钥。
2获取项目代码

克隆仓库到本地，后续依赖安装与容器配置都在该目录内进行。
```
git clone https://github.com/clusterzx/paperless-ai.git
cd paperless-ai
```
3安装依赖

在项目目录执行 README 给出的依赖安装命令，等待 npm 完成依赖拉取。
```
npm install
```
4以容器方式运行

README 说明项目提供 Docker 支持：配置持久化卷保存数据、设置自动重启与健康监控；具体镜像与端口以官方 Installation Wiki 为准。
5完成首次配置

打开 Web 界面，填写 API 密钥与偏好设置，选择要使用的模型后端并连接 Paperless-ngx。
6重启容器建索引

README 明确：首次安装完成设置后必须重启容器以构建 RAG 索引；后续升级更新不需要重启。
7确认处理结果

在 Web 界面查看文档处理进度，检查标题、标签、文档类型与对应人是否已回写。

关键配置

配置项	必填	说明	示例
`API 密钥`	是	调用所选模型服务所需的密钥，在 Web 界面偏好设置中填写	`sk-xxxxxxxx`
`模型服务地址`	是	OpenAI 兼容接口或本地 Ollama 的访问地址	`http://192.168.1.10:11434`
`Paperless-ngx 连接信息`	是	用于拉取文档并回写元数据的实例地址与访问凭据	`http://192.168.1.10:8000`
`偏好设置`	否	在 Web 界面调整自动处理、标签与分类等行为	`按实际需求填写`