Buzz 语音转文字 macOS 完整安装指南:从 0 到首次转录
【免费下载链接】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,转录和翻译全程离线、不上传文件。本文讲 macOS 上怎么装好 Buzz,并完成第一次转录。本文 6 节,带你装完。
30 秒自检:确认能开始
本节解决“我的机器装不装得动”的判断。先跑这条命令看芯片架构:
uname -m预期输出:arm64是 Apple 芯片(M1/M2/M3),x86_64是 Intel 芯片。注意版本要求:新版 Buzz 已要求 Apple 芯片,Intel 的最后支持版本是 1.4.5。
对照确认两点:
- Apple 芯片:直接装最新版,可正常用上加速。
- Intel 芯片:只能装 1.4.5 及更早版本,走 CPU。
三条路,先选一条
本节解决“该用哪种方式装”。三种方式对比:
| 安装方式 | 适合谁 | 操作成本 | 下一步 |
|---|---|---|---|
| 官方 .dmg 预编译包 | 想快速上手的 Mac 用户 | 低,拖拽即装 | 走「主路径」 |
| PyPI pip 安装 | 已有 Python 环境、或 Linux 用户 | 中,需 Python 环境 | 走「备选路径」 |
| Flatpak / Snap | Linux 桌面用户 | 低,一条命令 | 用系统包管理器装 |
拿不准就选官方 .dmg 预编译包,图形化、最省事。
4 步装完:官方 .dmg 预编译包
本节解决 macOS 最常见的安装。全程图形操作:
- 到项目发布页下载 .dmg。Apple 芯片下最新包,Intel 芯片下 1.4.5 及更早版本。
- 双击 .dmg,把 Buzz 图标拖进 Applications 文件夹。
- 首次打开被拦,进 系统设置 → 隐私与安全性,点「仍要打开」。
- 再次打开,进入主界面。
装完打开,主界面左侧就是转录任务队列,导入音频文件即可开始转录。
备选路径:PyPI pip 安装
本节给已有 Python 环境或 Linux 用户一条命令式的路。
- 准备好一个较新的 Python 环境。
- 运行下面两条命令,装好并启动:
pip install buzz-captions python -m buzz预期效果:Buzz 界面启动,功能和预编译包一致。适合不想用图形包、习惯命令行的用户。
第一次转录,顺带把加速配上
本节解决“装完怎么用、要不要提速”。先做最短验证:把一段短音频拖进主界面,任务队列自动开始转录,完成后显示带时间戳的文字稿。
想更快再改一处,按硬件二选一:
- 有 Nvidia 显卡(Linux/Windows):进 Help → About Buzz → Install CUDA Acceleration,装完重启 Buzz 生效。
- Apple 芯片 macOS:whisper.cpp 后端默认带 CoreML 加速,无需额外配置。
若显存不够或想更稳,进 偏好设置,勾选 “Use only CPU and disable GPU acceleration”,或打开 “Reduce GPU RAM” 降低显存占用。模型后端与 GPU 选项都在这张面板里:
踩坑速查
| 症状 | 原因 | 修复 |
|---|---|---|
| Intel Mac 装新版失败或打不开 | 新版要求 Apple 芯片 | 改装 1.4.5 及更早版本 |
| 转录明显掉速 | 芯片与包不匹配,或没走 GPU | 用uname -m核对架构,Nvidia 显卡装 CUDA 加速 |
| 首次打开被拦截 | 应用未签名被系统拦截 | 系统设置 → 隐私与安全性 → 仍要打开 |
| 大模型跑不动、显存爆 | 模型超出显卡显存 | 偏好设置勾选 “Use only CPU and disable GPU acceleration”,或换更小模型 |
装好或遇新报错,去项目 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),仅供参考