Schnellstart

Schnelle Installationsanleitung für Python: XMP Rating & Keywords

Dieses Skript ermöglicht die KI-gestützte Bewertung von Bildern über eine Web-Oberfläche oder die Kommandozeile und speichert die Ergebnisse als CSV- oder XMP-Sidecar-Dateien.

Voraussetzungen

  • GPU mit 8GB VRAM – Läuft auch auf der CPU, aber deutlich langsamer.
  • Darktable: Version 5.2 oder höher.
  • Lokale KI-API: Eine laufende Instanz von LMStudio (mit Qwen2.5-7B-VL) und aktivierter HTTP-API. Jede OpenAI kompatible API funktioniert (Ollama, llama.cpp)
  • Python 3 und pip (mit pandas flask requests) – Anleitung zur Installation von Python und Paketen

Installation der Python-Abhängigkeiten

Öffne dein Terminal und führe aus:

Fish
pip install pandas flask requests

Dateistruktur

Stelle sicher, dass folgende Dateien im selben Verzeichnis liegen:

  • Ai-Rating.py
  • ai_rating_utils.py
  • prompt.txt (wird bei Bedarf erstellt)
  • system_prompt.txt (wird bei Bedarf erstellt)
  • template.html

Ausführung des Skripts

Web-Modus (mit Benutzeroberfläche)

Starte den Server:

Fish
python Ai-Rating.py # Optionen [--host <host_address>] [--port <port_number>] [--api-url <url>]

Navigiere nach dem Start zu der angezeigten Adresse (standardmäßig http://127.0.0.1:5000).

Funktionsweise

  1. Bildkonvertierung: Originalbilder werden mit darktable-cli in temporäre JPEGs umgewandelt.
  2. KI-Bewertung: JPEGs und Prompts werden an die lokale KI-API gesendet.
  3. Ergebnis-Parsing: KI-Antwort wird nach Bewertungen und Keywords geparst.
  4. Speichern: Ergebnisse werden in CSV-Dateien und/oder XMP-Sidecar-Dateien gespeichert.

Fehlerbehebung

  • darktable-cli nicht gefunden: Überprüfe die Darktable-Installation und den System-PATH.
  • API-Fehler: Stelle sicher, dass die lokale KI-API läuft und erreichbar ist.

Für weitere Details oder Support besuche www.net-fx.de.