HKUDS/ViMax

これは何？

主な機能

• 01短いアイデアから、脚本、ストーリーボード、ショットを含む完成動画を生成する。
• 02明示的な脚本を複数シーン・複数ショットの動画に変換する。
• 03長編小説をエピソード形式の映像作品に翻案する。
• 04生成するシーンを通して、人物やペットの外見の一貫性を保つ。
• 05制作計画、修正、レンダリングを操作できるインタラクティブなTUIとローカルWeb UIを提供する。
• 06互換性のあるショットやメディア素材を並列で生成する。

ユースケース

• 文章で書かれたコンセプトから短編映画や予告編のプロトタイプを作る。
• 脚本をレビュー用のラフなマルチショット動画にする。
• 小説の一章をエピソード形式のアニメ風動画に翻案する。
• ユーザー自身の写真が登場する、パーソナライズされた短編ストーリーを作る。

クイックスタート

1. 1

   uvをインストールする（READMEにリンクされているuvのドキュメントを参照）

2. 2

   リポジトリをクローンする

   git clone https://github.com/HKUDS/ViMax.git
3. 3

   プロジェクトディレクトリに移動して、依存関係をインストールする

   cd ViMax && uv sync
4. 4

   ローカルのエージェント設定を作成し、APIキーを追加してからTUIを起動する

   cp configs/agent.example.yaml configs/agent.local.yaml

使う前に知っておきたいこと

• !LLM、画像生成、動画生成プロバイダーのAPIキーが必要です。費用が高額になる場合があります。
• !実行前に、モデルとプロバイダーの詳細を記載したYAMLファイルを設定する必要があります。
• !READMEに記載されている対応OSはLinuxとWindowsのみです。

トピック

よくある質問

ViMax とは？

ストーリーのアイデア、脚本、小説から、脚本・ストーリーボード・キャラクター・動画生成エージェントを連携させてマルチショット動画を作る、エージェント型動画生成フレームワーク。 ViMaxは、物語から完成した動画までの制作工程を自動化する、エージェント型の動画制作フレームワークです。脚本の執筆、ストーリーボードの作成、キャラクターと参照素材のデザイン、ショットの計画、画像・動画の生成、最終的な編集までを担うため、ユーザーはショットを一つずつ手作業で作らなくても、短いコンセプトや長文のテキストから制作を始められます。

ViMax は無料で使えますか？ライセンスは？

ViMax は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

ViMax は今もメンテナンスされていますか？

活発にメンテナンス中。ViMax の最終コミットは 2026年9月30日 です。

ViMax は何に使えますか？

文章で書かれたコンセプトから短編映画や予告編のプロトタイプを作る。 脚本をレビュー用のラフなマルチショット動画にする。 小説の一章をエピソード形式のアニメ風動画に翻案する。 ユーザー自身の写真が登場する、パーソナライズされた短編ストーリーを作る。

ViMax のインストール方法は？

uvをインストールする（READMEにリンクされているuvのドキュメントを参照） リポジトリをクローンする: git clone https://github.com/HKUDS/ViMax.git プロジェクトディレクトリに移動して、依存関係をインストールする: cd ViMax && uv sync ローカルのエージェント設定を作成し、APIキーを追加してからTUIを起動する: cp configs/agent.example.yaml configs/agent.local.yaml

ViMax はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/HKUDS/ViMax