waoowaoo:14000 Star 的 AI 影视生产平台,Next.js 16 + Temporal 的工程化打法
项目地址:https://github.com/waooAI/waoowaoo
官网 / 等候名单:https://www.waoowaoo.com/
协议:Elastic License 2.0(source-available,非 OSI 开源)
提示:原始仓库地址
github.com/saturndec/waoowaoo已跳转到github.com/waooAI/waoowaoo,请以新地址为准。
它现在是什么状态
先说清楚,waoowaoo 目前是 Preview 预览版,官方 README 自己写了「迭代很快,仍有一些 bug 和粗糙的地方」。仓库有 14047 Star、3087 Fork,热度不低,但别把它当成成熟稳定版。
它的自我定位是「工业级全流程 AI 影视生产平台」,从短剧到实拍、按好莱坞标准的工作流。功能上是一个面向图像/视频的 AI 创作工作台:
- 右侧 Assistant 陪你打磨分镜脚本(brief)并持续产出素材;
- 画布上上传参考图、整理文件、检查生成的图和视频;
- 按模型能力自动匹配画幅、时长、分辨率和参考角色(reference roles);
- 支持首帧、首尾帧、参考图等模式,具体取决于所选模型;
- 可以把一个已有结果改造成新版本,同时保留原版。
预览版目前只开放 OpenRouter 配置。可用模型包括 GPT Image 2、Nano Banana 系列、Seedance 系列、MiniMax H3 / H3 Max。其中 H3 Max 在当前应用里只接受单张首帧,不支持首尾帧成对。预览版不含音乐和配音控制。界面支持中英文,日韩只有 README 翻译。
技术栈:这次是认真在做「生产系统」
这套栈比同类项目重不少,看得出是按可扩展的后端系统写的:
- 前端:Next.js 16 + React 19
- 数据库:MySQL + Prisma ORM
- 持久化执行:Temporal
- 传输与缓存:Redis
- 媒体存储:私有 MinIO(S3)
- 样式:Tailwind CSS v4
- 认证:NextAuth.js
其中 Temporal 值得单独说一句:视频生成是长耗时任务,用工作流引擎做持久化执行,比自己在 Node 里裸跑异步任务要可靠,任务可恢复、状态可追踪。这说明项目是按「跑批量生产」而不是「跑 demo」来设计的。
部署:官方推荐预编译 Docker 镜像
有意思的是,README 没有给传统的分步安装文档,而是给了一段直接丢给本地 coding assistant 的提示词,让它自己检查机器、装依赖、配 Docker。原文明确要求:用已发布的预览版镜像,应用和 Codex runtime 都锁定到发布版本的不可变镜像 digest;检查 OS、CPU 架构、Docker、Compose v2、Git、flock;用新目录安装、保留已有容器和数据;生成唯一本地密钥且不打印不落盘;不要自创第二套启动流程。
官方推荐路径是 prebuilt Docker 镜像——主机上不需要装 Node.js、MySQL、Redis、Temporal、FFmpeg,应用依赖全在容器里跑。完整的手动安装说明在仓库的 docs/INSTALL.md。
发布版的 Compose 会自动起 Caddy,配好证书后打开 https://localhost:1443;端口 13000 只做 HTTP 重定向。源码开发模式 npm run dev 仍在 http://localhost:3001。用 overlay 时 SELF_HOSTED_HOST=localhost、SELF_HOSTED_HTTPS_PORT=1443,Caddy 的 /data、/config 命名卷要保留。
API 配置与数据
启动后在个人资料的「API 配置」里填 OpenRouter API Key,调用按你自己的账户付费。项目数据和媒体走本地数据库 + 私有 MinIO,提示词和参考图会发给供应商执行任务;支持的图片内联引用不需要公网媒体 URL。
注意 README 里反复强调的一点:别把 API Key 贴进聊天或支持日志。
许可证要注意
从 v0.5.0-beta.1 起,这个发行版用 Elastic License 2.0。个人使用、内部商业使用、修改和再分发都在条款允许内;但把软件的大量功能以托管/管理服务形式提供给第三方,需要单独许可。
这是一份 source-available(源码可见)协议,不是 OSI 认可的开源协议。如果你打算基于它做对外 SaaS,先读 LICENSE。
适合谁
- 想要一套架构正规、可持久化跑长任务的 AI 视频生产后端,愿意自己部署的团队;
- 用 OpenRouter 统一调模型、在意数据留在本地 MinIO 的创作者;
- 想参考 Next.js 16 + Temporal + Prisma 这套组合怎么搭 AI 生产系统的人。
预览版阶段不建议用于正式交付;想要开箱即用的稳定性,等它出稳定版更稳妥。