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

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

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

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

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

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

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

Öffnen Sie ein Dokument in Paperless-NGX
Klicken Sie auf den "AI Chat" Button
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 in Ihrem Unternehmen einsetzen? Wir unterstützen Sie bei der Installation, Konfiguration und dem Betrieb - inklusive datenschutzkonformer KI-Modelle auf dedizierten Servern.

Jetzt Beratungstermin vereinbaren