Repository files navigation

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.

• 2025/12/01 🚀 stable-diffusion.cpp now supportsZ-Image
  👉 Details:PR #1020

• 2025/11/30 🚀 stable-diffusion.cpp now supportsFLUX.2-dev
  👉 Details:PR #1016

• 2025/10/13 🚀 stable-diffusion.cpp now supportsQwen-Image-Edit / Qwen-Image-Edit 2509
  👉 Details:PR #877

• 2025/10/12 🚀 stable-diffusion.cpp now supportsQwen-Image
  👉 Details:PR #851

• 2025/09/14 🚀 stable-diffusion.cpp now supportsWan2.1 Vace
  👉 Details:PR #819

• 2025/09/06 🚀 stable-diffusion.cpp now supportsWan2.1 / Wan2.2
  👉 Details:PR #778

• Plain C/C++ implementation based onggml, working in the same way asllama.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
    • Chroma
    • Chroma1-Radiance
    • Qwen Image
    • Z-Image
    • Ovis-Image
  • Image Edit Models
    • FLUX.1-Kontext-dev
    • Qwen Image Edit/Qwen Image Edit 2509
  • Video Models
    • Wan2.1/Wan2.2
  • PhotoMaker support.
  • Control Net support with SD 1.5
  • LoRA support, same asstable-diffusion-webui
  • Latent Consistency Models support (LCM/LCM-LoRA)
  • Faster and memory efficient latent decoding withTAESD
  • Upscale images generated withESRGAN
• Supported backends
  • CPU (AVX, AVX2 and AVX512 support for x86 architectures)
  • CUDA
  • Vulkan
  • Metal
  • OpenCL
  • SYCL
• Supported weight formats
  • Pytorch checkpoint (.ckpt or.pth)
  • Safetensors (./safetensors)
  • GGUF (.gguf)
• 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
  • LCM
• Cross-platform reproducibility
  • --rng cuda, default, consistent with thestable-diffusion-webui GPU RNG
  • --rng cpu, consistent with thecomfyui RNG
• Embedds generation parameters into png output as webui-compatible text string

• Download pre-built binaries from thereleases page
• Or build from source by following thebuild guide

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

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

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

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

For detailed command-line arguments, check outcli doc.

If you want to improve performance or reduce VRAM/RAM usage, please refer toperformance guide.

• SD1.x/SD2.x/SDXL
• SD3/SD3.5
• FlUX.1-dev/FlUX.1-schnell
• FLUX.2-dev
• FLUX.1-Kontext-dev
• Chroma
• 🔥Qwen Image
• 🔥Qwen Image Edit/Qwen Image Edit 2509
• 🔥Wan2.1/Wan2.2
• 🔥Z-Image
• Ovis-Image
• LoRA
• LCM/LCM-LoRA
• Using PhotoMaker to personalize image generation
• Using ESRGAN to upscale results
• Using TAESD to faster decoding
• Docker
• Quantization and GGUF

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

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

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

• Jellybox
• Stable Diffusion GUI
• Stable Diffusion CLI-GUI
• Local Diffusion
• sd.cpp-webui
• LocalAI
• Neural-Pixel
• KoboldCpp

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

• ggml
• diffusers
• stable-diffusion
• sd3-ref
• stable-diffusion-stability-ai
• stable-diffusion-webui
• ComfyUI
• k-diffusion
• latent-consistency-model
• generative-models
• PhotoMaker
• Wan2.1
• Wan2.2