← all repositories
clusterzx/paperless-ai

An AI clerk for Paperless-ngx that may clock out for good

Paperless-AI bridges Paperless-ngx and practically any LLM API to automatically classify, tag, and let you chat with your documents via RAG.

5.8k stars JavaScript Domain AppsRAG · Search
paperless-ai
Not currently ranked — collecting fresh signals.
star history

What it does

Paperless-AI hooks into Paperless-ngx and passes new documents through an LLM—local Ollama models, OpenAI, Gemini, DeepSeek, or any OpenAI-compatible endpoint—to automatically assign titles, tags, types, and correspondents. It also layers a RAG-based chat interface on top of your archive, so you can query documents in plain English instead of digging through folders.

The interesting bit

The project builds a semantic search index over your personal paperwork, turning “What was my last electricity bill?” into a database query rather than a memory exercise. The author admits the repo is currently unmaintained and may not survive a rewrite, partly because Paperless-ngx itself is shipping official AI integration soon.

Key highlights

  • Backend agnostic: supports Ollama (Mistral, Llama, Phi, Gemma), OpenAI, DeepSeek, OpenRouter, Perplexity, Together, LiteLLM, VLLM, FastChat, Gemini, and others.
  • RAG chat interface for natural-language questions across your entire document history.
  • Rule engine to auto-filter which documents get processed and apply tags without human review.
  • Optional /manual web mode for reviewing sensitive documents before tagging.
  • Dockerized deployment with health monitoring and persistent volumes.

Caveats

  • The project is currently unmaintained; the author is unsure whether a promised rewrite will ever ship, especially with upstream Paperless-ngx adding native AI features.

Verdict

A pragmatic stopgap if you want LLM-powered document triage in Paperless-ngx today. Avoid if you need guaranteed long-term support or prefer to wait for first-party integration.

Frequently asked

What is clusterzx/paperless-ai?
Paperless-AI bridges Paperless-ngx and practically any LLM API to automatically classify, tag, and let you chat with your documents via RAG.
Is paperless-ai open source?
Yes — clusterzx/paperless-ai is open source, released under the MIT license.
What language is paperless-ai written in?
clusterzx/paperless-ai is primarily written in JavaScript.
How popular is paperless-ai?
clusterzx/paperless-ai has 5.8k stars on GitHub.
Where can I find paperless-ai?
clusterzx/paperless-ai is on GitHub at https://github.com/clusterzx/paperless-ai.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.