Buzz 模型下载总卡住一行镜像配置让下载全程加速【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是一款在本机离线完成音频转文字、翻译的工具靠 OpenAI Whisper 引擎在你自己的电脑上工作。很多人卡住的地方不在使用而在第一次下载模型文件从几十 MBtiny到数 GBlarge不等国内网络下进度条长时间不动或者中途直接报错。问题的根源是模型默认直接从 Hugging Face 拉取而把它改道到国内镜像只需一行环境变量不用改任何源码。加速原理为什么一行环境变量就够Buzz 里各离线引擎Whisper.cpp、Faster Whisper、Hugging Face的模型统一由huggingface_hub库的snapshot_download函数从 Hugging Face 下载实现位于 buzz/model_loader.py。snapshot_download可以理解为把某个模型仓库里的文件一次拉全落到本地缓存目录。关键在这个库自身的机制它访问哪个端点由HF_ENDPOINT环境变量决定即库用哪个域名去连 Hugging Face。把这个变量指向国内镜像站所有模型请求就都走镜像了。官方文档 docs/docs/preferences.md 也把这条列为国内用户的推荐做法。下载流程本身还有容错设计配合镜像效果更稳。buzz/model_loader.py 里的重试参数SNAPSHOT_DOWNLOAD_ATTEMPTS 3 SNAPSHOT_DOWNLOAD_RETRY_DELAY 5 # seconds, doubled after each failed attempt也就是说失败后会自动重试最多 3 次等待间隔依次是 5 秒、10 秒。已经下到一半的字节会留在缓存里重试只补传缺失的部分不会从头再来。全部文件下载成功后Buzz 会在模型快照目录里写一个.buzz_complete标记文件界面正是靠这个标记把模型显示为Downloaded已下载。开始前的四项自检动手之前花一分钟确认这 4 项即可Buzz 已装好源码安装git clone https://gitcode.com/GitHub_Trending/buz/buzz再执行pip install -e .知道模型目录位置Linux 默认是~/.cache/Buzz/modelsWindows、macOS 在各自的系统缓存目录磁盘留有空间medium 约 1.5 GB、large 约 2.9 GB见 buzz/model_loader.py 的规格大小表tiny 系列则只有几十 MB手边有一个带宽正常的终端会话全程约 515 分钟取决于所选规格配置镜像的操作流程第 1 步同一会话里设变量、启动 Buzz镜像变量只对当前终端会话生效所以必须在启动 Buzz 之前的那个终端里设置。Linux / macOSexport HF_ENDPOINThttps://hf-mirror.com python -m buzzWindows PowerShell$env:HF_ENDPOINT https://hf-mirror.com然后从同一窗口启动 Buzz。预期结果终端无报错Buzz 界面正常弹出。⚠️ 如果你是从桌面快捷方式点开的 Buzz它读不到这个终端变量必须回到同终端启动或把变量设为系统级。第 2 步在模型设置里选引擎和规格点 Download打开菜单 Preferences偏好设置→ Models模型Group 选 Whisper.cpp模型列表选 Tiny点 Download。预期结果弹出进度对话框。Whisper.cpp 这类引擎不显示百分比、只转圈显示 Downloading model属正常设计完成后模型从 Available for Download 分组移入 Downloaded 分组Download 按钮消失。第 3 步查看模型目录确认文件落盘ls ~/.cache/Buzz/models/预期结果出现models--ggerganov--whisper.cpp这类缓存目录此后每次启动 Buzz该模型都在 Downloaded 分组下不再重复下载。怎么确认模型真的下载成功了界面看起来正常不算数按下面三层验收三层全过才算真正完成界面层Models 列表里所选模型位于 Downloaded 分组Delete 按钮可用。标记层标记文件存在说明下载流程完整走完。find ~/.cache/Buzz/models -name .buzz_complete有输出即通过。大小层进入对应快照目录Whisper.cpp 的模型文件形如ggml-tiny.bin与 Hugging Face 仓库同名文件的大小量级对比一下明显偏小就是没下完删掉重新点 Download 即可。检查项未生效生效Models 列表分组模型在 Available for Download模型在 Downloaded缓存目录没有models--*目录或目录里没有模型文件有models--*目录且含模型文件.buzz_complete标记find无输出find有输出不走界面的三种替代做法离线 / 内网机器项目自带预下载脚本 scripts/download-models.py在联网机器上拉好模型再把目录分发过去BUZZ_MODEL_ROOT既指定下载位置也决定 Buzz 去哪里找模型BUZZ_MODEL_ROOT/data/buzz-models python scripts/download-models.py --model-type whispercpp --model-size tiny复用 Hugging Face 缓存Buzz 启动时会把HF_HOMEhuggingface_hub的缓存根目录定义在 buzz/buzz.py默认设为~/.cache/Buzz。所以用 Hugging Face 的命令行工具把模型下到~/.cache/BuzzBuzz 无需任何设置就能直接命中这些缓存。单文件手动放置从所选引擎的模型仓库文件列表里自行下载对应的.bin如ggml-tiny.bin在 Models 界面选 Whisper.cpp → Custom填入文件链接由 Buzz 自行抓取。问题速查Q1设置了HF_ENDPOINT下载速度却没变化。原因变量没作用到 Buzz 进程上常见于从 GUI 快捷方式启动——它读不到终端会话的变量。排查在启动 Buzz 的那个终端里执行echo $HF_ENDPOINTPowerShell 用$env:HF_ENDPOINT无输出说明没设上解决回到同一终端启动或把变量设为系统级环境变量后重启应用。Q2进度条一直转圈分不清是慢还是卡死。排查连跑两次du -sh ~/.cache/Buzz/models目录大小还在增长就是慢不是死。Whisper.cpp / Faster Whisper / Hugging Face 引擎的进度框不显示百分比是设计如此见 buzz/widgets/model_download_progress_dialog.py转圈不等于异常。Q3之前下载失败过重试又报错或文件对不上。原因缓存里残留的未完成文件与标记文件在捣乱。排查删掉缓存中未完成的模型文件和.buzz_complete标记再重试也可以直接在 Models 界面重新点 Download——重试只补传缺失部分不必删除整个缓存目录。一句话收尾HF_ENDPOINT负责把请求改道镜像标准下载流程负责把模型搬进缓存界面分组、.buzz_complete标记和文件大小三层验收负责告诉你结果——模型下载卡住的问题到这里就闭环了。更多环境变量与模型目录的细节可查官方文档 docs/docs/preferences.md。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考