waoowaoo AI 影视 Studio

一款基于 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

---

📦 页面功能预览

---

🤝 参与方式

本项目由核心团队独立维护。欢迎你通过以下方式参与：

• 🐛 提交 Issue 反馈 Bug
• 💡 提交 Issue 提出功能建议
• 🔧 提交 Pull Request 供参考 — 我们会认真审阅每一个 PR 的思路，但最终由团队自行实现修复，不会直接合并外部 PR

---

Made with ❤️ by waoowaoo team

Star History

waoowaoo AI 影视 Studio 快速上手指南

waoowaoo 是一款基于 AI 技术的短剧/漫画视频制作工具，支持从小说文本自动生成分镜、角色、场景，并合成完整视频。

1. 环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows / macOS / Linux
• 核心依赖：必须安装 Docker Desktop
• 网络环境：需能访问 GitHub 及 Docker 镜像仓库（如下载缓慢，建议配置国内 Docker 镜像加速）
• AI 密钥：准备各大模型服务商的官方 API Key（目前推荐使用官方接口）

2. 安装步骤

推荐普通用户使用 方式一，开发者或需要定制的用户使用 方式二。

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

无需克隆代码仓库，直接下载配置文件即可启动。

# 1. 下载 docker-compose.yml 配置文件
curl -O https://raw.githubusercontent.com/saturndec/waoowaoo/main/docker-compose.yml

# 2. 启动所有服务
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 构建

# 1. 克隆项目代码
git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo

# 2. 启动服务（首次运行会自动构建镜像）
docker compose up -d

更新版本命令：

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

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

如需修改源码，请按以下步骤操作：

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

# 1. 配置环境变量（必须在 npm install 之前完成）
cp .env.example .env
# ⚠️ 编辑 .env 文件，填入你的 AI API Key

# 2. 安装依赖
npm install

# 3. 启动基础设施 (MySQL, Redis, MinIO)
# 注意：端口已映射为非标准端口 (mysql:13306, redis:16379, minio:19000)
docker compose up mysql redis minio -d

# 4. 初始化数据库表结构 (首次必须执行，否则报错)
npx prisma db push

# 5. 启动开发服务器
npm run dev

3. 基本使用

访问应用

根据安装方式不同，访问地址如下：

• 方式一 / 方式二：http://localhost:13000
• 方式三 (开发模式)：http://localhost:3000

💡 提示：首次启动会自动完成数据库初始化，无需额外配置。若遇到网页卡顿，可安装 Caddy 启用 HTTPS 访问 (https://localhost:1443) 以提升并发性能。

配置 AI 服务

1. 登录系统后，进入设置中心。
2. 填入您准备的 AI 服务商 API Key。
3. 系统内置了配置教程，按照指引完成即可。

开始创作

1. 输入文本：在创作页面粘贴小说章节或剧本文本。
2. 自动分析：系统将自动解析角色、场景和剧情。
3. 生成素材：一键生成一致性的人物与场景图片。
4. 合成视频：自动生成分镜、添加 AI 配音并合成最终视频。

现在您可以开始探索 AI 影视创作的下一代工作流了！