colab-flux は何をしますか？
レンタルしたColab GPU上で、fluxxを介してFLUX 3 Image Kleinを実行します。fluxx genがA100を起動し、diffusersをインストール、FLUX 3と判定モデルをダウンロードしてロード、すべてのショットをレンダリング（複数候補から最良を判定）、画像をダウンロード、後続リクエストのために数分間GPUをウォーム状態に保ち、その後停止します。可能な限りすべてのショットを1回の呼び出しにまとめてください。
画像を一貫性のあるものにするのはブランドプロフィールであり、運ではありません：
- 商品参照：商品の実際の写真。毎ショットでFLUX 3に参照画像として渡され、商品の形状、ラベル、色を維持します（最大10枚）
- スタイル：具体的な写真用語の1段落がすべてのシーンに追加されます
- 回避：絶対に現れてはいけないもの
- シード：ブランドごとに固定。同じシーンが同じようにレンダリングされます
- フィードバック：すべてのショットが記録されます。
fluxx rateで気に入った点とその理由を記録し、パターンをスタイルに反映させます
すべてのデータは~/colab-flux/brands/<name>/に保存されます：brand.json、refs/、history.jsonl、shots/<time>/。
1. 初回使用：セットアップの確認
fluxx doctorを実行してください（fluxxが見つからない場合は、先にsh <このスキルのフォルダ>/install.shを実行します）。ok / TODOの行が表示されます。各TODOを平易な言葉で、1つずつ説明しながら進めてください：
| TODO | ユーザーの操作 | メモ |
|---|---|---|
| Colab CLIがインストールされていない | 何もしないでください：あなたがこのスキルのフォルダからsh install.shを実行します | uvと公式Colab CLIをインストール |
| Googleにサインインしていない | 自分のターミナルで fluxx login を実行 | ブラウザが開いてGoogleサインインを行います。あなたは代わりにこれを行うことはできません |
| コンピュートユニット | https://colab.research.google.com/signup でColab Proまたはコンピュートユニットを購入 | A100は無料枠では利用できません |
| Hugging Face（オプション） | デフォルトでは何もしません：トークンがない場合、fluxxは各ウェイトファイルのsha256を公式リポジトリと照合した後、公開ミラーからダウンロードします。公式リポジトリの場合：fluxx loginでFLUX 3のページが開くので、同意し、Readトークンを作成して非表示プロンプトに貼り付けます | 無料。トークンをチャットに貼り付けさせないでください |
| ブランドがない | 何もしないでください：あなたが以下のブランドインタビューを行います |
fluxx loginは非表示プロンプトでトークンを要求するため、実際のターミナルが必要です：Claude Codeでは、ターミナルタブを開いてそこで実行するよう指示してください（Codexも同様）。ユーザーが完了したと言ったら、再度fluxx doctorを実行します。
2. ブランドインタビュー（1ビジネスにつき1回）
これらを1つのメッセージで、簡潔に、例を交えて質問し、1分で回答できるようにします：
- ビジネスは何ですか？どのような商品を掲載しますか？（例：「琥珀色の瓶に入った手注ぎの大豆キャンドル」）
- 誰が購入しますか？画像はどこで使用されますか？（Shopify、Amazon、Etsy、Instagram、広告、印刷物）
- ルックを、数語または憧れのブランドで教えてください。（例：「穏やかで温かみのある、スカンジナビアン、Aesopのような」）
- 絶対に現れてはいけないものはありますか？（人物、テキスト、競合他社のアイテム、乱雑さ、特定の色）
- 商品の写真：ファイルパスを指定するか、ドラッグ＆ドロップしてください。商品ごとに、明るく均一な照明の写真が最適です。
次に、回答をプロフィールに変換します。形容詞は写真家が使うような言葉に翻訳してください。それがFLUXが従うものです。「穏やかで温かみのある」は「左からの柔らかい拡散窓光、オート麦、砂、テラコッタの温かみのあるニュートラルパレット、マットなリネンと淡いオークの表面、浅い被写界深度、たっぷりのネガティブスペース、エディトリアルな商品写真」となります。
fluxx brand new acme-candles --business "Acme, 琥珀色のガラス瓶に入った手注ぎの大豆キャンドル" \
--style "左からの柔らかい拡散窓光、オート麦、砂、テラコッタの温かみのあるニュートラルパレット..." \
--avoid "人物、手、瓶のラベル以外の書かれたテキスト、乱雑さ" --aspect 4:5
fluxx brand ref acme-candles /path/to/jar-front.jpg # role: product（デフォルト）
fluxx brand ref acme-candles /path/to/moodboard.jpg --role style
出力先に応じたアスペクト比：Amazon/Shopifyの商品グリッドは1:1、Instagramフィードは4:5、ストーリー/リールは9:16、Webヒーローは16:9、Etsyは4:3または1:1。ブランドのアスペクト比がデフォルトになります。--aspectで実行ごとに上書きできます。作成したプロフィールをユーザーに見せて（fluxx brand show NAME）、自分のイメージに合っているか確認してください。
3. 画像の作成
fluxx brand show NAME：何かを書く前に、プロフィールと最近のフィードバックを読んでください。- シーンを書きます。それぞれ1行の短い具体的な説明で、シーンのみに焦点を当てます。ブランドスタイル、回避リスト、参照ロールは自動的に追加され、FLUX 3自身のプロンプトアップサンプラー（GPU上の9Bモデル）が各行を完全なキャプションに展開するため、長いプロンプトにトークンを費やす必要はありません。良い例：
窓辺の日差しを受けたオーク材の窓台の上の瓶、朝、そばに乾燥ユーカリの小枝。 - ユーザーが欲しがる可能性のあるすべてのショットを1回の呼び出しにまとめてください（起動が高コストな部分です）：
fluxx gen -b acme-candles -n 2 "シーン1" "シーン2" "シーン3" fluxx gen -b acme-candles --from shots.txt # 1行1シーン、# コメント可16:9 | 日差しを受けた窓辺の瓶、見出し用のスペースを左に。 コールドスタートには約4分かかり、その後4MPレンダリングあたり約45秒かかります。Claude Codeではrun_in_backgroundで実行し、Codexではそのまま実行させてください。標準出力に画像パスを1行に1つ出力します。進捗状況、各ショットの判定スコアと欠陥、コンピュートユニットコストは標準エラー出力に出力されます。 ユーザーが商品を使用しているシーンの場合、どのように使用するかを説明してください：「電話のハンドセットを耳に当て、コードがフレームの外に出ている；電話機本体は見えない」。FLUXは参照通りの商品を描画するため、持ち上げられた部分が2回現れる傾向があります（テストでは、クレードルが空であるとプロンプトに指定しても、手持ちのハンドセットともう1台が電話機にあるように見えました）。商品の残りの部分をフレーム外にすることで修正されました。 - GPU上で判定されるベストオブN。 各ショットは最大
--candidates枚（デフォルト3）の画像をレンダリングします。ビジョン言語モデル（Qwen3.5-9B、同じGPU上）が各画像をブリーフ、商品参照、回避リスト（解剖学的構造、オブジェクトの重複、商品の忠実度、余分なテキスト、魅力）に対してチェックし、最良のものを保持し、1つが9+のスコアで欠陥なしになった時点で早期終了します。残りはalts/に小さなサイズで保存されるため、ユーザーはそれらを選択することもできます。 - 自分でも
_md.jpgファイル（小サイズ）を確認してください。特に、標準エラー出力に欠陥や7未満のスコアがリストされているショットは注意してください。完了として提示するのではなく、何が問題かを説明してください。その後、ユーザーにフォルダとパスを提示します。 - GPUはその後ウォーム状態を保ち（
--keep、デフォルト5分）、モデルがロードされたままになるため、同じセットアップでの後続のfluxx genは約4分待つ代わりにすぐにレンダリングを開始します。提示後すぐに、「GPUはあとN分間ウォーム状態です（アイドル状態の場合、約Xコンピュートユニット）。追加や変更はありますか？そうでなければシャットダウンします。」と尋ねてください。完了した場合はfluxx stopを実行します。ユーザーが何も言わなければ、自動的に停止します。より長く保持するよう依頼された場合は、次回の実行時に--keep 15を渡すか、fluxx config keep_minutes 15で新しいデフォルトを保存してください。--keep 0は実行終了時にGPUを停止します。
フラグ：-n N シーンごとのバリエーション（シード seed..seed+N-1）· --candidates K ショットごとのレンダリング数、最良を保持（1-8）· --keep MIN 後のウォーム時間（分）· --draft 1MP中品質のみ、1候補、高速、新しい方向性の探索用· --aspect W:H · --ref PATH 1回限りの追加商品写真· --no-refs · --seed S · --no-upsample シーンがすでに完全なキャプションの場合（19GBのダウンロードをスキップ）· --out DIR。
ショットごとの出力：<id>_hd.png（約4MP、例：2048x2048、印刷、ズーム、ヒーロー画像用）、<id>_md.jpg（長辺1024px、リスティング、ウェブ、ソーシャル用）。
4. マーケットプレイスリスティング（Amazon、Etsy、eBay、Shopify）
画像が商品をオンラインで販売するためのものである場合、genの代わりにfluxx listingを使用します。1回の実行で、6枚の正方形4MPショットの標準セットを作成し、各サイトの順序、名前、サイズでサイトごとのフォルダにエクスポートし、GPU上でリスティングコピーをドラフトします（判定モデルが作成するため、Claudeトークンは不要）：
fluxx listing -b acme-candles --product "木製蓋付き琥珀色ガラス瓶入りの手注ぎ大豆キャンドル" \
--notes "8オンス、50時間燃焼、コットンウィック、香り：シダーとスモーク、オレゴン製" --for amazon,etsy
| ショット（役割） | 内容 | ブランドルック |
|---|---|---|
main | 純白の背景に商品のみ、中央配置 | なし：fluxxが背景を正確にRGB 255にし、商品をフレームの85%に拡大（Amazonのメイン画像ルール） |
angle | 白背景で斜めからのビュー | なし |
detail | 素材と仕上げのクローズアップ | なし |
lifestyle | 購入者に合った設定で使用中 | あり |
scale | サイズがわかるよう日常品と一緒に | あり |
gift | 手に持った状態またはギフトとして、顔は映らない | あり |
実行フォルダ内のmarkets/<site>/に出力：
| サイト | 画像 | コピー（listing.md + copy.json）、制限はfluxxが適用 |
|---|---|---|
| amazon | MAIN.jpg、PT01.jpg... 2048px | タイトル75文字（2026年7月以降の制限）、商品ハイライト125、箇条書き5つ各200、説明2000、検索語250バイト |
| etsy | 01.jpg... 2048px、最初にスタイリングされたショット（検索サムネイルになります） | タイトル140、タグ13個各20文字、説明 |
| ebay | 01.jpg... 1600px | タイトル80、商品詳細、説明 |
| shopify | 01.jpg... 2048px | タイトル70、SEOタイトル60、SEO説明160、説明、タグ |
エージェント向けルール：
- 事実は販売者から得ます。 実行前にサイズ、素材、内容、注意事項を尋ね、
--notesで渡します。コピーモデルは事実を創作しないように指示されていますが、listing.mdを読み、メモや画像にない主張を公開前に削除してください。 - 画像はFLUXが描画したものであり、実際の商品ではありません。
main、angle、detailの場合、商品はユーザーの実際の商品と一致している必要があります：写真と照合し、マーケットプレイスでは実際のアイテムを示す画像が必要であることを伝えてください。ライフスタイルショットこそ、生成シーンが最も役立つ場所です。 - 完成した白背景の
main画像は、後続のショットの商品参照になるため、ユーザー自身の写真にある小道具（テーブルクロス、装飾品）がライフスタイルショットに漏れることはありません。それでも、明るく均一な照明の商品写真を依頼してください：それがmainの元になります。 --only main,lifestyleでサブセットを作成します；--no-refs --ref other.jpgで同じブランドの別の商品をリストします；--for etsyでサイトを制限します。
5. 好みの学習
フィードバックループを閉じることでプロフィールは改善されます。ユーザーが画像に反応するたびに：
fluxx rate 02-jar-on-oak-windowsill-v1 good "低い朝の光が気に入った"
fluxx rate 03-jar-in-bathroom-v2 bad "ごちゃごちゃしている、タオルに焦点が奪われる"
2つ以上の評価が同じ方向を示したら、brand.json（プレーンなJSONです。ファイルツールで編集してください）を編集します：styleを明確にし、avoidを拡張し、変更内容と理由を記載した日付入りの行をnotesに追加します。同じ欠陥が再発した場合（部品の重複、間違った色、ラベルの欠落）、checksに1行のルールを追加します。例："画像全体に電話のハンドセットは正確に1つだけ"。すると、判定モデルは今後すべての候補でそのルールをカウントして検証します。テストでは、一般的なスコアだけではこの種の欠陥を見逃していました。1行でユーザーに伝えてください（「スタイルに『低い朝の光』を追加し、瓶の近くの小道具を削除しました」）。気に入ったショットはスタイル参照にできます：fluxx brand ref NAME <path>_hd.png --role style（参照は合計10枚まで。FLUX 3はスタイル参照をルックのみとして扱い、コンテンツとしては扱いません）。
リクエストに応じてスタイルを変更する（「もっと暗くてムーディーに」「パステルにリブランドします」）：brand.jsonのstyleを書き換え、古いものは日付とともにnotesに残しておき、元に戻せるようにします。合わなくなったスタイル参照を削除し、既知の3〜4シーンのクイック--draft実行を提供して、フルバッチの前に新しいルックを確認してもらいます。2つ目の別のルック（例：ホリデーキャンペーン）の場合は、上書きするのではなく、同じ商品参照で別のブランドを作成します。
ルール
- 1回の呼び出し、多数のショット。
fluxx genを画像ごとにループさせないでください。コールドスタート（GPU、約60GBのモデル、ロード）には約4分かかります。ウォームウィンドウ内でのフォローアップはこれをスキップします。 - GPUは常に停止します。 失敗時は
fluxxが即座に停止します。成功時は--keep分間ウォーム状態を保ち、デタッチされたウォッチドッグがその後停止します（fluxxやエージェントが存在しなくなっても）。実行中、ウォッチドッグは最大時間を--max-minutes（デフォルト60）に制限します。実行がNOT CONFIRMED STOPPEDで終了した場合は、すぐにfluxx stop、次にfluxx statusを実行してください。 - チャットにシークレットを入れないでください。 Hugging Faceトークンは
fluxx loginの非表示プロンプトにのみ入力されます。ユーザー自身のColab VMに送信され、読み取り後にディスクから削除され、停止時に消去されます。 - ユーザーの画像はユーザーの手元に残ります。 トークン、画像、生成物はユーザーのColab VMとローカルの
~/colab-flux/にのみ存在します。あなたはそれらを見ることができますが、あなたのコンテキストに保存したり、外部に送信したりしないでください。 - コストは見えるようにしておきます。
fluxxは標準エラー出力に推定コンピュートユニットコストを出力します。コールドスタート（約4分、A100で約1ユニット/分）と、画像あたり約45秒（約0.75ユニット）が含まれます。1回の呼び出しに多くのショットをまとめるほど効率的です。
fluxx コマンドリファレンス
fluxx doctor # セットアップの確認
fluxx login # Google Colab + Hugging Face ログイン
fluxx brand new NAME # ブランドを作成
fluxx brand ref NAME PATH [--role product|style]
fluxx brand show NAME
fluxx brand list
fluxx gen -b NAME [オプション] "シーン"...
fluxx listing -b NAME [オプション]
fluxx rate SHOT_ID good|bad "理由"
fluxx stop
fluxx status
fluxx config KEY VALUE