leamsigc/ShortsGenerator

ShortsGenerator – 自動化されたYouTube Shortsビルダー

機能概要

• テキストプロンプトからAIが作成したスクリプト、ストック映像、テキスト読み上げ、字幕、BGM、オプションの画像連結を使用してショート動画を生成します。
• Nuxt 3で構築されたWeb UIがFlaskバックエンドと通信します。バックエンドはパイプライン全体を実行し、RESTエンドポイントのセットを公開します。
• 動画作成後、MagicSync統合を通じて複数のソーシャルプラットフォーム（Instagram、TikTok、Facebook、LinkedIn、YouTube）にスケジュール投稿できます。

主要コンポーネント

レイヤー	技術 / 役割
バックエンド	Python 3.11、Flask、ffmpeg、Torch（Qwen-3 TTS用）、g4f/Gemini（スクリプト生成用）。ストック動画検索（Pexels API）、TTS（Supertonic、TikTok、KittenTTS、Qwen-3）、字幕レンダリング、動画連結、MagicSync API呼び出しを処理します。
フロントエンド	Nuxt 3（Vue）UI。localhost:3000で実行。テーマの入力、生成されたスクリプトの編集、音声、字幕、アスペクト比、音楽などの選択が可能で、記載されたAPIを介してバックエンドをトリガーします。
AIモデル	• スクリプト: 無料のg4f（ブラウザCookieベース）またはGemini（GOOGLE_API_KEY経由）。
• TTS: ローカルのSupertonic（10音声、33言語）、TikTok TTS（フォールバック）、KittenTTS、Qwen-3-TTS（9種類のプリセット音色、音声デザイン、音声クローン対応のローカルモデル）。
メディアソース	Pexelsのストッククリップ、ユーザー提供の音楽ファイル、動画冒頭のオプション画像連結。
スケジュール	MagicSync – 複数のビジネスアカウント（API URL + トークン）を保存し、投稿時に使用するアカウントを選択できます。

使用方法

1. リポジトリをクローンし、.env.exampleを.envにコピーして、少なくともPEXELS_API_KEYとIMAGEMAGICK_BINARYを設定します。
2. バックエンド（python Backend/main.py）とNuxt UI（cd UI && pnpm i && npx nuxt dev --tunnel）を実行します。 Dockerもdocker compose up -dでサポートされています。
3. Web UIで動画のテーマを入力し、スクリプトを生成、調整し、音声と字幕スタイルを選択し、オプションの画像や音楽を追加して、生成をクリックします。
4. 動画が完了したら、サムネイルを抽出してプレビューし、MagicSyncでアップロードをスケジュールできます。

注目機能

• マルチボイスTTS – ローカルの高品質モデル（Qwen-3）とフォールバックを備えています。
• 字幕テンプレート（10のビジュアルスタイル）が自動生成されます。
• アスペクト比の柔軟性 – 縦型Short（9:16）や他の形式に対応。
• ハードウェアアクセラレーション – GPUを検出し、ffmpeg/Torchに渡してエンコードを高速化します。
• マルチビジネスMagicSync – クライアントごとにAPI資格情報を保存し、スケジュール時に適切なものを選択できます。

有用性

• 手動で動画を編集せずにYouTube Shortsを大量生産したいコンテンツクリエイター。
• 複数のブランドアカウントを管理し、再現可能なパイプラインを必要とする小規模な代理店。
• エンドツーエンドの短尺動画生成スタックのオープンソース参照実装を探している開発者。

制限事項

• Python 3.11とかなり重い依存関係スタック（Torch、Qwen-3ウェイト約3GB）が必要です。
• 一部のAIサービス（Gemini、OpenAI）にはAPIキーが必要です。無料のg4fパスはブラウザCookieに依存します。
• スケジュールは専有のMagicSyncサービスでのみ機能します。リポジトリには汎用のソーシャルメディアAPIは含まれていません。

ライセンス

• プロジェクトはLICENSEファイルにあるライセンス（ここには記載されていません）でリリースされています。