FramePack 项目启动与配置教程

1. 项目目录结构及介绍

FramePack 项目目录结构如下：

FramePack/
├── demo_gradio.py
├── demo_gradio_f1.py
├── diffusers_helper
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
└── update.bat (Windows专用)

• demo_gradio.py 和 demo_gradio_f1.py：这两个文件是启动 GUI 界面的 Python 脚本，demo_gradio_f1.py 是针对 FramePack-F1 版本的。
• diffusers_helper：包含用于处理视频生成过程中的一些辅助函数。
• .gitignore：指定 Git 忽略的文件和目录。
• LICENSE：项目的 Apache-2.0 许可证文件。
• README.md：项目的说明文档，包含项目介绍、安装指南和使用说明。
• requirements.txt：项目依赖的 Python 包列表。
• update.bat：Windows 系统下用于更新项目文件的批处理脚本。

2. 项目的启动文件介绍

Windows 系统

在 Windows 系统下，可以双击 update.bat 文件来更新项目，然后双击 run.bat 文件来启动项目。

Linux 和 macOS 系统

在 Linux 和 macOS 系统下，需要先安装项目依赖，然后运行以下命令启动项目：

# 安装依赖
pip install -r requirements.txt

# 启动 GUI
python demo_gradio.py

如果要使用 sage-attention，可以额外安装：

pip install sageattention==1.0.6

启动后，GUI 界面将显示，用户可以上传图片并输入提示文本，以生成视频。

3. 项目的配置文件介绍

项目的配置主要通过修改 requirements.txt 文件来进行。这个文件列出了项目运行所依赖的 Python 包。根据项目需求，可能需要安装额外的 attention kernels，如 sage-attention。

此外，demo_gradio.py 和 demo_gradio_f1.py 脚本中包含了一些启动参数，如 --share、--port、--server 和 --output_dir，这些参数可以用于配置服务器的地址、端口和输出目录等。

在 macOS 系统下，如果需要使用 Python 3.10，可以通过 Homebrew 安装：

brew install python@3.10

然后使用 python3.10 命令来运行脚本。

请注意，项目的配置应该根据具体的硬件环境和需求进行调整，以确保最佳性能和兼容性。