icereed/paperless-gpt

这是什么？

核心功能

• 01利用大语言模型根据文档内容生成标题、标签、发件人和创建日期。
• 02通过视觉大模型、Azure Document Intelligence、Google Document AI 或 Docling 从扫描件提取文字。
• 03支持 OpenAI、Mistral、Anthropic 以及本地 Ollama 模型。
• 04可按追加、更新或替换三种模式填充自定义字段。
• 05可在 Web 界面中编辑提示词，并为不同类型的文档设置工作流。

适用场景

• 在 paperless-ngx 中整理大量扫描文件，减少手动打标签的工作。
• 处理质量较差、传统 OCR 效果不佳的扫描件。
• 关联引用同一发票号、合同号或案件编号的发票、催款单和合同。
• 使用本地 Ollama 模型运行处理流程，让数据保留在自有设备上。

快速上手

1. 1

   安装 Docker

2. 2

   准备运行中的 paperless-ngx 实例以及 LLM 服务（OpenAI API 密钥或 Ollama 服务器）

3. 3

   参照 README 示例，在 paperless-ngx 旁创建 docker-compose.yml

4. 4

   使用 Docker Compose 启动服务

使用前须知

• !paperless-gpt 没有内置身份验证，必须放在反向代理之后或限制在受信任的网络中。
• !它需要 LLM 服务，例如 OpenAI API 密钥或正在运行的 Ollama 服务器。

收录于专题

标签

常见问题

paperless-gpt 是什么？

借助大语言模型和视觉 OCR，为 paperless-ngx 中的文档自动生成标题、标签和发件人等信息。 paperless-gpt 是 paperless-ngx（一款自托管文档管理系统）的配套服务。它将文档内容交给 OpenAI、Mistral、Anthropic 或本地 Ollama 等大语言模型处理，再把建议的标题、标签、发件人、日期和自定义字段写回 paperless-ngx。用户可以在 Web 界面中审核这些建议，也可以通过触发标签让文档自动处理。

paperless-gpt 可以免费使用吗？用的什么许可证？

paperless-gpt 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

paperless-gpt 还在维护吗？

活跃维护中。paperless-gpt 最近一次提交是在 2026年11月6日。

paperless-gpt 适合用来做什么？

在 paperless-ngx 中整理大量扫描文件，减少手动打标签的工作。 处理质量较差、传统 OCR 效果不佳的扫描件。 关联引用同一发票号、合同号或案件编号的发票、催款单和合同。 使用本地 Ollama 模型运行处理流程，让数据保留在自有设备上。

paperless-gpt 怎么安装和运行？

安装 Docker 准备运行中的 paperless-ngx 实例以及 LLM 服务（OpenAI API 密钥或 Ollama 服务器） 参照 README 示例，在 paperless-ngx 旁创建 docker-compose.yml 使用 Docker Compose 启动服务

在哪里获取 paperless-gpt？

源代码和安装说明在 GitHub 上：https://github.com/icereed/paperless-gpt