{"id":45999150,"url":"https://github.com/admonstrator/paperless-ai-next","last_synced_at":"2026-03-06T03:01:10.711Z","repository":{"id":341082822,"uuid":"1168720226","full_name":"admonstrator/paperless-ai-next","owner":"admonstrator","description":"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.","archived":false,"fork":false,"pushed_at":"2026-03-05T00:27:21.000Z","size":3514,"stargazers_count":22,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-05T05:29:56.521Z","etag":null,"topics":["documents-manager","paperless-ai","paperless-ngx"],"latest_commit_sha":null,"homepage":"https://paperless-ai-next.admon.me/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/admonstrator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-27T18:08:06.000Z","updated_at":"2026-03-04T23:27:25.000Z","dependencies_parsed_at":"2026-03-05T02:02:39.130Z","dependency_job_id":null,"html_url":"https://github.com/admonstrator/paperless-ai-next","commit_stats":null,"previous_names":["admonstrator/paperless-ai-patched","admonstrator/paperless-ai-next"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/admonstrator/paperless-ai-next","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/admonstrator%2Fpaperless-ai-next","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/admonstrator%2Fpaperless-ai-next/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/admonstrator%2Fpaperless-ai-next/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/admonstrator%2Fpaperless-ai-next/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/admonstrator","download_url":"https://codeload.github.com/admonstrator/paperless-ai-next/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/admonstrator%2Fpaperless-ai-next/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30160022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T22:39:40.138Z","status":"online","status_checked_at":"2026-03-06T02:00:08.268Z","response_time":250,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["documents-manager","paperless-ai","paperless-ngx"],"created_at":"2026-02-28T22:03:11.606Z","updated_at":"2026-03-06T03:01:10.681Z","avatar_url":"https://github.com/admonstrator.png","language":"JavaScript","funding_links":["https://github.com/sponsors/admonstrator","https://buymeacoffee.com/admon","https://ko-fi.com/admon","https://paypal.me/aaronviehl","https://www.patreon.com/c/clusterzx"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./logo.png\" alt=\"Paperless-AI next logo with the text Paperless-AI next, shown as a clean modern project mark at the top of the page, conveying a welcoming and professional tone\" weight=\"200\" style=\"border-radius: 10px; margin: 20px 0;\"\u003e\n\n# 📄 Paperless-AI next\n\n**An integration fork of Paperless-AI – picking up where the original left off.**\n\n[![Latest Release](https://img.shields.io/github/v/release/admonstrator/paperless-ai-next?style=for-the-badge\u0026logo=github\u0026color=blue)](https://github.com/admonstrator/paperless-ai-next/releases/latest)\n[![Docker Pulls](https://img.shields.io/badge/docker%20pulls-1.0k-brightgreen?style=for-the-badge\u0026logo=docker)](https://hub.docker.com/r/admonstrator/paperless-ai-next)\n[![License](https://img.shields.io/github/license/admonstrator/paperless-ai-next?style=for-the-badge)](LICENSE)\n[![Stars](https://img.shields.io/github/stars/admonstrator/paperless-ai-next?style=for-the-badge)](https://github.com/admonstrator/paperless-ai-next/stargazers)\n[![Docs](https://img.shields.io/badge/docs-paperless--ai--next.admon.me-blue?style=for-the-badge\u0026logo=readthedocs)](https://paperless-ai-next.admon.me/)\n\n---\n\n## 💖 Support the Project\n\nIf you find this tool helpful, consider supporting its development:\n\n[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsors-EA4AAA?style=for-the-badge\u0026logo=github)](https://github.com/sponsors/admonstrator) [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://buymeacoffee.com/admon) [![Ko-fi](https://img.shields.io/badge/Ko--fi-FF5E5B?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/admon) [![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://paypal.me/aaronviehl)\n\nAlso consider supporting the **original author**: \n\n[![Patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge\u0026logo=patreon\u0026logoColor=white)](https://www.patreon.com/c/clusterzx)\n\u003c/div\u003e\n\n---\n\n## 📖 About\n\n**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.\n\nThis 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.\n\n\u003e ℹ️ **Upstream Credit** – All original work belongs to [clusterzx](https://github.com/clusterzx)  \n\n📖 **[Full documentation →](https://paperless-ai-next.admon.me/)**\n\n## ⚠️ Please notice\n\nThis fork may not be fully compatible with the original Paperless-AI nor with previous Paperless-AI-patched versions.\n\n\u003e ⚠️ **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.\n\nI 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.\n\nI am actively improving the upgrade path and will provide detailed migration instructions in the documentation. 🙏\n\n---\n\n## ✨ Added Features\n\nWhat makes this fork stand out:\n\n- 🚀 **Performance upgrades**\n  - Server-side history pagination\n  - Centralized tag caching with configurable TTL\n  - Faster dashboard loading with async/lazy stats\n\n- 🛡️ **Security hardening**\n  - Regular dependency updates with security patches\n  - Improved input validation and error handling\n  - Container image optimizations for smaller attack surface\n\n- 🧠 **Smarter OCR + AI fallback flow**\n  - Mistral OCR queue for weak/failed text extraction\n  - AI-only re-analysis from stored OCR text (no re-run OCR required)\n  - OCR output preview/info per document\n\n- 🧰 **Advanced processing controls**\n  - Include + ignore tags for selective automation\n  - Better dashboard status visibility (processed / OCR-needed / failed)\n  - Dedicated permanently-failed queue with manual reset workflow\n\n- 🧪 **Maintenance-focused development**\n  - Integrated upstream PRs and community patches\n  - Expanded regression tests for critical workflows\n  - Active docs/changelog tracking for every integrated fix\n\nSee the complete fix list in the documentation:  \n📚 **[Included Fixes \u0026 Changelog →](https://paperless-ai-next.admon.me/changelog/)**\n\n---\n\n## 🚀 Quick Start\n\n### Docker Compose (Recommended)\n\nPlease check the docker variables [here](https://paperless-ai-next.admon.me/getting-started/configuration/#docker-environment-variables) for all configuration options.\n\n**Lite version** – AI tagging \u0026 OCR only (~500–700 MB):\n\n```yaml\nservices:\n  paperless-ai-next:\n    image: admonstrator/paperless-ai-next:latest-lite\n    container_name: paperless-ai-next\n    restart: unless-stopped\n    ports:\n      - \"3000:3000\"\n    volumes:\n      - data:/app/data\n    environment:\n      - PAPERLESS_API_URL=http://host.docker.internal:8000\n      - PAPERLESS_API_TOKEN=your_paperless_api_token\n\nvolumes:\n  data:\n```\n\n**Full version** – AI tagging + RAG semantic search (~1.5–2 GB):\n\n```yaml\nservices:\n  paperless-ai-next:\n    image: admonstrator/paperless-ai-next:latest-full\n    container_name: paperless-ai-next\n    restart: unless-stopped\n    ports:\n      - \"3000:3000\"\n    volumes:\n      - data:/app/data\n    environment:\n      - PAPERLESS_API_URL=http://host.docker.internal:8000\n      - PAPERLESS_API_TOKEN=your_paperless_api_token\n\nvolumes:\n  data:\n```\n\nThen open [http://localhost:3000](http://localhost:3000) to complete setup.\n\n\u003e ⚠️ **First-time install:** Restart the container **after completing setup** to build the RAG index (Full version only).\n\n### Container Images\n\n| Image Tag | Size | RAG |\n|---|---|---|\n| `admonstrator/paperless-ai-next:latest-lite` | ~500–700 MB | ❌ |\n| `admonstrator/paperless-ai-next:latest-full` | ~1.5–2 GB | ✅ |\n\n**Docker Hub:** [admonstrator/paperless-ai-next](https://hub.docker.com/r/admonstrator/paperless-ai-next)\n\n---\n\n## ℹ️ More\n\n| | |\n|---|---|\n| 📖 Full documentation | [paperless-ai-next.admon.me](https://paperless-ai-next.admon.me/) |\n| 🐛 Report issues | [GitHub Issues](https://github.com/admonstrator/paperless-ai-next/issues) |\n| 📜 License | MIT – original work by [clusterzx](https://github.com/clusterzx) |\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the community, for the community**\n\n⭐ If you find this useful, please star the repository!\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n_Last updated: 2026-03-03_\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadmonstrator%2Fpaperless-ai-next","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadmonstrator%2Fpaperless-ai-next","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadmonstrator%2Fpaperless-ai-next/lists"}