WZ-IT Logo

Paperless-AI Installation: KI-gestützte Dokumentenanalyse für Paperless-NGX

Timo Wevelsiep
Timo Wevelsiep
#PaperlessAI #PaperlessNGX #KI #AI #Docker #DocumentManagement #OpenAI #Ollama

Sie interessieren sich für das vorgestellte Produkt? Sprechen Sie uns an! Bei WZ-IT übernehmen wir Beratung, Installation, Support, Betrieb, Wartung und Monitoring Ihrer Lösung.

Installation Service - Professionelle Installation auf Ihrer Infrastruktur (On-Premise, Cloud oder Hybrid) mit KI-Integration, RAG-Setup und Security Hardening.

Managed Hosting Service - DSGVO-konformes Enterprise Managed Hosting in Deutschland mit 24/7 Monitoring, Support SLA und automatischen Updates.

Vereinbaren Sie hier Ihr kostenloses und unverbindliches Gespräch: Termin vereinbaren.

Paperless-AI ist eine KI-gestützte Erweiterung für Paperless-NGX, die Ihre Dokumentenverwaltung auf ein neues Level hebt. Mit automatischer Dokumentenklassifizierung, intelligenter Tag-Vergabe und semantischer Suche können Sie Ihre Dokumente noch effizienter verwalten. In dieser Anleitung zeigen wir Ihnen, wie Sie Paperless-AI zu Ihrer bestehenden Paperless-NGX Installation hinzufügen.

Voraussetzung: Diese Anleitung setzt voraus, dass Sie bereits Paperless-NGX installiert haben. Falls nicht, folgen Sie zuerst unserer Paperless-NGX Installationsanleitung.

Inhaltsverzeichnis

Funktionsumfang von Paperless-AI

Paperless-AI erweitert Paperless-NGX um beeindruckende KI-Funktionen:

Automatische Dokumentenverarbeitung

  • Erkennt neue Dokumente automatisch
  • Analysiert Inhalte mit KI-Modellen
  • Vergibt automatisch Titel, Tags, Dokumententyp und Korrespondent

RAG-basierter KI-Chat

Paperless-AI Chat Interface

Stellen Sie natürlichsprachliche Fragen zu Ihren Dokumenten:

  • "Wann habe ich meinen Mietvertrag unterschrieben?"
  • "Wie hoch war die letzte Stromrechnung?"
  • "Welche Dokumente erwähnen meine Krankenversicherung?"

Flexible Konfiguration

Paperless-AI Dokumenteneinstellungen
  • Aktivieren Sie nur die gewünschten Funktionen
  • Definieren Sie Regeln für die Dokumentenverarbeitung
  • Unterstützt verschiedene KI-Modelle

Voraussetzungen

  • Ubuntu Server (getestet mit 24.04)
  • Funktionierende Paperless-NGX Installation
  • Docker und Docker Compose

Installation

1. In das Paperless-Verzeichnis wechseln

cd /opt/paperless

2. Paperless-AI klonen und starten

sudo git clone https://github.com/clusterzx/paperless-ai.git
cd paperless-ai
sudo docker-compose up -d

Das war's schon! Paperless-AI läuft nun auf Port 3000.

3. API-Schlüssel aus Paperless-NGX auslesen

Loggen Sie sich in Ihre Paperless-NGX Installation ein und navigieren Sie zu Ihren Profileinstellungen. Dort finden Sie Ihren API-Token, den Sie für die Verbindung mit Paperless-AI benötigen.

HTTPS mit Caddy einrichten

Da Sie bereits Paperless-NGX mit Caddy betreiben, fügen wir Paperless-AI als Subdomain hinzu.

1. DNS-Eintrag erstellen

Erstellen Sie einen A-Record für Ihre Subdomain:

  • Subdomain: paperless-ai
  • Typ: A
  • Ziel: IP-Adresse Ihres Servers

2. Caddy-Konfiguration erweitern

Bearbeiten Sie Ihre bestehende Caddy-Konfiguration:

sudo nano /opt/paperless/caddy/Caddyfile

Fügen Sie folgenden Abschnitt hinzu:

# Paperless-AI Subdomain
paperless-ai.ihre-domain.de {
    reverse_proxy localhost:3000
}

3. Caddy neu laden

sudo systemctl reload caddy

Caddy erstellt automatisch ein SSL-Zertifikat für die neue Subdomain.

Erstkonfiguration

1. Paperless-AI Setup-Assistenten öffnen

Öffnen Sie in Ihrem Browser:

https://paperless-ai.ihre-domain.de

Der Setup-Assistent startet automatisch beim ersten Aufruf.

2. Paperless-NGX Verbindung einrichten

Paperless-AI API Einstellungen

Im Setup-Assistenten:

  • Paperless URL: Geben Sie die HTTPS-URL Ihrer Paperless-NGX Installation ein
    Beispiel: https://paperless.ihre-domain.de
  • Username: Ihr Paperless-NGX Benutzername
  • API Token: Fügen Sie den zuvor kopierten API-Token ein

3. KI-Modell konfigurieren

Wählen Sie Ihr bevorzugtes KI-Modell:

Option 1: OpenAI

  • Model: gpt-4o-mini (kostengünstig und effizient)
  • API Key: Ihren OpenAI API-Schlüssel eingeben

Option 2: Andere unterstützte Anbieter

  • DeepSeek, OpenRouter, Perplexity, Together.ai und viele mehr
  • Lokale Modelle mit Ollama für maximalen Datenschutz

Datenschutz-Tipp: Für sensible Dokumente empfehlen wir die Nutzung lokaler KI-Modelle. Wir bieten auch dedizierte KI-Server an, auf denen Sie Ihre eigenen Modelle betreiben können.

4. Funktionen aktivieren

Paperless-AI Dashboard

Nach erfolgreicher Einrichtung gelangen Sie zum Dashboard. Aktivieren Sie die gewünschten Funktionen:

  • Title Generation: Automatische Titelvergabe basierend auf dem Dokumentinhalt
  • Tag Assignment: Intelligente Tag-Zuweisung
  • Document Type Classification: Automatische Dokumententyp-Erkennung
  • Correspondent Detection: Erkennung von Absendern/Korrespondenten

Container neu starten (wichtig!)

Nach der Erstkonfiguration muss der Container einmal neu gestartet werden, damit der RAG-Index aufgebaut wird:

cd /opt/paperless/paperless-ai
sudo docker-compose restart

Verwendung

Automatische Verarbeitung

Sobald neue Dokumente in Paperless-NGX eingehen, werden diese automatisch von Paperless-AI analysiert und mit Metadaten versehen.

KI-Chat für Dokumente

Paperless-AI Chat
  1. Öffnen Sie ein Dokument in Paperless-NGX
  2. Klicken Sie auf den "AI Chat" Button
  3. Stellen Sie Fragen zum Dokumentinhalt

Manuelle Verarbeitung

Für sensible Dokumente können Sie unter https://paperless-ai.ihre-domain.de/manual Dokumente manuell zur Verarbeitung auswählen.

Tipps für den Betrieb

1. Regeln definieren

Sie können Regeln erstellen, um zu steuern, welche Dokumente verarbeitet werden:

  • Nur bestimmte Tags verarbeiten
  • Dokumente mit sensiblen Informationen ausschließen
  • Automatische Aktionen für bestimmte Dokumenttypen

2. Performance optimieren

  • Verwenden Sie gpt-4o-mini für ein gutes Preis-Leistungs-Verhältnis
  • Bei vielen Dokumenten: Batch-Verarbeitung in den Einstellungen aktivieren
  • Lokale Modelle: Mindestens 8GB RAM für optimale Performance

3. Monitoring

# Logs anzeigen
sudo docker-compose logs -f

# Container-Status prüfen
sudo docker ps

Fehlerbehebung

Verbindung zu Paperless-NGX schlägt fehl

  • Prüfen Sie, ob die URL korrekt ist (mit https://)
  • Stellen Sie sicher, dass der API-Token gültig ist
  • Firewall-Regeln überprüfen

KI-Modell antwortet nicht

  • API-Schlüssel und Guthaben prüfen
  • Logs checken: sudo docker-compose logs -f

Container startet nicht

# Berechtigungen prüfen
sudo chown -R 1000:1000 /opt/paperless/paperless-ai

# Container neu neustarten
sudo docker-compose down
sudo docker-compose up -d

Fazit

Mit Paperless-AI verwandeln Sie Ihre Paperless-NGX Installation in ein intelligentes Dokumentenmanagementsystem. Die KI-gestützte Analyse und Kategorisierung spart Zeit und macht Ihre Dokumente durch semantische Suche noch besser auffindbar.

Sie möchten Paperless-AI professionell in Ihrem Unternehmen einsetzen? Wir unterstützen Sie bei der Installation, Konfiguration und dem Betrieb - inklusive datenschutzkonformer KI-Modelle auf dedizierten Servern.


🚀 Lokale KI-Inferenz mit dem AI Cube

Für maximale Datensouveränität und Performance empfehlen wir unseren AI Cube - eine plug-and-play Lösung für lokale LLM-Inferenz:

Perfekt für Paperless AI & RAG-Setups:

  • Keine Cloud-Abhängigkeit - Ihre Dokumente bleiben zu 100% lokal
  • Vorinstallierte Software - Ollama, vLLM, Open WebUI bereits konfiguriert
  • Enterprise-Grade Hardware - RTX PRO 4000/5000/6000 Blackwell mit bis zu 96 GB VRAM
  • Plug & Play - Einschalten und direkt loslegen
  • Made in Germany - Support, Wartung und Hosting aus einer Hand

Zwei Modelle für jeden Bedarf:

  • AI Cube Basic (RTX PRO 4000 Blackwell, 24 GB VRAM)
  • AI Cube Pro (RTX PRO 6000 Blackwell, 96 GB VRAM)

🔗 Mehr über den AI Cube erfahren


Jetzt Beratungstermin vereinbaren

Lassen Sie uns über Ihre Idee sprechen

Ob konkrete IT-Herausforderung oder einfach eine Idee – wir freuen uns auf den Austausch. In einem kurzen Gespräch prüfen wir gemeinsam, ob und wie Ihr Projekt zu WZ-IT passt.

Vertraut von führenden Unternehmen

  • Keymate
  • SolidProof
  • Rekorder
  • Führerscheinmacher
  • ARGE
  • NextGym
  • Paritel
  • EVADXB
  • Boese VA
  • Maho Management
  • Aphy
  • Negosh
  • Millenium
  • Yonju
  • Mr. Clipart
1/3 – Themenauswahl33%

Worum geht es bei Ihrer Anfrage?

Wählen Sie einen oder mehrere Bereiche, bei denen wir Sie unterstützen dürfen.