clusterzx /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.

★ 6,031⑂ 333👁 37⑃ 192● 534▤ 59
TypeScriptMITCreated 2024-12-01clusterzx.github.io/paperless-ai/
下载:Paperless-AI 4.0 – a complete rewritePaperless-AI-4.0.0 ↓4.0.02026-11-10
+8
日增长
6,031
stars
333
forks
37
watchers
192
prs
534
issues
59
releases

README

📄 Paperless-AI






Paperless-AI is an AI extension for Paperless-ngx. It analyzes your documents and fills in title, tags, correspondent, document type, date and custom fields – and lets you ask questions about your whole archive in natural language, with answers that cite their sources.

Works with Paperless-ngx 2.x and 3.x, OpenAI, Anthropic (Claude), Ollama (fully local), Azure OpenAI and every OpenAI-compatible API (DeepSeek, OpenRouter, LiteLLM, vLLM, LM Studio, Gemini, Together, Perplexity, …).

 [!IMPORTANT]
 Security notice for 3.x: in all Paperless-AI versions before 4.0, the setup wizard can be used without logging in. Anyone who can reach such an instance can replace its user account and its configuration (Paperless token, AI provider), and this is being exploited. Update to 4.0 – it is not affected. If your 3.x instance was reachable from the internet, read Upgrading from 3.x before you migrate.

 💡 Just ask:
 “When did I sign my rental agreement?”
 “What was the amount of the last electricity bill?”
 “Which documents mention my health insurance?”

!Dashboard

---

 ✨ What's new in 4.0 – a complete rewrite

Version 4 is rebuilt from scratch with a focus on reliability, speed and low resource usage.

| | 3.x | 4.0 |
| --- | --- | --- |
| Architecture | Node.js + separate Python service (Torch, ChromaDB, NLTK) | One Node.js process (TypeScript) |
| Docker image | several GB | ~135 MB compressed |
| RAM in idle | 1–2 GB | ≈ 80–150 MB (embedding model loaded on demand) |
| RAG retrieval | one embedding of the first ~100 words per document | chunked passages, hybrid BM25 + vector search, metadata boosts |
| RAG answers | not streamed, no references | streamed, cited sources [1], follow-up questions |
| Index updates | full re-crawl & re-embed | incremental (changed/deleted documents only) |
| Settings | written to .env, container restart required | validated, applied instantly – no restart |
| Paperless-ngx | 2.x | 2.x and 3.x (API version negotiated automatically, verified against 2.14, 2.20 and 3.2) |
| Undo | only “forget processing state” | real undo – restores the original values in Paperless |
| Interface | server-rendered pages | new design: single-page app, command menu, light/dark + accent colours |

Upgrading from 3.x is automatic: your data/.env, user account, processing state, history and token statistics are migrated on first start (the old files are kept untouched) – see Upgrading from 3.x.

 🚀 Features

Automatic processing
- Detects new documents (schedule and/or instantly via a Paperless workflow webhook)
- Title, tags, correspondent, document type, document date and custom fields (text, long text, number, monetary, date, boolean, URL, select)
- AI providers: OpenAI, Anthropic (Claude), Ollama, any OpenAI-compatible API (DeepSeek, OpenRouter, LiteLLM, vLLM, LM Studio, Gemini …) and Azure OpenAI – reasoning/thinking models included
- Structured JSON output (JSON schema) with automatic fallback for providers without suppor

Discussions

Latest release

Paperless-AI 4.0 – a complete rewrite v4.0.0 2026-11-10
One Node.js process instead of Node.js + Python, a much smaller image (~135 MB instead of several GB), a new web interface and much better search in your archive.

 ⚠️ Security notice for 3.x
In all versions before 4.0, the setup wizard can be used without logging in, which allows anyone who can reach an instance to replace its account and configuration. This is being exploited. Please update. If your 3.x instance was reachable from the internet, read Upgrading from 3.x before you migrate.

 Highlights
- Title, tags, correspondent, document type, date and custom fields (incl. long text a

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON