stable-diffusion.cpp

Diffusion model(SD,Flux,Wan,...) inference in pure C/C++

Note that this project is under active development. \ API and command-line option may change frequently.

🔥Important News

• 2026/10/16 🚀 stable-diffusion.cpp adds Day-0 support for MOSS-Image-Base / MOSS-Image-SFT
• 2026/10/16 🚀 stable-diffusion.cpp adds Day-0 support for FLUX.3 Image Klein / Klein Base
• 2026/09/20 🚀 stable-diffusion.cpp adds Day-0 support for Qwen-Image-2.1
• 2026/08/20 🚀 stable-diffusion.cpp now supports LTX-2.5
• 2026/08/04 🚀 stable-diffusion.cpp adds Day-1 support for MiniMax-H3
• 2026/06/25 🚀 stable-diffusion.cpp now supports Krea2
• 2026/06/04 🚀 stable-diffusion.cpp now supports Ideogram4
• 2026/05/31 🚀 stable-diffusion.cpp now supports PiD
• 2026/05/27 🚀 stable-diffusion.cpp now supports Lens
• 2026/05/17 🚀 stable-diffusion.cpp now supports LTX-2.3
• 2026/04/11 🚀 stable-diffusion.cpp now uses a brand-new embedded web UI.
• 2026/01/18 🚀 stable-diffusion.cpp now supports FLUX.2-klein
• 2025/12/01 🚀 stable-diffusion.cpp now supports Z-Image
• 2025/11/30 🚀 stable-diffusion.cpp now supports FLUX.2-dev
• 2025/10/13 🚀 stable-diffusion.cpp now supports Qwen-Image-Edit / Qwen-Image-Edit 2509
• 2025/10/12 🚀 stable-diffusion.cpp now supports Qwen-Image
• 2025/09/14 🚀 stable-diffusion.cpp now supports Wan2.1 Vace
• 2025/09/06 🚀 stable-diffusion.cpp now supports Wan2.1 / Wan2.2

Features

• Plain C/C++ implementation based on ggml, working in the same way as llama.cpp
• Super lightweight and without external dependencies
• Supported models
• Image Models
  • SD1.x, SD2.x, SD-Turbo
  • SDXL, SDXL-Turbo
  • Some SD1.x and SDXL distilled models
  • SD3/SD3.5
  • FLUX.1-dev/FLUX.1-schnell
  • FLUX.2-dev/FLUX.2-klein
  • FLUX.3 Image Klein / Klein Base
  • MOSS-Image-Base / MOSS-Image-SFT
  • Fibo 2.0 Dev
  • Lens
  • Chroma
  • Chroma1-Radiance
  • Qwen Image
  • Qwen Image 2.1
  • PiD
  • LongCat Image
  • Z-Image
  • Z-Image L2P
  • MiniT2I
  • SenseNova U1.5
  • Ovis-Image
  • Anima
  • ERNIE-Image
  • Boogu Image
  • Krea2
  • Mage-Flow
  • SeFi-Image
  • HiDream-O1-Image
  • Ideogram4
  • LLaDA-Image
  • Ming-Image Design
  • PixArt
  • Iris-3B
• Image Edit Models
  • FLUX.1-Kontext-dev
  • Qwen Image Edit series
  • LongCat Image Edit
  • Boogu Image Edit
  • Mage-Flow-Edit
  • LLaDA-Image Edit
  • Fibo 2.0 Dev / Edit Turbo
• Video Models
  • Wan2.1/Wan2.2
  • MiniMax-H3
  • LTX-2.3/LTX-2.5
  • HunyuanVideo 1.5
  • LingBot-Video
• PhotoMaker support.
• IP-Adapter support (SD 1.5 and SDXL, including Plus)
• Control Net support with SD 1.5
• ADetailer
• LoRA support, same as stable-diffusion-webui
• Latent Consistency Models support (LCM/LCM-LoRA)
• Faster and memory efficient latent decoding with TAESD
• Upscale images generated with ESRGAN
• Supported backends
• CPU (AVX, AVX2 and AVX512 support for x86 architectures)
• CUDA
• Vulkan
• Metal
• OpenCL
• SYCL
• Supported weight formats
• Pytorch checkpoint (.ckpt or .pth or .pt)
• Safetensors (.safetensors)
• GGUF (.gguf)
• Convert mode supports converting model weights to .gguf or .safetensors
• Supported platforms
  • Linux
  • Mac OS
  • Windows
  • Android (via Termux, Local Diffusion)
• Flash Attention for memory usage optimization
• Negative prompt
• stable-diffusion-webui style tokenizer (not all the features, only token weighting for now)
• VAE tiling processing for reduce memory usage
• Sampling method
  • Euler A
  • Euler
  • Heun
  • DPM2
  • DPM++ 2M
  • DPM++ 2M v2
  • DPM++ 2S a
  • ER-SDE
  • LCM
• Cross-platform reproducibility
  • --rng cuda, default, consistent with the stable-diffusion-webui GPU RNG
  • --rng cpu, consistent with the comfyui RNG
• Embedds generation parameters into png output as webui-compatible text string

Quick Start

Get the sd executable

• Download pre-built binaries from the releases page
• Or build from source by following the build guide

Download model weights

• download weights(.ckpt or .safetensors or .gguf). For example

  • Stable Diffusion v1.5 from https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5

  sh curl -L -O https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors

Generate an image with just one command

./bin/sd-cli -m ../models/v1-5-pruned-emaonly.safetensors -p "a lovely cat"

For detailed command-line arguments, check out cli doc.

Performance

If you want to improve performance or reduce VRAM/RAM usage, please refer to performance guide. For runtime and parameter backend placement, see the backend selection guide.

More Guides

• Troubleshooting
• Backend selection
• RPC
• LoRA
• LCM/LCM-LoRA
• Docker
• Quantization and GGUF
• INT8 convrot safetensors
• Inference acceleration via caching

Bindings

These projects wrap stable-diffusion.cpp for easier use in other languages/frameworks.

• Golang (non-cgo): seasonjs/stable-diffusion
• Golang (cgo): Binozo/GoStableDiffusion
• Golang (non-cgo): l8bloom/gosd
• C#: DarthAffe/StableDiffusion.NET
• Python: william-murray1204/stable-diffusion-cpp-python
• Rust: newfla/diffusion-rs
• Flutter/Dart: rmatif/Local-Diffusion

UIs

These projects use stable-diffusion.cpp as a backend for their image generation.

• GIMP Plugins
• Stable Diffusion GUI
• Stable Diffusion CLI-GUI
• Local Diffusion
• sd.cpp-webui
• LocalAI
• Neural-Pixel
• KoboldCpp
• Kokon

Contributors

Thank you to all the people who have already contributed to stable-diffusion.cpp!