Zurück zu den Projekten

AI Document Sorter

KI-Dokumentensortierer

Ein serverbasierter Automatisierungsdienst, der gescannte PDF-Dokumente aus einem OneDrive-Scanordner automatisch erkennt, mit Gemini AI analysiert, passend umbenennt, in die richtige Ordnerstruktur einsortiert und anschließend eine Telegram-Benachrichtigung sendet.

PythonGoogle Gemini APIOneDrivercloneUbuntu ServersystemdTelegram Bot APIPDF ProcessingAutomation

So funktioniert es

Der automatisierte Ablauf in fünf Schritten:

Schritt 1ScanDrucker scannt das Dokument
Schritt 2OneDrive UploadPDF erscheint im OneDrive-Scanordner
Schritt 3AI AnalyseGemini AI analysiert das Dokument
Schritt 4Rename & SortDatei wird umbenannt und einsortiert
Schritt 5Telegram NotificationTelegram-Benachrichtigung wird gesendet

Problem

Gescannte Dokumente landen oft unsortiert in einem Scanordner. Das manuelle Umbenennen, Zuordnen und Verschieben kostet Zeit und ist fehleranfällig.

Lösung

Ich habe einen Python-basierten Dienst entwickelt, der dauerhaft auf einem Ubuntu-Server läuft. Sobald ein neues PDF im Scanordner erscheint, wird es erkannt, analysiert, klassifiziert und automatisch in den richtigen Zielordner verschoben. Danach wird eine Telegram-Nachricht mit Dateiname, Person, Kategorie und Confidence-Wert gesendet.

Funktionen

  • Überwachung eines OneDrive-Scanordners
  • Automatische PDF-Erkennung
  • KI-Analyse mit Gemini
  • Extraktion von Person, Datum, Kategorie und Dokumenttitel
  • Automatische Dateiumbenennung
  • Sortierung in personenspezifische Ordner
  • Telegram-Benachrichtigung nach erfolgreicher Verarbeitung
  • Systemd-Service für dauerhaften 24/7-Betrieb
  • Logging über journalctl
  • Mehrere Analyseversuche bei Fehlern

Screenshots

Hinweis: Private Daten in den Screenshots sind aus Datenschutzgründen unkenntlich gemacht.

Server-Log: Verarbeitung eines neuen Dokuments (journalctl)
Telegram-Benachrichtigung nach erfolgreicher Verarbeitung
Automatisch umbenannte und einsortierte Datei

Was ich gelernt habe

API-IntegrationServerdienste unter LinuxFehlerbehandlung und Retry-LogikAutomatisierung von DokumentenworkflowsStrukturierte DateiorganisationTelegram-Bot-IntegrationArbeiten mit systemd und Logs