saturndec/waoowaoo

首家工业级全流程 AI 影视生产平台。Industry-first professional AI Agent platform for controllable film & video production. From shorts to live-action with Hollywood-standard workflows.

ai-agentai-agentsautomationfilm-productiongenerative-aishort-dramastoryboardvideo-generation

GAI 中文摘要

waoowaoo 是一款工业级全流程 AI 影视生产平台，旨在为用户提供从剧本创作到成片输出的一站式解决方案。该项目通过集成 AI Agent 技术，实现了分镜设计、角色场景生成及视频合成的自动化，有效降低了短剧、漫画及影视创作的技术门槛。

自动解析小说文本，深度提取并结构化角色、场景与关键剧情节点。利用 AI 驱动角色与场景的一致性生成，确保影视内容在视觉风格上的连续稳定。支持自动化分镜视频制作，将静态素材转化为完整连贯的影视片段。集成 AI 多角色语音合成功能，为视频配音提供专业级的视听效果。具备多语言界面支持，方便不同区域用户快速上手并进行影视创作。

该项目适用于短剧制作人、漫画创作者及影视内容开发者，特别适合需要快速进行剧本可视化、分镜规划及低成本制作短视频的群体使用。

⭐

10.6k

Stars

🔱

2.3k

Forks

👁

Watchers

📋

110

Issues

TypeScript创建于 2026/1/22更新于今天

在 GitHub 上查看访问主页

README

由 Gemini 翻译整理

waoowaoo AI 影视 Studio

首家工业级全流程 AI 影视生产平台。一款基于 AI 技术的短剧/漫画视频制作工具，支持从小说文本自动生成分镜、角色、场景，并制作成完整视频。

English · 加入内测候补 · 反馈问题

[!IMPORTANT] ⚠️ 测试版声明：本项目目前处于测试初期阶段，由于暂时只有我一个人开发，存在部分 bug 和不完善之处。我们正在快速迭代更新中，欢迎进群反馈问题和需求，及时关注项目更新！目前更新会非常频繁，后续会增加大量新功能以及优化效果，我们的目标是成为行业最强 AI 工具！

✨ 功能特性

🎬 AI 剧本分析 — 自动解析小说，提取角色、场景、剧情
🎨 角色 & 场景生成 — AI 生成一致性人物和场景图片
📽️ 分镜视频制作 — 自动生成分镜头并合成视频
🎙️ AI 配音 — 多角色语音合成
🌐 多语言支持 — 中文 / 英文界面，右上角一键切换

🚀 快速开始

前提条件：安装 Docker Desktop

方式一：拉取预构建镜像（最简单）

无需克隆仓库，下载即用：

# 下载 docker-compose.yml
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml

# 启动所有服务
docker compose up -d

⚠️ 当前为测试版，版本间数据库不兼容。升级请先清除旧数据：

docker compose down -v
docker rmi ghcr.io/saturndec/waoowaoo:latest
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml
docker compose up -d

启动后请清空浏览器缓存并重新登录，避免旧版本缓存导致异常。

方式二：克隆仓库 + Docker 构建（完全控制）

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
docker compose up -d

更新版本：

git pull
docker compose down && docker compose up -d --build

方式三：本地开发模式（开发者）

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo

# 复制环境变量配置文件（必须在 npm install 之前完成）
cp .env.example .env
# ⚠️ 编辑 .env，填入你的 AI API Key（NEXTAUTH_URL 默认已是 http://localhost:3000，无需修改）

npm install

# 只启动基础设施
# 注意：docker-compose.yml 将服务映射到非标准端口，.env.example 已按此预设
mysql:13306  redis:16379  minio:19000
docker compose up mysql redis minio -d

# 初始化数据库表结构（首次必须执行，跳过会导致启动后报错）
npx prisma db push

# 启动开发服务器
npm run dev

[!WARNING] 跳过 npx prisma db push 会导致所有数据库表不存在，启动后报错 The table 'tasks' does not exist。请务必先运行此命令再启动开发服务器。

访问 http://localhost:13000（方式一、二）或 http://localhost:3000（方式三）开始使用！

首次启动会自动完成数据库初始化，无需任何额外配置。

[!TIP] 如果遇到网页卡顿：HTTP 模式下浏览器可能限制并发连接。可安装 Caddy 启用 HTTPS：
caddy run --config Caddyfile
然后访问 https://localhost:1443

🔧 API 配置

启动后进入设置中心配置 AI 服务的 API Key，内置配置教程。

💡 注意：目前仅推荐使用各服务商官方 API，第三方兼容格式（OpenAI Compatible）尚不完善，后续版本会持续优化。

📦 技术栈

框架: Next.js 15 + React 19
数据库: MySQL + Prisma ORM
队列: Redis + BullMQ
样式: Tailwind CSS v4
认证: NextAuth.js

📦 页面功能预览

4f7b913264f7f26438c12560340e958c67fa833a 67509361cbe6809d2496a550de5733b9f99a9702 466e13c8fd1fc799d8f588c367ebfa24e1e99bf7 c067c197c20b0f1de456357c49cdf0b0973c9b31