ComfyUI-WanVideoWrapper安装教程：三步快速部署视频生成工作流

ComfyUI-WanVideoWrapper是基于WanVideo模型的ComfyUI自定义节点扩展，支持文本转视频、图像转视频等多种视频生成任务。本教程将通过环境准备、依赖安装和模型配置三个步骤，帮助你快速搭建完整的视频生成工作流。

一、环境准备

1.1 系统要求

• Python 3.8+环境
• 支持CUDA的NVIDIA显卡（推荐8GB以上显存）
• ComfyUI基础环境（已安装并可正常运行）

1.2 克隆项目代码

将项目仓库克隆到ComfyUI的custom_nodes目录下：

cd ComfyUI/custom_nodes
git clone https://gitcode.com/GitHub_Trending/co/ComfyUI-WanVideoWrapper

二、依赖安装

2.1 安装核心依赖

项目依赖项定义在requirements.txt中，包含diffusers、accelerate等关键库。通过pip安装：

cd ComfyUI-WanVideoWrapper
pip install -r requirements.txt

2.2 便携式安装方案

若使用ComfyUI便携式版本，需通过内置Python执行：

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-WanVideoWrapper\requirements.txt

三、模型配置

3.1 基础模型下载

核心模型需放置到ComfyUI对应目录：

• 文本编码器：ComfyUI/models/text_encoders
• 图像编码器：ComfyUI/models/clip_vision
• 视频模型：ComfyUI/models/diffusion_models
• VAE模型：ComfyUI/models/vae

推荐使用FP8量化模型以节省显存：

https://huggingface.co/Kijai/WanVideo_comfy_fp8_scaled

3.2 扩展模型支持

项目支持多种扩展模型，包括：

• SkyReels：视频风格迁移模型
• ReCamMaster：摄像机运动控制
• HuMo：音频驱动视频生成
• EchoShot：长视频生成优化

3.3 工作流示例

example_workflows目录提供多种预设工作流，如：

• wanvideo_1_3B_FlashVSR_upscale_example.json：视频超分辨率
• wanvideo_HuMo_example_01.json：音频驱动视频
• wanvideo_T2V_example_03.json：文本转视频

四、常见问题解决

4.1 显存优化

• 更新后工作流内存占用变化，需调整块交换数量
• 清理Triton缓存释放内存：

rm -rf ~/.triton
rm -rf ~/AppData/Local/Temp/torchinductor_*

4.2 兼容性处理

• 使用原生WanVideo节点优先于自定义节点
• 模型加载失败时检查configs/transformer_config_i2v.json配置

五、开始使用

重启ComfyUI后，在节点面板中找到"WanVideo"分类，拖拽对应节点构建工作流。推荐从example_workflows中的示例开始，逐步调整参数以获得最佳效果。

点赞收藏本教程，关注获取后续高级功能教程，包括多模态输入融合和长视频生成优化。