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이 부족합니다 .

작은 성능 저하로 VRAM 사용량을 낮추기 위해 --offload-cpu 플래그를 전달하여 모델의 일부를 CPU로 오프로드할 수 있습니다. 안타깝게도 이것은 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
업스케일러(포함되지 않음)를 사용하여 해상도를 높일 수 있습니다.