GitHub  |  Gitee

δΈ­ζ–‡ | English

Toonflow Logo # Toonflow

AI Short Drama Factory
Turn novels into episodes with a tap!
AI Script Γ— AI Imagery Γ— Lightning-fast Generation πŸ”₯

Stars Badge AGPL License Badge release

> πŸš€ **One-stop Short Drama Workflow**: From text to character, storyboard to video, a full AI-powered process with zero threshold, boosting creative efficiency by 10x+!
--- # 🌟 Main Features Toonflow is an AI tool that leverages AI technology to automatically turn novels into scripts, then uses AI to generate images and videos for efficient short drama production. With Toonflow, you can easily accomplish the entire workflow from text to visuals, making short drama creation more intelligent and convenient. - βœ… **Character Generation** Automatically analyzes the original novel text, intelligently recognizes and generates character profiles, including appearance, personality, identity, etc., providing a reliable foundation for subsequent script and image creation. - βœ… **Script Generation** Based on selected events and chapters, the system automatically generates structured scripts, covering dialogue, scene descriptions, and plot direction, enabling an efficient transition from literary text to screenplay. - βœ… **Storyboard Creation** According to the script content, it intelligently generates storyboard prompts and visual designs, detailing foreground, middle ground, background, character movements, props, and scene layouts. Automatically produces storyboards from the script, providing a comprehensive blueprint for video production. - βœ… **Video Synthesis** Integrates AI image and video techniques, supporting generation of video clips via AI. With built-in online editing, supports personalized adjustments and outputs, making filmmaking highly collaborative and efficient. --- # πŸ“¦ Application Scenarios - Short video content production - Novel-to-film experiments - AI Literary Adaptation Tools - Script development and rapid prototyping - Video material generation --- # πŸ”° User Guide ## πŸ“Ί Video Tutorial https://www.bilibili.com/video/BV1na6wB6Ea2 [![Toonflow 8-minute Quick Start AI Video](./videoCover.png)](https://www.bilibili.com/video/BV1na6wB6Ea2) **Toonflow 8-Minute Quick Start AI Video** πŸ‘‰ [Click to watch](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e) πŸ“± Watch via WeChat QR scan Watch on WeChat --- # πŸš€ Installation ## Prerequisites Before installing and using this software, please prepare the following: - βœ… Large Language Model AI service endpoint. - βœ… Sora or Doubao video service endpoint - βœ… Nano Banana Pro image generation model service endpoint ## Local Installation ### 1. Download & Install | Operating System | GitHub Download | 123YunPan Download | Description | | :--------------: | :---------------------------------------------------------- | :-------------------------------------------------------- | :---------------------------------------------------------- | | Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [123YunPan](https://www.123865.com/s/bkn5Vv-E67cv) | Official release installation package | | Linux | βš™οΈ Coming soon | βš™οΈ Coming soon | To be released soon | | macOS | βš™οΈ Coming soon | βš™οΈ Coming soon | To be released soon | > ⚠️ If 123YunPan prompts for payment, it is only due to bandwidth limitations. This software is completely open-source and free. > Currently, only the Windows version is supported. Other systems will be released gradually. > Due to Gitee OS environment and file size restrictions for Release uploads, Gitee Release download links are not provided for now. ### 2. Launch the Service After installation, start the program to use the service. > ⚠️ **First login** > Account: `admin` > Password: `admin123` ## Cloud Deployment ### I. Server Requirements - **OS**: Ubuntu 20.04+ / CentOS 7+ - **Node.js**: 23.11.1+ - **RAM**: 1GB+ ### II. Server Deployment #### 1. Install the Environment ```bash # Install Node.js curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 24 # Install Yarn & PM2 npm install -g yarn pm2 ``` #### 2. Deploy the Project **Clone from GitHub:** ```bash cd /opt git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app yarn install yarn build ``` **Clone from Gitee (recommended in China):** ```bash cd /opt git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app yarn install yarn build ``` #### 3. Configure PM2 Create a `pm2.json` file: ```json { "name": "toonflow-app", "script": "build/app.js", "instances": "max", "exec_mode": "cluster", "env": { "NODE_ENV": "prod", "PORT": 60000, "OSSURL": "http://127.0.0.1:60000/" } } ``` **Environment Variable Description:** | Variable | Description | | ------------ | ------------------------------------------- | | `NODE_ENV` | Runtime environment, `prod` means production| | `PORT` | Service listening port | | `OSSURL` | File storage access address for static files| --- #### 4. Start the Service ```bash pm2 start pm2.json pm2 startup pm2 save ``` #### 5. Common Commands ```bash pm2 list # List processes pm2 logs toonflow-app # View logs pm2 restart all # Restart all services pm2 monit # Monitoring panel ``` #### 6. Deploy the Frontend Website To deploy or customize the frontend separately, refer to the frontend repo: - **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web) - **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web) > πŸ’‘ **Note**: This repo includes pre-compiled frontend assets; regular users don’t need to deploy frontend separately. The frontend repo is for developers needing secondary development. --- # πŸ”§ Development Workflow Guide ## Development Environment Preparation - **Node.js**: Version 23.11.1+ - **Yarn**: Recommended package manager ## Quick Project Startup 1. **Clone the project** **From GitHub:** ```bash git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app ``` **From Gitee (china):** ```bash git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app ``` 2. **Install Dependencies** Run the following in the root directory: ```bash yarn install ``` 3. **Start Development Server** - Launch dev server with Node.js: ```bash yarn dev #port 60000 ``` - Use Bun to quickly start dev server: ```bash yarn bun:dev #port 60000 ``` 4. **Build the Project** - Compile and generate TypeScript files: ```bash yarn build ``` - Package as a Windows executable: ```bash yarn dist:win ``` 5. **Code Quality Check** - Lint globally for syntax and style: ```bash yarn lint ``` ## Frontend Development To modify the frontend, go to the frontend repo: - **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web) - **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web) After building the frontend, copy the contents of the `dist` folder into this project’s `scripts/web` directory for integration. ## Project Structure ``` πŸ“‚ docs/ # Documentation πŸ“‚ scripts/ # Build scripts and static resources β”‚ └─ πŸ“‚ web/ # Embedded frontend build output πŸ“‚ src/ β”œβ”€ πŸ“‚ agents/ # AI Agent modules β”œβ”€ πŸ“‚ lib/ # Shared libs (DB init, response format) β”œβ”€ πŸ“‚ middleware/ # Middleware β”œβ”€ πŸ“‚ routes/ # Routing modules β”‚ β”œβ”€ πŸ“‚ assets/ # Asset management β”‚ β”œβ”€ πŸ“‚ index/ # Home page β”‚ β”œβ”€ πŸ“‚ novel/ # Novel management β”‚ β”œβ”€ πŸ“‚ other/ # Other features β”‚ β”œβ”€ πŸ“‚ outline/ # Outline management β”‚ β”œβ”€ πŸ“‚ project/ # Project management β”‚ β”œβ”€ πŸ“‚ prompt/ # Prompt management β”‚ β”œβ”€ πŸ“‚ script/ # Script generation β”‚ β”œβ”€ πŸ“‚ setting/ # System settings β”‚ β”œβ”€ πŸ“‚ storyboard/ # Storyboard management β”‚ β”œβ”€ πŸ“‚ task/ # Task management β”‚ β”œβ”€ πŸ“‚ user/ # User management β”‚ └─ πŸ“‚ video/ # Video generation β”œβ”€ πŸ“‚ types/ # TypeScript type declarations β”œβ”€ πŸ“‚ utils/ # Utility functions β”œβ”€ πŸ“„ app.ts # App entry point β”œβ”€ πŸ“„ core.ts # Routing core β”œβ”€ πŸ“„ env.ts # Env variable handling β”œβ”€ πŸ“„ err.ts # Error handling β”œβ”€ πŸ“„ router.ts # Route registration └─ πŸ“„ utils.ts # Common tools πŸ“‚ uploads/ # Uploads πŸ“„ LICENSE # License πŸ“„ NOTICES.txt # 3rd-party notices πŸ“„ package.json # Project config πŸ“„ README.md # Project description πŸ“„ tsconfig.json # TypeScript config ``` --- # πŸ”— Related Repos | Repository | Description | GitHub | Gitee | | ----------------- | ------------------------------------- | -------------------------------------------------- | ------------------------------------------------ | | **Toonflow-app** | Full client (this repo, for users) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) | | **Toonflow-web** | Frontend source (for devs) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) | > πŸ’‘ **Tip**: If you just want to use Toonflow, download the client from this repo. The web repo is only for frontend customization/development. --- # πŸ“ Development Roadmap We continue to optimize the product. Key focuses for the near future: 1. Core Function Upgrades - `🧩 Prompt Refinement Agent` AI-enhanced prompt generation for videos, auto-parsing storyboards, intelligent multi-shot fusion and smooth transitions - `πŸ“„ Multi-format Text Support` Extending to scripts, manga scripts, game dialogue text, and more formats beyond novels 2. Production Flow Optimization - `πŸ‘— Character Costume & Props Management` Improved consistency for costumes, makeup, props across long content, support for multi-episode memory and auto costume generation - `πŸ“¦ Batch Processing/Task Queues` Process multiple chapters at once, backend task management, real-time monitoring and resume-on-interrupt 3. Visual Generation Enhancement - `🎭 Multi-style Template Library` Bundled visual style packs, one-click style swap, user-defined style saving - `⏱️ Intelligent Rhythm Analysis/Optimization` Analyze plot emotional arcs, auto-suggest climaxes and pace changes, optimized storyboard workflow --- # πŸ‘¨β€πŸ‘©β€πŸ‘§β€πŸ‘¦ WeChat Discussion Groups ~~Group 1~~ ~~Group 2~~ ~~Group 3~~ ~~Group 4~~ ~~Group 5~~ Group 6: Toonflow Logo

Scan with WeChat to join. If the QR expires, open an issue to request an update.

--- # πŸ’Œ Contact Us πŸ“§ Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow%20Inquiry) --- # πŸ“œ License Toonflow is open source under the AGPL-3.0 license. Details: https://www.gnu.org/licenses/agpl-3.0.html You may use Toonflow for any purpose, including commercial, as long as you adhere to the AGPL-3.0 terms and conditions. For proprietary/commercial licensing exempt from AGPL-3.0, please contact us by email. --- # ⭐️ Star History [![Star History Chart](https://api.star-history.com/svg?repos=HBAI-Ltd/Toonflow-app&type=date&legend=top-left)](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=date&legend=top-left) --- # πŸ™ Special Thanks Thanks to the following open-source projects for empowering Toonflow: - [Express](https://expressjs.com/) – Fast, open, minimal Node.js web framework - [LangChain](https://js.langchain.com/) – Framework for building LLM apps - [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) – High-performance SQLite3 bindings - [Sharp](https://sharp.pixelplumbing.com/) – High-performance Node.js image processing - [Axios](https://axios-http.com/) – Promise-based HTTP client - [Zod](https://zod.dev/) – TypeScript-first schema validation - [Aigne](https://github.com/aigne-com/aigne) – Unified LLM API middleware - [Electron](https://www.electronjs.org/) – Cross-platform desktop app framework Thanks to the following organizations/individuals for supporting Toonflow:
Sophnet Cloud Logo Sophnet Cloud provided compute sponsorship [Official Site]
For the full list of third-party dependencies, see `NOTICES.txt`