AID Studio — AI Drama & Motion Comic Creation

简体中文 | English

AID Studio：开源 AI 漫剧创作平台，支持 AI 短剧、电影与漫画，从剧本、分镜到视频配音的一站式创作。

Open-source, self-hosted AI drama and motion comic creation — from scripts and storyboards to video and voiceovers, with support for films and comics.

在线体验   ·   开始部署   ·   使用教程   ·   版本发布   ·   获取帮助

_{流程画布实拍 · 查看更多产品截图}

部署、模型配置、二次开发或创作流程接入遇到问题，可以通过获取帮助中的入口反馈，或扫码加入交流群。

_{如果二维码未直接显示，可点击二维码区域查看原图。}

• 完整创作流程：剧本、角色场景、分镜、图片、视频与配音围绕同一项目组织。
• 多模型接入：按需配置文本、图片、视频和语音模型；能力以所选模型为准。
• 自行部署与管理：支持 Docker / systemd 安装，配套模型、任务、用户和升级管理。

源码按 MIT 协议提供。AI 生成需要配置相应供应商的 API 凭证；模型调用、服务器和存储可能产生费用，生成效果取决于模型与输入素材。

第一个漫剧项目 · 开始部署 · 产品截图 · 技术与源码 · 文档导航

以 AI 漫剧与短剧创作为核心，也支持电影化短片和静态漫画。创作者在同一个项目中管理剧本、分集、素材和生成结果；团队与开发者可自行部署并配置模型。

流程化创作与流程画布是两个独立入口，可按创作习惯选择；上方首图展示的是现有流程画布。

先跑通一个分镜，再扩展到整集：

1. 准备模型：自行部署后，在后台配置文本、图片模型；需要视频和配音时，再配置对应模型。核对能力、凭证与费用后启用。
2. 建立项目：准备一小段剧本，建立一个分集，并整理角色与场景。
3. 准备参考素材：生成或上传有权使用的角色、场景图片。
4. 完成一个分镜：检查分镜脚本和图片，再选择已配置的视频模型生成片段。
5. 配音与预览：按需添加配音，检查画面和声音，再继续更多分镜。

只制作静态漫画时，无需执行视频和配音步骤。具体页面操作见使用教程；安装问题见部署指南，其他问题见获取帮助。

先准备一台全新的 64 位 Linux 服务器；不启用 RocketMQ、且中间件同机时，最低为 2 核 / 4 GB 内存 / 40 GB 磁盘。更多容量要求与安装选项见部署指南。

下面的命令会把安装脚本保存到 /root/aid-install.sh，优先从 Gitee 下载，失败后自动切换 GitHub；下载成功后才执行脚本。首次安装会先生成配置，请检查并确认配置后再继续初始化和启动服务。

cd /root && if command -v curl >/dev/null 2>&1; then curl -fL --retry 3 --connect-timeout 15 -o /root/aid-install.sh https://gitee.com/gzxx-2025/aid-studio/raw/master/deploy/aid.sh || curl -fL --retry 3 --connect-timeout 15 -o /root/aid-install.sh https://raw.githubusercontent.com/gzxx-2025/aid-studio/master/deploy/aid.sh; elif command -v wget >/dev/null 2>&1; then wget -O /root/aid-install.sh https://gitee.com/gzxx-2025/aid-studio/raw/master/deploy/aid.sh || wget -O /root/aid-install.sh https://raw.githubusercontent.com/gzxx-2025/aid-studio/master/deploy/aid.sh; else echo '请先安装 curl 或 wget'; exit 1; fi && sudo env AID_REMOTE_BOOTSTRAP=1 AID_RELEASE_CHANNEL=auto bash /root/aid-install.sh install

安装完成后运行 sudo aid default 查看访问地址，首次登录立即修改管理员密码。在后台配置并启用所需模型后，再按第一个漫剧项目开始创作。

sudo env AID_REMOTE_BOOTSTRAP=1 AID_RELEASE_CHANNEL=auto bash /root/aid-install.sh install-docker
sudo env AID_REMOTE_BOOTSTRAP=1 AID_RELEASE_CHANNEL=auto bash /root/aid-install.sh install-manual

# 1. 一键启动开发环境（MySQL + Redis，自动导入 sql/ 初始化脚本）
cd deploy/docker
docker compose -f docker-compose.middleware.yml up -d
# 需要联调 RocketMQ 时改用：
# docker compose -f docker-compose.middleware.yml --profile mq up -d

# 2. 构建并启动后端（开发默认配置与上述环境完全对齐，无需修改任何配置）
cd ../..
mvn clean package -DskipTests
java -jar aid-admin/target/aid-admin.jar

http://服务器IP:8089/<访问码>

http://localhost:8089/Ab12Cd34Ef56

https://admin.example.com/Ab12Cd34Ef56

公开仓库中的管理端和用户创作端源码分别位于 frontend/admin 与 frontend/web。启动后在后台「AI模型配置」中配置所需厂商的凭证、模型能力与计费规则，再启用模型。完成视频与配音流程时，还需配置对应的视频与语音模型。

README 中的图片均使用仓库相对路径引用，可在 Gitee / GitHub 两端直接渲染；如页面加载较慢，请稍等浏览器完成图片缓存。

从项目创建、剧本创作、流程画布、角色与场景资产管理，到分镜生成、视频、配音和成片预览，用户端围绕 AI 漫剧、AI 电影与 AI 漫画组织为连续工作流。

平台创作入口	我的作品

项目配置与风格选择	流程化剧本创作

流程画布	场景与素材管理

画面编辑与参考素材	生成模型配置

分镜设计	分镜视频管理

多参数视频生成	音画同步管理

配音编辑	配音角色选择

管理端覆盖平台概览、用户与作品管理、AI 模型与供应商配置、任务监控、支付计费、系统升级等运营能力。

数据概览	生成任务监控

用户管理	内容详情审核

AI 模型配置	AI 业务编排

在线升级与版本说明	在线用户监控

公开仓 aid-studio 是 AID 的统一源码与部署发布入口，包含服务端、管理端、用户创作端、版本清单、部署脚本、增量 SQL 和独立升级器。三端使用同一个版本标签。

公开源码统一发布到 Gitee aid-studio 和 GitHub aid-studio，两个平台使用相同提交和标签。

从 v1.0.1 起，新版本统一使用本仓库的同名标签。历史版本的获取与迁移请先查阅对应发布说明；升级、备份与可用回退范围见部署指南。

AID 的初始化数据会引用一组官方媒体资源，用于首次部署后的平台展示和创作示例，包括角色、场景、道具、光影、景别/焦距、姿态、表情、特效、分镜示例、智能体与供应商图标、语音头像与 MP3 试听、首页图片及演示视频。该大体积资产包与程序源码分离，不会随 GitHub/Gitee Release 或一键部署自动下载，避免占用公共代码托管流量并防止误写部署方的 OSS/COS。

• 资产包只包含 aid_init 初始化库实际引用的官方文件，不包含用户生成内容、账号、密钥、日志或其他业务数据。
• 包内按 files/aid/... 保留数据库使用的原始对象键，可一次性导入本地存储、阿里云 OSS 或腾讯云 COS，无需批量改写初始化 SQL。
• 每个文件都记录在包内 manifest.json 和 asset-checksums.txt 中，可按路径、大小和 SHA-256 校验完整性。
• 获取入口与对应版本校验值由官方运营站及版本公告统一发布。请选择与程序版本一致的 aid-official-assets_<版本>.tar.gz，具体导入命令见包内 README.md。

aid-studio（Maven 多模块单体）
├── aid-admin        Spring Boot 启动入口与配置
├── aid-common       公共组件（安全/缓存/存储/支付/短信适配）
├── aid-business     Web 层
│   ├── business-framework   Web框架、数据源、过滤器、AOP
│   ├── business-system      后台管理接口（/system /aid /aidconfig）
│   ├── business-main        C端接口（/auth /api/user /recharge）
│   ├── business-quartz      定时任务
│   └── business-generator   代码生成
├── aid-interface    领域层
│   ├── interface-core       核心接口
│   ├── interface-system     实体、Mapper、系统服务
│   └── interface-main       业务服务（媒体/分镜/计费/升级等）
├── aid-consumer     MQ 消费者
├── deploy/updater   独立升级器（Go）
└── frontend
    ├── admin        运营管理端（React）
    └── web          用户创作端

管理端「系统管理 → 项目升级配置」和命令行使用同一套独立升级器。页面会展示当前版本、线上版本、双语版本说明、升级器状态、可回退版本以及黑色实时终端；任务执行期间禁止重复提交，低于 4 核 4G 时会在确认升级前给出高风险提醒。

升级流程会先确认升级器版本，升级器落后时必须先升级升级器；随后校验签名清单和统一仓库版本标签，完成配置与数据库备份、本机三端源码构建、增量 SQL、程序替换和健康检查。新增配置只会补入缺失项，原有配置值保持不变并在同目录生成备份；失败时按安全边界自动恢复程序与配置。升级期间可在页面或执行 sudo aid progress 查看同一份实时日志，按 q 退出查看不会中断后台任务。

更新会进行三端编译、数据库备份和健康检查，短时间内可能明显占用 CPU、内存和磁盘 I/O。生产环境应先做异机备份并在业务低峰执行；Beta 版本建议先在测试环境验证。完整升级、SQL 与回退规则见部署指南。

欢迎中文或英文 Issue 与 Pull Request。先阅读贡献指南与社区行为准则，再选择适合自己的贡献：复现问题、改进文档、修复缺陷或适配公开模型协议。

• 报告问题 / 提出建议
• 查找适合首次贡献的任务
• 报告安全问题

如果 AID 对你有帮助，欢迎 Star 收藏，也欢迎分享有权公开的创作案例和部署经验。

本项目基于 MIT License 开源，版权归光子讯息(杭州)科技有限公司所有。第三方归属说明见 NOTICE，原有版权与许可声明予以保留。

后台管理框架部分基于 RuoYi-Vue（MIT License）二次开发，特此致谢。

社区	鸣谢
	感谢 Linux.do 社区为中文技术交流与开源生态建设提供的支持。