Buzz Mac 安装避坑指南从芯片选择到 GPU 加速一次讲清【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款基于 OpenAI Whisper 的本地语音转写工具可完全离线运行并支持 GPU 加速。Mac 安装时最常见的坑有三个Intel 与 Apple Silicon 架构选错、首次启动被系统拦截、GPU 加速不生效。本文按安装前自查、安装执行、故障排查的顺序带你把正确版本装到位。 安装前自查先搞清楚你的 Mac 是什么动手下载之前花两分钟确认下面两件事它们决定了后面所有步骤怎么走。查芯片架构一条命令的事Mac 分两种芯片下载包必须对得上打开「终端」运行uname -m输出arm64→ Apple SiliconM1 及以后输出x86_64→ Intel关键事实官方现行版本1.4.6只提供 Apple Silicon 构建最后一个支持 Intel Mac 的版本是1.4.5。也就是说 Intel 机型在 1.4.5 之后拿不到新特性的官方包反过来Apple Silicon 机型装旧版 Intel 包会白白少掉 CoreML 加速等新能力。动作现在打开终端执行uname -m把结果记下来再去找安装包。系统版本与安装渠道官方发布页优先Buzz 在 Mac 上主要有三个安装渠道更新节奏不一样官方发布页.dmg与开源仓库同步修复和新特性先到这里App Store 版本独立打包、独立上架版本号和功能经常落后于发布页官方仓库里的修复可能要等一段时间才会出现在商店PyPI / 源码面向想要最新特性或自定义环境的用户。结论除非你特别依赖 App Store 的分发习惯否则一律选发布页。动作点左上角菜单 「关于本机」确认 macOS 版本再到官方发布页按你的芯片架构挑对应构建。 选一条安装路线走到底路线一官方预编译包推荐大多数人到官方发布页Apple Silicon 选 arm64 构建的 .dmgIntel 用户只能选1.4.5的 x64 构建。下载后双击打开把 Buzz 拖进「应用程序」文件夹。首次启动。如果系统弹出「无法验证开发者」一类的提示先别慌——自编译或未走完公证流程的包没有签名macOS 默认拦截这属于正常现象。图Buzz 主界面左侧是转录任务队列上方工具栏可添加音频或开始录制动作在 Finder 里右键点击 Buzz 图标选「打开」或在「系统设置 隐私与安全性」下拉到底点「仍要打开」。路线二源码编译想要最新特性再走这条只有当官方版还没有你要的功能或你想自己控制运行环境时才建议走这条路。前置条件装好 Xcode 命令行工具xcode-select --installPython 3.13项目pyproject.toml要求3.13,3.14装好 ffmpegbrew install ffmpeg最小命令集git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz python3.13 -m venv .venv source .venv/bin/activate pip install . python -m buzz安装过程中构建系统会一并编译 whisper.cpp 子模块在 Apple Silicon 上Makefile会自动加上-DWHISPER_COREML1让转录后端走 CoreML无需额外配置。动作运行python -m buzz主窗口能正常弹出即说明源码版安装成功。 装不上、打不开、加速不了故障速查以下每条按「症状—可能原因—动作」列出对号入座即可。症状双击提示「无法打开因为无法验证开发者」原因包未签名或未公证源码编译产物、个别第三方镜像最常见动作Finder 中右键「打开」弹窗里再点一次「打开」或走「系统设置 隐私与安全性」底部的「仍要打开」。症状转录明显偏慢GPU 加速像没开原因Whisper 类型选错了。Mac 上 Buzz 走Whisper.cpp后端才能真正用上 GPU实现见buzz/transcriber/whisper_cpp.py选 Whisper 或 Faster Whisper 实际是在跑 CPU动作在偏好设置里把 Whisper 类型改成 Whisper.cpp选一个 ggml 模型首次转录时等模型完整下载完成。症状速度掉档长音频要等很久原因模型太大或 Intel 机器停在 1.4.5 拿不到后续优化模型文件下载损坏也会导致异常动作换更小的 whisper.cpp 模型仍不正常就到「Help Preferences Models」删除已下载模型重新下载。图Buzz 偏好设置在这里切换 Whisper 类型、管理模型与 API 密钥 装好之后更新跟踪与反馈渠道查版本Help About Buzz 可以看到当前版本号再到官方发布页对比是否有更新想尝鲜最新开发版看项目文档 FAQ 中「latest development version」一节的说明管模型Mac 上模型缓存在~/Library/Caches/Buzz可通过「Help Preferences Models Show file location」直接打开目录提问题遇到 bug 到项目 issue 跟踪器提交附上「Help About Buzz Show logs」里的日志文件开发者定位问题会快很多。动作装完先打开 Help About Buzz 记一下版本号日后排查和升级都以它为基准。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考