Buzz 语音转文字：3 步装好的避坑指南
【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz
Buzz 是一款离线语音转文字工具，基于 OpenAI Whisper，录音不出本机就能转成文字。新手最常卡住的一步是装完 PyPI 包后导入音频直接报错、任务卡在失败。本文推荐走 PyPI 安装，它跨平台、一条命令装好；先自检环境，再装包，最后验证转录。🎯
🎯 选安装方式
按下表对号入座，拿不准就选 PyPI 安装。
| 你的情况 | 推荐路径 | 耗时 |
|---|---|---|
| 大多数用户（macOS / Windows / Linux） | PyPI 装 1.4.6 | 约 5 分钟 |
| macOS 不想碰命令行 | 官方 .dmg 预编译包 | 约 5 分钟 |
| Linux 桌面环境 | Flatpak | 约 5 分钟 |
| Intel 老款 Mac | 1.4.5 及更早版本 | 约 5 分钟 |
注意：新版已要求 Apple 芯片，Intel Mac 最后支持版本是 1.4.5，选错架构会装不上。
🔍 自检运行环境
一条命令确认 Python 版本，一条确认 ffmpeg 是否就位。
python --version ffmpeg -version输出 Python 3.12 或 3.13 就满足要求，输出 ffmpeg 版本号说明依赖齐了。两条都通过就能装；缺 ffmpeg 先补装它；Python 低于 3.12 会直接装不上。
📦 安装 Buzz 包
PyPI 装包是主路径，3 步装完，每步都有预期结果可对照。
- 装 ffmpeg：Buzz 依赖它做音视频解码，先装好它。预期结果：
ffmpeg -version打印版本号。 - 装 Buzz 包：在你的 Python 3.13 环境里执行安装。预期结果：pip 结束行显示
Successfully installed buzz-captions-1.4.6。
pip install buzz-captions- 启动程序：用模块方式拉起 Buzz 图形界面。预期结果：主界面打开，左侧就是转录任务队列。
python -m buzz- 导入文件开始转录：菜单 File > Import File 选中音频，首次运行会自动下载 tiny 模型，转完导出 TXT 或 SRT。
🖥️ 装官方预编译包
不想用 PyPI 就按平台下载预编译包，两条命令合并展示，细节见 docs/docs/installation.md。
# macOS：下载对应芯片的 .dmg（Apple 芯片 / Intel 分开），拖入 Applications 即可 # Windows：SourceForge 下载安装包，警告弹窗选 More info -> Run anyway✅ 验证安装
命令行输出版本号 1.4.6 即算装好，界面和设置各确认一处。
- 终端执行
python -m buzz --version，输出1.4.6。 - 主界面打开后，左侧任务队列、顶部菜单 File / Help 都在。
- 从 Help 菜单打开 Preferences，能看到模型类型与大小选项；详细项见 docs/docs/preferences.md。
有 NVIDIA 显卡可单独装 CUDA 加速：1.4.6 起它不再捆绑在基础包里，路径是 Help > About Buzz > Install CUDA Acceleration。
🛠️ 排查常见报错
遇到下表症状按对应一行修复，改完重跑一次验证命令。
| 症状 | 原因 | 一行修复 |
|---|---|---|
| 导入文件即报错、任务失败 | 系统缺 ffmpeg | 按系统包管理器装好 ffmpeg 再启动 |
| pip 安装直接报 Requires-Python | Python 不是 3.12 / 3.13 | 换 Python 3.13 环境重装 |
| Intel Mac 装新版失败 | 新版要求 Apple 芯片 | 改装 1.4.5 及更早版本 |
| 首次转录很慢 | 正在下载 tiny 模型 | 等下载完成，第二次转录明显变快 |
| Windows 安装弹未签名警告 | 安装包未签名 | 点 More info -> Run anyway |
仍解决不了，按 docs/docs/cli.md 核对命令行参数，或到项目 issue 系统反馈。
【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
