zyc/video-flow-toon

Fork 0

ACT丶流星雨 cfdb3131d1 完善协议

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

21 KiB

Raw Blame History

| | Atomgit Atomgit

簡体字中国語 | 繁体字中国語 | 英語 | タイ語 | ベトナム語 | 日本語 | ロシア語

Toonflow

AI短編ドラマ工場
指先ひとつで、小説が瞬時にドラマ化！
AI脚本 × AI映像 × 超高速生成 🔥

🚀 ワンストップ短編ドラマ制作：テキストからキャラクター、絵コンテ、映像まで、0知識でAI化された全プロセス。創作効率10倍以上！

🌟 主な機能

ToonflowはAI短編漫画/ドラマ制作ツールで、小説をAIが自動的に脚本化し、AI生成画像・映像と組み合わせて高効率な短編ドラマ制作を実現します。Toonflowにより、テキストから映像までの流れを簡単に完結でき、短編ドラマ制作がよりスマート＆便利になります。

✅ キャラクター生成
元の小説テキストを自動分析し、外見・性格・身分など詳細なキャラクター設定をスマートに識別・生成。脚本・作画の基盤を提供します。
✅ 脚本生成
選択したエピソードや章に基づき、構造化された脚本（セリフ・シーン描写・ストーリー展開など）をシステムが自動生成。小説から映像脚本への効率的な変換を実現します。
✅ 絵コンテ作成
脚本内容に基づき、AIが適切な絵コンテプロンプトや画面設計を生成。前景・中景・背景、キャラクター動作、小道具設計、場面レイアウトを細分化し、脚本からビデオへの完全なルートマップを自動構築します。
✅ 動画合成
AI画像と動画技術を統合し、AI生成により映像クリップの作成が可能。オンライン編集と個別調整にも対応し、映像創作の効率アップ＆迅速実現をサポートします。

📦 利用シーン

ショート動画コンテンツ制作
小説の映像化実験
AI文学改編ツール
脚本開発＆高速プロトタイピング
動画素材生成

🔰 使い方ガイド

📺 動画チュートリアル

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

Toonflow 8分クイックスタートAI動画 👉 クリックして見る

📱 スマホWeChatでQRコードをスキャンして視聴

🚀 インストール

前提条件

本ソフトウェアのインストール・利用前に以下をご用意ください：

✅ 大規模言語モデルAIサービスのエンドポイント
✅ SoraまたはDoubao動画サービスAPI
✅ Nano Banana Pro画像生成モデルAPI

ローカルインストール

1. ダウンロード＆インストール

OS	GitHubダウンロード	Quark（夸克）クラウドダウンロード	説明
Windows	Release	夸克クラウド	公式配布インストーラ
Linux	Release	夸克クラウド	公式配布インストーラ
macOS	Release	夸克クラウド	公式配布インストーラ

Caution

MacOSの場合は、設定→プライバシーとセキュリティでセキュリティ設定を許可してください。証明書問題でアプリが開かない場合があります。

参考：知乎ドキュメント：https://www.zhihu.com/question/433389276

Gitee OSの制限とReleaseファイルのサイズ上限により、Gitee側のReleaseダウンロードは現在未提供です。

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

# 指定ポートの /web/index.html でアクセス可
# 例）http://localhost:10588/web/index.html

サービスポート情報

ポート	用途	デプロイマッピング
`10588`	UI	`10588:10588`

環境変数メモ：

変数	説明
`NODE_ENV`	実行環境、`prod`が本番
`PORT`	サービスポート（デフォルト10588）
`OSSURL`	ファイル保存URL（静的リソース）

クラウドデプロイ

1. サーバー環境要件

OS：Ubuntu 20.04以上/CentOS 7以上
Node.js：24.x（推奨、最低23.11.1以上）
メモリ：2GB以上

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`	ファイル保存URL（静的リソース）

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

💡 補足：このリポジトリにはビルド済のフロントリソースが内蔵済み。通常ユーザーはフロント分離構築は不要。フロントリポジトリはカスタム開発用です。

🔧 開発フローガイド

Caution

🚧 PR提出ガイドライン 🚧

⛔ masterブランチはPR不可｜ ✅ developブランチにPR提出

開発者のご参加を歓迎します。参加希望はコミュニティで主催者ACTにご連絡ください。

🛠️ 技術スタック

カテゴリ	技術
ランタイム	Node.js 23.11.1+
言語	TypeScript 5.x
バックエンド	Express 5
データベース	SQLite（better-sqlite3 / knex）
AI連携	Vercel AI SDK（OpenAI / Anthropic / Google / DeepSeek / 智谱 / MiniMax / 通義千問 / xAI）
ローカル推論	@huggingface/transformers（ONNX）
リアルタイム通信	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
```
開発環境の起動

本プロジェクトはバックエンドAPIサービスとフロントエンドがあります。次から用途を選択。
- 方法1：バックエンドのみ起動
```
yarn dev
```
  ⚠️ このコマンドはAPIサーバー（ポート10588）のみ起動。http://localhost:10588でAPIのみ利用。GUI表示にはフロントプロジェクトの起動または下記のGUIモードをご利用ください。
- 方法2：Electronデスクトップクライアント
```
yarn dev:gui
```
  バックエンドとElectronウィンドウが同時起動。内蔵フロント付きで即利用OK。すべての機能を体験したい方向け。
- 方法3：本番モードで起動
```
yarn start
```
  本番モードでビルド済サービスを直接起動（yarn buildが必要）。
プロジェクトパッケージ化
- TypeScriptファイルのビルド：
```
yarn build
```
- Windows用実行ファイル化：
```
yarn dist:win
```
- Mac用実行ファイル化：
```
yarn dist:mac
```
- Linux用実行ファイル化：
```
yarn dist:linux
```
コード品質チェック
- グローバルLintチェック：
```
yarn lint
```
AIデバッグパネル（任意）

AI SDKのGUIデバッグツール。AI呼び出しのデバッグに便利。
```
yarn debug:ai
```

フロントエンド開発

フロントUIの修正はフロントエンドリポジトリへ：

GitHub：Toonflow-web
Gitee：Toonflow-web

ビルド後、dist以下を本プロジェクト data/webへコピーで統合完了。

プロジェクト構成

📂 build/                    # ビルド成果物
📂 data/                     # 実行時データ
│  ├─ 📂 models/            # ローカル推論モデル（ONNX）
│  ├─ 📂 oss/               # オブジェクトストレージ（素材/キャラ/背景）
│  ├─ 📂 serve/             # 本番エントリ
│  ├─ 📂 skills/            # Agentプロンプト集
│  └─ 📂 web/               # ビルトインフロント
📂 docs/                     # ドキュメントリソース
📂 env/                      # 環境設定
📂 scripts/                  # ビルド＆ツールスクリプト
📂 src/
├─ 📂 agents/               # AI Agentモジュール
│  ├─ 📂 productionAgent/   # プロダクション用Agent
│  └─ 📂 scriptAgent/       # 脚本Agent
├─ 📂 lib/                  # 共通ライブラリ（DB初期化等）
├─ 📂 middleware/           # ミドルウェア
├─ 📂 routes/               # ルーティングモジュール
│  ├─ 📂 agents/            # Agentメモリ管理
│  ├─ 📂 artStyle/          # 画風管理
│  ├─ 📂 assets/            # 素材管理
│  ├─ 📂 assetsGenerate/    # 素材生成
│  ├─ 📂 cornerScape/       # 絵コンテ管理
│  ├─ 📂 general/           # 共通API
│  ├─ 📂 login/             # ログイン認証
│  ├─ 📂 migrate/           # データ移行
│  ├─ 📂 modelSelect/       # モデル選択
│  ├─ 📂 novel/             # 小説管理
│  ├─ 📂 other/             # その他機能
│  ├─ 📂 production/        # 制作管理
│  ├─ 📂 project/           # プロジェクト管理
│  ├─ 📂 script/            # 脚本生成
│  ├─ 📂 scriptAgent/       # 脚本AgentAPI
│  ├─ 📂 setting/           # システム設定
│  ├─ 📂 task/              # タスク管理
│  └─ 📂 test/              # テストAPI
├─ 📂 socket/               # WebSocket通信
├─ 📂 types/                # TypeScript型
├─ 📂 utils/                # ユーティリティ
├─ 📄 app.ts                # アプリエントリ
├─ 📄 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	フロントエンドソース（フロントエンド開発者向け）	GitHub	Gitee

💡 ヒント：Toonflowを利用したいだけなら本リポジトリをそのままダウンロードすればOK。フロントリポジトリはフロントカスタマイズや2次開発者向けです。

👨‍👩‍👧‍👦 WeChatコミュニティグループ

~~グループ1~~

~~グループ2~~

...

~~グループ10~~

~~グループ11~~

~~グループ12~~

~~グループ13~~

...

~~グループ24~~

グループ招待アシスタント:

💌 お問い合わせ

📧 メール：ltlctools@outlook.com

📜 ライセンス

ToonflowはApache-2.0ライセンス＋補足商業契約でオープンソース公開されています。

ライセンス詳細：https://www.apache.org/licenses/LICENSE-2.0

補足契約

本ソフトウェアを製品として2つ以上の独立した第三者に配布する場合、HBAI-Ltdの書面による商業許諾が必要です。
5法人以下の共同運営で内部利用のみの場合は、商業許諾不要です。
Toonflowの商標・ロゴ・著作権情報の削除・改変は禁止です。

永久無料シーン

✅ Toonflowでコンテンツを制作しプラットフォーム収益を得る
✅ 自チーム内部利用の二次開発
✅ ≤ 5法人の共同運営内部利用
✅ 個人学習・研究・非商用利用

商業ライセンス価格

段階	年間売上高	年間費用
🌱 育成期	< ¥10万	無料
🚀 スタートアップ	¥10〜50万	¥5,000/年
📈 成長期	¥50〜150万	¥20,000/年
🏢 拡大期	¥150〜500万	¥80,000/年
🌐 エンタープライズ	> ¥500万	要相談

不遡及条項：v1.0.8リリース前にAGPL-3.0でToonflowを使用していたユーザーは、本変更の影響を受けません。既存の利用はAGPL-3.0に基づき継続されます。

完全な契約内容は LICENSE をご覧ください。

⭐️ スター履歴

🙏 謝辞

以下のオープンソースプロジェクトの強力な支援に感謝します：

Express - 高速・オープンなNode.js Webフレームワーク
AI SDK - TypeScript向けAIツールキット
Better-SQLite3 - 高性能SQLite3バインディング
Sharp - 高速Node.js画像処理
Axios - PromiseベースHTTPクライアント
Zod - TypeScript優先のバリデーション
Socket.IO - リアルタイム双方向通信エンジン
Electron - クロスプラットフォームデスクトップ開発
Hugging Face Transformers - ローカル機械学習推論ライブラリ

以下の組織・団体・個人によるToonflowへの協力に感謝します：

算能云 よりコンピューティング協賛 [公式サイト]

第三者依存リストは NOTICES.txt をご覧ください

</translate_input>

21 KiB Raw Blame History Unescape Escape

Toonflow

🌟 主な機能

📦 利用シーン

🔰 使い方ガイド

📺 動画チュートリアル

🚀 インストール

前提条件

ローカルインストール

1. ダウンロード＆インストール

2. サービス起動

Dockerデプロイ

前提条件

方法1：オンラインデプロイ

方法2：ローカルビルド

サービスポート情報

クラウドデプロイ

1. サーバー環境要件

2. サーバーデプロイ

1. 環境インストール

2. プロジェクト導入

3. PM2構成

4. サービス起動

5. よく使うコマンド

6. フロントエンドのデプロイ

🔧 開発フローガイド

🛠️ 技術スタック

開発環境準備

プロジェクトのクイック起動

フロントエンド開発

プロジェクト構成

🔗 関連リポジトリ

👨‍👩‍👧‍👦 WeChatコミュニティグループ

💌 お問い合わせ

📜 ライセンス

補足契約

永久無料シーン

商業ライセンス価格

⭐️ スター履歴

🙏 謝辞

21 KiB

Raw Blame History