Buzz Mac 安装完全指南装不上别慌语音转文字本地转录 10 分钟跑起来【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 下载完打不开macOS 一直提示“无法验证开发者”或者你在 App Store 里装到的版本比社区版落后了好几个迭代——这是 Mac 用户安装这款语音转文字工具时最常撞上的三种情况。Buzz 是基于 OpenAI Whisper 模型的本地转录与翻译工具音频文件和实时录音都在你自己的电脑上处理数据不出本机支持硬件时还能开 GPU 加速把处理速度拉高。它适合要做访谈、会议、课程录音转写的你尤其是既在意隐私、又想离线可用的用户。30 秒速览Buzz 装不上的两个主因这一节先给结论不装也能先定位原因30 秒判断该走哪条路。Buzz 在 Mac 上装不上或装完跑不动多半就是两件事——芯片版本选错或者商店版太旧。按这个顺序处理打开终端运行uname -m输出arm64是 Apple Siliconx86_64是 Intel。Apple Silicon 机器 → 走路径 A取官方最新预编译 .dmg。Intel 机器 → 注意官方最新发行已只支持 Apple SiliconIntel 能装到的最后一版是1.4.5下这个旧包的 .dmg。想要最新特性、或需要按自己需求改 → 走路径 B从源码构建。为什么 App Store 版在 Mac 上“水土不服”这一节讲透两个底层原因之后你看到任何报错都能对号入座。原因一两条发布轨道商店版天然慢半拍。Mac App Store 的条目和开源仓库不是同一条流水线。商店条目走独立维护分支修复与新功能先落到主仓库再慢慢同步进商店分支。于是你在商店里装到的常常是几个迭代以前的版本拿着它和社区发布版对比发现“这个功能没有”“这个 bug 还在”不是你的 Mac 有问题而是同步延迟。原因二芯片不自适应装错包直接伤功能。Mac 存在 Intel x86 与 Apple Silicon 两条处理器路线同一个应用要按架构分别打包。商店版缺少按芯片引导用户选对版本的机制装错包有两种下场在 Apple Silicon 上跑 x86 包走翻译层转录速度掉掉三成左右更麻烦的是 GPU 加速路径直接失效——Apple Silicon 上的加速依赖系统的 Metal/CoreML 栈架构对不上的构建根本调不动它。一句话商店版“装不上”很多时候不是系统坏了是版本和架构错配。路径 A如何按芯片选对 Buzz 安装包这一节把“下载 → 安装 → 首次放行”完整走一遍两种芯片的用户都能直接照着做各平台细节可参考 docs/docs/installation.md。确认芯片。终端里跑uname -m看一眼输出再决定下哪个包。下官方预编译包。到项目官方发布页面下载 .dmgApple Silicon 选arm64标记的版本Intel 选最后一个兼容版本1.4.5更新版本不再提供 Intel 包。安装。双击 .dmg把 Buzz 拖进 Applications 文件夹。处理首次运行权限。若提示“无法验证开发者”别放弃打开“系统设置 → 隐私与安全性”滚到安全区点“仍要打开”部分系统也可以右键应用图标选“打开”。装好之后打开主界面就是下方这张任务列表的样子导入音频、选模型、点开始。路径 BBuzz Mac 源码构建拿最新特性与自定义能力这一节用源码把 Buzz 构建并跑起来代价是安装步骤多一些好处是永远能跟主仓库保持一致。前置条件装好 Xcode Command Line Tools运行xcode-select --install并准备Python 3.13环境——项目依赖把 Python 版本钉在 3.13 区间。然后执行下面这段每行都标了作用git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz python -m venv venv source venv/bin/activate pip install . buzzgit clone ...拉取完整源码后面所有操作都在这个目录里做。python -m venv ...建一个隔离虚拟环境并激活不污染系统 Python。pip install .按pyproject.toml安装 Buzz 及全部依赖输出里看到Successfully installed buzz-captions即完成。buzz启动图形界面。想启用 whisper.cpp 引擎的话还要先用make编译 C 部分仓库 Makefile 会自动识别芯片Apple Silicon 走 CoreML 加速路径Intel 用纯 CPU 构建构建时间会更长一些。装完自查三步确认 Buzz 语音转文字真的跑通这一节给你 3 个验证动作任何一步失败就回上面对应路径重做别急着去提 issue。转录一段短音频。往主界面拖入一段 1 分钟以内的 MP3/WAV选 tiny 或 base 这样的小模型启动任务观察任务从排队到进行中再到完成进度条要有动静。检查结果。打开转录查看器把文字和原音频对一遍再切换 TXT / SRT / VTT 导出确认文件正常落盘。✅验证翻译与加速。在任务选项里打开翻译、挑一个目标语言Apple Silicon 上优先用 whisper.cpp 引擎它会走系统 Metal/CoreML 的 GPU 路径。若转录明显偏慢先回uname -m复查架构对不对再看系统版本是否新到支持 MetalmacOS 12 及以上。Buzz Mac 安装踩坑速查表这一节是表格版排错清单遇到现象直接查行处理不用重读全文。现象原因正确操作⚠️ 转录明显变慢、功能缺失、GPU 加速无效果Apple Silicon 机器装了 x86 包uname -m先确认芯片卸掉旧包重装 arm64 版⚠️ 首次打开提示“无法打开”或“无法验证开发者”macOS 默认拦截未验证开发者签名不代表包损坏系统设置 → 隐私与安全性 →“仍要打开”或右键应用选“打开”⚠️ Intel 机器装不上或官方页面找不到对应包最新发行只支持 Apple SiliconGPU 加速路径在 Intel 上也没有对应实现Intel 用户停留在 1.4.5要新版本只能源码构建走 CPU⚠️ 开了 GPU 加速但速度没变化加速同时依赖芯片、系统版本、引擎选型缺一即失效确认 arm64 且 macOS 12 以上换用 whisper.cpp 引擎再测跟进 Buzz 更新找得到人帮忙这一节给你两个习惯避免今天踩的坑下个月再踩一遍。盯发布页。维护团队以每月一次的节奏发稳定版Apple Silicon 的性能优化基本每个迭代都有。商店版用户尤其要看一眼商店版本落得明显更远时直接改用官方预编译包。用对 issue 和 Discussions。遇到安装问题先搜已有 issue没有再新建把uname -m输出、macOS 版本、安装方式商店 / 官方包 / 源码写清楚排查会快很多。想和其他用户交流可以去 Discussions 板块能读源码的话顺手提交修复也是被鼓励的。装好它把录音转成文字然后去干活——这就是 Buzz 存在的全部意义。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考