不折腾网络搞定 Buzz 音频转录的模型下载卡顿：三条路线一次跑通

不折腾网络搞定 Buzz 音频转录的模型下载卡顿三条路线一次跑通【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzzBuzz 是基于 Whisper 的本地音频转录工具你导入音频准备转录模型下载进度条却卡在 0% 或中途断掉。这里给 3 条可落地路线镜像加速、手动导入、代理加速选一条十分钟跑通。 先定位卡点进度条卡在 0% 或只有几十 KB/s等十分钟不动下载到一半中断重连时报错缓存目录里留了个不完整的文件下载完成后模型页仍显示未下载任务里选这个模型直接报错添加任务时长时间停在正在加载模型最终提示连接被重置或超时本质上都是模型文件存放在境外源站直连链路不稳下载走不完或走不完整。️ 路线对比先选再动手路线适合谁操作成本A. HF_ENDPOINT 镜像加速下载 Whisper.cpp / Faster Whisper 模型卡住的多数人一行环境变量约 2 分钟B. 手动下载 注册自定义模型网络特别复杂能拿到模型文件就行中等约 10 分钟C. 系统代理加速已有稳定本地代理的用户一行环境变量约 2 分钟拿不准就先走路线 A因为改动最小、官方文档直接支持且不动任何本地文件。️ 动手实操路线 AHF_ENDPOINT 镜像加速下载 HF 系模型最省事前置条件Buzz 已能启动Python 依赖装好即可无需管理员权限。如果还没拿到 Buzz 代码先克隆仓库git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz在同一个终端里设置镜像环境变量export HF_ENDPOINThttps://hf-mirror.comWindows 用 PowerShell改成$env:HF_ENDPOINThttps://hf-mirror.com仍在该终端启动 Buzz进入 偏好设置 → 模型 页点目标模型旁的下载按钮python main.py原理一句话HF_ENDPOINT 把 huggingface_hub 的下载流量整体指到镜像站官方文档 docs/docs/preferences.md 就明确推荐国内用这个变量提速。环境变量只在当前终端生效从桌面快捷方式启动等于没设回到设过变量的终端再python main.py。模型类型选的是 WhisperPyTorch 版时该镜像不覆盖它的下载源换路线 C。路线 B手动下载 注册自定义模型只要能拿到文件就行前置条件一个可用的模型文件如 ggml-tiny.bin约 75MB来源不限Buzz 图形界面可正常打开。用你顺手的下载工具IDM、aria2 等把 ggml-tiny.bin 存到本地任意目录确认文件完整# 检查文件大小tiny 应约 75 MB ← 换成你的文件路径 ls -lh ~/Downloads/ggml-tiny.bin打开 Buzz按 Ctrl, 进入偏好设置 → 模型在 Whisper.cpp 的自定义模型区输入一个名称指向刚下载的 .bin 文件。新增转录任务时把模型类型选成 Whisper.cpp刚才填的名称会出现在模型大小下拉框里选它即可转录。原理一句话自定义模型完全跳过从 HF 源站拉取这一步Buzz 只读本地文件网络通不通都无所谓。下拉框里没有自定义模型模型类型没选 Whisper.cpp只有这个类型才列出自定义项。启动转录报加载失败文件不完整重新下载等大小对上再注册。路线 C代理环境变量已有稳定代理直接走前置条件本机有一个可用的 HTTP(S) 代理客户端。在终端导出代理环境变量export HTTPS_PROXYhttp://127.0.0.1:7890 # ← 换成你的代理地址和端口 export HTTP_PROXYhttp://127.0.0.1:7890在同一终端启动 Buzz正常下载模型对比速度python main.py原理一句话Buzz 的模型下载都经由 requests / huggingface_hub 发起二者会自动读取 HTTP_PROXY 和 HTTPS_PROXY整条下载链路直接走代理。浏览器走代理正常但 Buzz 不走确认环境变量和启动 Buzz 在同一个终端且代理客户端已放行 HTTPS。走代理后报 SSL 证书错误先确认代理客户端本身能翻 HTTPS 站点再重试下载。⚡ 让效率再高一档先用 tiny 跑通再升级。tiny 只有约 75MB最不容易下载失败确认整条流程没问题后再回 偏好设置 → 模型 页把 base、small 依次拉下来转录参数一行都不用改。命令行批处理整批音频。模型下好之后批量任务不用再逐条点界面buzz add -m whispercpp -s tiny --srt --txt --hide-gui ./audio/*.mp3--hide-gui让窗口收起来终端里安静跑完字幕和纯文本一起产出。给模型目录换个家。模型默认存在用户缓存目录主分区紧张时挪到大盘export BUZZ_MODEL_ROOT/data/buzz-models # ← 换成你的磁盘路径设置生效后再下载都会落进新目录想清旧模型直接在 偏好设置 → 模型 页点打开位置按钮进缓存目录删。❓ 踩坑速查Q下载断了一半要不要删了从头来不用。下载流程支持断点续传删掉反而浪费时间。直接再点一次下载按钮已落盘的部分会被接着写。Q下载完了模型页为什么还显示未下载多半是文件比预期小、被判定不完整校验逻辑见 buzz/model_loader.py。进缓存目录把那个半截文件删掉重新下载一次即可。Q我注册的自定义模型实时录音转录也能用吗能。录音任务把模型类型选成 Whisper.cpp自定义模型同样出现在下拉框里和文件转录共用一份缓存。Q旧模型占了几个 GB能直接删吗能。模型随时可重下删除不影响已生成的转录结果。用模型页的打开位置按钮找到目录删掉不用的 .bin 文件就行。把镜像变量配上用 tiny 模型先把第一段音频转出来后面要批量处理时直接照抄命令行那条命令。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考