3条路径跑通Buzz离线语音转录从模型下载超时到出转录结果【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz进度条卡在0%弹窗弹出 ConnectionError下了一半的 Whisper 模型文件又得从头再来——这是 Buzz 离线语音转录卡在模型下载时最常见的现场。这篇文章把从克隆仓库到出转录结果的路径拆开讲三种网络环境下各有一条可直接执行的路线。快速诊断Buzz 模型下载卡在哪个环节对号入座先判断你属于哪种情况如果看到ConnectionError或ConnectTimeout大概率是直连 Hugging Face 的链路不通属于网络层问题优先走下面的代理或镜像路线。如果看到ReadTimeout、进度条长时间不动连接建立了但跨国链路限速文件会越下越慢甚至中途断掉属于带宽问题换个出口比重试有用。如果文件下完了但启动时仍提示要下载或模型尺寸明显偏小多半是上次中断留下的残缺缓存。项目里用.buzz_complete标记文件表示下载完成没这个标记的文件等于没下完删掉缓存重下即可。如果报LocalEntryNotFoundErrorBuzz 在本地模型目录里没找到对应模型文件通常是手动放置的路径不对对照下面第二条路线检查。按场景选方案三条路线各有一个明确的使用前提先判断自己属于哪类再看对应小节。路线上手成本下载耗时稳定程度适合谁镜像仓库克隆低短高想最快跑起来的普通用户手动下载 指定路径中自控高网络环境复杂、需要完全掌控代理/环境变量中取决于代理中已有稳定代理的技术用户如果你只是想快点跑起来直接克隆国内镜像仓库模型下载走的是仓库内的网络不再依赖直连国外站点# 克隆镜像仓库 git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz # 安装依赖要求 Python 3.12项目锁定 3.12,3.13 pip install -e . # 启动 python main.py注意 Python 版本这条别跳过3.10、3.13 装依赖都会出问题。如果你的网络环境比较特殊手动把模型文件弄到本地缓存目录再让 Buzz 指过去。缓存目录由platformdirs按平台生成固定是Buzz/models子目录Windows%LOCALAPPDATA%\Buzz\modelsmacOS~/Library/Caches/Buzz/modelsLinux~/.cache/Buzz/models在 Buzz 的偏好设置 → 模型页里Whisper、Whisper.cpp、Faster Whisper 这几类模型都支持手动下载源码里对应is_manually_downloadable。另外还有一个隐藏开关BUZZ_MODEL_ROOT环境变量可以整体覆盖模型根目录见 buzz/model_loader.py适合把模型放到大容量磁盘上。如果你已经有代理让 Buzz 走代理下载在启动前设置环境变量即可。Linux/macOSexport HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890 python main.pyWindows PowerShell$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890 python main.py项目文档里还记录了一个针对国内环境的选项HF_ENDPOINT指向 hf-mirror 镜像端点和代理二选一详见 docs/docs/preferences.md。从克隆到出结果的完整走一遍按顺序执行每步只看一个成功标志。① 装环境执行上面第一条路线的命令块。看到Successfully installed字样就算通过此时不用急着启动。② 首次启动选模型运行python main.py。首次运行会弹出模型选择第一次建议选 Tiny 或 Base——Tiny 约 73MB、Base 约 139MB先让全链路通起来大模型随时可以后补。③ 建转录任务把音频拖进主界面任务表格里选好模型、语言勾选后任务开始排队。任务列表和状态都在这里管理④ 查看结果任务跑完后双击打开查看器带时间戳的文本就是最终产物支持导出 TXT、SRT、VTT 等格式看到带时间戳的文本出来的那一刻就说明从模型加载到解码的全链路是通的。踩过的坑 排查手册⚠️Windows 上下载卡死不动别急着杀进程。huggingface_hub 的并行下载在 Windows 上有文件锁竞争代码里对 Windows 已经做了降级处理改用串行文件拷贝见 buzz/model_loader.py 的打补丁逻辑先给它 5~10 分钟多数情况会自己动。文件下了一半重启后又从头下这是残缺缓存不是 Buzz 的问题。定位到对应平台的Buzz/models目录删掉该模型对应的子目录再重新触发下载有.buzz_complete标记的才是完整文件。怎么判断文件是不是残缺代码里维护了各档模型的预期体积WHISPER_MODEL_SIZEStiny 约 73MB、base 约 139MB、small 约 462MB、medium 约 1.5GB、large 约 2.9GB。本地文件比预期小一截就是没下完。任务列表莫名清空Buzz 的任务缓存在tasks.json里JSON 解析失败时代码会自动重置缓存而不是崩溃属于自恢复行为重新建任务就行不用手动清文件。⚠️设置了代理却没生效确认环境变量和python main.py在同一个 shell 会话里。新开终端环境变量就没了可以先curl -I https://huggingface.co验证代理是否真的通。让转录更快的几个点按场景换模型实时转录、大批量先跑通用 Tiny/Base要精度就上 Medium 或 Large-v3-turbo——turbo 版只有约 1.6GB比 Large约 2.9GB小一半还多解码速度也快。确认 GPU 加速真的开了打开任务的高级设置看 Device 选项里有没有 CUDANVIDIA或 CoreMLApple Silicon。只有 CPU 的话检查 CUDA 环境项目里有对应的初始化脚本 buzz/cuda_setup.py。批量文件别手动拖偏好设置有文件夹监控选项目录里新增音频会自动进任务队列适合丢一晚上、早上收结果的用法。自动化场景走 CLIdocs/docs/cli.md 描述了命令行用法脚本里调用比模拟点击界面稳定得多。延伸材料安装与系统依赖docs/docs/installation.md模型下载与缓存核心逻辑buzz/model_loader.py各类偏好设置含 HF_ENDPOINTdocs/docs/preferences.md各转录引擎实现buzz/transcriber/如果还卡在某一步把完整报错贴出来比多试十遍都管用。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3条路径跑通Buzz离线语音转录：从模型下载超时到出转录结果
3条路径跑通Buzz离线语音转录从模型下载超时到出转录结果【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz进度条卡在0%弹窗弹出 ConnectionError下了一半的 Whisper 模型文件又得从头再来——这是 Buzz 离线语音转录卡在模型下载时最常见的现场。这篇文章把从克隆仓库到出转录结果的路径拆开讲三种网络环境下各有一条可直接执行的路线。快速诊断Buzz 模型下载卡在哪个环节对号入座先判断你属于哪种情况如果看到ConnectionError或ConnectTimeout大概率是直连 Hugging Face 的链路不通属于网络层问题优先走下面的代理或镜像路线。如果看到ReadTimeout、进度条长时间不动连接建立了但跨国链路限速文件会越下越慢甚至中途断掉属于带宽问题换个出口比重试有用。如果文件下完了但启动时仍提示要下载或模型尺寸明显偏小多半是上次中断留下的残缺缓存。项目里用.buzz_complete标记文件表示下载完成没这个标记的文件等于没下完删掉缓存重下即可。如果报LocalEntryNotFoundErrorBuzz 在本地模型目录里没找到对应模型文件通常是手动放置的路径不对对照下面第二条路线检查。按场景选方案三条路线各有一个明确的使用前提先判断自己属于哪类再看对应小节。路线上手成本下载耗时稳定程度适合谁镜像仓库克隆低短高想最快跑起来的普通用户手动下载 指定路径中自控高网络环境复杂、需要完全掌控代理/环境变量中取决于代理中已有稳定代理的技术用户如果你只是想快点跑起来直接克隆国内镜像仓库模型下载走的是仓库内的网络不再依赖直连国外站点# 克隆镜像仓库 git clone https://gitcode.com/GitHub_Trending/buz/buzz cd buzz # 安装依赖要求 Python 3.12项目锁定 3.12,3.13 pip install -e . # 启动 python main.py注意 Python 版本这条别跳过3.10、3.13 装依赖都会出问题。如果你的网络环境比较特殊手动把模型文件弄到本地缓存目录再让 Buzz 指过去。缓存目录由platformdirs按平台生成固定是Buzz/models子目录Windows%LOCALAPPDATA%\Buzz\modelsmacOS~/Library/Caches/Buzz/modelsLinux~/.cache/Buzz/models在 Buzz 的偏好设置 → 模型页里Whisper、Whisper.cpp、Faster Whisper 这几类模型都支持手动下载源码里对应is_manually_downloadable。另外还有一个隐藏开关BUZZ_MODEL_ROOT环境变量可以整体覆盖模型根目录见 buzz/model_loader.py适合把模型放到大容量磁盘上。如果你已经有代理让 Buzz 走代理下载在启动前设置环境变量即可。Linux/macOSexport HTTP_PROXYhttp://127.0.0.1:7890 export HTTPS_PROXYhttp://127.0.0.1:7890 python main.pyWindows PowerShell$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890 python main.py项目文档里还记录了一个针对国内环境的选项HF_ENDPOINT指向 hf-mirror 镜像端点和代理二选一详见 docs/docs/preferences.md。从克隆到出结果的完整走一遍按顺序执行每步只看一个成功标志。① 装环境执行上面第一条路线的命令块。看到Successfully installed字样就算通过此时不用急着启动。② 首次启动选模型运行python main.py。首次运行会弹出模型选择第一次建议选 Tiny 或 Base——Tiny 约 73MB、Base 约 139MB先让全链路通起来大模型随时可以后补。③ 建转录任务把音频拖进主界面任务表格里选好模型、语言勾选后任务开始排队。任务列表和状态都在这里管理④ 查看结果任务跑完后双击打开查看器带时间戳的文本就是最终产物支持导出 TXT、SRT、VTT 等格式看到带时间戳的文本出来的那一刻就说明从模型加载到解码的全链路是通的。踩过的坑 排查手册⚠️Windows 上下载卡死不动别急着杀进程。huggingface_hub 的并行下载在 Windows 上有文件锁竞争代码里对 Windows 已经做了降级处理改用串行文件拷贝见 buzz/model_loader.py 的打补丁逻辑先给它 5~10 分钟多数情况会自己动。文件下了一半重启后又从头下这是残缺缓存不是 Buzz 的问题。定位到对应平台的Buzz/models目录删掉该模型对应的子目录再重新触发下载有.buzz_complete标记的才是完整文件。怎么判断文件是不是残缺代码里维护了各档模型的预期体积WHISPER_MODEL_SIZEStiny 约 73MB、base 约 139MB、small 约 462MB、medium 约 1.5GB、large 约 2.9GB。本地文件比预期小一截就是没下完。任务列表莫名清空Buzz 的任务缓存在tasks.json里JSON 解析失败时代码会自动重置缓存而不是崩溃属于自恢复行为重新建任务就行不用手动清文件。⚠️设置了代理却没生效确认环境变量和python main.py在同一个 shell 会话里。新开终端环境变量就没了可以先curl -I https://huggingface.co验证代理是否真的通。让转录更快的几个点按场景换模型实时转录、大批量先跑通用 Tiny/Base要精度就上 Medium 或 Large-v3-turbo——turbo 版只有约 1.6GB比 Large约 2.9GB小一半还多解码速度也快。确认 GPU 加速真的开了打开任务的高级设置看 Device 选项里有没有 CUDANVIDIA或 CoreMLApple Silicon。只有 CPU 的话检查 CUDA 环境项目里有对应的初始化脚本 buzz/cuda_setup.py。批量文件别手动拖偏好设置有文件夹监控选项目录里新增音频会自动进任务队列适合丢一晚上、早上收结果的用法。自动化场景走 CLIdocs/docs/cli.md 描述了命令行用法脚本里调用比模拟点击界面稳定得多。延伸材料安装与系统依赖docs/docs/installation.md模型下载与缓存核心逻辑buzz/model_loader.py各类偏好设置含 HF_ENDPOINTdocs/docs/preferences.md各转录引擎实现buzz/transcriber/如果还卡在某一步把完整报错贴出来比多试十遍都管用。【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考