stable-diffusion.cpp

leejet%2Fstable-diffusion.cpp | Trendshift

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/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](./docs/sd.md) - 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 - Lens -

Chroma - Chroma1-Radiance - Qwen Image - [Qwen Image

2.1](./docs/qwen_image_2.1.md) - PiD - LongCat Image - Z-Image -

MiniT2I - SenseNova U1.5 - Ovis-Image - Anima -

ERNIE-Image - Boogu Image - Krea2 - Mage-Flow -

SeFi-Image - HiDream-O1-Image - Ideogram4 -

LLaDA-Image - Image Edit Models - FLUX.1-Kontext-dev - [Qwen Image Edit

series](./docs/qwen_image_edit.md) - LongCat Image Edit - Boogu Image Edit -

Mage-Flow-Edit - LLaDA-Image Edit - Video Models -

Wan2.1/Wan2.2 - MiniMax-H3 - LTX-2.3/LTX-2.5 - HunyuanVideo 1.5

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](https://github.com/rmatif/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](https://github.com/AUTOMATIC1111/stable-diffusion-webui/discussions/8457) -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 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
    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

```sh
./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

LCM/LCM-LoRA - Docker - Quantization and GGUF - [INT8 convrot

safetensors](./docs/int8_convrot.md) - Inference acceleration via caching

Bindings

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

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.

GUI](https://github.com/fszontagh/sd.cpp.gui.wx) - Stable Diffusion CLI-GUI - [Local

Diffusion](https://github.com/rmatif/Local-Diffusion) - sd.cpp-webui -

LocalAI - Neural-Pixel -

KoboldCpp

Contributors

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

Contributors