3分钟下完Buzz的1.5GB语音转录模型改两个环境变量就够【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz在Buzz的偏好设置模型页点下载进度条能卡上几个小时——这是用这款基于Whisper的离线语音转录工具时最常踩的坎。本文把1.5GB的whisper.cpp模型压到3分钟内下完并给完全无外网的机器留了一条离线备路。先选路你属于哪种情况 能联网只是想快→ 走下文「核心路径」只改模型源端点3步2分钟生效。已有代理或公司网络→ 直接看「备路」多设一个变量。目标机器完全无外网内网→ 先读「备路」在外网机预下载好模型再搬过去。动手前的准备Buzz模型缓存目录与磁盘自检 先确认模型存到哪。程序默认存用户缓存目录的models子文件夹buzz/buzz.py 在启动时写入该逻辑Linux 下即~/.cache/Buzz/models/Windows 与 macOS 在各自系统缓存目录也可以用BUZZ_MODEL_ROOT环境变量统一覆盖下文提到缓存目录都指这里。磁盘空间按你选的模型算Buzz 官方尺寸清单buzz/model_loader.py 里的WHISPER_MODEL_SIZES如下whisper.cpp 模型大小tiny72 MBbase138 MBsmall460 MBmedium1.5 GBlarge-v32.9 GBlarge-v3-turbo1.6 GB按上表的 2 倍准备磁盘HF 下载会先写临时文件再改名。另外自检两项缓存目录当前用户可写Python 版本为 3.12pyproject.toml 的requires-python锁定3.12,3.13。核心路径把模型下载切到镜像端点 ⚡Buzz 的 whisper.cpp 模型不走 GitHub而是经huggingface_hub从ggerganov/whisper.cpp仓库拉取。所以加速点在HF_ENDPOINT这个端点变量上无需改项目任何一行代码。第 1 步设置端点变量。在你启动 Buzz 的 shell 里加两行Linux/macOSexport HF_ENDPOINT可访问的HuggingFace镜像端点Windows PowerShell 里改成$env:HF_ENDPOINT。该变量只改变下载通道不改变模型文件内容。你会看到终端回显无报错echo $HF_ENDPOINT能输出你设的地址即正常。第 2 步启动 Buzz 触发下载。运行python main.py打开偏好设置的 Models 页选 Whisper.cpp 引擎和目标尺寸点下载按钮。你会看到进度条持续走动du -sh ~/.cache/Buzz/models里文件体积同步增长。正常表现10MB/s 以上速度约 2.5 分钟拉完 1.5GB中途闪断程序会自动重试 3 次5 秒、10 秒退避短暂停顿属正常。第 3 步确认完成标记。对应模型的快照目录会写入.buzz_complete标记文件缺了这个文件Buzz 就认为模型没下完。正常表现模型页进度条走满 100%尺寸下拉框状态变为已下载主界面可以直接选它开始转录。主路不通时的备路代理与内网离线预下载 已有代理不动端点启动前设好代理变量然后照核心路径第 2 步操作export HTTPS_PROXYhttp://127.0.0.1:7890 export HTTP_PROXYhttp://127.0.0.1:7890完全无外网在外网机用项目自带的预下载脚本把模型落到可移动目录git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz BUZZ_MODEL_ROOT/移动盘/buzz-models uv run python scripts/download-models.py --model-type whispercpp --model-size medium内网机器把BUZZ_MODEL_ROOT指向同一目录buzz/buzz.py 启动时会据此同步HF_HOME程序即直接使用本地模型全程不触网。脚本还支持--model-type whisper fasterwhisper与一次传多个--model-size一条命令可覆盖团队全部需求。确认效果前后速度对比与模型校验 ✅同样拉完 1.5GB 的 medium 模型耗时对比同一网络环境实测走法实际速度耗时适用直连 Hugging Face约 100KB/s约 4 小时—镜像端点核心路径约 10MB/s约 2.5 分钟国内网络代理备路2–5MB/s5–12 分钟已有代理离线预下载备路本地拷贝数秒无外网内网三种校验方式任过其一即可体积校验ls -lh缓存目录下对应.bin文件medium 显示 1.4GB 属正常——程序按预期尺寸的 95% 阈值判定逻辑在 buzz/model_loader.py。标记校验ls快照目录出现.buzz_complete才算完整。界面校验主界面模型下拉框该模型显示已下载点转录直接进入识别不再弹下载框。想读下载实现本身看这三个文件buzz/model_loader.py下载、断点续传、SHA256 校验、scripts/download-models.py离线预下载、buzz/buzz.py缓存路径初始化。常见坑速查 ⚠️进度条长时间不动最后弹连接错误→ 国际链路中断 → 直接再点下载HF 缓存支持断点续传不用删文件。下载完成但界面仍显示未下载→ 快照目录缺.buzz_complete标记 → 删掉对应models--*缓存目录重下一次。Windows 日志出现 [WinError 1314]→ 无符号链接权限程序自带拷贝兜底 → 打开系统开发者模式或忽略日志等自动兜底完成。日志反复出现 429 / 限流报错→ Hugging Face 限流程序自动重试 3 次5 秒、10 秒退避 → 仍失败就切到核心路径的镜像端点。到这里Buzz 的模型下载从 4 小时缩到 2.5 分钟下次转录直接选模型点开始。若你遇到 MMS 多语言模型等其他下载场景欢迎带着问题到项目社区发帖看看大家各有什么解法。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考