zyc/video-flow-toon

Fork 0

ACT丶流星雨 cfdb3131d1 完善协议

2026-03-31 03:22:27 +08:00

26 KiB

Raw Blame History

| | Atomgit Atomgit

Toonflow

AI-фабрика коротких сериалов
Одним движением — роман за секунду становится сериалом!
AI-сценарий × AI-изображения × Молниеносная генерация 🔥

🚀 Универсальный конвейер коротких сериалов: от текста к персонажам, от раскадровки к видео, 0 порога по всему процессу на базе AI, рост эффективности творчества 10× и более!

🌟 Основные функции

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

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

📦 Области применения

Создание коротких видео-контента
Эксперименты по экранизации романов
Инструмент AI для литературных адаптаций
Разработка сценариев и быстрые прототипы
Генерация видеоматериалов

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

📺 Видеоруководство

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

Toonflow: 8 минут до полного освоения AI-видео 👉 Смотреть видео

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

🚀 Установка

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

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

✅ Адрес API сервиса языковой AI-модели
✅ Адрес API Sora или Doubao для видео
✅ Адрес API сервиса модели Nano Banana Pro для генерации изображений

Установка локально

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

Операционная система	Скачать с GitHub	Скачать с Quark Disk	Примечание
Windows	Release	Quark Disk	Официальный установщик
Linux	Release	Quark Disk	Официальный установщик
macOS	Release	Quark Disk	Официальный установщик

Caution

Для macOS: откройте "Настройки → Конфиденциальность и безопасность" и настройте параметры безопасности, иначе может не открыться из-за проблемы с сертификатом.

См. на Zhihu: https://www.zhihu.com/question/433389276

Из-за ограничений Gitee OS и лимита по размеру файлов Release — отдельная ссылка для загрузки с Gitee временно недоступна.

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

После установки запустите приложение для начала работы.

⚠️ Первый вход
Логин: 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

# Доступ по адресу: http://localhost:10588/web/index.html

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

Порт	Назначение	Мэппинг в контейнере
`10588`	Web-интерфейс	`10588:10588`

Переменные окружения:

Переменная	Описание
`NODE_ENV`	Среда запуска, `prod` — продуктивная
`PORT`	Порт службы (по умолчанию 10588)
`OSSURL`	Доступ к хранилищу файлов, для статики

Развёртывание в облаке

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

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

2. Развёртывание на сервере

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/"
  }
}

Описание переменных:

Переменная	Описание
`NODE_ENV`	Среда запуска, `prod` — продакшн
`PORT`	Слушаемый порт
`OSSURL`	Адрес доступа к статике

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

pm2 start pm2.json
pm2 startup
pm2 save

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

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

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

6. Развёртывание фронта

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

GitHub: Toonflow-web
Gitee: Toonflow-web

💡 Примечание: В этот репозиторий уже встроен скомпилированный фронт. Обычным пользователям отдельная установка канала не требуется. Фронт-репозиторий — только для тех, кто хочет разрабатывать/модифицировать UI.

🔧 Руководство по процессу разработки

Caution

🚧 Правила по PR 🚧

⛔ В master запрещены любые PR | ✅ Создавайте PR только в ветку develop

Разработчиков приглашаем к со-разработке Toonflow! Для участия пишите главному админу ACT в группу.

🛠️ Технологический стек

Категория	Технологии
Рантайм	Node.js 23.11.1+
Язык	TypeScript 5.x
Бэкенд	Express 5
БД	SQLite (better-sqlite3 / knex)
AI-интеграции	Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhihu / MiniMax / Tongyi Qianwen / xAI)
Локальный AI	@huggingface/transformers (ONNX)
RTC	Socket.IO
Десктоп-клиент	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); без интерфейса. Для доступа к UI — используйте отдельный frontend проект или запускайте через GUI-модули ниже.
- 2: Electron-desktop-клиент
```
yarn dev:gui
```
  Открывает backend и Electron GUI-окно — всё встроено, без доп. настроек. Рекомендуется для полноценного использования.
- 3: Режим продакшн
```
yarn start
```
  Запуск производственной сборки (предварительно yarn build обязателен).
Сборка проекта
- Компиляция .ts файлов:
```
yarn build
```
- Сборка exe для Windows:
```
yarn dist:win
```
- Сборка для Mac:
```
yarn dist:mac
```
- Сборка для Linux:
```
yarn dist:linux
```
Lint и проверка кода
- Проверка кода на ошибки и стиль:
```
yarn lint
```
AI Debug-панель (по желанию)

Запуск GUI для отладки AI SDK:
```
yarn debug:ai
```

Фронтенд разработка

Для редактирования интерфейса используйте фронт-репозиторий:

GitHub: Toonflow-web
Gitee: Toonflow-web

После сборки фронта (dist/) скопируйте его содержимое в data/web/ основного проекта.

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

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

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

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

💡 Подсказка: если вы просто хотите пользоваться Toonflow — скачайте этот клиент. Отдельный frontend нужен только разработчикам UI.

👨‍👩‍👧‍👦 WeChat-группы

~~Группа 1~~

~~Группа 2~~

...

~~Группа 10~~

~~Группа 11~~

~~Группа 12~~

~~Группа 13~~

...

~~Группа 24~~

Ассистент по добавлению в группу:

💌 Обратная связь

📧 Email: ltlctools@outlook.com

📜 Лицензия

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

Подробности: https://www.apache.org/licenses/LICENSE-2.0

Дополнительное соглашение

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

Всегда бесплатно — без лицензии

✅ Создание контента в Toonflow и получение дохода на платформах
✅ Доработка для внутреннего использования команды
✅ ≤ 5 юрлиц — совместная внутренняя эксплуатация
✅ Личное обучение, исследования, некоммерческое использование

Цены на коммерческую лицензию

Этап	Годовой оборот	Годовая плата
🌱 Старт	< ¥100 тыс.	Бесплатно
🚀 Стартап	¥100–500 тыс.	¥5 000/год
📈 Рост	¥500 тыс.–1,5 млн	¥20 000/год
🏢 Масштаб	¥1,5–5 млн	¥80 000/год
🌐 Корпоративный	> ¥5 млн	По договорённости

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

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

⭐️ История звёзд

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

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

Express — быстрый, открытый и лёгкий фреймворк для Node.js
AI SDK — инструменты AI для TypeScript
Better-SQLite3 — высокопроизводительная обвязка SQLite3
Sharp — быстрая библиотека для работы с изображениями на Node.js
Axios — HTTP-клиент на промисах
Zod — TS-first валидация схем
Socket.IO — обмен событиями в реальном времени
Electron — кроссплатформенный desktop-фреймворк
Hugging Face Transformers — фреймворк для локального ML

Спасибо за поддержку проекту Toonflow от следующих организаций:

Sophnet Cloud — спонсор вычислительных ресурсов [сайт]

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

26 KiB Raw Blame History Unescape Escape

Toonflow

🌟 Основные функции

📦 Области применения

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

📺 Видеоруководство

🚀 Установка

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

Установка локально

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

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

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

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

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

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

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

Развёртывание в облаке

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

2. Развёртывание на сервере

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

2. Развёртывание проекта

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

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

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

6. Развёртывание фронта

🔧 Руководство по процессу разработки

🛠️ Технологический стек

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

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

Фронтенд разработка

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

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

👨‍👩‍👧‍👦 WeChat-группы

💌 Обратная связь

📜 Лицензия

Дополнительное соглашение

Всегда бесплатно — без лицензии

Цены на коммерческую лицензию

⭐️ История звёзд

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

26 KiB

Raw Blame History