Usage

Place the audio file in your current working directory and tell the AI:

Convert xxx.mp3 to SRT subtitles

Or specify the full path directly:

Convert /path/to/audio.mp3 to SRT subtitles

Convert xxx.mp3 to English subtitles using large-v3-turbo model

Convert xxx.mp3 to subtitles, language is Japanese

Execution

AI will execute the scripts/transcribe.py script, which will:

Python 3.8+
PyTorch (version matching your hardware)
- Intel GPU: pip install torch==2.10.0+xpu
- NVIDIA GPU: pip install torch --index-url https://download.pytorch.org/whl/cu121
- CPU: pip install torch
openai-whisper: Automatically installed via pip install openai-whisper

First run will auto-download the model file (turbo ~1.5GB)
Models cache in ~/.cache/whisper by default, use symlink/Junction to redirect to another disk
Intel XPU requires Intel Arc GPU + matching PyTorch version

Tip for China users: If model download fails, manually download from mirror sites and place in ~/.cache/whisper/

Model	Size	Speed	Accuracy
`tiny`	39M	Fastest	Low
`base`	74M	Fast	Medium
`small`	244M	Medium	Medium
`medium`	769M	Slow	High
`turbo`	809M	Medium	High ✅ Recommended
`large-v3`	1550M	Slowest	Highest
`large-v3-turbo`	1550M	Slow	Highest

使用本地 Whisper 模型将音频文件转录为 SRT 字幕，完全免费，无需联网，支持 GPU 加速。

将音频文件放入当前工作目录，然后告诉 AI：

把 xxx.mp3 转成 SRT 字幕文件

或者直接指定路径：

把 /path/to/audio.mp3 转成 SRT 字幕

把 xxx.mp3 用 large-v3-turbo 模型转成英文字幕

把 xxx.mp3 转成字幕，语言是日语

AI 会调用 scripts/transcribe.py 脚本执行转录，脚本会：

Python 3.8+
PyTorch（版本需匹配硬件）
- Intel GPU：pip install torch==2.10.0+xpu
- NVIDIA GPU：pip install torch --index-url https://download.pytorch.org/whl/cu121
- CPU：pip install torch
openai-whisper：由 ClawHub 通过 pip install openai-whisper 自动安装

国内用户提示：首次运行会自动下载模型，如下载失败可手动从镜像站下载后放入 ~/.cache/whisper/