Voicebox本地声音克隆：4步跑通安装与首次运行

Voicebox本地声音克隆4步跑通安装与首次运行【免费下载链接】voiceboxThe open-source AI voice studio. Clone, dictate, create.项目地址: https://gitcode.com/GitHub_Trending/voicebox1/voiceboxVoicebox 是一款本地优先的开源免费 AI 语音工作室能把几秒音频克隆成可用声音再离线生成语音。本文覆盖 macOS、Windows、Linux/Docker 三条安装路线以及首次运行最常见的报错按顺序走完你能在 10 分钟内拿到第一段自己生成的语音。第一步装之前先确认三件事系统版本macOS 11 / Windows 10 / 较新的 Linux 发行版源码构建另需 Python 3.12just setup会固定这个版本。硬件最低 8GB 内存、5GB 可用磁盘推荐 16GB 内存和 NVIDIA GPU生成需要 6GB 显存。网络首次生成会自动从 HuggingFace 下载模型约 350MB 到 8GB网络受限会卡住见第三步处理。平台推荐方式耗时估算备注macOSDMG 安装2 分钟注意芯片架构选 aarch64 或 x64WindowsMSI 安装2 分钟可能触发 SmartScreenLinuxDocker 容器5-10 分钟首次构建需编译前端开发者源码构建15-30 分钟需 Rust、just、Bun安装文档第二步按你的平台走对应路线macOS 路线官方安装包含 GPU 加速后端从 Releases 下载对应芯片的 DMG拖入 Applications。首次双击若提示App 已损坏属正常隔离在终端执行一行命令解除xattr -cr /Applications/Voicebox.app再打开即可。Apple Silicon 上后端会自动使用 MLX比 PyTorch 快 4-5 倍无需手动配置。Windows 路线官方安装包下载voicebox_x64_en-US.msi双击按向导安装。SmartScreen 蓝屏提示未知应用是未签名应用的正常拦截点更多信息再点仍要运行10 秒过。有 NVIDIA 显卡的用户在 Settings → GPU 里确认安装了 CUDA 后端否则生成会退回 CPU速度差 5-10 倍。Linux / Docker 路线容器化部署Linux 暂无官方桌面安装包容器是最省事的走法浏览器直接访问完整界面。在仓库目录执行git clone https://gitcode.com/GitHub_Trending/voicebox1/voicebox cd voicebox docker compose up首次构建要几分钟编译前端 装 Python 依赖之后秒开浏览器打开http://localhost:17493即可。想走源码构建就装好just和 Bun 后依次跑just setup、just build产物在tauri/src-tauri/target/release/bundle/。第三步首次启动看到红灯别慌左下角状态灯变绿才算后端就绪。红灯或卡住时先对照下表处理你看到的现象一步到位的处理动作App is damaged, cant be opened终端执行xattr -cr /Applications/Voicebox.appSmartScreen已保护你的电脑点更多信息→仍要运行Failed to connect to server查 17493 端口占用 → 补执行权限 → 看日志进度停在 Downloading...换小模型Kokoro ~350MB或挂代理CUDA out of memory关占显存应用或 Settings → Generation 切 CPUDatabase is locked退出所有实例删除 data 目录的-wal/-shm文件端口冲突是最常见的红灯根因。后端固定在 17493 端口被别的实例占住就起不来lsof -i :17493 # macOS / Linux taskkill /PID PID /F # 确认 PID 后在 Windows 结束进程权限与日志macOS/Linux 上服务二进制可能缺执行权限chmod x ~/Library/Application\ Support/sh.voicebox.app/backend/voicebox-server即可日志在~/Library/Application\ Support/sh.voicebox.app/logs/server.logtail -f跟进才能看到真正的崩溃原因。Windows 对应%APPDATA%\sh.voicebox.app\logs\server.log。模型缓存首次生成慢不是故障是引擎在自动下载模型。进度在 Settings → Models 查看Docker 用户若每次重启都重新下载检查huggingface-cache卷是否保留。日志里出现Warning: flash-attn is not installed可以安全忽略——它是可选加速库缺省时 PyTorch 自动改用 SDPA 注意力速度几乎无损。完整排障文档第四步验证你真的装好了启动应用左下角状态灯为绿色说明内置后端已连上。创建测试语音档案进 Voices 页点 New Voice上传或录制 10-30 秒清晰音频背景噪声越少克隆越准。生成一段语音切到 Generate 页选刚建的档案输入一句话点 Generate。能听到声音即安装成功音频会同步进 History 列表。附录常用路径与快捷命令服务日志macOS~/Library/Application Support/sh.voicebox.app/logs/server.logWindows%APPDATA%\sh.voicebox.app\logs\server.log数据目录档案 生成音频备份认准它macOS~/Library/Application Support/sh.voicebox.app/、Windows%APPDATA%\sh.voicebox.app\、Linux~/.config/sh.voicebox.app/模型缓存~/.cache/huggingface/可用环境变量VOICEBOX_MODELS_DIR自定义查端口占用lsof -i :17493macOS/Linux健康检查curl http://127.0.0.1:17493/healthAPI 文档浏览器访问http://127.0.0.1:17493/docs手动下载模型pip install huggingface_hub后huggingface-cli download Qwen/Qwen3-TTS-12Hz-1.7B-Base【免费下载链接】voiceboxThe open-source AI voice studio. Clone, dictate, create.项目地址: https://gitcode.com/GitHub_Trending/voicebox1/voicebox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考