# Paperless-AIssist

Paperless-AIssist is a self-hosted ai app. AI-powered middleware that connects Paperless-ngx to LLM providers (Ollama, OpenAI, Grok, OpenRouter) for automated document classification, OCR post-processing, and structured data extraction via configurable... It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/1808/paperless-aissist

## Description

AI-powered middleware that connects Paperless-ngx to LLM providers (Ollama, OpenAI, Grok, OpenRouter) for automated document classification, OCR post-processing, and structured data extraction via configurable tag-based workflows.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

67/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 13 days ago)
- Popular: 38 (82 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 70 (no serious findings, 14 minor, CI, tests)

## Links

- Official website: https://nyxtron.github.io/paperless-aissist/
- GitHub: https://github.com/nyxtron/paperless-aissist
- Unraid: https://ca.unraid.net/apps/paperless-aissist-19xvcui0sr1ypq?q=Paperless-AIssist

## Common questions

### Can I require sign-in to the Paperless-AIssist web UI?

Yes, optional authentication can protect the web UI with your Paperless-ngx credentials. It is disabled by default.

### Which host port does the Docker example expose?

The quick-start Docker command maps host port 8000 to container port 8080.

### Which data directory should I persist for Paperless-AIssist?

The quick-start Docker command mounts persistent data at /app/data.

### Can I keep metadata generation local and use a paid vision model only for OCR?

Yes, text and vision models are configured separately. You can run metadata generation on a local Ollama model and reserve a paid vision model for documents tagged for OCR.

### What happens if the AI is unsure about metadata classification?

In decision mode, an unsure pick leaves the field unchanged and tags the document for review.

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