Buzz 离线音频转录模型下载加速指南：如何解决 Hugging Face 下载慢
Buzz 离线音频转录模型下载加速指南如何解决 Hugging Face 下载慢【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz在 Buzz 里选中 medium约 1.5GB这样的大模型点击下载进度可能长时间爬行甚至中途失败。本文按投入从少到多给出三种加速或绕开 Hugging Face 模型下载的方法帮你把离线音频转录用起来。先搞懂问题出在哪点击下载后Buzz 通过 huggingface_hub 库从 Hugging Face 源拉取 ggml-*.bin 模型文件核心逻辑在 buzz/model_loader.py。该源位于海外国内直连普遍缓慢且容易断连而模型文件本身很大tiny 约 73MB、base 约 139MB、medium 约 1.5GB、large 约 2.9GB下载窗口期天然很长。另外HF 的下载特性是中断后已下载部分会留在缓存目录但所有文件到齐后快照才被标记完成不完整文件不处理Buzz 就会一直显示该模型未下载。官方文档docs/docs/preferences.md已为国内用户列出了镜像源配置下面的方法按落地成本从低到高排列。设置 HF_ENDPOINT 环境变量使用 Hugging Face 镜像源适用能访问第三方镜像源但直连 Hugging Face 官方站点慢。步骤在启动 Buzz 前设置环境变量Linux/macOS 终端执行export HF_ENDPOINThttps://hf-mirror.comWindows 在 PowerShell 中执行$env:HF_ENDPOINThttps://hf-mirror.com打开 Preferences → Models像平时一样点击下载。验证下载完成后在同一窗口点 Show file location确认目录中出现对应的 ggml-*.bin 文件。局限镜像源是第三方服务若其不可用或文件缺失仍需回退官方站点从桌面图标启动的图形程序可能不继承终端里 export 的变量建议把该变量写入系统级环境变量以每次生效。在 Buzz 中选择 Custom 模型并粘贴 .bin 直链适用你手上有模型 .bin 文件的可直链下载地址例如镜像站点的文件链接且使用 Whisper.cpp 模型类型。步骤在 Preferences → Models 中把模型类型选为 Whisper.cpp。在模型大小列表中选择 Custom。在直链输入框粘贴 .bin 文件的 URL 后点击下载链接需指向 .bin 文件本身可用模型页面上的 download 按钮取到。验证下载完成后模型目录中出现 ggml-model-whisper-custom.bin新建转录任务选择该模型可直接开始转录。局限仅适用于 Whisper.cpp 类型且需要你自己提供直链无法像内置列表那样直接按尺寸挑选。手动拷贝模型缓存目录实现离线导入适用目标机器无法访问外网内网、隔离环境或网络不稳定到无法完成 GB 级下载。步骤在网络良好的机器上用 Buzz 下载好所需模型在 Preferences → Models 中点 Show file location 打开模型目录Linux 下默认是~/.cache/Buzz/models。将整个 models 目录压缩带到目标机器解压到相同路径若要用其他位置存放模型可通过BUZZ_MODEL_ROOT环境变量指向自定义目录。需要批量准备缓存时可运行仓库自带的 scripts/download-models.py 脚本。验证目标机器上 Preferences → Models 能识别已导入的模型断开网络新建转录任务也能正常完成。局限需要在另一台机器上预先准备目录之后更换或新增模型仍要重复一次拷贝。常见坑速查模型状态异常时可先到 Preferences → Models 窗口查看并清理报错现象最常见原因处理办法下载到某个百分比后中断重试重新下载断网留下不完整文件快照未标记完成在 Preferences → Models 删除该模型再下载已缓存部分会续传文件已存在但模型仍不被识别文件损坏或完成标记缺失对照官方尺寸检查文件大小明显偏小就删除重下Windows 上下载进度长时间不动文件锁竞争或杀毒软件扫描干扰Buzz 在 Windows 已改用单线程下载关闭对缓存目录的实时扫描后重试公司网络下报 SSL 证书错误企业代理拦截 TLS证书不受信任设置 REQUESTS_CA_BUNDLE 指向内部 CA 证书或改用无拦截网络怎么选你的情况做法能访问 Hugging Face 但慢优先用 HF_ENDPOINT 镜像源并写入系统环境保证每次启动生效已有代理启动 Buzz 前设置 HTTP_PROXY / HTTPS_PROXY让官方下载走代理通道内网无外网在有网机器下载模型后整体拷贝 models 目录或用 download-models.py 脚本批量预置行动清单确认当前选择的模型尺寸初用选 small 或 medium 即可tiny/base 适合测试在启动 Buzz 前设置 HF_ENDPOINT并把它写入系统级环境变量下载完成后用 Show file location 打开模型目录确认 ggml-*.bin 存在离线场景先在联网机器上备好多份 models 目录或使用 download-models.py 批量准备出现问题先删除对应模型重新下载再查看日志定位原因Buzz 的模型文件保存在系统用户缓存目录Linux 为~/.cache/Buzz/models文件就位后转录与翻译可完全离线运行不再依赖网络连接。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考