手把手指南Buzz 的 Whisper 模型下载卡在 99%换手动摆放就通【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz打开 Buzz 下载 Whisper 模型OpenAI 的语音转文字模型进度条在 37% 停了半小时或者一上来就弹网络连接超时。原因不复杂模型文件托管在海外平台体积 1GB 到 10GB跨国链路又不稳。不用硬扛网络把文件放进本地模型目录离线转录就能跑起来。Buzz 去哪里找模型Buzz 默认把模型放在系统缓存目录下的models子文件夹WindowsC:\Users\用户名\AppData\Local\Buzz\modelsmacOS~/Library/Caches/Buzz/modelsLinux~/.cache/Buzz/models也可以用环境变量BUZZ_MODEL_ROOT覆盖这个路径方便把模型挪到空间更大的磁盘。手动摆放 Whisper 模型这是多数场景下能直接走通的做法在网络好的机器上把模型下载下来再拷贝过来。克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz pip install .先想清楚要哪一档模型tiny最快但精度低small、medium均衡large-v3精度最高但最慢。然后从镜像站点拿到对应文件——Whisper.cpp 用的是ggml-model-whisper-*.bin文件其余转录引擎的模型来自 Hugging Face。把文件拖入上面的models目录。启动 Buzz进入偏好设置 → 模型Whisper.cpp 的自定义模型可以直接指向你放好的.bin文件也可以把界面里的下载链接填成一个可达的镜像地址Buzz 会自动去拉取。如果模型走 Hugging Face 通道再加一个HF_ENDPOINT环境变量指向国内镜像相当于给整个下载库换源。备选配一个代理手上已有稳定代理的话不用手动搬文件。启动前设置环境变量export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890 python main.pyWindows 的 PowerShell 里改成$env:HTTP_PROXYhttp://127.0.0.1:7890再启动即可。下载全程走代理其他设置不用动。备选克隆完整镜像仓库代码和配套资源想一次拿全直接克隆镜像仓库git clone https://gitcode.com/GitHub_Trending/buz/buzz克隆完成后运行 Buzz能复用的本地文件不会再从国外服务器拉取适合不想折腾路径配置的人。验证成功顺手处理常见失败成功标志在偏好设置 → 模型里能看到目标模型并选中拖入音频转录查看器能输出带时间戳的文本。排查清单现象 → 处理反复网络连接超时跨国链路瓶颈改走手动摆放或镜像仓库路线。SHA256 校验失败文件传了一半不完整删除后重新拷贝Buzz 对 ggml 模型下载后会自动校验。模型选不到确认文件在models目录里、文件名符合规则whisper.cpp 为ggml-model-whisper-*.bin。同一个模型被反复下载用BUZZ_MODEL_ROOT固定模型路径避免缓存目录漂移。几条顺手优化 ⚙️实时录音转录用tiny/small离线精转再用large按场景分档。有 NVIDIA 显卡就开 CUDA 加速Apple Silicon 用对应加速选项。用文件夹监控自动转录新放入的音频不用逐个导入。批量自动化直接用 CLI省去界面操作。参考资料docs/docs/installation.md — 官方安装说明覆盖各平台与 PyPI、Flatpak、Snap 的安装方式。buzz/model_loader.py — 模型下载、路径解析与完整性校验的实现。buzz/transcriber/ — 各转录引擎Whisper、Whisper.cpp、本地服务等的实现。buzz/widgets/preferences_dialog/models_preferences_widget.py — 模型设置界面源码排查界面行为时有用。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考