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 venv
source .venv/bin/activate
uv pip install -r requirements.txt
python3 src/main.py

使用點：

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

故障排除

我沒有足夠的顯存：

您可以傳遞--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
您可以使用升級器（未隨附）來提高解析度。