
Buzz 本地音频转写完整指南10 分钟装好离线转录【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz把会议录音、访谈音频发到云端转写既担心隐私外泄又怕网络一抖就中断。Buzz 是一款基于 OpenAI Whisper 的离线音频转录工具装在自己电脑上转写、翻译、实时字幕全部本地完成数据不出门。读完这篇文章你能做到3 步在 Windows / macOS / Linux 任一系统装好 Buzz10 分钟内跑通第一条音频文件的转录在偏好设置里下载、管理不同尺寸的 Whisper 模型写一个启动脚本把线程数、模型路径、显存策略一次性锁定自查修复转录慢、模型下载失败、麦克风无权限这 3 类高频问题动手之前Buzz 系统要求一览表Buzz 的硬性门槛是 CPU 必须支持AVX2指令集很老的机器不支持其余按下表对号入座即可系统最低要求推荐配置备注WindowsWindows 10 64 位AVX2 支持16GB 内存 NVIDIA 显卡CUDA 12安装包未签名首次安装需点仍要运行macOSmacOS 11Intel 或 Apple SiliconApple Silicon 16GB 内存两种芯片都有官方安装包Linux64 位发行版Ubuntu 20.04AVX216GB 内存需预装libportaudio2、ffmpeg没有独显也能跑Whisper.cpp 引擎支持 CPU 和集显Vulkan新款笔记本集显都能做到实时转录。按平台选路3 步装好 Buzz不用把三种方式都试一遍按你所在平台选推荐路线就行备选路线留给有特殊需求的场景。Windows 用户推荐下载官方.exe安装包双击安装。弹出未识别的应用警告是正常的——官方包未签名选More info→Run anyway即可备选从源码装适合想尝鲜开发版的人git clone https://gitcode.com/GitHub_Trending/buz/buzz开发版还需要本地编译 Whisper.cpp 组件仓库根目录的 Makefile 和 CONTRIBUTING 文档里有完整步骤。macOS 用户推荐下载官方.dmg拖进 ApplicationsIntel 和 Apple Silicon 版本通用备选PyPI 安装见下方 Linux 备选命令相同Linux 用户推荐Flatpak 一条命令装好flatpak install flathub io.github.chidiwilliams.Buzz备选Snap先补音频依赖再装sudo apt-get install libportaudio2 libcanberra-gtk-module libcanberra-gtk3-module sudo snap install buzz备选PyPI要求 Python 3.12 环境需先装好 ffmpegpip install buzz-captions python -m buzz第一次跑通10 分钟完成首条转录图形界面路径最直观启动 Buzz把音频文件拖进主界面支持 mp3/wav/mp4 等常见格式也支持粘贴网页链接在任务里选择模型类型和尺寸。首次使用会自动下载对应模型之后不再联网等待进度条走完在转录查看器中对照音频逐句查看文本成功的标志查看器里出现带时间戳的逐句转录文本点击任意一句能跳到音频对应位置如果勾选了导出文件旁边会生成.txt/.srt/.vtt。命令行路径适合批处理和脚本化buzz add -m whispercpp -s tiny --txt audio.wav这一行的作用用 Whisper.cpp 的 tiny 模型转录audio.wav并导出 TXT 文件模型未下载时会自动拉取。更多参数翻译任务、语言、词级时间戳、隐藏界面见 docs/docs/cli.md。换配置换模型环境变量速查表模型下载走图形界面最省事按Ctrl/Cmd ,打开偏好设置 → Models 页签 → 选引擎Whisper / Whisper.cpp / Faster Whisper / HuggingFace→ 选尺寸 → 点 Download。Whisper.cpp 还支持在尺寸里选 Custom 并粘贴.bin模型直链可以装社区提供的量化版或语言特化版模型。模型默认存在系统缓存目录Linux~/.cache/Buzz、macOS~/Library/Caches/Buzz、Windows%USERPROFILE%\AppData\Local\Buzz\Buzz\Cache磁盘紧张或想统一管理时用下表的环境变量微调。变量在启动 Buzz 之前设置即可也可以写进启动脚本一劳永逸场景参数建议值模型换存储目录默认盘满 / 多项目共用BUZZ_MODEL_ROOT如/data/models建议同时设HF_HOME到同一目录Whisper.cpp 转录偏慢想手动调并发BUZZ_WHISPERCPP_N_THREADS默认是核心数的一半笔记本从 8 起步步进 2 逐个试旧显卡比 CPU 还慢 / GPU 报错BUZZ_FORCE_CPUtrue显存不够装不下大模型BUZZ_REDUCE_GPU_MEMORYtrue自动用 8bit 量化压缩模型常用语言太多想固定几个在最前BUZZ_FAVORITE_LANGUAGES逗号分隔语言码如en,zh,ja下载私有视频被反爬拦截BUZZ_DOWNLOAD_COOKIEFILE指向 cookies.txt 文件不想上报基础使用统计BUZZ_DISABLE_TELEMETRYtrue内网机器不想检查更新BUZZ_DISABLE_UPDATE_CHECKtrue固定默认引擎和尺寸省得每次选BUZZ_DEFAULT_MODEL_TYPE/BUZZ_DEFAULT_MODEL_SIZE如whispercpp/smallTXT 导出的段落切分阈值BUZZ_PARAGRAPH_SPLIT_TIME默认2000毫秒静音启动脚本模板macOS / Linux 存为run_buzz.shWindows 存为run_buzz.bat把set换成export即可echo off set BUZZ_MODEL_ROOTD:\models set BUZZ_WHISPERCPP_N_THREADS8 C:\Program Files (x86)\Buzz\Buzz.exe作用每次启动都带上这些配置避免重复设置。变量全集和详细说明见 docs/docs/preferences.md。提速调优4 种让转录变快的办法目标手段可复现的收益Whisper.cpp 转录偏慢设BUZZ_WHISPERCPP_N_THREADS为核心数一半以 2 为步长上下试官方在 16 线程笔记本上实测设为 8 提速约 15%再加反而更慢同硬件想再快一档换引擎原版 Whisper → Faster Whisper需 NVIDIA 显卡 ≥6GB 显存或 Whisper.cppCPU / 集显 / 任意 GPUFaster Whisper 比原版快数个数量级Whisper.cpp 在集显笔记本上也能实时转录大模型爆显存BUZZ_REDUCE_GPU_MEMORYtrue或改用 Whisper.cpp 的 q5 量化模型8bit 量化显著压低显存占用模型文件也更小大批量长音频先 tiny / base 模型出粗稿重点段落再上 medium / large 精转小模型单句耗时明显更短按段落精度分级处理最划算另外两个容易忽略的点转录速度瓶颈在计算而非硬盘买更快的 SSD 没用如果你在国内网络环境下载模型慢参考 docs/docs/faq.md 中关于HF_ENDPOINT镜像的设置。排错速查高频 6 坑的解法现象可能原因解法模型下载进度条卡死 / 报网络错误网络不稳、目标站点有反爬校验设BUZZ_DOWNLOAD_COOKIEFILE提供 cookies或手动下载模型文件放进模型缓存目录装完模型后 Buzz 崩溃 / 转录中途挂掉模型文件下载不完整或损坏在 Models 设置页删除该模型重新下载仍不行就用 帮助 → About Buzz → Show logs 看日志定位无法录音报Unanticipated host error (PaErrorCode-9999)系统隐私设置或杀毒软件拦截麦克风Windows 到 设置 → 隐私 → 麦克风 允许 Buzz临时禁用杀毒软件测试一轮老电脑启动即崩溃或提示指令不支持CPU 缺少 AVX2这是硬件门槛无软件解法换机或升级 CPUWindows 安装时警告未识别的应用官方安装包未签名点 More info → Run anyway属正常现象Linux 下 NVIDIA 显卡没被利用CUDA / cuBLAS / cuDNN 环境缺失Linux 对 NVIDIA 开箱即用有报错时补装 CUDA 12 全家桶收个尾到这里你的音频已经能全程在自己机器上完成转写和翻译不传云端、不依赖网络断网也能干活。想继续深入三个方向都值得试插件扩展plugins/ 下的 AI 摘要、自动重排字幕等插件能直接把长转录加工成会议纪要CLI 自动化用buzz add结合目录监控实现丢进文件夹就自动转的流水线直播字幕设BUZZ_UPLOAD_URL把实时转录结果推到网页端适合线下活动大屏显示【免费下载链接】buzzBuzz transcribes and translates audio offline on your personal computer. Powered by OpenAIs Whisper.项目地址: https://gitcode.com/GitHub_Trending/buz/buzz创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考