本地部署 FramePack，支持Mac Windows

### FramePack 模型下载及本地部署教程 #### 准备工作 在开始之前，需确认已安装 Python 和必要的开发工具链。推荐使用虚拟环境管理器（如 `venv` 或 `conda`），以便隔离依赖项。 #### 安装 FramePack 项目 访问 FramePack 的官方仓库地址[^1]，克隆该项目至本地： ```bash git clone https://gitcode.com/gh_mirrors/fr/FramePack.git cd FramePack ``` 创建并激活虚拟环境（可选）： ```bash python -m venv env source env/bin/activate # Linux/MacOS .\env\Scripts\activate # Windows ``` 安装所需的 Python 库： ```bash pip install -r requirements.txt ``` #### 下载预训练模型 FramePack 使用 Hugging Face Hub 提供的模型存储服务。以下是具体命令用于下载所需模型： 1. **HunyuanVideo 社区模型** ```python from huggingface_hub import snapshot_download snapshot_download(repo_id="hunyuanvideo-community/HunyuanVideo", local_dir="./models/hunyuan_video") ``` 2. **Flux Redux BFL 模型** ```python snapshot_download(repo_id="lllyasviel/flux_redux_bfl", local_dir="./models/flux_redux_bfl") ``` 3. **FramePack I2V HY 模型** ```python snapshot_download(repo_id="lllyasviel/FramePackI2V_HY", local_dir="./models/framepack_i2v_hy") ``` 运行以上脚本后，模型文件会被保存到指定目录下（默认为当前路径下的 `./models` 文件夹）。如果需要更改目标位置，请调整 `local_dir` 参数。 #### 配置本地环境 完成模型下载后，按照 FramePack 文档中的说明配置环境变量和参数设置。通常情况下，需要编辑项目的配置文件（如 `config.yaml` 或其他 JSON/YAML 格式的配置文件），指明模型路径以及硬件加速选项（GPU/CPU）。 对于 GPU 用户，建议验证 PyTorch 是否能够检测到可用设备： ```python import torch print(torch.cuda.is_available()) # 输出 True 表示支持 CUDA 加速 ``` #### 启动应用 启动 FramePack 工具前，确保所有依赖均已正确安装且模型成功加载。执行以下命令以启动程序： ```bash python main.py --model_path ./models/ ``` 更多高级功能可以通过传递额外参数实现，详情参见文档。 --- ### 注意事项 - 如果遇到显卡驱动版本不匹配或其他技术难题，可以参考 ComfyUI 的安装指南[^2]获取通用解决方法。 - 对于低配机器用户，可能需要降低分辨率或帧率来平衡性能需求[^3]。 ---