Communitygithub.com

badlogic/pi-skills

Lokale Sprach-zu-Text-Transkription auf Apple Silicon macOS. Unterstützt wav direkt und andere Audioformate über ffmpeg.

Was ist pi-skills?

Dieses Skill ermöglicht die lokale Sprach-zu-Text-Transkription direkt auf Apple Silicon macOS ohne Cloud-Abhängigkeit. Es basiert auf dem `piper-tts`-Projekt, das für schnelle Offline-Transkription optimiert ist. Das Skill unterstützt direkt das WAV-Audioformat und nutzt ffmpeg zur Konvertierung anderer Formate (wie MP3, M4A, FLAC). Entwickler können damit Sprachbefehle oder Diktate in Echtzeit oder aus Dateien transkribieren, was ideal für datenschutzsensible Anwendungen, automatisierte Workflows und Barrierefreiheitslösungen ist. Es ist speziell für macOS mit Apple Silicon (M1/M2/M3) konzipiert und nutzt die Neural Engine für optimale Leistung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/badlogic/pi-skills/tree/main/transcribe

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht pi-skills?

Lokale Sprach-zu-Text-Transkription auf Apple Silicon macOS. Unterstützt wav direkt und andere Audioformate über ffmpeg.

Installation

  1. Stelle sicher, dass ffmpeg installiert ist: brew install ffmpeg
  2. Lade das Modell herunter: piper-tts download
  3. Installiere die Abhängigkeiten: pip install -r requirements.txt

Verwendung

Transkription einer WAV-Datei:

pi transcribe input.wav

Transkription anderer Formate (automatische Konvertierung mit ffmpeg):

pi transcribe input.mp3

Transkription in Echtzeit (Mikrofon):

pi transcribe --live

Optionen

  • --model: Pfad zum Modell (Standard: automatisch heruntergeladen)
  • --language: Sprachcode (Standard: de)
  • --device: Ausgabegerät für Echtzeit-Transkription
  • --output: Ausgabedatei für Transkription (ansonsten nur Standardausgabe)

Beispiel

from pi_skills import transcribe

# Transkribiere eine WAV-Datei
text = transcribe("aufnahme.wav")
print(text)

Unterstützte Formate

  • WAV (direkt)
  • MP3, M4A, FLAC, OGG (über ffmpeg)

Abhängigkeiten

  • Python 3.8+
  • ffmpeg
  • piper-tts

Hinweise

  • Dieses Skill funktioniert nur auf macOS mit Apple Silicon.
  • Stelle sicher, dass genügend RAM und Speicherplatz für das Modell vorhanden sind.

Verwandte Skills