Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fukuro-kun/wortweber
Wortweber ist ein sich in der Entwicklung befindendes Open-Source-Projekt, das Echtzeit-Sprachtranskription mit KI-Technologie erforscht. Es dient als Lern- und Experimentierplattform für Spracherkennung in Deutsch und Englisch.
https://github.com/fukuro-kun/wortweber
speech-to-text whisper
Last synced: about 1 month ago
JSON representation
Wortweber ist ein sich in der Entwicklung befindendes Open-Source-Projekt, das Echtzeit-Sprachtranskription mit KI-Technologie erforscht. Es dient als Lern- und Experimentierplattform für Spracherkennung in Deutsch und Englisch.
- Host: GitHub
- URL: https://github.com/fukuro-kun/wortweber
- Owner: fukuro-kun
- License: gpl-3.0
- Created: 2024-09-10T13:17:36.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-15T22:08:33.000Z (about 1 month ago)
- Last Synced: 2024-11-15T22:33:26.620Z (about 1 month ago)
- Topics: speech-to-text, whisper
- Language: Python
- Homepage:
- Size: 743 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wortweber
Wortweber ist ein Projekt zur Echtzeit-Transkription von Sprache in Text, das sich derzeit in der Entwicklungsphase befindet. Es nutzt KI-Technologie für die Spracherkennung in Deutsch und Englisch und ist als Lern- und Experimentierplattform konzipiert.
## Aktueller Entwicklungsstand
Wortweber befindet sich in einer frühen Entwicklungsphase und ist noch nicht für den produktiven Einsatz geeignet. Die aktuelle Version bietet grundlegende Funktionalität, ist aber weder vollständig optimiert noch umfassend getestet. Benutzer sollten mit gelegentlichen Fehlern und Einschränkungen rechnen.
## Geplante Hauptfunktionen
- Echtzeit-Audioaufnahme mit Push-to-Talk-Funktionalität (Standard: F12-Taste, änderbar)
- Transkription in Deutsch und Englisch mit Whisper-Modellen
- Einfache grafische Benutzeroberfläche
- Umwandlung von Zahlwörtern in Ziffern und umgekehrt
- Flexible Eingabemodi: Textfenster oder Systemcursor-Position
- Speichern von Benutzereinstellungen
## Plugin-System
Wortweber verfügt über ein umfangreiches Plugin-System, das es Entwicklern ermöglicht, die Funktionalität der Anwendung zu erweitern. Detaillierte Informationen zur Architektur, Entwicklung und Nutzung von Plugins finden Sie in der [Plugin-System-Dokumentation](docs/PLUGINSYSTEM.md).
## Installation
### Voraussetzungen
- Linux-Betriebssystem
- Conda (Miniconda oder Anaconda)
- Systemabhängigkeiten (werden automatisch installiert)
### Automatische Installation
1. Klonen Sie das Repository:
```bash
git clone [Repository-URL]
cd Wortweber
```
2. Führen Sie das Installationsskript aus:
```bash
./install_and_test.sh
```
Das Skript wird automatisch:
- Eine neue Conda-Umgebung mit Python 3.12 erstellen
- Alle notwendigen System- und Python-Abhängigkeiten installieren
- Ein Startskript (wortweber.sh) erstellen
### Anwendung starten
Nach erfolgreicher Installation können Sie die Anwendung wie folgt starten:
```bash
./wortweber.sh
```
## Projektstruktur
- `src/`: Enthält den Quellcode
- `backend/`: Backend-Logik für Audioaufnahme und Transkription
- `frontend/`: GUI-Komponenten und Benutzerschnittstelle
- `plugin_system/`: Kernkomponenten des Plugin-Systems
- `utils/`: Hilfsfunktionen und -klassen
- `docs/`: Enthält die Projektdokumentation
- `PLUGINSYSTEM.md`: Umfassende Dokumentation des Plugin-Systems
- `CHANGELOG.md`: Änderungsprotokoll des Projekts
- `DEVELOPMENT.md`: Entwicklerdokumentation
- `TODO.md`: Aufgabenliste für zukünftige Entwicklungen
- `tests/`: Enthält Unittests und Integrationstests
- `plugins/`: Verzeichnis für installierte Plugins
- `logs/`: Enthält Logdateien der Anwendung
- `requirements.txt`: Liste der Python-Abhängigkeiten
- `install_and_test.sh`: Installations- und Testskript
- `VERSION`: Aktuelle Versionsnummer des Projekts
- `wortweber.sh`: Startskript für die Anwendung
## Tests
Um alle Tests auszuführen, verwenden Sie den folgenden Befehl im Hauptverzeichnis des Projekts:
```
python run_tests.py
```
Sie können auch spezifische Testoptionen verwenden:
```
- Für grundlegende Tests ohne Transkriptions- oder GUI-Tests: python run_tests.py
- Für parallele Transkriptionstests: python run_tests.py -p oder python run_tests.py --parallel
- Für sequenzielle Transkriptionstests: python run_tests.py -s oder python run_tests.py --sequential
- Für alle Tests einschließlich paralleler und sequenzieller Transkriptionstests sowie GUI-Tests: python run_tests.py -a oder python run_tests.py --all
- Für GUI-Tests: python run_tests.py -g oder python run_tests.py --gui
```
Beachten Sie:
- Die Verfügbarkeit von GPU-Ressourcen wird automatisch überprüft. Bei unzureichendem GPU-Speicher werden parallele Tests deaktiviert.
- Sie können mehrere Optionen kombinieren, z.B. `python run_tests.py -a -p` für alle Tests mit Priorisierung paralleler Ausführung, wo möglich.
Für detaillierte Informationen zu den Testoptionen können Sie folgenden Befehl ausführen:
```
python run_tests.py --help
```
Bitte beachten Sie, dass die Tests in der aktuellen Entwicklungsphase nicht immer stabil laufen und gelegentlich fehlschlagen können.
## Wichtige Hinweise
- Stellen Sie sicher, dass Sie die Wortweber-Umgebung aktiviert haben, bevor Sie die Anwendung starten.
- Die Anwendung wurde für die Verwendung in einer isolierten Conda-Umgebung entwickelt, um Konflikte mit System-Python-Installationen zu vermeiden.
- Diese Software befindet sich in einem experimentellen Stadium und sollte nicht für kritische oder produktive Zwecke eingesetzt werden.
- Die Leistung und Zuverlässigkeit können stark variieren und sind von verschiedenen Faktoren abhängig.
## Problembehebung
### GLIBCXX_3.4.32 Fehler
Wenn Sie einen Fehler bezüglich `GLIBCXX_3.4.32` erhalten, führen Sie folgenden Befehl aus:
```
cp /usr/lib/x86_64-linux-gnu/libstdc++.so.6 $CONDA_PREFIX/lib/
```
Dies kopiert die benötigte C++-Bibliothek in Ihre Conda-Umgebung. Dieser Schritt ist oft notwendig,
da die in Conda enthaltene Version möglicherweise nicht mit den Systemanforderungen übereinstimmt.
### Pyperclip-Fehler
Wenn Sie eine Fehlermeldung erhalten, die besagt, dass Pyperclip keinen Copy/Paste-Mechanismus für Ihr System finden konnte, installieren Sie bitte xclip:
```
sudo apt-get install xclip
```
Dies sollte das Problem mit der Zwischenablagenfunktionalität beheben.
### Weitere Problemlösungen
1. Stellen Sie sicher, dass Sie die neueste Version von Conda verwenden.
2. Überprüfen Sie, ob alle Systemabhängigkeiten korrekt installiert sind.
3. Bei Problemen mit PyAudio, versuchen Sie eine Neuinstallation:
```
pip uninstall pyaudio
pip install --no-binary :all: pyaudio
```
4. Bei Problemen mit der Audiogeräte-Erkennung, passen Sie den DEVICE_INDEX in der `config.py` an.
### Bekannte Probleme
- ALSA-Warnungen können in den meisten Fällen ignoriert werden und sind nicht kritisch für die Funktionalität der Anwendung.
- Bei ALSA-bezogenen Fehlern können Sie versuchen, die ALSA-Bibliotheken zu aktualisieren:
```
sudo apt-get install --reinstall libasound2 libasound2-plugins
```
Wenn Sie weiterhin Probleme haben, überprüfen Sie die Konsolenausgabe auf spezifische Fehlermeldungen und suchen Sie nach diesen online oder eröffnen Sie ein Issue in diesem Repository.
## Systemanforderungen
Diese Anwendung wurde erfolgreich getestet auf:
- Ubuntu 24.04 LTS
- Python 3.11
- Conda 23.11.0
## Projektstatuslage und Beiträge
Wortweber ist ein Open-Source-Projekt, das hauptsächlich zu Demonstrationszwecken und für persönliche Nutzung entwickelt wurde. Um Missverständnisse zu vermeiden, möchte ich die aktuelle Projektstatuslage transparent kommunizieren:
1. **Wartung**: Das Projekt wird passiv gewartet. Updates und Fehlerbehebungen erfolgen unregelmäßig und nach persönlichem Bedarf.
2. **Pull Requests (PRs)**:
- PRs sind willkommen und werden geschätzt.
- Die Überprüfung und Integration von PRs kann erhebliche Zeit in Anspruch nehmen.
- Es besteht keine Garantie, dass alle PRs akzeptiert werden.
- Bitte haben Sie Verständnis, wenn die Bearbeitung länger dauert oder Vorschläge nicht übernommen werden können.
3. **Issues**:
- Fehlerberichte und Verbesserungsvorschläge können eingereicht werden.
- Bitte verstehen Sie, dass ihre Bearbeitung nicht garantiert ist und möglicherweise lange dauern kann.
4. **Support**:
- Aufgrund zeitlicher Beschränkungen kann kein aktiver Support angeboten werden.
- Die Dokumentation in diesem Repository sollte die meisten Fragen beantworten.
5. **Forking und eigene Nutzung**:
- Sie sind herzlich eingeladen, das Projekt zu forken und für Ihre eigenen Bedürfnisse anzupassen.
- Wenn Sie Verbesserungen vornehmen, die Sie teilen möchten, können Sie diese gerne als PR einreichen.
6. **Erwartungsmanagement**:
- Bitte erwarten Sie keine schnellen Antworten oder Umsetzungen von Vorschlägen.
- Das Projekt wird nach bestem Wissen und Gewissen, aber ohne Garantien oder Verpflichtungen gepflegt.
Dieses Projekt ist eine Einladung zum Lernen und Experimentieren. Ich freue mich über Ihr Interesse und danke für Ihr Verständnis bezüglich der begrenzten Ressourcen für die Projektpflege.
## Lizenz
Dieses Projekt ist unter der GNU General Public License v3.0 (GPLv3) lizenziert.
Für weitere Details siehe die [LICENSE](LICENSE)-Datei im Projektverzeichnis oder besuchen Sie
[https://www.gnu.org/licenses/gpl-3.0.en.html](https://www.gnu.org/licenses/gpl-3.0.en.html).