企业官网建设流程全解析

Buzz Mac 语音转文字安装完整指南

【免费下载链接】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 的本地语音转文字工具，转录和翻译全程离线，文件不出你的电脑。Mac 上安装失败通常就两点原因：一是芯片架构，官方新版只支持 Apple 芯片，Intel Mac 停在 1.4.5；二是路径选错，源码构建要用 uv 环境，直接 pip 装不起来。下面先确认芯片，再在官方包和源码构建里挑一条路，一次装好。

🔧 ① 先确认你的 Mac 芯片

一行命令：

uname -m

输出arm64→ Apple 芯片（M1/M2/M3），选 Apple 芯片包，后面的 CoreML 加速可用。输出x86_64→ Intel 芯片，只能用 Buzz 1.4.5 及更早版本，别装新版。

⚖️ ② 选对安装方式

拿不准就选官方预编译包，源码构建留给要尝鲜的人。

📦 ③ 三步装完官方预编译包

1. 下载：从项目发布页（SourceForge）拿 macOS 的 .dmg，Apple 芯片包。
2. 安装：双击 .dmg，把 Buzz 拖进 Applications 文件夹。
3. 放行：首次打开被拦，进 系统设置 > 隐私与安全性，点 仍要打开。

打开后主界面左侧就是转录任务队列，导入文件即可开始转录。

🛠️ ④ 从源码构建 Buzz

仓库用 uv 管依赖，requirements.txt不存在，直接 pip 装不通。四步：

git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz

pip install uv

uv sync

uv sync装全部依赖，自动锁定 Python 3.13。要跑 Whisper.cpp 后端（Mac 推荐，带 CoreML 加速）先编译它：

uv run make buzz/whisper_cpp

uv run buzz

构建细节见 CONTRIBUTING.md。

⚡ ⑤ 开启 GPU 加速并验证

模型类型和大小都在 偏好设置（Cmd + ,）同一面板，两处设置：

1. 模型类型选 Whisper.cpp —— Apple 芯片下走 CoreML 加速，官方 FAQ 直接说它是 Mac 上的最佳选择。
2. 模型大小验证先选 tiny，最小最省。

验证方式：导入一条短音频，跑 tiny，和 CPU 速度对比，快了就是加速生效。要强制走 CPU 排查，启动前设环境变量BUZZ_FORCE_CPU=true。也可以不进界面直接跑一条：

buzz add -m whispercpp -s tiny audio.mp3

完成后任务状态变绿，双击打开转录查看器，文本和时间轴都在，可直接导出 SRT/TXT。模型怎么选见 偏好设置文档。

❓ ⑥ 常见问题速查

装完导入一条真实音频验证；遇新报错，在 帮助 > 关于 Buzz 拿日志，再去项目 issue 区反馈。

【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz