sorker/ai-shotlive

AI ShotLive Director – ワンストップAIショートドラマ / モーションコミック制作プラットフォーム

概要

• 小説やストーリーの構成案を、フル尺のショートビデオやコミックに変換できる、Web（およびElectron経由のデスクトップ）アプリケーションです。ワークフローは完全に工業化されています：小説 → 台本 → 絵コンテ → アセット → キーフレーム → 最終ビデオ。
• 自らAIモデルをホストするのではなく、薄いアダプター層を通じて外部のテキスト、画像、ビデオ、オーディオAPI（OpenAI, Anthropic, Google Gemini, AntSK, etc.）を呼び出します。

コア・コンセプト

• キーフレーム駆動型生成 – システムはまず各ショットの開始フレームと終了フレームを作成し、次にビデオモデルで中間フレームを補完します。これにより、視覚的な一貫性を維持しながら、高コストなビデオ生成の量を削減できます。
• アセット制約 – キャラクターの「メイクアップ」画像やシーンのコンセプトアートが、生成されるすべてのフレームの参照として使用され、ショット間で同じキャラクターが同じように見えることを保証します。
• マルチモデル・サポート – テキスト、画像、ビデオ、オーディオのプロバイダーを自由に組み合わせることができ、Model Config ページでAPIキーを変更するだけでモデルを切り替えることができます。

主なモジュール

フェーズ	機能
01 – 小説 & 台本	.txt形式の小説をアップロードし、章を自動解析、エピソード台本を生成する章を選択、またはストーリーの構成案を直接貼り付けます。AIがシーンの分解、ダイアログ、視覚的プロンプトを生成します。
02 – アセット & キャスティング	キャラクターの参照画像（衣装のバリエーションを含む）とシーンのコンセプトアートを生成し、カスタムプロップ（小道具）をアップロードします。
03 – ディレクター・ワークベンチ	グリッドベースの絵コンテエディタ。最初/最後のキーフレームを編集、各ショットの9グリッドプレビュー、現在のキャラクターとシーンの画像を使用するコンテキスト認識型生成、image‑to‑video (I2V) とキーフレーム補完モードの両方をサポートします。
04 – エクスポート & 編集	タイムラインプレビュー、マルチトラック・ビデオエディタ（ビデオ、オーディオ、字幕、画像）、AI生成字幕とTTSオーディオ、そして高解像度フレームまたはMP4としてエクスポートします。
アカウント & データ	ユーザーごとの分離、パスワード変更、MySQL/SQLiteのデータと data/ メディアフォルダを含むZIPによるプロジェクト/アセットの完全なバックアップと復元。

テクノロジースタック

• Frontend: React 19 + Vite 6, Tailwind CSS 4, Radix UI, Framer Motion.
• Backend: Express.js, JWT auth, MySQL 8 (or SQLite for local mode).
• Desktop client: Electron 33 with better‑sqlite3; macOS (Intel & Apple‑Silicon) と Windows 用にビルドされます。
• AI integration: アダプター層 (services/adapters) が、チャット、画像、ビデオ、オーディオ生成のための、サポートされているすべてのプロバイダーへの呼び出しを正規化します。
• Deployment: Docker compose (オプションで外部MySQLを使用) またはローカル開発用のシンプルな npm run dev。

クリエイターのための典型的なワークフロー

1. ログイン (デフォルトの admin/admin123 または新規登録)。
2. モデルの設定 – 使用したいテキスト、画像、ビデオ、オーディオサービスのAPIキーを追加します。
3. プロジェクトの作成 → 小説をアップロード、またはストーリーを貼り付けます。
4. 台本の生成 – AIが選択した章をシーン記述を含む脚本へと書き換えます。
5. アセットの生成 – キャラクターのルックブックとシーンのコンセプトアートを生成し、カスタムプロップをアップロードします。
6. 絵コンテ作成 – ショットを編集し、最初/最後のキーフレームを設定し、9グリッド表示を選択し、ビデオモデルにクリップを求めてレンダリングします。
7. 編集 & ブラッシュアップ – 内蔵のマルチトラック・エディタを使用して、AI生成字幕、TTSボイスオーバー、または追加のメディアを使用します。
8. エクスポート – 最終的なビデオまたは個別の高解像度フレームをダウンロードします。

はじめに

# clone and install
git clone https://github.com/sorker/ai-shotlive.git
cd ai-shotlive
npm install
cp .env.example .env   # edit DB and JWT settings

# local SQLite mode (no external DB needed)
npm run build:local
npm run start:local   # http://localhost:3001

プロダクション環境では、Dockerファイル (docker-compose.yaml または docker-compose.mysql.yaml) を使用できます。Electronクライアントは npm run build:electron でビルドし、.dmg or .exe として配布可能です。

どのような人が使うのか

• ビデオ編集ソフトの学習なしに、アニメーション・ショートやモーションコミックのプロトタイプを作りたい独立系クリエイター。
• 独自のモデルプロバイダーを自由にカスタマイズできる、迅速な「脚本-to-ビデオ」パイプラインを求めている小規模スタジオ。
• AI拡張ストーリーテリングやキーフレーム駆動型ビデオ生成を技術的にデックストレーションする教育者。

ライセンス

• Creative Commons BY‑NC‑SA 4.0 – 個人および非営利目的での使用は無料ですが、二次的著作物を同一ライセンスで共有する義務があります。

---

All details above are taken directly from the repository's README; no additional features were inferred.