https://github.com/admonstrator/paperless-ai-next
Next-generation fork of Paperless-AI for Paperless-ngx, improving AI/OCR reliability with an OCR rescue queue (Mistral), a permanent-failure queue, and ignore filters. Adds history + one-click rescan, restore-original-metadata, and Date/Boolean custom fields support.
https://github.com/admonstrator/paperless-ai-next
documents-manager paperless-ai paperless-ngx
Last synced: 3 months ago
JSON representation
Next-generation fork of Paperless-AI for Paperless-ngx, improving AI/OCR reliability with an OCR rescue queue (Mistral), a permanent-failure queue, and ignore filters. Adds history + one-click rescan, restore-original-metadata, and Date/Boolean custom fields support.
- Host: GitHub
- URL: https://github.com/admonstrator/paperless-ai-next
- Owner: admonstrator
- License: mit
- Created: 2026-02-27T18:08:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-05T00:27:21.000Z (3 months ago)
- Last Synced: 2026-03-05T05:29:56.521Z (3 months ago)
- Topics: documents-manager, paperless-ai, paperless-ngx
- Language: JavaScript
- Homepage: https://paperless-ai-next.admon.me/
- Size: 3.35 MB
- Stars: 22
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📄 Paperless-AI next
**An integration fork of Paperless-AI – picking up where the original left off.**
[](https://github.com/admonstrator/paperless-ai-next/releases/latest)
[](https://hub.docker.com/r/admonstrator/paperless-ai-next)
[](LICENSE)
[](https://github.com/admonstrator/paperless-ai-next/stargazers)
[](https://paperless-ai-next.admon.me/)
---
## 💖 Support the Project
If you find this tool helpful, consider supporting its development:
[](https://github.com/sponsors/admonstrator) [](https://buymeacoffee.com/admon) [](https://ko-fi.com/admon) [](https://paypal.me/aaronviehl)
Also consider supporting the **original author**:
[](https://www.patreon.com/c/clusterzx)
---
## 📖 About
**Paperless-AI next** is an AI-powered extension for [Paperless-ngx](https://github.com/paperless-ngx/paperless-ngx) that brings automatic document classification, smart tagging, and semantic search using OpenAI-compatible APIs and Ollama.
This fork collects pending upstream PRs, applies security patches, and tests improvements. Since the upstream project is no longer actively maintained, it has grown into the most up-to-date version available.
> ℹ️ **Upstream Credit** – All original work belongs to [clusterzx](https://github.com/clusterzx)
📖 **[Full documentation →](https://paperless-ai-next.admon.me/)**
## ⚠️ Please notice
This fork may not be fully compatible with the original Paperless-AI nor with previous Paperless-AI-patched versions.
> ⚠️ **Important:** Upgrading or migrating from the original project can lead to **data loss** (including metadata, history, or local app data) - please create a full backup before any upgrade or migration. A fresh install and document reprocessing may still be required for the best experience.
I use this fork for my own setup, but every deployment is at your own risk. Keep regular Paperless-ngx backups, especially before any upgrade or migration, as data loss can still occur.
I am actively improving the upgrade path and will provide detailed migration instructions in the documentation. 🙏
---
## ✨ Added Features
What makes this fork stand out:
- 🚀 **Performance upgrades**
- Server-side history pagination
- Centralized tag caching with configurable TTL
- Faster dashboard loading with async/lazy stats
- 🛡️ **Security hardening**
- Regular dependency updates with security patches
- Improved input validation and error handling
- Container image optimizations for smaller attack surface
- 🧠 **Smarter OCR + AI fallback flow**
- Mistral OCR queue for weak/failed text extraction
- AI-only re-analysis from stored OCR text (no re-run OCR required)
- OCR output preview/info per document
- 🧰 **Advanced processing controls**
- Include + ignore tags for selective automation
- Better dashboard status visibility (processed / OCR-needed / failed)
- Dedicated permanently-failed queue with manual reset workflow
- 🧪 **Maintenance-focused development**
- Integrated upstream PRs and community patches
- Expanded regression tests for critical workflows
- Active docs/changelog tracking for every integrated fix
See the complete fix list in the documentation:
📚 **[Included Fixes & Changelog →](https://paperless-ai-next.admon.me/changelog/)**
---
## 🚀 Quick Start
### Docker Compose (Recommended)
Please check the docker variables [here](https://paperless-ai-next.admon.me/getting-started/configuration/#docker-environment-variables) for all configuration options.
**Lite version** – AI tagging & OCR only (~500–700 MB):
```yaml
services:
paperless-ai-next:
image: admonstrator/paperless-ai-next:latest-lite
container_name: paperless-ai-next
restart: unless-stopped
ports:
- "3000:3000"
volumes:
- data:/app/data
environment:
- PAPERLESS_API_URL=http://host.docker.internal:8000
- PAPERLESS_API_TOKEN=your_paperless_api_token
volumes:
data:
```
**Full version** – AI tagging + RAG semantic search (~1.5–2 GB):
```yaml
services:
paperless-ai-next:
image: admonstrator/paperless-ai-next:latest-full
container_name: paperless-ai-next
restart: unless-stopped
ports:
- "3000:3000"
volumes:
- data:/app/data
environment:
- PAPERLESS_API_URL=http://host.docker.internal:8000
- PAPERLESS_API_TOKEN=your_paperless_api_token
volumes:
data:
```
Then open [http://localhost:3000](http://localhost:3000) to complete setup.
> ⚠️ **First-time install:** Restart the container **after completing setup** to build the RAG index (Full version only).
### Container Images
| Image Tag | Size | RAG |
|---|---|---|
| `admonstrator/paperless-ai-next:latest-lite` | ~500–700 MB | ❌ |
| `admonstrator/paperless-ai-next:latest-full` | ~1.5–2 GB | ✅ |
**Docker Hub:** [admonstrator/paperless-ai-next](https://hub.docker.com/r/admonstrator/paperless-ai-next)
---
## ℹ️ More
| | |
|---|---|
| 📖 Full documentation | [paperless-ai-next.admon.me](https://paperless-ai-next.admon.me/) |
| 🐛 Report issues | [GitHub Issues](https://github.com/admonstrator/paperless-ai-next/issues) |
| 📜 License | MIT – original work by [clusterzx](https://github.com/clusterzx) |
---
**Made with ❤️ by the community, for the community**
⭐ If you find this useful, please star the repository!
_Last updated: 2026-03-03_