README.md aktualisiert

This commit is contained in:
TiffanyBrugger 2026-07-24 17:55:04 +02:00
parent 20f7f3e274
commit 1e7845c903

View file

@ -26,8 +26,6 @@ Eine ausführliche Beschreibung des Projektes findest du hier: [Projektbeschreib
- Python 3.12
- FFmpeg
## Installation & Setup
### Systempakete installieren
```bash
sudo apt install ffmpeg
@ -48,7 +46,10 @@ pip install -r requirements.txt
Die vollständige Paketliste ist in der `requirements.txt` aufgeführt.
## Starten
## Starten der Anwendung
> ⚠️ **Voraussetzung:** Misty II, der Ubuntu-Server und der Laptop müssen alle im gleichen WLAN sein!
### Schritt 1 Mit Server verbinden
@ -128,25 +129,27 @@ Aufruf: `http://192.168.68.62:5000`
### Features
- Statusanzeige in Echtzeit (wartend / aufnehmend / analysierend)
- Letzte Session: Füllwörter, Sprechtempo, Transkript, Gesicht, Feedback
- Sessionverlauf mit Fortschrittsbalken
- Füllwörter verwalten: hinzufügen und entfernen
- Fehlermeldung wenn Misty nicht erreichbar
- Live-Updates per SSE (Server-Sent Events) kein Seitenrefresh nötig
- Heartbeat: prüft alle 5 Sekunden ob Misty erreichbar ist
- Wird beim Start von start_coaching.py automatisch zurückgesetzt
**🟢 Echtzeit-Überwachung**
- Statusanzeige (wartend / aufnehmend / analysierend) aktualisiert sich automatisch per SSE ohne Seitenrefresh
- Heartbeat: prüft alle 5 Sekunden ob Misty erreichbar ist und zeigt Fehlermeldung wenn nicht
### Füllwörter anpassen
**📊 Ergebnisse der aktuellen Session**
- Anzahl der erkannten Füllwörter mit Vergleich zur vorherigen Session
- Sprechtempo in Wörtern pro Minute mit Gauge-Anzeige (zu langsam / optimal / zu schnell)
- Transkript des gesprochenen Textes
- Mistys Gesichtsausdruck als Reaktion
- Feedback-Text von Misty
Die Füllwortliste kann direkt im Dashboard verwaltet werden.
Änderungen gelten ab der nächsten Session.
**📈 Sessionverlauf**
- Zeigt alle Sessions mit Fortschrittsbalken Verbesserung über mehrere Durchgänge sichtbar
Standardliste:
**⚙️ Füllwörter verwalten**
- Füllwörter direkt im Dashboard hinzufügen und entfernen
- Standardliste: `["äh", "ähm", "ehm", "mhm", "hm", "halt", "also", "sozusagen", "irgendwie"]`
- Änderungen gelten ab der nächsten Session
```json
["äh", "ähm", "ehm", "mhm", "hm", "halt", "also", "sozusagen", "irgendwie"]
```
**🔄 Automatischer Reset**
- Wird beim Start von `start_coaching.py` automatisch zurückgesetzt
### Feedback-Logik
@ -198,7 +201,7 @@ misty_stream/
- Mistys IP ändert sich bei jedem Neustart → immer in Misty App nachschauen
- Whisper base-Modell transkribiert nicht immer perfekt small wäre genauer aber auf dem Server ohne GPU zu langsam
- FP16-Warnung im Terminal ist harmlos (keine GPU vorhanden, wechselt aber automatisch)
- FP16-Warnung im Terminal ist harmlos (keine GPU vorhanden, wechselt aber automatisch auf FP32)
- Livemodus (RTSP-Stream) wurde entwickelt aber als zu instabil eingestuft → liegt in `livemodus_experimentell/`
---