Wan2GP项目完整安装与使用指南-程序员充电站

项目概述

【免费下载链接】Wan2GPWan 2.1 for the GPU Poor项目地址: https://gitcode.com/gh_mirrors/wa/Wan2GP

Wan2GP是基于Wan2.1模型的开源视频生成工具，专为GPU资源有限的用户设计。该项目支持多种视频生成任务，包括文本到视频、图像到视频、视频编辑、文本到图像以及视频到音频转换等AI生成功能。

核心特性

低VRAM要求：最低6GB显存即可运行部分模型
广泛硬件兼容：支持老款NVIDIA显卡（RTX 10XX、20XX系列）和AMD显卡（Radeon RX 76XX、77XX、78XX和79XX系列）
最新GPU优化：在最新GPU上具有极快速度
完整Web界面：易于使用的全Web界面
自动模型下载：根据您的特定架构自动下载所需模型
集成工具套件：包含遮罩编辑器、提示增强器、时空生成、MMAudio、视频浏览器、姿态/深度/流提取器）

系统要求

硬件要求

操作系统：Linux或Windows
Python版本：3.8或更高版本（推荐3.10.9）
GPU：支持CUDA的NVIDIA显卡或兼容的AMD显卡
存储空间：至少10GB可用空间

安装步骤

方法一：一键安装（推荐）

使用Pinokio应用进行一键安装：

下载并安装Pinokio应用
在社区脚本中搜索"wan2gp"或"wan2gp-amd"
选择由Morpheus提供的社区脚本

方法二：手动安装

克隆项目仓库

git clone https://gitcode.com/gh_mirrors/wa/Wan2GP.git cd Wan2GP

创建Python环境

conda create -n wan2gp python=3.10.9 conda activate wan2gp

安装PyTorch

pip install torch==2.7.1 torchvision torchaudio --index-url https://download.pytorch.org/whl/test/cu128

安装项目依赖

pip install -r requirements.txt

启动应用

启动Web界面

python wgp.py

首次使用Wan2GP时，建议查看"指南"选项卡，其中提供了推荐的模型选择和使用建议。

更新应用

常规更新

git pull conda activate wan2gp pip install -r requirements.txt

强制更新（覆盖本地修改）

git fetch origin && git reset --hard origin/main conda activate wan2gp pip install -r requirements.txt

无头模式（批量处理）

处理保存的队列

python wgp.py --process my_queue.zip

处理设置文件

python wgp.py --process my_settings.json

Docker安装

对于基于Debian的系统（Ubuntu、Debian等）：

运行Docker脚本

./run-docker-cuda-deb.sh

此自动化脚本将：

自动检测您的GPU型号和显存
为您的GPU选择最佳的CUDA架构
安装NVIDIA Docker运行时（如果需要）
构建包含所有依赖项的Docker镜像
使用针对您硬件优化的设置运行Wan2GP

核心功能模块

视频生成模型

Wan 2.1/2.2系列：支持文本到视频、图像到视频生成
Hunyuan Video 1.5：腾讯推出的高质量视频生成模型
Flux 2：最佳开源图像生成器
Kandinsky 5：先进的视频生成技术
Qwen系列：图像生成和编辑模型

预处理工具

姿态提取：从视频中提取人体姿态信息
深度估计：生成深度图用于3D效果
音频处理：支持语音生成和音频转换

后处理功能

视频增强：提升生成视频质量
音频同步：确保音频与视频的完美匹配

高级功能配置

Loras微调

Loras是一种用于微调模型的技术，可以提升生成图像的质量和多样性。Wan2GP支持多种优化模块，包括：

Wan 2.2 t2v优化模块
Wan 2.1 i2v优化模块
Flux优化模块
最新Wan 2.2 Lightning优化模块

内存优化配置

Wan2GP提供多种内存配置文件：

配置文件3：标准配置，平衡性能和内存使用
配置文件4：内存优化，适合显存较小的GPU
配置文件4+：进一步内存优化，比配置文件4稍慢但可节省最多1GB显存

故障排除

常见问题解决

Git错误处理如果在升级到v9版本时出现Git错误消息，请执行以下操作：

命令行方法

cd installation_path_of_wangp git fetch origin && git reset --hard origin/main pip install -r requirements.txt

通用方法

将"ckpts"、"settings"、"outputs"文件夹和所有"loras"文件夹以及"wgp_config.json"文件移出WanGP安装文件夹
删除WanGP文件夹并重新安装
将移出的文件移回原位置

文档资源

核心文档

安装指南
AMD安装指南
入门指南
模型概述
Loras指南
VACE控制网络
命令行参考
故障排除

视频教程

Vace使用教程：详细讲解Vace功能的使用方法
另一Vace指南：补充视频教程

使用建议

新手入门

从默认配置开始，逐步熟悉界面操作
尝试推荐的模型，了解不同模型的特点
利用"指南"选项卡中的推荐设置

进阶使用

探索高级功能如Loras微调和内存优化
尝试批量处理功能提高工作效率
定期查看更新日志了解新功能

性能优化技巧

VRAM优化

根据GPU显存选择合适的模型
使用内存配置文件调整性能
利用暂停功能释放显存资源

生成质量提升

使用提示增强器优化输入提示
选择合适的优化模块
调整去噪强度和遮罩强度参数

社区支持

Discord服务器：获取其他用户的帮助并展示您的最佳视频
Twitter/X关注：获取最新消息和更新

通过遵循本指南，您将能够成功安装并开始使用Wan2GP进行高质量的视频生成。如有任何问题，建议查阅官方文档或加入社区讨论。