FreeVideo 0.4.25

MANIFEST.in

@@ -5,7 +5,7 @@ include NOTICE THIRD_PARTY_NOTICES.md CONTRIBUTING.md SECURITY.md CITATION.cff
 recursive-include example_workflows *.json
 recursive-include web *.js *.css
 include web/vendor/three/LICENSE
-recursive-include web/assets *.svg *.png *.webp
+include web/assets/*.svg web/assets/*.png web/assets/*.webp
 recursive-include web/howto *.png
 recursive-include web/fonts *.woff2
 recursive-include web/tutorial *.webp *.mp4
@@ -30,3 +30,39 @@ prune .github
 exclude AGENTS.md CHANGELOG.md
 
 include freevideo_source_bootstrap.py freevideo_ed25519.py freevideo_update_keys.py
+
+# Bundled feature examples; every file is registered explicitly.
+include web/assets/tour/anime-first.webp
+include web/assets/tour/anime-last.webp
+include web/assets/tour/c1-s2.mp4
+include web/assets/tour/c1-s2.webp
+include web/assets/tour/c2-product.webp
+include web/assets/tour/c2-whitemodel.webp
+include web/assets/tour/c2g-s3.mp4
+include web/assets/tour/c2g-s3.webp
+include web/assets/tour/c3-s1.mp4
+include web/assets/tour/c3-s1.webp
+include web/assets/tour/c4-high.mp4
+include web/assets/tour/c4-high.webp
+include web/assets/tour/c4-light.mp4
+include web/assets/tour/c4-light.webp
+include web/assets/tour/c4-max.mp4
+include web/assets/tour/c4-max.webp
+include web/assets/tour/c4-medium.mp4
+include web/assets/tour/c4-medium.webp
+include web/assets/tour/c5-forest-s1.mp4
+include web/assets/tour/c5-forest-s1.webp
+include web/assets/tour/c5-snow-s1.mp4
+include web/assets/tour/c5-snow-s1.webp
+include web/assets/tour/c6-s1.mp4
+include web/assets/tour/c6-s1.webp
+include web/assets/tour/c7-s1.mp4
+include web/assets/tour/c7-s1.webp
+include web/assets/tour/c7-src-s1.mp4
+include web/assets/tour/c7-src-s1.webp
+include web/assets/tour/c8-original.webp
+include web/assets/tour/c8-s1.mp4
+include web/assets/tour/c8-s1.webp
+include web/assets/tour/c9-s1.mp4
+include web/assets/tour/c9-s1.webp
+include web/assets/tour/fox-sheet.webp

__init__.py

@@ -3,6 +3,14 @@
 
 
 async def comfy_entrypoint():
+    from .freevideo_engine.comfy_environment import control_process
+    from .freevideo_engine.gpu_pool import pool_enabled
+    if control_process() and pool_enabled():
+        from server import PromptServer
+        from .freevideo_engine import comfy_bridge
+        from .freevideo_engine.comfy_pool import register_pool
+        await register_pool(PromptServer.instance, root=comfy_bridge.installation_root(),
+                            source=comfy_bridge.source_root())
     from .freevideo_engine.comfy_progress import register as progress_routes
     progress_routes()
     try:
@@ -41,6 +49,8 @@ async def comfy_entrypoint():
     subtitle_file_routes()
     from .freevideo_engine.comfy_share import register as share_routes
     share_routes()
+    from .freevideo_engine.swap_lora import register as swap_lora_routes
+    swap_lora_routes()
     from .freevideo_engine.comfy_metadata import register as workflow_backfill
     workflow_backfill()
     try:

docs/Linux.md

@@ -10,7 +10,7 @@ FreeVideo runs on x86_64 Linux with an NVIDIA GPU and driver 580 or newer. On a
 2. Make it executable, either in the file's properties (**Allow executing file as program**) or with `chmod +x FreeVideo-Linux-x86_64.AppImage`, then open it.
 3. Choose a folder for a new installation, or an existing ComfyUI, and click **Install & launch**. ComfyUI opens in the browser with the FreeVideo workspace.
 
-FreeVideo then appears in the application menu and on the desktop, and later versions update the launcher by themselves, as on Windows. The AppImage needs a distribution from 2022 or newer (Ubuntu 22.04, Debian 12, Fedora 36, RHEL 9 or later); on older systems, use the terminal installation below. If the computer lacks the compiler FreeVideo builds its GPU acceleration with, the installation plan shows the command that installs it.
+FreeVideo then appears in the application menu and on the desktop, and later versions update the launcher by themselves, as on Windows. The AppImage needs a distribution from 2022 or newer (Ubuntu 22.04, Debian 12, Fedora 36, RHEL 9 or later); on older systems, use the terminal installation below. If the computer lacks Git or a C++ compiler, FreeVideo downloads its own copies during the installation, without administrator rights.
 
 ## Terminal: one command
 

docs/Linux.zh-CN.md

@@ -10,7 +10,7 @@ FreeVideo 支持 x86_64 Linux，需要 NVIDIA 显卡和 580 及以上版本的
 2. 在文件属性中勾选**允许作为程序执行**，或运行 `chmod +x FreeVideo-Linux-x86_64.AppImage`，然后打开它。
 3. 选择新安装的文件夹或已有的 ComfyUI，点击**安装并启动**。ComfyUI 会在浏览器中打开，并进入 FreeVideo 创作面板。
 
-安装完成后，应用菜单和桌面上会出现 FreeVideo，启动器也会像 Windows 版一样自动更新。AppImage 需要 2022 年以后的发行版（Ubuntu 22.04、Debian 12、Fedora 36、RHEL 9 或更新版本）；更老的系统请使用下面的终端安装方式。如果系统缺少编译 GPU 加速所需的编译器，安装计划会给出安装它的命令。
+安装完成后，应用菜单和桌面上会出现 FreeVideo，启动器也会像 Windows 版一样自动更新。AppImage 需要 2022 年以后的发行版（Ubuntu 22.04、Debian 12、Fedora 36、RHEL 9 或更新版本）；更老的系统请使用下面的终端安装方式。如果系统缺少 Git 或 C++ 编译器，FreeVideo 会在安装时自行下载，不需要管理员权限。
 
 ## 终端：一条命令
 

docs/community-results.md

@@ -90,6 +90,39 @@ Thanks to the community members who sent diagnostic reports. FreeVideo already r
 | 5080 | 16 GB | 64 GB | 768×1344 | 3 s | Max | 0.3.20 | 216 s | 0.3.20 | Already optimal |
 | 4060 Ti | 8 GB | 32 GB | 960×544 | 5 s | Light | 0.4.12 | 333 s | 0.4.12 | Already optimal |
 | 5070 Ti | 16 GB | 64 GB | 1184×672 | 15 s | Medium | 0.4.13 | 487 s | 0.4.13 | Already optimal |
+| 3070 | 16 GB | 32 GB | 768×1344 | 5.2 s | Light | 0.4.14 | 2380 s | 0.4.14 | Already optimal |
+| M4 Max | Unified | 128 GB | 768×1344 | 10 s | Light | 0.4.14 | 3444 s | 0.4.14 | Already optimal |
+| 4060 Ti | 8 GB | 32 GB | 672×1184 | 10.8 s | Light | 0.4.14 | 936 s | 0.4.14 | Already optimal |
+| 4060 Laptop | 8 GB | 16 GB | 1344×768 | 10 s | Light | 0.4.15 | 1147 s | 0.4.15 | Already optimal |
+| 3060 | 12 GB | 24 GB | 1344×768 | 13.7 s | Light | 0.4.15 | 1747 s | 0.4.20 | 1700 s (−50 s) |
+| 5070 Laptop | 8 GB | 64 GB | 1184×672 | 10 s | Light | 0.4.15 | 822 s | int8 model² | 720 s (−100 s) |
+| 5080 | 16 GB | 64 GB | 1024×1024 | 15 s | Light | 0.4.16 | 412 s | 0.4.16 | Already optimal |
+| M1 Max | Unified | 64 GB | 960×544 | 5.2 s | Light | 0.4.16 | 1816 s | 0.4.16 | Already optimal |
+| 4060 Laptop | 8 GB | 32 GB | 1344×768 | 5.2 s | Light⁵ | 0.4.17 | 470 s | 0.4.17 | Already optimal |
+| 3060 | 12 GB | 32 GB | 1344×768 | 10.8 s | Light⁵ | 0.4.17 | 967 s | 0.4.19 | 880 s (−90 s) |
+| 4060 Laptop | 8 GB | 32 GB | 1344×768 | 10 s | Max | 0.4.17 | 2311 s | 0.4.17 | Already optimal |
+| 5080 | 16 GB | 48 GB | 768×1344 | 12.3 s | Light | 0.4.17 | 293 s | 0.4.17 | Already optimal |
+| 3060 | 12 GB | 64 GB | 960×544 | 9.4 s | Light | 0.4.17 | 743 s | 0.4.17 | Already optimal |
+| 3060 | 12 GB | 32 GB | 768×1344 | 5.2 s | Light | 0.4.17 | 811 s | 0.4.17 | Already optimal |
+| 5070 Ti | 16 GB | 32 GB | 1184×672 | 15 s | Light | 0.4.19 | 447 s | 0.4.19 | Already optimal |
+| 4060 | 8 GB | 32 GB | 960×544 | 15 s | Light | 0.4.19 | 1311 s | 0.4.19 | Already optimal |
+| M5 | Unified | 24 GB | 1344×768 | 10 s | Max | 0.4.12 | 30509 s | 0.4.14 | 27000 s (−3500 s) |
+| 4070 Ti | 12 GB | 64 GB | 960×544 | 10 s | Light | 0.4.19 | 236 s | 0.4.19 | Already optimal |
+| 3090 | 24 GB | 128 GB | 1344×768 | 10 s | Light | 0.4.19 | 377 s | 0.4.19 | Already optimal |
+| 3060 | 12 GB | 32 GB | 672×1184 | 15 s | Light | 0.4.20 | 1608 s | 0.4.20 | Already optimal |
+| M5 Max | Unified | 128 GB | 1664×960 | 3 s | Light | 0.4.18 | 755 s | 0.4.18 | Already optimal |
+| 5050 Laptop | 8 GB | 24 GB | 544×960 | 8 s | Light | 0.4.21 | 534 s | 0.4.21 | Already optimal |
+| 3080 | 10 GB | 32 GB | 768×1344 | 15 s | Max | 0.4.22 | 1965 s | 0.4.22 | Already optimal |
+| 4090 Laptop | 16 GB | 64 GB | 1344×768 | 10 s | Medium | 0.4.14 | 590 s | 0.4.17 | 570 s (−20 s) |
+| 4060 Laptop | 8 GB | 32 GB | 960×544 | 10 s | Light | 0.4.6 | 517 s | 0.4.6 | Already optimal |
+| 4060 Laptop | 8 GB | 16 GB | 1344×768 | 10 s | Light | 0.4.14 | 1168 s | 0.4.14 | Already optimal |
+| 5070 Laptop | 8 GB | 32 GB | 1344×768 | 11.5 s | Light | 0.4.17 | 1003 s | 0.4.24 | 900 s (−100 s) |
+| 3070 Ti | 8 GB | 64 GB | 1344×768 | 16.5 s | Light | 0.4.17 | 1623 s | 0.4.24 | 1570 s (−50 s) |
+| 3060 Ti | 8 GB | 32 GB | 768×1344 | 10 s | Light | 0.4.18 | 843 s | 0.4.24 | 810 s (−33 s) |
+| 5060 | 8 GB | 32 GB | 672×1184 | 11.5 s | Light | 0.4.18 | 707 s | 0.4.24 | 680 s (−27 s) |
+| 5070 Ti Laptop | 12 GB | 32 GB | 1344×768 | 10 s | Light | 0.4.23 | 373 s¹³ | 0.4.23 | Thermal‑limited¹ |
+| 5060 | 8 GB | 48 GB | 768×1344 | 14 s | Medium | 0.3.25 | 3474 s | 0.3.25 | Already optimal |
+| 3060 | 12 GB | 32 GB | 896×1120 | 10 s | Light | 0.3.25 | 1045 s | 0.4.0 | 1025 s (−20 s) |
 
 - Time: end to end, from submission until the video is saved.
 - After: the estimated time, derived from the report's stage times and from complete planned runs on our test machines (RTX 3090 and RTX 5060 Ti on Windows, RTX PRO 6000 on Linux) under the reporting machine's VRAM and RAM limits, not from reruns on that machine.
@@ -106,3 +139,4 @@ Thanks to the community members who sent diagnostic reports. FreeVideo already r
 - ¹⁰ GPU shared: other programs were using about 29% of the graphics card during the run, so FreeVideo's steps ran at a little over 70% of their usual speed. With the card free, the same request takes about 7200 s.
 - ¹¹ With 16 GB of RAM, the text encoder and part of the video model cannot stay in memory and are read from the drive; text encoding and the first pass, which wait on these reads, took about 460 s of the 887 s.
 - ¹² Reference-video task: the reference video and audio roughly double the sequence the model processes, so each step takes about twice as long as a plain request of the same size.
+- ¹³ Preview (first pass only).

docs/zh-CN/community-results.md

@@ -90,6 +90,39 @@
 | 5080 | 16 GB | 64 GB | 768×1344 | 3 s | 极⁠致 | 0.3.20 | 216 s | 0.3.20 | 已⁠是⁠最⁠优 |
 | 4060 Ti | 8 GB | 32 GB | 960×544 | 5 s | 轻⁠量 | 0.4.12 | 333 s | 0.4.12 | 已⁠是⁠最⁠优 |
 | 5070 Ti | 16 GB | 64 GB | 1184×672 | 15 s | 标⁠准 | 0.4.13 | 487 s | 0.4.13 | 已⁠是⁠最⁠优 |
+| 3070 | 16 GB | 32 GB | 768×1344 | 5.2 s | 轻⁠量 | 0.4.14 | 2380 s | 0.4.14 | 已⁠是⁠最⁠优 |
+| M4 Max | 统⁠一⁠内⁠存 | 128 GB | 768×1344 | 10 s | 轻⁠量 | 0.4.14 | 3444 s | 0.4.14 | 已⁠是⁠最⁠优 |
+| 4060 Ti | 8 GB | 32 GB | 672×1184 | 10.8 s | 轻⁠量 | 0.4.14 | 936 s | 0.4.14 | 已⁠是⁠最⁠优 |
+| 4060 笔⁠记⁠本 | 8 GB | 16 GB | 1344×768 | 10 s | 轻⁠量 | 0.4.15 | 1147 s | 0.4.15 | 已⁠是⁠最⁠优 |
+| 3060 | 12 GB | 24 GB | 1344×768 | 13.7 s | 轻⁠量 | 0.4.15 | 1747 s | 0.4.20 | 1700 s⁠（−50 s⁠） |
+| 5070 笔⁠记⁠本 | 8 GB | 64 GB | 1184×672 | 10 s | 轻⁠量 | 0.4.15 | 822 s | int8 模⁠型² | 720 s⁠（−100 s⁠） |
+| 5080 | 16 GB | 64 GB | 1024×1024 | 15 s | 轻⁠量 | 0.4.16 | 412 s | 0.4.16 | 已⁠是⁠最⁠优 |
+| M1 Max | 统⁠一⁠内⁠存 | 64 GB | 960×544 | 5.2 s | 轻⁠量 | 0.4.16 | 1816 s | 0.4.16 | 已⁠是⁠最⁠优 |
+| 4060 笔⁠记⁠本 | 8 GB | 32 GB | 1344×768 | 5.2 s | 轻⁠量⁵ | 0.4.17 | 470 s | 0.4.17 | 已⁠是⁠最⁠优 |
+| 3060 | 12 GB | 32 GB | 1344×768 | 10.8 s | 轻⁠量⁵ | 0.4.17 | 967 s | 0.4.19 | 880 s⁠（−90 s⁠） |
+| 4060 笔⁠记⁠本 | 8 GB | 32 GB | 1344×768 | 10 s | 极⁠致 | 0.4.17 | 2311 s | 0.4.17 | 已⁠是⁠最⁠优 |
+| 5080 | 16 GB | 48 GB | 768×1344 | 12.3 s | 轻⁠量 | 0.4.17 | 293 s | 0.4.17 | 已⁠是⁠最⁠优 |
+| 3060 | 12 GB | 64 GB | 960×544 | 9.4 s | 轻⁠量 | 0.4.17 | 743 s | 0.4.17 | 已⁠是⁠最⁠优 |
+| 3060 | 12 GB | 32 GB | 768×1344 | 5.2 s | 轻⁠量 | 0.4.17 | 811 s | 0.4.17 | 已⁠是⁠最⁠优 |
+| 5070 Ti | 16 GB | 32 GB | 1184×672 | 15 s | 轻⁠量 | 0.4.19 | 447 s | 0.4.19 | 已⁠是⁠最⁠优 |
+| 4060 | 8 GB | 32 GB | 960×544 | 15 s | 轻⁠量 | 0.4.19 | 1311 s | 0.4.19 | 已⁠是⁠最⁠优 |
+| M5 | 统⁠一⁠内⁠存 | 24 GB | 1344×768 | 10 s | 极⁠致 | 0.4.12 | 30509 s | 0.4.14 | 27000 s⁠（−3500 s⁠） |
+| 4070 Ti | 12 GB | 64 GB | 960×544 | 10 s | 轻⁠量 | 0.4.19 | 236 s | 0.4.19 | 已⁠是⁠最⁠优 |
+| 3090 | 24 GB | 128 GB | 1344×768 | 10 s | 轻⁠量 | 0.4.19 | 377 s | 0.4.19 | 已⁠是⁠最⁠优 |
+| 3060 | 12 GB | 32 GB | 672×1184 | 15 s | 轻⁠量 | 0.4.20 | 1608 s | 0.4.20 | 已⁠是⁠最⁠优 |
+| M5 Max | 统⁠一⁠内⁠存 | 128 GB | 1664×960 | 3 s | 轻⁠量 | 0.4.18 | 755 s | 0.4.18 | 已⁠是⁠最⁠优 |
+| 5050 笔⁠记⁠本 | 8 GB | 24 GB | 544×960 | 8 s | 轻⁠量 | 0.4.21 | 534 s | 0.4.21 | 已⁠是⁠最⁠优 |
+| 3080 | 10 GB | 32 GB | 768×1344 | 15 s | 极⁠致 | 0.4.22 | 1965 s | 0.4.22 | 已⁠是⁠最⁠优 |
+| 4090 笔⁠记⁠本 | 16 GB | 64 GB | 1344×768 | 10 s | 标⁠准 | 0.4.14 | 590 s | 0.4.17 | 570 s⁠（−20 s⁠） |
+| 4060 笔⁠记⁠本 | 8 GB | 32 GB | 960×544 | 10 s | 轻⁠量 | 0.4.6 | 517 s | 0.4.6 | 已⁠是⁠最⁠优 |
+| 4060 笔⁠记⁠本 | 8 GB | 16 GB | 1344×768 | 10 s | 轻⁠量 | 0.4.14 | 1168 s | 0.4.14 | 已⁠是⁠最⁠优 |
+| 5070 笔⁠记⁠本 | 8 GB | 32 GB | 1344×768 | 11.5 s | 轻⁠量 | 0.4.17 | 1003 s | 0.4.24 | 900 s⁠（−100 s⁠） |
+| 3070 Ti | 8 GB | 64 GB | 1344×768 | 16.5 s | 轻⁠量 | 0.4.17 | 1623 s | 0.4.24 | 1570 s⁠（−50 s⁠） |
+| 3060 Ti | 8 GB | 32 GB | 768×1344 | 10 s | 轻⁠量 | 0.4.18 | 843 s | 0.4.24 | 810 s⁠（−33 s⁠） |
+| 5060 | 8 GB | 32 GB | 672×1184 | 11.5 s | 轻⁠量 | 0.4.18 | 707 s | 0.4.24 | 680 s⁠（−27 s⁠） |
+| 5070 Ti 笔⁠记⁠本 | 12 GB | 32 GB | 1344×768 | 10 s | 轻⁠量 | 0.4.23 | 373 s¹³ | 0.4.23 | 散⁠热⁠受⁠限¹ |
+| 5060 | 8 GB | 48 GB | 768×1344 | 14 s | 标⁠准 | 0.3.25 | 3474 s | 0.3.25 | 已⁠是⁠最⁠优 |
+| 3060 | 12 GB | 32 GB | 896×1120 | 10 s | 轻⁠量 | 0.3.25 | 1045 s | 0.4.0 | 1025 s⁠（−20 s⁠） |
 
 - 用时：从提交到视频保存完成的端到端用时。
 - 优化后：预估用时，根据报告中的分段用时，结合测试机（Windows RTX 3090 和 RTX 5060 Ti、Linux RTX PRO 6000）在报告机器的显存和内存上限下运行完整规划的实测推算，不是在报告机器上重跑。
@@ -106,3 +139,4 @@
 - ¹⁰ 显卡被占用：生成过程中其他程序占用了约 29% 的显卡，FreeVideo 每一步只有独占时七成多一点的速度；显卡空出来时，同样的请求约需 7200 秒。
 - ¹¹ 16 GB 内存留不下文本编码器和视频模型的一部分，需要从硬盘读取；887 秒里约 460 秒是等待这些读取的文本编码和第一遍。
 - ¹² 参考视频任务：参考视频和参考音频使模型处理的序列约增加一倍，每步耗时约为相同尺寸普通请求的两倍。
+- ¹³ 预览（只做第一遍）。