leejet/stable-diffusion.cpp

▲ 384 stars today★ 7,477⑂ 839

Diffusion model(SD,Flux,Wan,Qwen Image,Z-Image,...) inference in pure C/C++

About leejet/stable-diffusion.cpp

leejet/stable-diffusion.cpp is an open-source project on GitHub, mainly written in C++. Diffusion model(SD,Flux,Wan,Qwen Image,Z-Image,...) inference in pure C/C++ It currently holds 7,477 stars and 839 forks with 0 open issues, and was last pushed on an unknown date (repository created unknown).

Project Overview

AI Homed tracks it on the Today's Trending board.

GitHub Repository Details

Repository leejet/stable-diffusion.cpp · default branch - · size 0 KB · watchers 0 · source: GitHub REST API and repository README

README

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/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
Lens
Chroma
Chroma1-Radiance
Qwen Image
Qwen Image 2.1
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
Ming-Image Design
PixArt
Image Edit Models
FLUX.1-Kontext-dev
Qwen Image Edit series
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
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

    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.