waoowaoo AI 影视 Studio--一个基于 AI 的短剧/漫画视频制作工具

这份详细的部署教程将指引您安装和运行 waoowaoo AI 影视 Studio——一个基于 AI 的短剧/漫画视频制作工具。它能从小说文本出发，自动完成剧本分析、角色与场景生成、分镜制作和视频合成，将创意转化为完整的视频内容。

waoowaoo 的核心优势在于其全流程自动化。它集成了剧本解析、AI 绘图、AI 配音和视频合成等多个环节，旨在为创作者提供一个“从文本到成片”的一站式工业级生产平台。目前项目处于测试初期，正在快速迭代中。

整个部署流程提供了多种方式，从最简单的 Docker 一键启动，到适合开发者的本地源码运行，您可以根据需求灵活选择。

🐳 方式一：使用预构建 Docker 镜像（最简单）

这是为普通用户设计的最快捷方式，无需克隆代码，直接拉取镜像运行。

前提条件：确保系统已安装 Docker 和 Docker Compose。

下载并启动：

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

# 启动所有服务（会自动拉取镜像）
docker compose up -d

访问应用：在浏览器中打开 http://localhost:13000 开始使用。

重要提示：首次启动后，请清空浏览器缓存并重新登录，以避免旧版本缓存导致界面异常。

升级与数据重置：

测试版重要提醒：当前版本间数据库不兼容。升级前必须清除旧数据，否则可能无法正常启动。

# 停止并删除数据卷
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
2
3

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

更新：

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

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

如果您希望直接运行源码进行开发调试，可以按照此方式操作。

环境要求：Node.js 和 npm。

克隆与安装：

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo
# 复制环境变量文件（必须在 npm install 之前）
cp .env.example .env
# 编辑 .env 文件，填入你的 AI API Key
npm install

启动基础设施：使用 Docker Compose 启动所需的数据库和缓存服务。

1 2	# 只启动 MySQL、Redis、MinIO 服务（非标准端口映射） docker compose up mysql redis minio -d

初始化数据库（重要）：跳过此步骤会导致应用报错 The table 'tasks' does not exist。
1
npx prisma db push
启动开发服务器：
1
npm run dev
访问 http://localhost:3000 开始使用。

⚙️ 核心配置与使用

API 配置：启动应用后，您需要进入设置中心，配置 AI 服务的 API Key。应用内置了配置教程。
HTTPS 支持：如果遇到网页卡顿，可能是 HTTP 模式的浏览器并发限制。您可以安装 Caddy 并启用 HTTPS：
1
caddy run --config Caddyfile
然后访问 https://localhost:1443。