FLUX.1 推論 CLI

MPS（Apple Silicon）、CUDA、CPUをサポート

特徴

複数のモデル: FLUX.1-schnell および FLUX.1-dev をサポート
LoRA サポート: 簡単に選択できるインタラクティブな LoRA ピッカー
クロスプラットフォーム: MPS、CUDA、CPU をサポート
macOS でテスト済み: Apple Silicon ¹で正常に動作

インストール

リポジトリのクローン作成:

git clone https://github.com/SplittyDev/flux1-cli.git
cd flux1-cli

UV の使用 (推奨) :

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
python3 src/main.py

pip の使用:

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
python3 src/main.py

LoRA のインストール

.safetensorsファイルをloraディレクトリに置くだけです。
/loraと入力すると、すぐに使用できるようになります。

プロンプト

推論修飾子

CLI はさまざまな修飾子をサポートしており、次のようにプロンプトの末尾に追加できます。

Photograph of a meadow in a forest /fast
Photograph of a meadow in a forest /1024x768 /slow
Photograph of a meadow in a forest /seed=1234 /8

修飾子のリスト:

修飾子	説明
`/f` 、 `/fast`	少数の推論ステップを使用して迅速な結果を得る
`/s` 、 `/slow`	正確な結果を得るために多数の推論ステップを使用する
`/a` 、 `/again`	次の推論のために前のシードを再利用する
`/r` 、 `/random`	次の推論にランダムシードを使用する
`/<n>` n < 128 の場合	この推論ステップ数を次の推論に使用します
`/<n>` n >= 128 の場合	解像度を`nxn`に設定します
`/<w>x<h>`	解像度を`wxh`に設定します

スタンドアロンモディファイア

CLI は、独自の行でのみ機能するスタンドアロン修飾子もサポートしています。

スタンドアロンモディファイアのリスト:

修飾子	説明
`/quit`	CLIを終了する
`/lora`	LoRA ピッカーを表示
`/lora_scale=<scale>`	LoRA スケールを`scale`に設定します
`/seed=<seed>`	シードを`seed`に設定します

ヒントとコツ

プロンプトを完全に空のままにすると、最後のプロンプトが繰り返されます
次のように修飾子を組み合わせることができます: Photograph of a meadow in a forest /fast /seed=1234
次のように、プロンプトを繰り返さずに新しい修飾子を適用できます: /slow /1024x768
画像は次の形式で保存されます： output/<date>/<timestamp>_<seed>.png

モディファイアを使用したワークフローの例

思考プロセスを説明する注釈付きの例

 # Initial prompt. Generate images fast, to get a feeling for the prompt.
λ Prompt: Photograph of a meadow in a forest /fast
# Refine prompt. Fast mode is still active, no need to repeat it.
λ Prompt: High resolution photograph of a meadow in a forest
# This looks nice! Let's generate the same image again, but in slow mode.
λ Prompt: /again /slow
# Let's keep the same prompt, but randomize the seed again.
λ Prompt: /random
# Let's try it in landscape mode, but fast, to see if it looks better.
λ Prompt: /1920x1080 /fast
# Alright, let's call it a day
λ Prompt: /quit

実際の例、ショートカットを使用しコメントなし

λ Prompt: Photograph of a moonlit meadow in a mythical forest/f
λ Prompt: 
λ Prompt: /a/s
λ Prompt: Stunning photograph of a moonlit meadow in a mythical forest, godrays/r/f
λ Prompt: /a/s
λ Prompt: /quit

トラブルシューティング

十分な VRAM がありません:

--offload-cpuフラグを渡すと、モデルの一部を CPU にオフロードして、パフォーマンスへの影響は小さいものの、VRAM 使用量を削減できます。残念ながら、これは MPS では機能しないようです。理由を知っている人がいたら教えてください！

(何らかの理由で) CPU を使用したいのですが:

--force-cpuフラグを渡すと、CPU 推論を強制できます。これは、MPS や CUDA よりもはるかに遅いため、お勧めできません。

高解像度の画像が壊れる

FLUX.1 の最大解像度は 2MP です。これらはおよそ可能な最大サイズ²です。
1:1 正確 1448 x 1448、四捨五入 1408 x 1408
3:2 正確 1773 x 1182、四捨五入 1728 x 1152
4:3 正確 1672 x 1254、四捨五入 1664 x 1216
16:9 正確な 1936 x 1089、四捨五入 1920 x 1088
21:9 正確 2212 x 948、四捨五入 2176 x 960
アップスケーラー (別売り) を使用して解像度を上げることができます。