English · 扫码加入开源交流群

AID Studio is an open-source AI motion comic creation platform for AI short dramas, films and comics, with an end-to-end workflow from scripts and storyboards to video and voiceovers.

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

Try it online   ·   Deploy AID   ·   User tutorials   ·   Releases   ·   Get help

_{Actual workflow canvas screenshot · View more product screenshots}

Community and Feedback

For questions about deployment, model configuration, customization or integrating your creative workflow, use the channels in Get help, or scan the QR code to join the community chat.

扫码加入 AID 开源交流群（中文交流 / 技术支持入口）

本群仅仅为开源交流、技术支持群，无广告，无任何隐形消费。

This group is exclusively for open-source discussion and technical support, with no advertising or hidden charges.

_{扫码进群：如果二维码未直接显示，可点击二维码区域查看原图。
Scan to join the community chat. If the QR code does not appear, click the QR code area to open the original image.}

Sponsors

	MiniMax H3 视频生成 API｜秘塔科技 秘塔科技提供高性价比的 MiniMax H3 视频生成服务：768P 仅 0.09 元/秒，2K 仅 0.15 元/秒。支持原生 2K、音画同步，API 兼容 OpenAI 协议，同时支持 ComfyUI，无需自行部署 GPU。 🎁 通过 aid-studio 专属链接注册，即可领取赠送额度及专属优惠。

Core Capabilities

• Complete creative workflow: Organize scripts, characters, scenes, storyboards, images, videos and voiceovers within one project.
• Multiple models: Configure text, image, video and speech models as needed; available capabilities depend on the selected model.
• Controlled model invocation: Combine fixed model parameters, runtime reasoning options and request mappings according to explicit precedence rules; configuration errors that can be identified before quoting are rejected before provider submission.
• Self-hosting and management: Install with Docker or systemd, with integrated model, task, user and upgrade management.

The source code is available under the MIT License. AI generation requires API credentials for the relevant providers. Model calls, servers and storage may incur costs; generation quality depends on the models and input assets.

Your first motion comic project · Deploy AID · Product screenshots · Technology and source code · Documentation

What Is AID For?

AID focuses on AI motion comics and short dramas, and also supports cinematic short films and static comics. Creators manage scripts, episodes, assets and generated results within the same project; teams and developers can self-host the platform and configure their own models.

Three Main Creative Workflows

Workflow-based creation and the workflow canvas are two separate entry points. Choose the one that suits your creative habits; the opening screenshot shows the existing workflow canvas.

Your First Motion Comic Project

Complete one storyboard shot before expanding to a full episode:

1. Prepare your models: After deploying AID, configure text and image models in the admin panel. Add video and speech models when you need video and voiceovers. Check their capabilities, credentials and costs before enabling them.
2. Create a project: Prepare a short script, create an episode, and organize its characters and scenes.
3. Prepare reference assets: Generate or upload character and scene images that you have the right to use.
4. Complete one storyboard shot: Review the storyboard script and image, then choose a configured video model to generate a clip.
5. Add voiceovers and preview: Add voiceovers as needed, check the visuals and audio, then continue with more shots.

For static comics, skip the video and voiceover steps. See the user tutorials for page-by-page instructions, the deployment guide for installation questions, and Get help for other questions.

Features

Quick Start

Production Deployment

Start with a fresh 64-bit Linux server. With RocketMQ disabled and middleware on the same host, the minimum is 2 CPU cores / 4 GB RAM / 40 GB disk. See the deployment guide for further capacity requirements and installation options.

The command below saves the installer to /root/aid-install.sh. It downloads from Gitee first and automatically falls back to GitHub if that fails; the script runs only after a successful download. On first installation, configuration is generated first. Review and confirm the configuration before continuing with initialization and service startup.

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 'Please install curl or wget first'; exit 1; fi && sudo env AID_REMOTE_BOOTSTRAP=1 AID_RELEASE_CHANNEL=auto bash /root/aid-install.sh install

After installation, run sudo aid default to view the access URLs. Change the administrator password immediately after your first login. Configure and enable the required models in the admin panel, then follow Your first motion comic project.

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. Start the development environment (MySQL + Redis; automatically imports the initialization scripts in sql/)
cd deploy/docker
docker compose -f docker-compose.middleware.yml up -d
# To include RocketMQ for integration testing, use:
# docker compose -f docker-compose.middleware.yml --profile mq up -d

# 2. Build and start the backend (development defaults match the environment above; no configuration changes are needed)
cd ../..
mvn clean package -DskipTests
java -jar aid-admin/target/aid-admin.jar

http://SERVER_IP:8089/<ACCESS_CODE>

http://localhost:8089/Ab12Cd34Ef56

https://admin.example.com/Ab12Cd34Ef56

Configure AI Providers

The public repository contains the admin frontend and user creation frontend source code in frontend/admin and frontend/web, respectively. After startup, use “AI Model Configuration” in the admin panel to configure provider credentials, model capabilities and billing rules, then enable the models. Video and voiceover workflows also require the corresponding video and speech models.

Product Preview

README images use repository-relative paths and render directly on both Gitee and GitHub. If the page loads slowly, allow the browser time to finish caching the images.

User Creation Workbench

From project creation, scriptwriting, the workflow canvas, and character/scene asset management to storyboard generation, video, voiceovers and finished-video previews, the user frontend provides a continuous workflow for AI motion comics, AI films and AI comics.

Creation entry points	My works

Project configuration and style selection	Workflow-based scriptwriting

Workflow canvas	Scene and asset management

Image editing and reference assets	Generation model configuration

Storyboard design	Storyboard video management

Video generation with multiple parameters	Audio/video synchronization

Voiceover editing	Voiceover character selection

Admin Dashboard

The admin frontend covers platform overviews, user and work management, AI model and provider configuration, task monitoring, payments and billing, system upgrades and other administrative capabilities.

Data overview	Generation task monitoring

User management	Content detail review

AI model configuration	AI workflow orchestration

Online upgrades and release notes	Online user monitoring

Public Source Layout

The public aid-studio repository is AID's unified source code and deployment release entry point. It includes the backend, admin frontend, user creation frontend, version manifests, deployment scripts, incremental SQL and standalone updater. All three application components share the same version tag.

The unified public source is published to Gitee aid-studio and GitHub aid-studio, with identical commits and tags on both platforms.

Starting with v1.0.1, new versions use matching version tags in this repository. Consult the relevant release notes before obtaining or migrating historical versions. See the deployment guide for upgrades, backups and available rollback ranges.

Official Asset Bundle

AID's initialization data references official media resources for the platform's initial presentation and creative examples after first deployment. These include characters, scenes, props, lighting, shot sizes/focal lengths, poses, expressions, effects, storyboard examples, agent and provider icons, voice avatars and MP3 samples, homepage images and demo videos. This large asset bundle is distributed separately from the source code. It is not downloaded automatically through GitHub/Gitee Releases or one-command deployment, to avoid consuming public code-hosting bandwidth or accidentally writing to the deployer's OSS/COS storage.

• The bundle contains only official files actually referenced by the aid_init initialization database. It excludes user-generated content, accounts, keys, logs and other business data.
• Original object keys used by the database are preserved under files/aid/.... Import the bundle into local storage, Alibaba Cloud OSS or Tencent Cloud COS in one operation without bulk rewriting the initialization SQL.
• Each file is listed in manifest.json and asset-checksums.txt inside the bundle, allowing integrity checks by path, size and SHA-256.
• Download entry points and version-specific checksums are published through the official website and release announcements. Choose aid-official-assets_<VERSION>.tar.gz matching your application version; import commands are in the bundle's README.md.

System Architecture

aid-studio (Maven multi-module monolith)
├── aid-admin        Spring Boot entry point and configuration
├── aid-common       Shared components (security/cache/storage/payments/SMS adapters)
├── aid-business     Web layer
│   ├── business-framework   Web framework, data sources, filters and AOP
│   ├── business-system      Admin APIs (/system /aid /aidconfig)
│   ├── business-main        User APIs (/auth /api/user /recharge)
│   ├── business-quartz      Scheduled tasks
│   └── business-generator   Code generation
├── aid-interface    Domain layer
│   ├── interface-core       Core interfaces
│   ├── interface-system     Entities, Mappers and system services
│   └── interface-main       Business services (media/storyboards/billing/upgrades, etc.)
├── aid-consumer     MQ consumers
├── deploy/updater   Standalone updater (Go)
└── frontend
    ├── admin        Admin frontend (React)
    └── web          User creation frontend

Documentation

Online Upgrades

The admin panel under “System Management → Project Upgrade Configuration” and the CLI use the same standalone updater. The page displays the current version, online version, bilingual release notes, updater status, available rollback versions and a black live terminal. Duplicate submissions are blocked while a task is running. Below 4 cores/4 GB RAM, a high-risk warning appears before confirming an upgrade.

The upgrade process first checks the updater version; an outdated updater must be upgraded before continuing. It then validates the signed manifest and the unified repository's version tag, backs up configuration and the database, builds all three application components locally, applies incremental SQL, replaces programs and performs health checks. New configuration settings are added only when missing; existing values are retained, and a backup is created in the same directory. On failure, programs and configuration are restored automatically within the defined safety boundaries. During an upgrade, view the same live logs in the UI or with sudo aid progress; pressing q exits the viewer without interrupting the background task.

Updates compile all three components, back up the database and run health checks, which may briefly consume substantial CPU, memory and disk I/O. For production, create an off-host backup first and run updates during low-traffic hours. Test Beta versions in a test environment first. See the deployment guide for complete upgrade, SQL and rollback rules.

Contributing

Issues and Pull Requests in Chinese or English are welcome. Read the contributing guide, Public Provider integration guide and Code of Conduct, then choose a contribution that suits you: reproducing issues, improving documentation, fixing bugs or adapting public model protocols.

• Report an issue / suggest an improvement
• Find a good first issue
• Report a security issue

If AID helps you, consider starring the repository. You are also welcome to share creative examples you have the right to publish, along with your deployment experience.

赞赏支持 / Donate

如果 AID Studio 对你有帮助，欢迎自愿赞赏，支持项目持续维护与改进。

If AID Studio is useful to you, consider a voluntary donation to support ongoing maintenance and improvements.

_{微信扫码赞赏 · Scan with WeChat to donate
点击图片查看原图 / Click the image to view full size}

License

This project is open source under the MIT License. Copyright belongs to 光子讯息(杭州)科技有限公司 (Guangzi Xunxi (Hangzhou) Technology Co., Ltd.). See NOTICE for third-party attribution. Original copyright and license notices are preserved.

Acknowledgements

Parts of the admin framework are based on RuoYi-Vue (MIT License). We gratefully acknowledge the original project.

Community	Thanks
	Thank you to the Linux.do community for supporting Chinese-language technical discussion and the open-source ecosystem.