gflow-cli – Google Flow（Veo と Imagen）のコマンドラインドライバー

概要

• Python ベースの CLI（およびオプションの MCP サーバー）で、ターミナルから Google の Flow サービス（Veo 動画生成と Imagen テキストから画像への変換を支える UI）を制御できます。
• Playwright で実際の Chrome/Chromium インスタンスを起動し、Google アカウントにログインして Flow UI を自動化します。すべての生成は Google のサーバーで行われ、自分の Flow クレジット残高に請求されます。

主な機能

機能	使用方法
バッチ生成	シェルループ内で gflow image t2i "プロンプト" または gflow video t2v "プロンプト" を使用。CLI は送信前に各項目をローカルに記録するため、クラッシュしてもクレジットを無駄にしません。
再利用可能なキャラクター	gflow character create … で顔と体の参照を保存し、同じ「人物」を複数の生成にわたって使用できます。
プロンプトツール	--tool creative-director は短いプロンプトを Google 推奨の 5 コンポーネント形式に書き換えます。docs/TOOLS.md でカスタムツールを追加できます。
パイプラインとストレージ	出力はデフォルトで $GFLOW_CLI_OUTPUT_DIR に保存されます。GFLOW_CLI_STORAGE_URI で S3、MinIO、GCS を指定できます。
エージェント統合	4 つのエントリポイント（gflow mcp run、gflow serve など）が、Claude Code、Codex、その他の LLM 駆動ツールなどの AI エージェントに同じコマンドを公開します。
認証とセッション処理	gflow auth login --browser chrome で最初のログイン用に実際の Chrome ウィンドウを開きます。gflow auth renew はユーザー操作なしで永続化された Playwright プロファイルを更新します。

重要性

• 開発者とコンテンツパイプラインに、Web UI が提供するのと同じ高品質の Veo/Imagen モデルへのプログラムによるアクセスを提供します。プライベートな Google SDK は不要です（公式 SDK はまだ未提供）。
• コストを透明に保ちます：動画生成のみクレジットを消費し、画像関連の操作は無料です。
• 再現性を重視して設計されています。各バッチ項目は送信前にローカルに保存され、異なる終了コードで UI のずれやその他の障害を示します。

インストールクイックスタート

uv tool install gflow-cli                     # 推奨インストーラー
uv tool run --from gflow-cli playwright install chromium   # 一度だけのブラウザダウンロード
gflow auth login --browser chrome            # Chrome を開いてログイン
gflow image t2i "a hot air balloon over Tokyo" # 最初の生成

（pip install gflow-cli も使用できます。）

制限事項

• ヘッド付き Chrome セッションに依存します。Google のボット対策チェックがヘッドレス呼び出しをブロックするため、動画生成用の純粋な HTTP API はまだ利用できません。
• プロジェクトは アルファ 段階です。Google 側の UI 変更により自動化が壊れる可能性がありますが、作者は迅速なパッチを提供します。
• プロキシやフィンガープリント偽装はありません。このツールはアカウントフラグを避けるために「目立たない」ことを目指していますが、保証はありません。

ドキュメントとコミュニティ

• 完全なユーザーガイド、設定、トラブルシューティングドキュメントは docs/ の下にあります（例：docs/USER_GUIDE.md）。
• リポジトリにはロードマップ、変更ログ、単独メンテナーを支援するスポンサーページが含まれています。
• 特に Chrome 自動化レイヤーを直接 REST トランスポートに置き換える貢献を歓迎します。

結論 gflow-cli は、コマンドラインから Google Flow の画像から動画への変換とテキストから画像への変換を自動化する本格的でプロダクション指向のツールであり、バッチ処理、再現可能なパイプライン、または AI エージェントとの統合を必要とする開発者を対象としています。