designfuchen/worldforge

项目介绍

WorldForge（世界工坊）把 Google Colab 的 G4 实例（RTX PRO 6000 Blackwell，98 GB 显存）或本地 RTX 4090/5090 机器当作推理后端，在 Mac 上用原生 SwiftUI 客户端和本地 Python 守护进程操作。客户端通过一条多路复用的 SSH 隧道连接远端 FastAPI 服务，远端常驻模型 Worker，避免每次生成都重新加载权重。

它面向需要在租用或本地 NVIDIA 显卡上批量生成 2K 图像、文生/图生视频和 3D 穿梭长镜头，又希望有流畅桌面交互的创作者。内置模型覆盖文生图、文生视频、图生视频、TTS 和 NVIDIA Lyra 长镜头模式，也支持粘贴任意 Hugging Face 仓库注册模型；Mac 端则负责 RIFE 插帧、变速、缩放和尾帧定格等后期。

快速使用

准备：一台 Mac（推荐 Apple Silicon）、通过 Homebrew 安装 ffmpeg、已登录且有余量的 colab CLI。若走本地显卡模式，则不需要 Colab CLI。

git clone https://github.com/designfuchen/worldforge.git
cd worldforge
open WorldForge.app   # 启动原生客户端并自动拉起后台 forge.py

也可以只运行 python3 forge.py --open 启动本地守护进程和 Web 工作台。使用本地 NVIDIA 主机时，先在该机器上执行 ./start_local_gpu.sh（等价于 python3 remote/forge_server.py --local --host 0.0.0.0 --port 17860），再在 Mac 上运行 python3 forge.py --gpu-url http://<主机IP>:17860 --open 连接。生成作品默认保存在 ~/Movies/WorldForge。

Lyra 长镜头的使用要点

README 专门说明如何复现官方级「一直在穿梭」的长镜头：双向生成加后退段倒放拼接、冻结舞台提示词模板、DA3/MoGe 逆深度对齐、按原生 832:480 中心裁剪，以及在 Mac 上用 RIFE 插帧。这些是项目提供的模式和参数预设，使用时需要按 Lyra 面板中记录的 mode 和轨迹参数操作，不能只填一句提示词。

使用约束

云端模式需要可用的 Google Colab 账号和计算单元，费用与空闲关机由应用的状态接口和看门狗管理。原生客户端仅支持 macOS，Web 界面与守护进程基于 Python 3 标准库。本地 4090/5090 模式需要一台可通过网络访问的 Linux 或 WSL2 机器。模型体积达数十 GB，对 GPU 主机的显存、内存和磁盘有要求；项目文档称在小显存卡上会自动启用 VAE 分块和卸载。许可证为 MIT。

HotRepo 点评

项目很新，在 2026-11-09 进入 HotRepo 新项目榜，首个增长窗口记录为 101 Star、33 Fork。目前没有足够长的 Star 曲线，不能据此判断热度趋势。值得关注的是它同时包含 SwiftUI 客户端、零依赖本地守护进程和带锁页内存换页的远端 Worker 池，工程描述比常见的脚本套壳具体得多；这套复杂度是否值得，取决于用户能否拿到 G4 级 Colab 实例或本地 4090/5090 主机。

项目源码与说明