如何安装用于视频生成的FramePack

FramePack是一种革命性的神经网络结构，用于视频生成中的下一帧预测模型。本指南将引导您完成在Windows和Linux系统上的安装过程。

Windows安装指南

快速安装（Windows）

对于Windows用户，我们提供了一个方便的一键式安装包，其中包含预先配置的CUDA 12.6和PyTorch 2.6：

下载一键式安装包（CUDA 12.6 + PyTorch 2.6）

使用上面的按钮下载安装包
将下载的文件解压到您选择的目录中
运行update.bat以确保您拥有最新版本
运行run.bat启动FramePack

重要提示：运行update.bat至关重要，因为它确保您拥有带有所有错误修复的最新版本。跳过此步骤可能会导致使用有潜在问题的过时版本。

注意：模型将在首次运行时自动下载。这将需要从HuggingFace下载超过30GB的内容。确保您有足够的磁盘空间和稳定的互联网连接。

Linux安装指南

Linux安装

对于Linux用户，我们建议设置一个独立的Python 3.10环境：

1. 安装支持CUDA的PyTorch：

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu126

2. 安装所需依赖项：

pip install -r requirements.txt

3. 启动图形用户界面：

python demo_gradio.py

图形用户界面支持各种命令行选项，包括：

--share：创建公共URL
--port：指定自定义端口
--server：指定服务器选项

高级配置：注意力机制

FramePack支持多种注意力机制：

默认PyTorch注意力
xformers
flash-attn
sage-attention

默认情况下，FramePack使用PyTorch注意力。高级用户可以安装替代的注意力核心以获得潜在的性能提升。

安装sage-attention（Linux）

pip install sageattention==1.0.6

建议：我们建议首先使用默认的PyTorch注意力机制尝试FramePack。虽然像sage-attention这样的替代注意力机制可以提供性能改进，但它们可能会略微影响结果。

系统要求

运行FramePack的最低要求：

GPU：NVIDIA GPU，至少12GB VRAM（推荐16GB+）
CUDA：CUDA 12.x
内存：16GB（推荐32GB）
存储：为模型和缓存预留50GB空闲空间
Python：Python 3.10

故障排除

如果您在安装或运行FramePack时遇到问题：

检查您的CUDA驱动程序是否最新
确保您有足够的磁盘空间用于模型下载
验证您的Python环境是否正确设置（推荐Python 3.10）
在Windows上，如果遇到权限问题，请尝试以管理员身份运行
查看GitHub存储库中的已知问题或提交新问题

入门

安装完成后，您可以使用FramePack进行各种视频生成任务：

文本到视频生成
图像到视频转换
视频扩展和增强
长形式视频创建

访问我们的文档获取详细教程和示例。

后续步骤：安装完成后，查看我们的快速入门指南，使用FramePack创建您的第一个AI生成视频！

如何安装Framepack AI