Pyramid-Flow

环境要求

• conda 环境管理工具（README 推荐用 conda 配置环境）
• Python 3.8.10
• PyTorch 2.1.2（README 给出对应版本安装指南）
• Gradio，用于启动本地网页 demo
• 可访问 Hugging Face 下载模型权重，并具备可运行视频生成的 GPU 环境

安装与启动步骤

1. 1克隆项目代码

   从 GitHub 拉取 Pyramid-Flow 官方仓库，并进入项目根目录。

   git clone https://github.com/jy0205/Pyramid-Flow
   cd Pyramid-Flow

   复制

2. 2创建 conda 环境

   README 推荐使用 conda，代码库当前基于 Python 3.8.10，激活后再装依赖。

   conda create -n pyramid-flow python=3.8.10 -y
   conda activate pyramid-flow

   复制

3. 3安装项目依赖

   安装 requirements.txt 中的依赖，并额外安装 Gradio；PyTorch 建议按官方指南装 2.1.2。

   pip install -r requirements.txt
   pip install gradio

   复制

4. 4下载模型权重

   从 Hugging Face 获取 miniFLUX（最长 10 秒）或 SD3 权重，保存到本地目录。

5. 5设置模型路径

   打开 app.py，把第 36 行（#L36）的模型路径改为你本地存放权重的目录。

6. 6启动 Gradio 演示

   在项目目录执行 app.py，Gradio 演示页面会在浏览器中打开。

   python app.py

   复制

关键配置

如何确认成功

执行 python app.py 后浏览器自动打开 Gradio 页面，输入文本提示能正常生成视频即部署成功。

常见问题

注意事项

• 代码库当前基于 Python 3.8.10 和 PyTorch 2.1.2，作者正在支持更多版本。
• 模型权重需自行从 Hugging Face 下载：miniFLUX 版（最长 10s）与 SD3 版。
• 模型可生成 768p、24FPS、最长 10 秒的视频，并天然支持图生视频。
• 官方推荐用 conda 管理环境，修改 app.py 第 36 行模型路径后再启动。