セルフホスティングガイド — AI動画生成ツールを無料で動かす4つの方法

動作環境

デプロイ前に以下の要件を確認してください（Dockerを選べばスキップ可能 — イメージにすべての依存関係が含まれています）：

• Python 3.10+（手動方式とnpm方式に必要）
• ffmpeg（手動方式のみ必要；Dockerとnpmには同梱）
• Node.js 18+（npm方式のみ必要）
• Git（リポジトリのクローン用）
• GPU不要・大容量メモリ不要 — AI計算はすべてクラウドで行われ、普通のノートPCで十分

4つのデプロイ方法

どれかひとつ選べばサービスが起動します。ブラウザで http://localhost:8765 を開いてください。

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
./start.sh

docker run -d -p 8765:8765 \
  -e AGNES_API_KEY=<あなたのキー> \
  -v ~/agnes-data/working:/app/.working_dir \
  -v ~/agnes-data/config:/app/.agnes_config \
  ghcr.io/lcy362/free-short-video:latest

npx free-short-video
# またはグローバルインストールして実行：free-short-video（短縮エイリアス：fsv）
AGNES_API_KEY=<あなたのキー> npx free-short-video

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
# あとはAIエージェントにこう伝えるだけ：
"このプロジェクトのAGENTS.mdを読んで、依存関係をインストールし、APIキーを設定して、サービスを起動して。"

デプロイ成功の確認方法

• ブラウザが自動で開く（または http://localhost:8765 にアクセス）— Agnes Video Generator の画面が見えれば成功
• ページ上部に無料のAPIキーを貼り付けて生成を開始
• 所要時間の目安：シンプル動画 約1〜3分、クリエイティブ長編（5シーン）約10〜20分

使い方のポイント

• 再開：サービスが中断したら再起動し、タスク一覧で未完了タスクの「再開」をクリック
• 出力先：すべての成果物は .working_dir/{タイムスタンプ}_{task_id}/ に保存。final_video.mp4 が最終動画（ナレーションと字幕入り）
• ポート占有：8765が使われている場合、macOS/Linuxは lsof -ti:8765 | xargs kill、Windowsは netstat -ano | findstr :8765 でPIDを調べて taskkill
• API呼び出しは1分あたり16回まで — 無料を維持するための制限であり、パソコンが遅いわけではありません