paperless-ai

An automated document analyzer for Paperless-ngx using OpenAI API, Ollama, Deepseek-r1, Azure and all OpenAI API compatible Services to automatically analyze an

What is paperless-ai?

An automated document analyzer for Paperless-ngx using OpenAI API, Ollama, Deepseek-r1, Azure and all OpenAI API compatible Services to automatically analyze and tag your documents.

Overview of paperless-ai

What it is

An automated document analyzer for Paperless-ngx that uses OpenAI API, Ollama, Deepseek-r1, Azure and all OpenAI API compatible services to automatically analyze and tag documents. It is not currently maintained; the author is rewriting the codebase and may not continue the project.

Key features

  • Automatically detects new documents in Paperless-ngx and assigns title, tags, document type, and correspondent
  • Supports OpenAI, Ollama, DeepSeek.ai, OpenRouter.ai, Perplexity.ai, Together.ai, LiteLLM, VLLM, Fastchat, Gemini (Google), and other compatible backends
  • RAG-based AI chat for natural language document search and Q&A
  • Web interface for manual AI tagging, accessible via /manual
  • Smart tagging rules to limit which documents are processed and disable prompts

Use cases

Automated document classification and tagging in Paperless-ngx; semantic search across a full document archive; answering natural language questions about documents (e.g., “When did I sign my rental agreement?”); manual review of sensitive documents.

Getting started

First-time install: restart the container after completing setup (API keys, preferences) to build RAG index. For local development, run:bashnpm installnpm run test

License and pricing

MIT License.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/clusterzxpaperless-ai.svg)](https://yunodb.com/tools/clusterzxpaperless-ai?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/clusterzxpaperless-ai?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/clusterzxpaperless-ai.svg" alt="Featured on YunoDB" height="20"></a>