| |

Toonflow

Фабрика AI-мини-сериалов и короткометражных фильмов
Всего несколько кликов — и ваша новелла превращается в фильм или сериал!
AI-сценарий × AI-изображения × Сверхбыстрая генерация 🔥

🚀 All-in-One платформа для коротких сериалов и фильмов: От текста до персонажей, от раскадровки до готового видео. Полная автоматизация с помощью ИИ с нулевым порогом входа — повышает эффективность творчества в 10 раз и более!

🌐 Мультиязычная поддержка

Toonflow поддерживает следующие языки интерфейса:

Язык	Language
简体中文	Chinese (Simplified)
繁體中文	Chinese (Traditional)
English	English
ไทย	Thai
Tiếng Việt	Vietnamese
日本語	Japanese
Русский	Russian

💡 В настоящее время мы активно добавляем новые языки. Будем рады вашей помощи с переводами!

🌟 Основные возможности

Toonflow — это мощный ИИ-инструмент для создания коротких видео, мини-сериалов и комиксов. Он автоматически превращает новеллы в сценарии, а затем с помощью ИИ генерирует изображения и видео, позволяя быстро и эффективно создавать качественный контент.
С Toonflow вы можете пройти весь цикл производства — от текста до готового видео — легко и удобно, без специальных навыков.

✅ Генерация персонажей
Автоматический анализ оригинального текста новеллы, интеллектуальное распознавание и создание подробных профилей персонажей (внешность, характер, личность, отношения и другие детали). Это закладывает прочную основу для сценария и визуальной части.
✅ Генерация сценария
На основе выбранных событий и глав система автоматически создаёт структурированный сценарий с естественными диалогами, описаниями сцен и развитием сюжета, обеспечивая эффективную адаптацию литературного произведения в видеоформат.
✅ Создание раскадровки (Storyboard)
Автоматическая генерация промптов и дизайн кадров на основе сценария. Детальная проработка переднего, среднего и заднего планов, движений персонажей, реквизита и композиции — готовая раскадровка становится точным планом для производства видео.
✅ Синтез видео
Интеграция современных ИИ-технологий для генерации изображений и видеоклипов. Встроенный онлайн-редактор позволяет гибко настраивать результат, делая процесс создания видео быстрым, удобным и плавным.

📦 Сценарии использования

Создание контента для коротких видео (Shorts, Reels, TikTok)
Экранизация и визуализация новелл
ИИ-инструмент для адаптации литературных произведений
Разработка сценариев и быстрое прототипирование
Генерация видеоматериалов и футажей

🔰 Руководство пользователя

📺 Видеоуроки

https://www.bilibili.com/video/BV1oXD7BqEqJ

Toonflow: Быстрый старт в AI-видео за 12 минут 👉 Нажмите для просмотра

📱 Отсканируйте QR-код для просмотра видео на телефоне

🚀 Установка

Предварительные требования

Перед установкой и использованием Toonflow подготовьте следующее:

✅ URL API для LLM (большой языковой модели)
✅ URL API для генерации видео (Sora или Doubao)
✅ URL API для генерации изображений (Nano Banana Pro)

Локальная установка (на ПК)

1. Скачивание и установка

ОС	GitHub	Atomgit	Скачать (Quark Drive)	Описание
Windows	Release	Release	Quark Drive	Официальный установщик
Linux	Release	Release	Quark Drive	Официальный установщик
macOS	Release	Release	Quark Drive	Официальный установщик

Caution

Пользователям macOS необходимо перейти в Системные настройки → Конфиденциальность и безопасность и разрешить запуск приложения. В противном случае программа может не открыться из-за проблем с сертификатом.

Подробнее (на китайском): https://www.zhihu.com/question/433389276

Из-за технических ограничений Gitee Release (размер файлов и окружение) ссылки для скачивания на Gitee временно недоступны.

2. Запуск сервиса

После завершения установки просто откройте программу Toonflow — сервис будет готов к работе.

⚠️ Данные для первого входа
Логин: admin
Пароль: admin123

Развертывание через Docker

Предварительные требования

Установлен Docker версии 20.10 или выше

Способ 1: Онлайн-развертывание

В настоящее время в стадии разработки.
Рекомендуется использовать локальную сборку.

Способ 2: Локальная сборка

Сборка проекта непосредственно из исходного кода на вашем компьютере.
Подходит для разработчиков и пользователей, которые уже клонировали репозиторий. Требуется установленная система контроля версий Git:

# Сначала клонируйте проект (пропустите, если уже сделано)
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

# Локальная сборка и запуск с помощью docker-compose
yarn docker:local

# Или ручная сборка
docker build -t toonflow .
docker run -d -p <локальный_порт>:10588 -v <путь_к_локальным_данным>:/app/data toonflow

# После этого интерфейс будет доступен по пути /web/index.html на указанном порту
# Пример: http://localhost:10588/web/index.html

Описание портов сервиса

Порт	Назначение	Маппинг
`10588`	Основной порт сервиса (API)	`10588:10588`

Переменные окружения (Environment Variables):

Переменная	Описание
`NODE_ENV`	Среда выполнения (`prod` = Production)
`PORT`	Порт сервиса (по умолчанию 10588)
`OSSURL`	Адрес Object Storage для хранения и отдачи статических файлов

Облачное развертывание / Установка на сервер

I. Требования к серверу

Операционная система: Ubuntu 20.04+ / CentOS 7+
Node.js: 24.x (рекомендуется, минимум 23.11.1+)
ОЗУ: 2 ГБ и более

II. Развертывание

1. Установка окружения

# Установка Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
# Установка Yarn и PM2
npm install -g yarn pm2

2. Загрузка и сборка проекта

Клонирование с GitHub:

cd /opt
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

Клонирование с Gitee (рекомендуется для Китая):

cd /opt
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

3. Настройка PM2

Создайте файл pm2.json:

{
  "name": "toonflow-app",
  "script": "data/serve/app.js",
  "instances": "max",
  "exec_mode": "cluster",
  "env": {
    "NODE_ENV": "prod",
    "PORT": 10588,
    "OSSURL": "http://127.0.0.1:10588/"
  }
}

Переменные окружения (Environment Variables):

Переменная	Описание
`NODE_ENV`	Среда выполнения (`prod` = Production)
`PORT`	Порт сервиса (по умолчанию 10588)
`OSSURL`	Адрес Object Storage для хранения и отдачи статических файлов

4. Запуск сервиса

pm2 start pm2.json
pm2 startup
pm2 save

5. Полезные команды

pm2 list              # Список процессов
pm2 logs toonflow-app # Просмотр логов
pm2 restart all       # Перезапуск сервисов
pm2 monit             # Панель мониторинга

⚠️ Данные для первого входа
Логин: admin
Пароль: admin123

6. Развертывание Frontend

Если вам нужно отдельно развернуть или кастомизировать фронтенд, перейдите в репозиторий Toonflow-web:

GitHub: Toonflow-web
Gitee: Toonflow-web

💡 Примечание: Этот репозиторий уже содержит скомпилированные файлы Frontend. Обычным пользователям не требуется отдельно устанавливать фронтенд. Репозиторий Toonflow-web предназначен только для разработчиков, которые хотят внести изменения или доработать интерфейс.

🔧 Руководство разработчика

Caution

🚧 Правила отправки Pull Request 🚧

⛔ Ветка master не принимает PR ｜ ✅ Отправляйте все PR в ветку develop

Приглашаем всех желающих разработчиков присоединиться к развитию Toonflow.
Если вы хотите участвовать, свяжитесь с куратором проекта ACT в нашей группе сообщества.

🛠️ Стек технологий

Категория	Технология
Runtime	Node.js 23.11.1+
Язык	TypeScript 5.x
Backend-фреймворк	Express 5
База данных	SQLite (better-sqlite3 / knex)
Интеграция ИИ	Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI)
Локальный инференс	@huggingface/transformers (ONNX)
Real-time связь	Socket.IO
Desktop-клиент	Electron 40
Обработка изображений	Sharp
Контейнеризация	Docker

Подготовка среды разработки

Node.js: версия 23.11.1 и выше
Yarn: рекомендуется использовать в качестве пакетного менеджера

Быстрый запуск проекта

Клонирование проекта

С GitHub:

git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

С Gitee:

git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

Установка зависимостей

Выполните следующую команду в корневой папке проекта:
```
yarn install
```
Запуск среды разработки

Проект состоит из Backend API и Frontend страниц. Выберите нужный способ запуска:
- Способ 1: Запуск только Backend
```
yarn dev
```
⚠️ Эта команда запускает только Backend API (порт 10588) без интерфейса Frontend.
При переходе по адресу http://localhost:10588 вы сможете только обращаться к API. Полноценный графический интерфейс отображаться не будет.
Чтобы работать с UI, запустите Frontend отдельно или используйте режим GUI (см. ниже).
- Способ 2: Запуск клиента Electron (GUI)
```
yarn dev:gui
```
Эта команда одновременно запускает Backend и десктопное приложение Electron со встроенным Frontend.
Программа готова к работе сразу после запуска, без дополнительных настроек.
Идеально подходит для разработчиков, которые хотят быстро протестировать весь функционал приложения.
- Способ 3: Запуск в режиме Production
```
yarn start
```
  Запуск скомпилированного сервиса в режиме Production (сначала необходимо выполнить yarn build).
Сборка проекта (Build & Package)
- Компиляция и генерация TypeScript:
```
yarn build
```
- Сборка исполняемого файла для Windows:
```
yarn dist:win
```
- Сборка исполняемого файла для Mac:
```
yarn dist:mac
```
- Сборка исполняемого файла для Linux:
```
yarn dist:linux
```
Проверка качества кода (Linting)
- Запуск глобальной проверки синтаксиса:
```
yarn lint
```
Панель отладки AI (Опционально)

Запуск визуального инструмента отладки AI SDK:
```
yarn debug:ai
```

Разработка Frontend

Если вам нужно внести изменения в пользовательский интерфейс, перейдите в репозиторий фронтенда:

GitHub: Toonflow-web
Gitee: Toonflow-web

После сборки (build) фронтенда скопируйте всю папку dist в директорию data/web этого проекта для интеграции.

Структура проекта

📂 build/                    # Артефакты сборки
📂 data/                     # Данные времени выполнения (Runtime)
│  ├─ 📂 models/             # Локальные модели (ONNX)
│  ├─ 📂 oss/                # Object Storage (изображения, персонажи, сцены)
│  ├─ 📂 serve/              # Точка входа в Production-режим
│  ├─ 📂 skills/             # Промпты навыков Agent
│  └─ 📂 web/                # Скомпилированный Frontend (встроен в проект)
📂 docs/                     # Документация и ресурсы
📂 env/                      # Конфигурации окружения
📂 scripts/                  # Скрипты сборки и вспомогательные скрипты
📂 src/
├─ 📂 agents/                # Модули AI Agent
│  ├─ 📂 productionAgent/    # Production Agent (агент производства)
│  └─ 📂 scriptAgent/        # Script Agent (агент сценариев)
├─ 📂 lib/                   # Общие библиотеки (инициализация БД, форматы ответов)
├─ 📂 middleware/            # Middleware
├─ 📂 routes/                # Модули маршрутизации
│  ├─ 📂 agents/             # Управление памятью Agent
│  ├─ 📂 artStyle/           # Управление художественными стилями
│  ├─ 📂 assets/             # Управление ассетами
│  ├─ 📂 assetsGenerate/     # Генерация ассетов
│  ├─ 📂 cornerScape/        # Управление раскадровкой (Storyboard)
│  ├─ 📂 general/            # Общие API
│  ├─ 📂 login/              # Аутентификация
│  ├─ 📂 migrate/            # Миграция данных
│  ├─ 📂 modelSelect/        # Выбор моделей
│  ├─ 📂 novel/              # Управление новеллами
│  ├─ 📂 other/              # Прочие функции
│  ├─ 📂 production/         # Управление производством и монтажом
│  ├─ 📂 project/            # Управление проектами
│  ├─ 📂 script/             # Генерация сценариев
│  ├─ 📂 scriptAgent/        # Интерфейс Script Agent
│  ├─ 📂 setting/            # Системные настройки
│  ├─ 📂 task/               # Управление задачами
│  └─ 📂 test/               # Тестовые API
├─ 📂 socket/                # Real-time коммуникация через WebSocket
├─ 📂 types/                 # Типы TypeScript
├─ 📂 utils/                 # Вспомогательные утилиты
├─ 📄 app.ts                 # Точка входа приложения (App Entry)
├─ 📄 core.ts                # Инициализация ядра системы
├─ 📄 env.ts                 # Обработка переменных окружения
├─ 📄 err.ts                 # Обработка ошибок
├─ 📄 logger.ts              # Модуль логирования
├─ 📄 router.ts              # Регистрация маршрутов
└─ 📄 utils.ts               # Общие утилиты
📄 Dockerfile                # Файл для сборки Docker
📄 electron-builder.yml      # Конфигурация сборки Electron
📄 skillList.json            # Список навыков
📄 LICENSE                   # Лицензия (Apache-2.0)
📄 NOTICES.txt               # Уведомления о сторонних зависимостях
📄 package.json              # Конфигурация проекта
📄 tsconfig.json             # Конфигурация TypeScript

🔗 Связанные репозитории

Репозиторий	Описание	GitHub	Gitee
Toonflow-app	Полноценный клиент (этот репозиторий, рекомендуется для большинства пользователей)	GitHub	Gitee
Toonflow-web	Исходный код Frontend (для frontend-разработчиков)	GitHub	Gitee

💡 Совет: Если вы просто хотите использовать Toonflow, достаточно скачать клиент из этого репозитория. Репозиторий Toonflow-web предназначен только для разработчиков, желающих внести изменения или доработать интерфейс.

👨‍👩‍👧‍👦 Discord сообщество

Нажмите на иконку ниже, чтобы присоединиться к Discord:

Или перейдите по прямой ссылке: https://discord.gg/HEjKmpNpAZ

💌 Свяжитесь с нами

📧 Email: ltlctools@outlook.com

📜 Лицензия

Toonflow распространяется как open-source проект под лицензией Apache-2.0 с дополнительным коммерческим соглашением.

Подробнее о лицензии Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0

Дополнительное коммерческое соглашение

Если данное ПО распространяется в виде продукта для 2 и более независимых третьих лиц, необходимо получить письменную коммерческую лицензию от HBAI-Ltd.
Если ПО используется совместно не более чем 5 юридическими лицами только для внутренних нужд (без оказания услуг внешним пользователям), это считается внутренним использованием и лицензия не требуется.
Запрещается удалять или изменять логотипы и информацию об авторских правах в Toonflow.

Сценарии бессрочного бесплатного использования

✅ Создание контента с помощью Toonflow и монетизация через видеоплатформы
✅ Вторичная разработка (secondary development) для внутреннего использования команды
✅ Совместное использование группой из ≤ 5 юридических лиц только внутри организации
✅ Личное обучение, научные исследования и любые некоммерческие цели

Тарифы коммерческой лицензии

Стадия	Годовая выручка	Годовой взнос
🌱 Старт / Поддержка	< ¥100 000 RMB	Бесплатно
🚀 Стартап	¥100 000 – 500 000 RMB	¥5,000 / год
📈 Рост	¥500 000 – 1 500 000 RMB	¥20,000 / год
🏢 Масштабирование	¥1 500 000 – 5 000 000 RMB	¥80,000 / год
🌐 Корпоративный	> ¥5 000 000 RMB	Договорная цена

Оговорка о необратной силе: Пользователи, которые использовали Toonflow под лицензией AGPL-3.0 до выхода версии v1.0.8, продолжают работать по правилам AGPL-3.0. Изменения данного соглашения на них не распространяются.

Полный текст соглашения доступен в файле LICENSE.

⭐️ История звезд (Star History)

🙏 Благодарности

Выражаем благодарность следующим open-source проектам за мощную поддержку Toonflow:

Express - Быстрый, гибкий и минималистичный веб-фреймворк для Node.js
AI SDK - AI инструментарий для TypeScript
Better-SQLite3 - Библиотека с высокой производительностью для SQLite3
Sharp - Высокопроизводительная библиотека Node.js для обработки изображений
Axios - Promise-based HTTP клиент
Zod - Библиотека валидации схем, ориентированная на TypeScript
Socket.IO - Движок для двунаправленной real-time связи на основе событий
Electron - Фреймворк для кроссплатформенных десктоп-приложений
Hugging Face Transformers - Библиотека для локального ML инференса

Спасибо следующим организациям/лицам за поддержку Toonflow:

Logo	Название	Тип поддержки	Описание	Сайт
	Sophnet	💻 Спонсор	Создание быстрой, стабильной и экономичной платформы API для инференса моделей	Сайт
	Atlas Cloud	💻 Спонсор	Первая в мире мультимодальная платформа вывода. Чат, изображения, видео, аудио — единый API. 300+ моделей, совместимость с OpenAI.	Сайт

Полный список зависимостей третьих сторон находится в файле NOTICES.txt.

FilesExpand file tree

README.ru.md

Latest commit

History

README.ru.md

File metadata and controls

Toonflow

🌐 Мультиязычная поддержка

🌟 Основные возможности

📦 Сценарии использования

🔰 Руководство пользователя

📺 Видеоуроки

🚀 Установка

Предварительные требования

Локальная установка (на ПК)

1. Скачивание и установка

2. Запуск сервиса

Развертывание через Docker

Предварительные требования

Способ 1: Онлайн-развертывание

Способ 2: Локальная сборка

Описание портов сервиса

Облачное развертывание / Установка на сервер

I. Требования к серверу

II. Развертывание

1. Установка окружения

2. Загрузка и сборка проекта

3. Настройка PM2

4. Запуск сервиса

5. Полезные команды

6. Развертывание Frontend

🔧 Руководство разработчика

🛠️ Стек технологий

Подготовка среды разработки

Быстрый запуск проекта

Разработка Frontend

Структура проекта

🔗 Связанные репозитории

👨‍👩‍👧‍👦 Discord сообщество

💌 Свяжитесь с нами

📜 Лицензия

Дополнительное коммерческое соглашение

Сценарии бессрочного бесплатного использования

Тарифы коммерческой лицензии

⭐️ История звезд (Star History)

🙏 Благодарности

copyright © Huaibei AIA Network Technology Co., Ltd.