ComfyUI_Sonic

环境要求

• 已安装 ComfyUI，存在 ./ComfyUI/custom_node 目录
• 可用的 Python 与 pip 环境（用于安装 requirements.txt）
• 需自行下载 Sonic 检查点：audio2bucket.pth、audio2token.pth、unet.pth、yoloface_v5m.pt
• 需自行下载 openai/whisper-tiny 模型文件（config.json、model.safetensors）
• 建议 12G 及以上显存，首次加载较大

安装与启动步骤

1. 1进入插件目录

   切换到 ComfyUI 的自定义节点目录，后续克隆和安装都在这里进行。路径按 README 为 ./ComfyUI/custom_node。

   cd ./ComfyUI/custom_node

   复制

2. 2克隆插件仓库

   在 custom_node 目录下克隆 ComfyUI_Sonic，克隆完成后会得到同名文件夹，作为 ComfyUI 节点加载。

   git clone https://github.com/smthemex/ComfyUI_Sonic.git

   复制

3. 3安装 Python 依赖

   在插件目录（克隆出的 ComfyUI_Sonic 文件夹）内执行 README 给出的依赖安装命令，安装运行所需 Python 包。

   pip install -r requirements.txt

   复制

4. 4下载 Sonic 模型

   从 README 给出的 Google Drive 链接下载检查点文件：audio2bucket.pth、audio2token.pth、unet.pth、yoloface_v5m.pt。

5. 5下载 whisper-tiny

   从 README 给出的 HuggingFace 链接 openai/whisper-tiny 下载 config.json 与 model.safetensors，放入 whisper-tiny 子目录。

6. 6放置模型目录

   按 README 的文件结构，把上述模型放到 ComfyUI/models/sonic/ 下，whisper-tiny 作为其子文件夹，放错位置节点会找不到模型。

7. 7重启 ComfyUI

   重启 ComfyUI 使新插件被加载，之后在节点列表里查找 Sonic 相关节点搭建音频驱动人像工作流。

如何确认成功

重启后节点列表出现 Sonic 相关节点，且 ComfyUI/models/sonic/ 下 5 个模型文件（含 whisper-tiny 目录）齐全。

常见问题

注意事项

• 本项目是 smthemex/ComfyUI_Sonic 的下游 fork，默认分支为 fix/torchaudio-soundfile，如需规避 torchcodec 兼容问题请使用该分支。
• 模型目录结构必须严格按 README：ComfyUI/models/sonic/ 下放 4 个权重文件，whisper-tiny 为其子目录。
• README 未给出启动 ComfyUI 的命令，请按你本地既有的方式启动或重启 ComfyUI。
• 下游改动清单可查看仓库中的 IMPROVEMENTS.md。