Paperless-GPT

Paperless-GPT is an AI companion for Paperless-ngx that automatically generates document titles and tags, saving hours of manual sorting.

  • AI
  • Cloud
  • Other
  • Productivity
  • Tools & Utilities
Paperless-GPT is an AI companion for Paperless-ngx that automatically generates document titles and tags, saving hours of manual sorting. It runs next to your existing Paperless-ngx instance and uses LLMs (large language models) to supercharge OCR text extraction, keeping accuracy high even on tricky scans. For self-hosters who want reliable, automated document organization, it extends Paperless-ngx without replacing it.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

76/100 Good

Maintained
88last commit 36 days ago
Popular
692,801 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 7 days ago

GitHub stars
2,801
Open issues
193
Last commit
2026-10-16
Latest release
v0.31.0
License
MIT
Activity
declining

Checked 20 days ago - source: GitHub (icereed/paperless-gpt)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start Paperless with Docker Compose Run docker compose up -d in your Paperless folder to start the app in the background. This gets you to a usable first run and helps it come back after a reboot. source
  • Keep consume and media folders safe Create the consume and media directories in a place you can back up. Paperless stores your documents and media there, so losing or moving that folder can make documents disappear. source
  • Install required system packages If you are not using Docker, install the system packages before starting Paperless. They provide the document and image tools the app needs, and missing them can break document processing. source
  • Runs alongside Paperless-ngx Paperless-GPT is a companion, not a replacement: it pairs with a running Paperless-ngx instance, so start Paperless-ngx first and point Paperless-GPT at it in the configuration. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can Paperless-GPT work with Ollama instead of only OpenAI?

Yes. The Cloudron forum describes using OpenAI or Ollama to improve Paperless-ngx titles, tags, and OCR.

What OCR problems have people seen with local vision models?

A user reported inconsistent or repetitive output after using local vision models for Paperless-GPT OCR on Paperless-ngx.

Which Paperless folders should I back up to keep my documents?

Back up the consume and media directories. Paperless stores your documents and media there, and losing or moving that folder can make documents disappear.

What must I install before starting Paperless if I do not use Docker?

Install the required system packages before starting Paperless. Missing them can break document processing.

Answers sourced from docs.paperless-ngx.com, docs.paperless-ngx.com, forum.cloudron.io, forum.level1techs.com

Community

Collected 53 days ago - public community threads