Gesichtserkennung Files

===========================================================================
                      KI MULTI-GESICHTS-VERGLEICH (MANUELL)
===========================================================================

Dieses Programm ermöglicht es, mehrere Gesichter auf einem Ausgangsbild (Bild 1)
manuell per Mausauswahl zu markieren, in einer Galerie zu speichern und 
anschließend einzeln mit einem Zielgesicht auf einem zweiten Bild (Bild 2)
mittels modernster Deep-Learning-Verfahren (DeepFace) zu vergleichen.

Die Anwendung läuft nach der Ersteinrichtung zu 100 % lokal und offline.


---------------------------------------------------------------------------
1. PROJEKTSTRUKTUR
---------------------------------------------------------------------------
Ihr Projektordner sollte die folgenden Dateien enthalten:
- main.py             (Der Controller, steuert den Programmablauf)
- gui_ansicht.py      (Das visuelle Layout der Benutzeroberfläche)
- ki_logik.py         (Die Schnittstelle zur DeepFace-KI)
- helper_functions.py (Mathematische Umrechnungen & Hilfsfunktionen)
- README.txt          (Diese Anleitung)


---------------------------------------------------------------------------
2. SYSTEMANFORDERUNGEN & INSTALLATION
---------------------------------------------------------------------------
Stellen Sie sicher, dass Python (Version 3.8 bis 3.11 empfohlen) installiert ist.
Öffnen Sie Ihr Terminal/Eingabeaufforderung im Projektordner und installieren
Sie die benötigten Bibliotheken mit folgendem Befehl:

pip install opencv-python pillow deepface tf-keras


---------------------------------------------------------------------------
3. STARTEN DES PROGRAMMS
---------------------------------------------------------------------------
Führen Sie im Terminal den Befehl aus:
python main.py


---------------------------------------------------------------------------
4. BEDIENUNGSANLEITUNG
---------------------------------------------------------------------------
1. Klicken Sie auf "Bild 1 wählen" und laden Sie das erste Bild.
2. Ziehen Sie mit gedrückter linker Maustaste rote Rechtecke über alle 
   Gesichter, die Sie speichern möchten. Diese erscheinen unten in der Galerie.
3. Klicken Sie auf "Bild 2 wählen" und laden Sie das Vergleichsbild.
4. Ziehen Sie ein rotes Rechteck über das Zielgesicht auf Bild 2.
5. Klicken Sie in der Galerie auf das gewünschte Gesicht aus Bild 1.
6. Klicken Sie auf den orangenen Button "Ausgewähltes Gesicht vergleichen".
7. Über die Buttons "Auswahl löschen" können Sie die Markierungen pro Bild
   jederzeit zurücksetzen und neu zeichnen.


---------------------------------------------------------------------------
5. PROGRAMMGRÖSSE & SPEICHERBEDARF (WICHTIG)
---------------------------------------------------------------------------
Obwohl Ihr eigener Quellcode (.py-Dateien) nur wenige Kilobyte (KB) groß ist,
benötigt das Gesamtsystem ca. 1,5 GB bis 3 GB Speicherplatz auf Ihrer Festplatte.
Dieser setzt sich wie folgt zusammen:

A) Die Python-Bibliotheken (ca. 1,0 - 1,5 GB)
   - TensorFlow / tf-keras: Das mathematische Schwergewicht im Hintergrund.
   - DeepFace & OpenCV: Bibliotheken für Bildverarbeitung und KI-Pipelines.

B) Die KI-Modelle / Gewichtsdateien (ca. 500 MB - 1,5 GB)
   Beim allerersten Start lädt DeepFace die vortrainierten neuronalen Netze
   automatisch aus dem Internet herunter. Diese Dateien werden im versteckten
   Benutzerordner Ihres PCs abgelegt unter:
   C:\User\<IhrName>\.deepface\weights\

   Größen der typischen DeepFace-Modelle (je nach Nutzung):
   - VGG-Face (Standard): ca. 580 MB
   - Facenet / Facenet512: ca. 110 - 180 MB
   - Age/Emotion-Modelle: ca. 100 MB

C) Arbeitsspeicher (RAM)
   Während der Analyse benötigt das Programm kurzzeitig zwischen 1 GB und 2 GB 
   freien Arbeitsspeicher, da die Bilder und das neuronale Netz in den RAM
   geladen werden müssen.


---------------------------------------------------------------------------
6. DATENSCHUTZ & OFFLINE-BETRIEB
---------------------------------------------------------------------------
Sobald die unter Punkt 5B erwähnten Gewichtsdateien einmalig heruntergeladen
wurden, benötigt das Programm KEINEN Internetzugang mehr. Es werden zu keinem
Zeitpunkt Bilder, Gesichtsdaten oder Ergebnisse an externe Server gesendet. 
Alles bleibt absolut privat auf Ihrem lokalen Rechner.
===========================================================================