ComfyUI WanVideoWrapper 安装指南:3 步跑通 WanVideo 视频生成
【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper
ComfyUI-WanVideoWrapper 是一个 ComfyUI 插件,它把 WanVideo 视频生成模型接进 ComfyUI 的节点工作流,让你像搭积木一样做文生视频、图生视频,还能挂各种扩展模型。如果你已经能打开 ComfyUI、跑过图像工作流,跟着这篇文章走,几分钟内就能把环境装好、模型放到位,跑出第一条视频。
📦 它帮你省掉了什么
WanVideo 这套模型自己搭推理代码并不轻松,而这个封装把整条链路打包成了 ComfyUI 里的节点:加载模型、接文本编码器、接 VAE、出图,拖线就行。除了官方模型,它还顺手接了 SkyReels、VACE、ReCamMaster、ATI、MultiTalk、WanAnimate 等一批扩展玩法,而且支持 fp8 量化版和 GGUF 格式的主干模型,显存不太充裕的机器也有得跑。
🛠️ 动手前的 5 分钟准备
开始之前确认这几项,基本就不会在中间翻车:
- ComfyUI 已装好,浏览器能正常打开界面
- Python 3.8或更高版本
- Git已安装
- 如果是 ComfyUI 便携版(windows_portable),确认能访问到其中的python_embeded文件夹——后面装依赖要用它
三步跑通
克隆仓库进 custom_nodes
打开终端,进入 ComfyUI 的上级目录,执行:
git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper这会把插件代码拉到本地。克隆完成后,确保ComfyUI-WanVideoWrapper文件夹最终位于 ComfyUI 的custom_nodes目录下(如果 clone 到了别处,把整个文件夹挪进去即可)。
安装 Python 依赖
进入插件目录后,用普通安装方式装依赖:
pip install -r requirements.txt这条命令会安装 diffusers、accelerate、opencv-python 等运行 WanVideo 必需的库,全部下完才算成功。
如果你用的是 ComfyUI 便携版,别用系统 pip,回到 ComfyUI_windows_portable 文件夹根目录,改用内置 Python 执行:
python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-WanVideoWrapper\requirements.txt装完后重启 ComfyUI,启动日志里能加载到这个节点包、节点列表里出现 WanVideo 相关节点,就说明环境通了。
把模型文件放进对应文件夹
模型统一从 Hugging Face 上的Kijai/WanVideo_comfy模型库下载(显存紧张的话可以看Kijai/WanVideo_comfy_fp8_scaled的 fp8 量化版,仓库作者在 readme.md 里也点名推荐)。下载后按类型放进不同文件夹:
- 文本编码器 →ComfyUI/models/text_encoders
- 主干视频模型(Transformer)→ComfyUI/models/diffusion_models
- VAE →ComfyUI/models/vae
- Clip Vision 权重 →ComfyUI/models/clip_vision(也可以不单独下,直接复用 ComfyUI 原生的文本编码和 clip vision 加载器)
放好后重启 ComfyUI,在模型加载节点里能看到对应文件名,这一步就算验证完成——可以拿仓库里example_workflows目录下的示例工作流 JSON 导入试跑一次。
卡住了?先查这里
- 依赖装不上或装错了地方:优先检查是不是 3.8 以上的 Python,便携版用户尤其要确认用的是
python_embeded\python.exe而不是系统里的 pip,装错环境会导致 ComfyUI 启动时找不到模块。 - 节点加载了却找不到模型:九成是文件放错文件夹。对照上面四个目录名逐个检查,文件名和扩展名保持下载原样。
- Windows 上第一次跑显存暴涨:readme.md 提到,开启 torch.compile 时旧版 triton 缓存会在首次运行新尺寸输入时把显存抬得很高,删掉
C:\Users\<用户名>\.triton和C:\Users\<用户名>\AppData\Local\Temp\torchinductor_<用户名>两个缓存目录后重跑一次通常就恢复。
🎬 接下来可以玩什么
环境通了之后,仓库的example_workflows目录里躺着一整套现成工作流:文生视频、图生视频、相机控制、口型驱动(MultiTalk、HuMo)、动画迁移(WanAnimate)都有,直接导入 ComfyUI 就能照着跑。随便丢一张人物或场景照片进去当参考图,就能体验图生视频的效果——下面这张竹林场景图就是仓库示例工作流用的输入素材之一:
更多细节和模型清单,直接读仓库根目录的readme.md就够了。
【免费下载链接】ComfyUI-WanVideoWrapper项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考