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
您可以使用升级器（未随附）来提高分辨率。