725 lines
38 KiB
Markdown
725 lines
38 KiB
Markdown
<img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=200§ion=header&text=Toonflow&fontSize=90&fontColor=ffffff&animation=fadeIn&fontAlignY=50" width="100%"/>
|
||
|
||
<p>
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub" />
|
||
</a>
|
||
|
|
||
<a href="https://gitee.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="https://img.shields.io/badge/Gitee-C71D23?style=flat-square&logo=gitee&logoColor=white" alt="Gitee" />
|
||
</a>
|
||
|
|
||
<a href="https://gitcode.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="./atomgitLogo.svg" alt="Atomgit" style="height:20px"/>
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="../README.md">简体中文</a> |
|
||
<a href="./README.zhtw.md">繁體中文</a> |
|
||
<a href="./README.en.md">English</a> |
|
||
<a href="./README.th.md">ไทย</a> |
|
||
<a href="./README.vi.md">Tiếng Việt</a> |
|
||
<a href="./README.ja.md">日本語</a> |
|
||
<strong>Русский</strong>
|
||
</p>
|
||
|
||
<div align="center">
|
||
|
||
<img src="./logo.png" alt="Toonflow Logo" height="120"/>
|
||
|
||
# Toonflow
|
||
|
||
<p align="center">
|
||
<b>
|
||
Фабрика AI-мини-сериалов и короткометражных фильмов
|
||
<br />
|
||
Всего несколько кликов — и ваша новелла превращается в фильм или сериал!
|
||
<br />
|
||
AI-сценарий × AI-изображения × Сверхбыстрая генерация 🔥
|
||
</b>
|
||
</p>
|
||
<p align="center">
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/stargazers">
|
||
<img src="https://img.shields.io/github/stars/HBAI-Ltd/Toonflow-app?style=for-the-badge&logo=github" alt="Stars Badge" />
|
||
</a>
|
||
<a href="https://www.apache.org/licenses/LICENSE-2.0" target="_blank">
|
||
<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge" alt="Apache-2.0 License Badge" />
|
||
</a>
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/releases">
|
||
<img alt="release" src="https://img.shields.io/github/v/release/HBAI-Ltd/Toonflow-app?style=for-the-badge" />
|
||
</a>
|
||
</p>
|
||
<p align="center">
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/network/members">
|
||
<img src="https://img.shields.io/github/forks/HBAI-Ltd/Toonflow-app?style=for-the-badge&logo=github&color=orange" alt="Forks Badge" />
|
||
</a>
|
||
<a href="https://atomgit.com/HBAI-Ltd/Toonflow-app">
|
||
<img src="https://img.shields.io/badge/AtomGit-G--Star%20No.540-FF6B35?style=for-the-badge&logo=git&logoColor=white" alt="AtomGit G-Star No.540" />
|
||
</a>
|
||
<a href="https://discord.gg/HEjKmpNpAZ">
|
||
<img src="https://img.shields.io/badge/Discord-Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" />
|
||
</a>
|
||
</p>
|
||
<p align="center">
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/issues">
|
||
<img src="https://img.shields.io/github/issues/HBAI-Ltd/Toonflow-app?style=for-the-badge&color=F48D73" alt="Issues" />
|
||
</a>
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/graphs/contributors">
|
||
<img src="https://img.shields.io/github/contributors/HBAI-Ltd/Toonflow-app?style=for-the-badge&color=2088FF" alt="Contributors" />
|
||
</a>
|
||
<a href="https://github.com/HBAI-Ltd/Toonflow-app/commits">
|
||
<img src="https://img.shields.io/github/last-commit/HBAI-Ltd/Toonflow-app?style=for-the-badge&color=blueviolet" alt="Last Commit" />
|
||
</a>
|
||
</p>
|
||
<p align="center">
|
||
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/TypeScript/typescript2.svg" alt="TypeScript" />
|
||
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/NodeJS/nodejs2.svg" alt="Node.js" />
|
||
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Docker/docker2.svg" alt="Docker" />
|
||
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Electron/electron2.svg" alt="Electron" />
|
||
</p>
|
||
<p align="center">
|
||
<img src="https://mobaicons.com/icons/typescript,nodejs,electron,docker,socket?perline=5" alt="Tech Stack Icons" />
|
||
</p>
|
||
<p align="center">
|
||
<img src="https://widgetbite.com/stats/HBAI-Ltd" alt="Visitors" />
|
||
</p>
|
||
|
||
> 🚀 **All-in-One платформа для коротких сериалов и фильмов**: От текста до персонажей, от раскадровки до готового видео. Полная автоматизация с помощью ИИ с нулевым порогом входа — повышает эффективность творчества в 10 раз и более!
|
||
</div>
|
||
|
||
<div align="center">
|
||
<img src="./g-star.png" alt="Сертификат AtomGit G-Star" height="300"/>
|
||
</div>
|
||
|
||
---
|
||
|
||
# 🌐 Мультиязычная поддержка
|
||
|
||
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](https://www.bilibili.com/video/BV1oXD7BqEqJ)
|
||
[](https://www.bilibili.com/video/BV1oXD7BqEqJ)
|
||
|
||
**Toonflow: Быстрый старт в AI-видео за 12 минут**
|
||
👉 [Нажмите для просмотра](https://www.bilibili.com/video/BV1oXD7BqEqJ/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e)
|
||
|
||
📱 Отсканируйте QR-код для просмотра видео на телефоне
|
||
|
||
<img src="./videoQR.png" alt="Сканировать QR-код для просмотра видео" width="150"/>
|
||
|
||
---
|
||
|
||
# 📸 Скриншоты и демо-видео
|
||
|
||
Скриншоты и видео ниже взяты из демонстрационного AI-сериала, созданного с помощью Toonflow примерно за 2 часа. Процесс охватывал генерацию сценария, раскадровку и монтаж.
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%"><a href="../screenshot/1.png"><img src="../screenshot/1.png" width="100%"/></a></td>
|
||
<td width="50%"><a href="../screenshot/2.png"><img src="../screenshot/2.png" width="100%"/></a></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%"><a href="../screenshot/3.png"><img src="../screenshot/3.png" width="100%"/></a></td>
|
||
<td width="50%"><a href="../screenshot/4.png"><img src="../screenshot/4.png" width="100%"/></a></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%"><a href="../screenshot/5.png"><img src="../screenshot/5.png" width="100%"/></a></td>
|
||
<td width="50%"><a href="../screenshot/6.png"><img src="../screenshot/6.png" width="100%"/></a></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%"><a href="../screenshot/7.png"><img src="../screenshot/7.png" width="100%"/></a></td>
|
||
<td width="50%"><a href="../screenshot/8.png"><img src="../screenshot/8.png" width="100%"/></a></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="50%"><a href="../screenshot/9.png"><img src="../screenshot/9.png" width="100%"/></a></td>
|
||
<td width="50%"><a href="../screenshot/10.png"><img src="../screenshot/10.png" width="100%"/></a></td>
|
||
</tr>
|
||
</table>
|
||
|
||
## Информация о демо
|
||
|
||
| Пункт | Подробности |
|
||
|-------|------------|
|
||
| Период производства | ~2 часа |
|
||
| Модель видео | Seedance 2.0 |
|
||
| Модель изображений | GPT Image 2 |
|
||
| Языковая модель | Claude Opus 4.6 |
|
||
| Хронометраж | ~2 мин (исходный материал 3 мин, ~1 мин удалено)|
|
||
|
||
## Разбивка затрат
|
||
|
||
| Пункт | Стоимость |
|
||
|-------|-----------|
|
||
| Изображения (270 шт. × ¥0.04) | ¥10.8 |
|
||
| Видео (45 клипов × ¥3.5) | ¥157.5 |
|
||
| Итого | **~¥168** |
|
||
|
||
> 📌 Исходное разрешение демо-видео — 1080×1882, опубликованная версия сжата до 480p. По вопросам авторских прав обращайтесь: [ltlctools@outlook.com](mailto:ltlctools@outlook.com).
|
||
|
||
## Демо-видео
|
||
|
||
https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
|
||
|
||
> Если видео не воспроизводится, [нажмите для скачивания](https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9).
|
||
|
||
---
|
||
|
||
# 🚀 Установка
|
||
|
||
## Предварительные требования
|
||
|
||
Перед установкой и использованием Toonflow подготовьте следующее:
|
||
|
||
- ✅ URL API для LLM (большой языковой модели)
|
||
- ✅ URL API для генерации видео (Sora или Doubao)
|
||
- ✅ URL API для генерации изображений (Nano Banana Pro)
|
||
|
||
## Локальная установка (на ПК)
|
||
|
||
### 1. Скачивание и установка
|
||
|
||
| ОС | GitHub | Atomgit | Скачать (Quark Drive) | Описание |
|
||
| :------: | :----------------------------------------------------------- | :------------------------------------------------------------ | :---------------------------------------------- | :------------- |
|
||
| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Официальный установщик |
|
||
| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Официальный установщик |
|
||
| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Release](https://gitcode.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Drive](https://pan.quark.cn/s/94ef07509df0) | Официальный установщик |
|
||
|
||
> [!CAUTION]
|
||
> Пользователям macOS необходимо перейти в **Системные настройки → Конфиденциальность и безопасность** и разрешить запуск приложения. В противном случае программа может не открыться из-за проблем с сертификатом.
|
||
>
|
||
> Подробнее (на китайском): [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276)
|
||
|
||
> Из-за технических ограничений Gitee Release (размер файлов и окружение) ссылки для скачивания на Gitee временно недоступны.
|
||
|
||
### 2. Запуск сервиса
|
||
|
||
После завершения установки просто откройте программу Toonflow — сервис будет готов к работе.
|
||
|
||
> ⚠️ **Данные для первого входа**
|
||
> Логин: `admin`
|
||
> Пароль: `admin123`
|
||
|
||
## Развертывание через Docker
|
||
|
||
### Предварительные требования
|
||
|
||
- Установлен [Docker](https://docs.docker.com/get-docker/) версии 20.10 или выше
|
||
|
||
### Способ 1: Онлайн-развертывание
|
||
|
||
В настоящее время в стадии разработки.
|
||
Рекомендуется использовать локальную сборку.
|
||
|
||
### Способ 2: Локальная сборка
|
||
|
||
Сборка проекта непосредственно из исходного кода на вашем компьютере.
|
||
Подходит для разработчиков и пользователей, которые уже клонировали репозиторий. Требуется установленная система контроля версий Git:
|
||
|
||
```shell
|
||
# Сначала клонируйте проект (пропустите, если уже сделано)
|
||
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. Установка окружения
|
||
|
||
```bash
|
||
# Установка 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:**
|
||
|
||
```bash
|
||
cd /opt
|
||
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
yarn install
|
||
yarn build
|
||
```
|
||
|
||
**Клонирование с Gitee (рекомендуется для Китая):**
|
||
|
||
```bash
|
||
cd /opt
|
||
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
yarn install
|
||
yarn build
|
||
```
|
||
|
||
#### 3. Настройка PM2
|
||
|
||
Создайте файл `pm2.json`:
|
||
|
||
```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. Запуск сервиса
|
||
|
||
```bash
|
||
pm2 start pm2.json
|
||
pm2 startup
|
||
pm2 save
|
||
```
|
||
|
||
#### 5. Полезные команды
|
||
|
||
```bash
|
||
pm2 list # Список процессов
|
||
pm2 logs toonflow-app # Просмотр логов
|
||
pm2 restart all # Перезапуск сервисов
|
||
pm2 monit # Панель мониторинга
|
||
```
|
||
|
||
> ⚠️ **Данные для первого входа**
|
||
> Логин: `admin`
|
||
> Пароль: `admin123`
|
||
|
||
#### 6. Развертывание Frontend
|
||
|
||
Если вам нужно отдельно развернуть или кастомизировать фронтенд, перейдите в репозиторий Toonflow-web:
|
||
|
||
- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
|
||
- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/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**: рекомендуется использовать в качестве пакетного менеджера
|
||
|
||
## Быстрый запуск проекта
|
||
|
||
1. **Клонирование проекта**
|
||
|
||
**С GitHub:**
|
||
|
||
```bash
|
||
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
```
|
||
|
||
**С Gitee:**
|
||
|
||
```bash
|
||
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
|
||
cd Toonflow-app
|
||
```
|
||
|
||
2. **Установка зависимостей**
|
||
|
||
Выполните следующую команду в корневой папке проекта:
|
||
|
||
```bash
|
||
yarn install
|
||
```
|
||
|
||
3. **Запуск среды разработки**
|
||
|
||
Проект состоит из **Backend API** и **Frontend страниц**. Выберите нужный способ запуска:
|
||
|
||
- **Способ 1: Запуск только Backend**
|
||
|
||
```bash
|
||
yarn dev
|
||
```
|
||
|
||
> ⚠️ Эта команда запускает **только Backend API** (порт 10588) **без интерфейса Frontend**.
|
||
> При переходе по адресу `http://localhost:10588` вы сможете только обращаться к API. Полноценный графический интерфейс отображаться не будет.
|
||
> Чтобы работать с UI, запустите Frontend отдельно или используйте режим GUI (см. ниже).
|
||
|
||
- **Способ 2: Запуск клиента Electron (GUI)**
|
||
|
||
```bash
|
||
yarn dev:gui
|
||
```
|
||
|
||
> Эта команда одновременно запускает Backend и десктопное приложение Electron со встроенным Frontend.
|
||
> Программа готова к работе сразу после запуска, без дополнительных настроек.
|
||
> Идеально подходит для разработчиков, которые хотят быстро протестировать весь функционал приложения.
|
||
|
||
- **Способ 3: Запуск в режиме Production**
|
||
|
||
```bash
|
||
yarn start
|
||
```
|
||
|
||
> Запуск скомпилированного сервиса в режиме Production (сначала необходимо выполнить `yarn build`).
|
||
|
||
4. **Сборка проекта (Build & Package)**
|
||
|
||
- Компиляция и генерация TypeScript:
|
||
|
||
```bash
|
||
yarn build
|
||
```
|
||
|
||
- Сборка исполняемого файла для Windows:
|
||
|
||
```bash
|
||
yarn dist:win
|
||
```
|
||
|
||
- Сборка исполняемого файла для Mac:
|
||
|
||
```bash
|
||
yarn dist:mac
|
||
```
|
||
|
||
- Сборка исполняемого файла для Linux:
|
||
|
||
```bash
|
||
yarn dist:linux
|
||
```
|
||
|
||
5. **Проверка качества кода (Linting)**
|
||
|
||
- Запуск глобальной проверки синтаксиса:
|
||
|
||
```bash
|
||
yarn lint
|
||
```
|
||
|
||
6. **Панель отладки AI (Опционально)**
|
||
|
||
Запуск визуального инструмента отладки AI SDK:
|
||
|
||
```bash
|
||
yarn debug:ai
|
||
```
|
||
|
||
## Разработка Frontend
|
||
|
||
Если вам нужно внести изменения в пользовательский интерфейс, перейдите в репозиторий фронтенда:
|
||
|
||
- **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web)
|
||
- **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/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](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) |
|
||
| **Toonflow-web** | Исходный код Frontend (для frontend-разработчиков) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) |
|
||
|
||
> 💡 **Совет**: Если вы просто хотите использовать Toonflow, достаточно скачать клиент из этого репозитория. Репозиторий Toonflow-web предназначен только для разработчиков, желающих внести изменения или доработать интерфейс.
|
||
|
||
---
|
||
|
||
# 👨👩👧👦 Discord сообщество
|
||
|
||
Нажмите на иконку ниже, чтобы присоединиться к Discord:
|
||
|
||
[](https://discord.gg/HEjKmpNpAZ)
|
||
|
||
Или перейдите по прямой ссылке: [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ)
|
||
|
||
---
|
||
|
||
# 💌 Свяжитесь с нами
|
||
|
||
📧 Email: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Запрос%20Toonflow)
|
||
|
||
---
|
||
|
||
# 📜 Лицензия
|
||
|
||
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](./LICENSE).
|
||
|
||
---
|
||
|
||
# ⭐️ История звезд (Star History)
|
||
|
||
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app)
|
||
|
||
[](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)
|
||
|
||
---
|
||
|
||
|
||
# 🙏 Благодарности
|
||
|
||
Выражаем благодарность следующим open-source проектам за мощную поддержку Toonflow:
|
||
|
||
- [Express](https://expressjs.com/) - Быстрый, гибкий и минималистичный веб-фреймворк для Node.js
|
||
- [AI SDK](https://ai-sdk.dev/) - AI инструментарий для TypeScript
|
||
- [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Библиотека с высокой производительностью для SQLite3
|
||
- [Sharp](https://sharp.pixelplumbing.com/) - Высокопроизводительная библиотека Node.js для обработки изображений
|
||
- [Axios](https://axios-http.com/) - Promise-based HTTP клиент
|
||
- [Zod](https://zod.dev/) - Библиотека валидации схем, ориентированная на TypeScript
|
||
- [Socket.IO](https://socket.io/) - Движок для двунаправленной real-time связи на основе событий
|
||
- [Electron](https://www.electronjs.org/) - Фреймворк для кроссплатформенных десктоп-приложений
|
||
- [Hugging Face Transformers](https://huggingface.co/docs/transformers.js) - Библиотека для локального ML инференса
|
||
|
||
Спасибо следующим организациям/лицам за поддержку Toonflow:
|
||
|
||
<table>
|
||
<thead>
|
||
<tr>
|
||
<th align="center">Logo</th>
|
||
<th align="center">Название</th>
|
||
<th align="center">Тип поддержки</th>
|
||
<th>Описание</th>
|
||
<th align="center">Сайт</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td align="center"><img src="./sponsored/sophnet.png" alt="Sophnet Logo" width="48"></td>
|
||
<td align="center"><b>Sophnet</b></td>
|
||
<td align="center">💻 Спонсор</td>
|
||
<td>Создание быстрой, стабильной и экономичной платформы API для инференса моделей</td>
|
||
<td align="center"><a href="https://www.sophnet.com/">Сайт</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><img src="./sponsored/atlascloud.png" alt="Atlas Cloud Logo" width="48"></td>
|
||
<td align="center"><b>Atlas Cloud</b></td>
|
||
<td align="center">💻 Спонсор</td>
|
||
<td>Первая в мире мультимодальная платформа вывода. Чат, изображения, видео, аудио — единый API. 300+ моделей, совместимость с OpenAI.</td>
|
||
<td align="center"><a href="https://www.atlascloud.ai/">Сайт</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td align="center"><img src="./sponsored/hunyuan.webp" alt="Tencent Hunyuan3D Logo" width="48"></td>
|
||
<td align="center"><b>Tencent Hunyuan3D</b></td>
|
||
<td align="center">🌐 Техническая поддержка World Model</td>
|
||
<td>Tencent Hunyuan3D AI Creation Engine основан на модели Tencent Hunyuan3D v2.5 — первая в отрасли комплексная платформа создания 3D-контента на базе ИИ. Поддерживает текст-в-3D, изображение-в-3D, генерацию 3D-анимации, текстур, эскиз-в-3D и 3D-персонажей, с преимуществами генерации low-poly моделей.</td>
|
||
<td align="center"><a href="https://3d.hunyuan.tencent.com/">Сайт</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
Полный список зависимостей третьих сторон находится в файле `NOTICES.txt`.
|
||
|
||
##### copyright © Beijing AIA Network Technology Co., Ltd.
|
||
|
||
<img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=100§ion=footer" width="100%"/> |