AIComicBuilder

环境要求

• Node.js 运行环境（搭配 pnpm 包管理器）
• Docker 环境（使用 Docker 方式部署时需要）
• 准备可用的 AI 模型供应商账号：OpenAI / Gemini / Seedance / Kling / Veo 等
• 视频合成依赖 FFmpeg（技术栈依赖，通常随镜像内置）

安装与启动步骤

1. 1安装项目依赖

   在项目根目录执行 pnpm install，安装 Next.js 16、React 19、Drizzle ORM 等全部依赖；需先确保本机已装好 pnpm。

   pnpm install

   复制

2. 2启动开发服务

   运行 pnpm dev 启动 Next.js 开发服务器，终端会输出本地访问地址，保持窗口不要关闭。

   pnpm dev

   复制

3. 3访问本地页面

   浏览器打开 http://localhost:3000，看到 AIComicBuilder 界面即表示本地启动完成。

4. 4Docker 快速启动

   不想装 Node 环境可直接用官方镜像启动，映射 3000 端口并挂载 data、uploads 目录保存数据与上传素材。

   docker run -d \n  --name ai-comic-builder \n  -p 3000:3000 \n  -v ./data:/app/data \n  -v ./uploads:/app/uploads \n  --platform linux/amd64 \n  twwch/aicomicbuilder:latest

   复制

5. 5编写 Compose 文件

   在目录下新建 docker-compose.yml，内容如下，用于持久化数据和素材并设置自动重启。

   services:
     ai-comic-builder:
       image: twwch/aicomicbuilder:latest
       ports:
         - "3000:3000"
       volumes:
         - ./data:/app/data
         - ./uploads:/app/uploads
       restart: unless-stopped

   复制

6. 6启动 Compose 服务

   在 docker-compose.yml 所在目录执行，后台拉起容器；查看日志确认无报错。

   docker compose up -d

   复制

7. 7配置 AI 模型供应商

   启动后进入设置页面，填入 OpenAI / Gemini / Seedance 等供应商的模型配置，否则无法生成角色图与视频。

关键配置

如何确认成功

浏览器访问 http://localhost:3000，能正常打开界面即启动成功；Docker 方式可用 docker compose up -d 后查看容器日志确认。

常见问题

注意事项

• README 中本地开发只提供 pnpm install 与 pnpm dev 两步，没有给出 npm/yarn 的等价命令。
• Docker 启动命令带 --platform linux/amd64，ARM 设备请勿删除该参数。
• 必须在启动后到设置页面配置 AI 模型供应商，否则无法完成角色四视图与视频生成流程。
• 生成视频需依赖 FFmpeg，使用官方镜像可省去自行安装的步骤。