mirror of
https://github.com/leejet/stable-diffusion.cpp
synced 2026-03-01 20:50:06 +01:00
| .github | ||
| assets | ||
| docs | ||
| examples | ||
| ggml@3e9f2ba3b9 | ||
| thirdparty | ||
| .clang-format | ||
| .clang-tidy | ||
| .dockerignore | ||
| .gitignore | ||
| .gitmodules | ||
| cache_dit.hpp | ||
| clip.hpp | ||
| CMakeLists.txt | ||
| common.hpp | ||
| conditioner.hpp | ||
| control.hpp | ||
| denoiser.hpp | ||
| diffusion_model.hpp | ||
| Dockerfile | ||
| Dockerfile.musa | ||
| Dockerfile.sycl | ||
| Dockerfile.vulkan | ||
| easycache.hpp | ||
| esrgan.hpp | ||
| face_detect.py | ||
| flux.hpp | ||
| format-code.sh | ||
| ggml_extend.hpp | ||
| gguf_reader.hpp | ||
| gits_noise.inl | ||
| latent-preview.h | ||
| LICENSE | ||
| llm.hpp | ||
| lora.hpp | ||
| ltxv.hpp | ||
| mmdit.hpp | ||
| model.cpp | ||
| model.h | ||
| name_conversion.cpp | ||
| name_conversion.h | ||
| ordered_map.hpp | ||
| pmid.hpp | ||
| preprocessing.hpp | ||
| qwen_image.hpp | ||
| README.md | ||
| rng_mt19937.hpp | ||
| rng_philox.hpp | ||
| rng.hpp | ||
| rope.hpp | ||
| stable-diffusion.cpp | ||
| stable-diffusion.h | ||
| t5.hpp | ||
| tae.hpp | ||
| tokenize_util.cpp | ||
| tokenize_util.h | ||
| ucache.hpp | ||
| unet.hpp | ||
| upscaler.cpp | ||
| util.cpp | ||
| util.h | ||
| vae.hpp | ||
| version.cpp | ||
| vocab_mistral.hpp | ||
| vocab_qwen.hpp | ||
| vocab_umt5.hpp | ||
| vocab.hpp | ||
| wan.hpp | ||
| z_image.hpp | ||
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
-
2025/12/01 🚀 stable-diffusion.cpp now supports Z-Image
👉 Details: PR #1020 -
2025/11/30 🚀 stable-diffusion.cpp now supports FLUX.2-dev
👉 Details: PR #1016 -
2025/10/13 🚀 stable-diffusion.cpp now supports Qwen-Image-Edit / Qwen-Image-Edit 2509
👉 Details: PR #877 -
2025/10/12 🚀 stable-diffusion.cpp now supports Qwen-Image
👉 Details: PR #851 -
2025/09/14 🚀 stable-diffusion.cpp now supports Wan2.1 Vace
👉 Details: PR #819 -
2025/09/06 🚀 stable-diffusion.cpp now supports Wan2.1 / Wan2.2
👉 Details: PR #778
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
- Image Edit Models
- Video Models
- PhotoMaker support.
- Control Net support with SD 1.5
- 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 (
.ckptor.pth) - Safetensors (
.safetensors) - GGUF (
.gguf)
- Pytorch checkpoint (
- 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 AEulerHeunDPM2DPM++ 2MDPM++ 2M v2DPM++ 2S aLCM
- 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
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/runwayml/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.
More Guides
- 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 series
- 🔥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
- 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
- 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.
- Jellybox
- Stable Diffusion GUI
- Stable Diffusion CLI-GUI
- Local Diffusion
- sd.cpp-webui
- LocalAI
- Neural-Pixel
- KoboldCpp
Contributors
Thank you to all the people who have already contributed to stable-diffusion.cpp!