Buzz 模型下载加速从镜像源配置到手动导入的三档路径附环境变量清单【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz盯着 Buzz 的模型下载进度条卡在 3% 看了二十分钟好不容易动了又弹出校验和错误——多半是境外源的问题。Buzz 是一款在本地电脑完成音频转录和翻译的工具核心引擎是 Whisper模型文件从几十 MB 到几 GB 不等其中大部分托管在 Hugging Face 上。这篇文章按由浅入深的三档操作路径走一遍一行环境变量切镜像源、手动下载模型文件导入、借助代理直连最后附一份下载失败的排错速查。最省力一行 HF_ENDPOINT 环境变量切到镜像源适合绝大多数国内网络环境什么都不用装5 分钟搞定。Buzz 的模型下载与完整性校验逻辑集中在 buzz/model_loader.py 模块里Whisper.cpp、Faster Whisper 等模型都从 Hugging Face 拉取因此按官方配置文档的说法指向国内镜像源即可。在终端里追加一行环境变量并在同一个终端启动 Buzzexport HF_ENDPOINThttps://hf-mirror.com python main.pyWindows 下把export换成set HF_ENDPOINThttps://hf-mirror.com。打开 偏好设置 → 模型选中需要的规格点击下载速度会明显变快。 这里有个小细节很多人忽略环境变量只对从这个终端里启动的进程生效直接双击桌面图标是拿不到这个变量的。要么用命令行启动要么在系统环境变量里永久配置。另外下载支持断点续传中断后重开 Buzz已下载的部分不会重下。顺带一提官方 Whisper 组的源在 OpenAI 的 CDN 上镜像对它无效可以把模型组切换成 Whisper.cpp算法效果相同走的就是镜像源。镜像也走不通手动下载模型文件导入 Buzz如果你的网络连镜像源都费劲或者机器本身是内网隔离的那就干脆跳过在线下载环节——自己搬。Buzz 把模型统一存放在本地 models 目录Linux 为~/.cache/Buzz/modelsWindows 为%LOCALAPPDATA%\Buzz\cache\modelsmacOS 为~/Library/Caches/Buzz/models也可以用BUZZ_MODEL_ROOT环境变量指定别处。手动导入有两条路直接放文件从任何可达的渠道内网文件服务器、网盘、U 盘拷贝拿到对应的ggml-xxx.bin文件放进 models 目录的对应子目录Buzz 再次启动时会自动识别。用内置的自定义链接在模型设置页选 Whisper.cpp 组、规格设为 Custom会出现一个模型文件直链输入框粘贴链接点下载即可——链接指向国内镜像站也没问题。 在线下载的模型默认带 SHA256 校验手动放的文件没有这道保险建议先核对文件大小tiny 约 73 MBbase 约 140 MBsmall 约 460 MBmedium 约 1.5 GB明显偏小说明文件不完整。如果要批量备货仓库里带了离线脚本 scripts/download-models.py在联网机器上跑一次即可python scripts/download-models.py --model-type whispercpp --model-size tiny base已有代理工具Buzz 的正确打开方式如果你本来就有稳定的代理这其实是最省事的一档——Buzz 的网络请求走标准 HTTP 库会尊重系统代理设置不需要改任何代码。启动 Buzz 前在终端里设置代理变量export HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890同一终端执行python main.py再照常进模型页下载。进度条以正常速度前进就说明链路已经走通。 Windows 上同样存在终端继承问题双击图标启动时代理变量不生效务必从终端启动或把代理写成系统环境变量。不经过代理的局域网地址可以用NO_PROXY排除掉避免误伤。遇到下载失败或校验和不匹配按这个顺序排查先看文件大小Buzz 内置了各规格的预期大小定义在 model_loader.py 里本地文件明显偏小就是没下完直接重新下载即可断点续传会接着上次的进度走。删掉损坏的文件只删 models 目录里对应的那个 .bin 文件不要清整个目录其余已下载的模型不用动。用脚本定位内网机器先在联网机跑python scripts/download-models.py它会逐个报告哪个规格下载失败。最后查日志从终端启动 Buzz日志会实时输出下载进度和具体报错。模型加载成功后导入一段音频转出文本是最直接的验证方式Buzz 的模型模块目前已经具备断点续传、校验和比对和下载完成标记这几项基础保障离线预下载脚本也已入仓库。项目后续会继续在模型分发和显存优化比如 8bit 量化开关方向迭代有想法可以关注仓库的最新改动。只要模型这一关走过去后面的转录、翻译就都在本地完成基本不再依赖网络。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考