TiffanyBrugger/Misty-Sprach-Coach
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

README.md aktualisiert

Browse source
This commit is contained in:
TiffanyBrugger 2026-07-24 17:55:04 +02:00
parent 20f7f3e274
commit 1e7845c903
1 changed files with 22 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
README.md
View file

@ -26,8 +26,6 @@ Eine ausführliche Beschreibung des Projektes findest du hier: [Projektbeschreib
- Python 3.12 - Python 3.12
- FFmpeg - FFmpeg
## Installation & Setup
### Systempakete installieren ### Systempakete installieren
```bash ```bash
sudo apt install ffmpeg sudo apt install ffmpeg
@ -48,7 +46,10 @@ pip install -r requirements.txt
Die vollständige Paketliste ist in der `requirements.txt` aufgeführt. 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 ### Schritt 1 – Mit Server verbinden
@ -128,25 +129,27 @@ Aufruf: `http://192.168.68.62:5000`
### Features ### Features
- Statusanzeige in Echtzeit (wartend / aufnehmend / analysierend) **🟢 Echtzeit-Überwachung**
- Letzte Session: Füllwörter, Sprechtempo, Transkript, Gesicht, Feedback - Statusanzeige (wartend / aufnehmend / analysierend) – aktualisiert sich automatisch per SSE ohne Seitenrefresh
- Sessionverlauf mit Fortschrittsbalken - Heartbeat: prüft alle 5 Sekunden ob Misty erreichbar ist und zeigt Fehlermeldung wenn nicht
- 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
### 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. **📈 Sessionverlauf**
Änderungen gelten ab der nächsten Session. - 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 **🔄 Automatischer Reset**
["äh", "ähm", "ehm", "mhm", "hm", "halt", "also", "sozusagen", "irgendwie"] - Wird beim Start von `start_coaching.py` automatisch zurückgesetzt
```
### Feedback-Logik ### Feedback-Logik
@ -198,7 +201,7 @@ misty_stream/
- Mistys IP ändert sich bei jedem Neustart → immer in Misty App nachschauen - 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 - 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/` - Livemodus (RTSP-Stream) wurde entwickelt aber als zu instabil eingestuft → liegt in `livemodus_experimentell/`
--- ---