MockingBird

环境要求

• Python 3.7 或更高版本（遇到 torch 安装失败建议改用 Python 3.9）
• 已安装 PyTorch（推荐 Repo Tag 0.0.1 搭配 Pytorch 1.9.0、Torchvision 0.10.0、cudatoolkit 10
• 已安装 ffmpeg
• Git（用于克隆仓库）
• 可选：conda 或 mamba 用于创建虚拟环境

安装与启动步骤

1. 1克隆项目仓库

   把 MockingBird 源码下载到本地，之后所有命令都在该目录下执行。

   git clone https://github.com/babysor/MockingBird.git
   cd MockingBird

   复制

2. 2安装 PyTorch

   按 PyTorch 官网指引安装。若报找不到 torch==1.9.0+cu102，通常是 Python 版本过低，换成 3.9 即可。

3. 3安装 ffmpeg

   从 ffmpeg 官方下载页按操作系统选择安装包，音频处理依赖它。

4. 4安装其余依赖

   安装 requirements.txt 中剩余的必要 Python 包，建议在虚拟环境中执行。

   pip install -r requirements.txt

   复制

5. 5安装 webrtcvad

   如需语音活动检测功能，单独安装 webrtcvad-wheels。

   pip install webrtcvad-wheels

   复制

6. 6改用 conda 建环境

   这是上面安装方式的替代方案，env.yml 只含运行所需依赖，暂不含 monotonic-align。

   conda env create -n env_name -f env.yml
   conda activate env_name

   复制

7. 7运行工具箱

   启动 demo_toolbox.py 进行推理，M1 Mac 需用 x86 架构的 pythonM1 来执行。

   python demo_toolbox.py

   复制

如何确认成功

执行 python demo_toolbox.py 能正常打开 Toolbox 图形界面并完成一次推理，即表示环境就绪。

常见问题

注意事项

• 作者已不再积极更新本仓库，README 中另有云端托管版本链接可供参考。
• README 推荐环境为 Repo Tag 0.0.1 + Pytorch1.9.0 + Torchvision0.10.0 + cudatoolkit10.2 + requirements.txt + webrtcvad-wheels。
• env.yml 只包含运行项目所需依赖，暂时不含 monotonic-align，GPU 版 PyTorch 需按官网另行安装。
• M1 Mac 上使用 demo_toolbox.py 需通过 Rosetta 终端按 x86 架构安装 PyQt5、pyworld、ctc-segmentation 等依赖。