Paperless-GPT
Paperless-GPT is an AI companion for Paperless-ngx that automatically generates document titles and tags, saving hours of manual sorting.
Platform availability
Available on 2 of 10 platforms
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
Variants
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
- Chat with Paperless-ngx documents using AI : r/selfhosted - Reddit (reddit)
- paperless-gpt on Cloudron - AI-powered Document Tagging for Paperless ... (forum)
- [Support] Paperless GPT - Docker Containers - Unraid (forum)
- Need help with ai ocr for paperless-ngx - forum.level1techs.com (forum)
Collected 53 days ago - public community threads