Skip to content

Repository files navigation

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/11/11 🚀 stable-diffusion.cpp adds Day-0 support for MiniMax-H3-Image
  • 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

Quick Start

Get the executables

The executable examples below run from the build directory (cd build from the repository root). Windows examples use the Visual Studio Release path; adjust the executable path for other build configurations or extracted archives. Model files stay under the repository's models/ directory.

Download model weights

Choose a model from the model guides and download its weights and required components. For a simple example, save Stable Diffusion 1.5 under models/checkpoints/:

Windows (PowerShell)

New-Item -ItemType Directory -Force ..\models\checkpoints | Out-Null
curl.exe -L -o ..\models\checkpoints\v1-5-pruned-emaonly.safetensors https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors

Linux/macOS

mkdir -p ../models/checkpoints
curl -L -o ../models/checkpoints/v1-5-pruned-emaonly.safetensors https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors

Option 1: Web UI

Start the server:

Windows (PowerShell)

.\bin\Release\sd-server.exe --model-dir ..\models

Linux/macOS

./bin/sd-server --model-dir ../models

Open http://127.0.0.1:1234/, choose SD 1.x in Recipe, select the checkpoint, and click Load models. Enter a prompt and click Generate. See the Web UI guide for the full workflow.

Option 2: CLI

Generate an image with one command:

Windows (PowerShell)

.\bin\Release\sd-cli.exe -m ..\models\checkpoints\v1-5-pruned-emaonly.safetensors -p "a lovely cat"

Linux/macOS

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

Run .\bin\Release\sd-cli.exe --help on Windows or ./bin/sd-cli --help on Linux/macOS for all command-line options. See the CLI guide for additional usage notes.

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.

Documentation

Browse the documentation index or jump to a topic:

Contributors

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

Contributors

Releases

Packages

Used by

Contributors

Languages