stt

name	stt
description	Transcribe audio speech to text or generate subtitle (.srt) files. Use this to process voice messages.

Prerequisites

Make sure the stt command is installed with the package: which stt || uv tool install --default-index https://pypi.org/simple git+https://github.com/codescv/aigc_toolkit.

Parameters

• --audio: The full path to the input audio file.
• --output (Optional): The path to save the output text or .srt file. If not specified, prints to standard output.
• --srt (Optional): Force the output as SubRip Subtitle format (.srt). This is automatically inferred if --output ends with .srt.
• --model (Optional, default: mlx-community/whisper-large-v3-turbo): The whisper model ID or local path to use.

Examples

Transcribe Audio to Plain Text

stt --audio /path/to/audio.wav

Save Transcription to a Text File

stt --audio /path/to/audio.wav --output /path/to/transcription.txt

Generate Subtitle (SRT) File

stt --audio /path/to/audio.wav --output /path/to/subtitles.srt