FreeSkyCinema

让 MiniMax H3 成为一台无头影片渲染机：读分镜 JSON，逐镜吐出带声音的 mp4。

本仓库是 Wan2GP 之上的薄封装——不改动上游任何文件， 通过 Wan2GP 官方的 wgp.py --process 无头模式驱动，方便随上游 git pull 升级。 典型场景：连环画/绘本管线的「影片管线」worker 节点（本仓库管第 ③ 段：分镜 JSON → 逐镜 mp4）。

特性

• 无头：无网页、无 Gradio，一条命令跑完整个分镜
• 契约化：通过 spool 目录（inbox/outputs/DONE.txt）与上游 worker 交接，见 docs/SPOOL_CONTRACT.md
• 标准档写死：MiniMax H3 FL2VA Pruned 20B int8 / 832×480 / 107 帧 / 20+3 步 euler shift 12，防止现场降档充数
• 自动后端探测：有 triton/sageattention 自动启用，没有则落 PyTorch/SDPA 兜底
• 断点续跑：已存在的 shot_NN.mp4 自动跳过，随时停、随时续
• 失败不卡死：单镜重试 1 次（同 seed），再败记日志跳过后续镜；全部失败才不写 DONE.txt

快速开始（Colab L4，推荐）

git clone https://gitlink.org.cn/PISC/FreeSkyCinema.git
cd FreeSkyCinema
bash install_colab.sh          # 装栈 + 下载模型（~90GB，需 ≥100GB 磁盘）
python headless_render.py --job test_job_001 --spool "$PWD/spool"

验收四件套见 docs/SPOOL_CONTRACT.md；spool/outputs/test_job_001/ 里应出现 shot_01.mp4（832×480，约 4.5s，带 AAC 音轨）+ timing.txt + DONE.txt。

快速开始（Windows 本地）

git clone https://github.com/deepbeepmeep/Wan2GP D:\Wan2GP   # 上游与渲染器分目录隔离
# Python 3.10~3.12 venv 中：
pip install torch==2.7.1 torchvision==0.22.1 torchaudio==2.7.1 --index-url https://download.pytorch.org/whl/cu126
pip install -r D:\Wan2GP\requirements.txt
set HF_HOME=D:\hf_cache_h3
python download_models.py
python headless_render.py --job test_job_001 --spool D:\D032_film_spool

注意：torch 2.10.0+cu130（Colab 锚定版）不支持 Pascal 显卡（如 GTX 1070，sm_61 无内核）， 老卡请用 cu126 轮子。Ada（L4/40系）及更新按 install_colab.sh 原样即可。

与上游 worker 对接

上游 worker（Node/TypeScript，已部署）只需把 spool 同步根指向同一目录（DRIVE_SYNC_ROOT）： worker 写 inbox/<jobId>/storyboard.json，轮询 outputs/<jobId>/DONE.txt，按大小稳定后取回 mp4。 本渲染器负责中间一段：盯 inbox → 逐镜渲染 → 按契约写 outputs。

实测数据

环境	单镜耗时	说明
GTX 1070 8GB（Pascal，本机预研）	~228.6 min	权重 21GB 逐步换页所致；10 镜约 38h
Colab L4 24GB（估算）	~45–55 min	社区锚点：L4 10 步 ~25min，20+3 步外推，±50%

许可与致谢

• 本仓库的封装代码（headless_render.py、download_models.py、install_colab.sh 等）以 Apache-2.0 开源。
• Wan2GP 上游适用其 WanGP Community License 2.0：免费使用（含商用）、 直接出售其生成内容时需署名 WanGP、不得将 WanGP 本身售卖/转授权/SaaS 化。本封装不随仓库分发上游代码，请自行克隆。
• MiniMax H3 模型权重另有其官方许可证（见 DeepBeepMeep/MiniMax-H3），商用前请阅读。
• 本项目生成内容用于「天马行空工作室」连环画影片管线；向 WanGP 与 MiniMax 致谢。