OpenSkillIndex← back to search
claude-code

Skills whisper-stt

install
source · Clone the upstream repo
git clone https://github.com/wulaosiji/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/wulaosiji/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/whisper-stt" ~/.claude/skills/wulaosiji-skills-whisper-stt && rm -rf "$T"
manifest: whisper-stt/SKILL.md
source content

Whisper STT 技能 (Whisper Speech-to-Text)

本地语音转文字，隐私安全，完全免费，无需 API Key。

When to Use

适用于以下场景：

  • 需要将语音/音频转换为文字
  • 隐私要求高的场景（本地处理，不上传云端）
  • 无需网络连接的场景
  • 中文语音转录
  • 多语言语音转录
  • 与语音克隆结合使用（语音→文字→AI处理→语音）

Do NOT use this skill if:

  • 需要实时流式转录（Whisper 适合离线批量处理）
  • 对转录速度要求极高且设备性能有限
  • 需要云端协作或共享转录结果
  • 音频质量极差（背景噪音过大）

触发关键词 / Trigger Phrases:

  • 语音转文字 / speech to text
  • 语音转录 / voice transcription
  • 本地STT / local STT
  • 语音识别 / speech recognition
  • 音频转文字 / audio transcription
  • 转录音频 / transcribe audio
  • whisper转录 / whisper transcription

Workflow

1. 安装依赖

pip3 install openai-whisper

2. 使用封装脚本

from tools.whisper_stt import transcribe

# 转录音频
result = transcribe("audio.mp3", model="base", language="zh")

if result.get("success"):
    print(f"转录内容: {result['text']}")
else:
    print(f"错误: {result['error']}")

3. 命令行使用

# 基本用法
whisper audio.mp3

# 指定中文和模型
whisper audio.mp3 --model base --language zh

# 指定输出格式
whisper audio.mp3 --model base --language zh --output_format txt

4. 与语音克隆结合

from tools.whisper_stt import transcribe
from tools.voice_clone_api import generate_speech

# 语音转文字
stt_result = transcribe("user_voice.mp3")
text = stt_result["text"]

# AI处理...
response = f"收到: {text}"

# 文字转语音（克隆声音）
generate_speech(response, voice_id="wuna-001")

Model Selection

模型大小速度准确率推荐场景
tiny39MB最快一般测试
base74MB快良好日常使用 ✅
small244MB中等好平衡
medium769MB较慢很好高质量
large1550MB最慢最佳精确转录

Guardrails

音频质量要求

  • 格式: MP3, WAV, M4A 等常见格式
  • 清晰度: 语音清晰，避免背景噪音
  • 音量: 正常音量，避免过小或失真
  • 语言: 支持中文、英文及 90+ 语言

限制说明

  • 实时性: 不适合实时流式转录
  • 资源占用: 大型模型需要较多内存
  • 准确性: 口音、方言可能影响准确率
  • 时长: 长音频可能需要分批处理

故障排除

问题解决方案
安装失败先装PyTorch CPU: 
pip3 install torch --index-url https://download.pytorch.org/whl/cpu
速度慢换用tiny/base模型
中文不准确认指定 
--language zh
内存不足使用base/tiny模型

Related Skills

技能关系说明
voice-clone配套语音克隆技能，可与STT形成完整语音工作流

About UniqueClub

Part of UniqueClub toolkit - AI-powered creative tools for speech processing. Learn more: https://uniqueclub.ai

基于OpenAI Whisper开源项目