Usage
For detailed command-line arguments, run:
./bin/sd-cli -h
Logging defaults to info. Use --log-level <level> to select debug, verbose,
info, warn, or error (from most to least detailed). Each level includes
messages at that level and all less detailed levels. -v and --verbose are
equivalent to --log-level verbose. If repeated, the last logging option wins.
--flash-attn on|off|auto defaults to auto, selecting flash attention for each
compute backend during context creation. See Backend selection
for probing behavior.
Use module assignments such as --flash-attn auto,te=off,vae=on to override
individual modules.
--conv-direct on|off|auto also defaults to auto, enabling direct convolution
on backends with implicit GEMM implementations. Use --conv-direct auto,vae=off
for module overrides; supported modules are diffusion, vae, and controlnet.
See Direct convolution.
For direct image repair or automatic post-generation YOLOv8 detection followed by cropped inpainting, see ADetailer.
Use repeatable --image-preprocess rules to select resizing, cropping, padding,
and resampling separately for each image input. Add canny=true to any input
rule for edge detection. See
Image preprocessing for input selectors,
input defaults, downstream model processing, mask alignment, and examples.
Metadata mode inspects PNG/JPEG container metadata without loading any model:
./bin/sd-cli -M metadata --image ./output.png
./bin/sd-cli -M metadata --image ./output.jpg --metadata-format json
./bin/sd-cli -M metadata --image ./output.png --metadata-raw
./bin/sd-cli -M metadata --image ./output.png --metadata-all
For completely black or white images or videos, NaNs, and the --linear-scale /
--attn-scale workaround, see Troubleshooting.