# Paperless-AI

Paperless-AI is a self-hosted ai app. An automated document analyzer for Paperless-ngx using OpenAI API and Ollama (Mistral, llama, phi 3, gemma 2) to automatically analyze and tag your documents. It is open source and self-hosted, installable on Docker Hub, Proxmox, TrueNAS and Unraid.

Canonical page: https://ourlocalhost.com/app/596/paperless-ai

## Description

An automated document analyzer for Paperless-ngx using OpenAI API and Ollama (Mistral, llama, phi 3, gemma 2) to automatically analyze and tag your documents.

## Platform availability

Available on 3 of 9 platforms: Unraid, TrueNAS, Proxmox.

## Health score

67/100 (Good), based on 5 of 5 factors.
- Maintained: 52 (last commit 205 days ago)
- Popular: 76 (5,970 GitHub stars)
- Easy to install: 70 (3 install platforms, install notes, setup guide, Docker image)
- Light to run: 95 (512 MB minimum RAM, runs on ARM)
- Security check: 60 (no serious findings, 17 minor, CI)

## Links

- Official website: https://clusterzx.github.io/paperless-ai/
- GitHub: https://github.com/clusterzx/paperless-ai
- Docker Hub: https://hub.docker.com/r/clusterzx/paperless-ai
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=paperless-ai
- TrueNAS: https://apps.truenas.com/catalog/paperless-ai/
- Unraid: https://ca.unraid.net/apps/paperless-ai-19a1cu41avkx2w?q=Paperless-AI

## Common questions

### How do I start Paperless-AI in Docker so it keeps running after reboots?

From the folder with your docker-compose file, run `docker compose up -d` to start Paperless-AI in the background. This is the normal way to get it running and keep it available after reboots.

### What folders should I create before first start?

Create the consume and media folders before first start because they are where incoming documents and stored files live. Without them, Paperless-AI may fail to process files.

### Do I need to run a separate consumer service if I am not using the bundled Docker setup?

Yes, run `python3 manage.py document_consumer` from the source folder so it watches for new files. Otherwise, documents in the consume folder won't be imported automatically.

### Can Paperless-AI run chats against large document collections?

Yes, a Reddit discussion describes creating Paperless-AI document collections and running multiple chats against them. It uses background processing for large document sets.

## Alternatives

- ChatPDF
- Private GPT: Ask questions to your documents without an internet connection, using the power of LLMs.
- UPDF

---
Source: Our Local Host (https://ourlocalhost.com/app/596/paperless-ai), the self-hosted and open-source app directory.