mirror of https://github.com/leejet/stable-diffusion.cpp.git synced 2026-01-02 10:43:35 +00:00

Go to file

feat: add seamless texture generation support (#914 )

* global bool

* reworked circular to global flag

* cleaner implementation of tiling support in sd cpp

* cleaned rope

* working simplified but still need wraps

* Further clean of rope

* resolve flux conflict

* switch to pad op circular only

* Set ggml to most recent

* Revert ggml temp

* Update ggml to most recent

* Revert unneded flux change

* move circular flag to the GGMLRunnerContext

* Pass through circular param in all places where conv is called

* fix of constant and minor cleanup

* Added back --circular option

* Conv2d circular in vae and various models

* Fix temporal padding for qwen image and other vaes

* Z Image circular tiling

* x and y axis seamless only

* First attempt at chroma seamless x and y

* refactor into pure x and y, almost there

* Fix crash on chroma

* Refactor into cleaner variable choices

* Removed redundant set_circular_enabled

* Sync ggml

* simplify circular parameter

* format code

* no need to perform circular pad on the clip

* simplify circular_axes setting

* unify function naming

* remove unnecessary member variables

* simplify rope

---------

Co-authored-by: Phylliida <phylliidadev@gmail.com>
Co-authored-by: leejet <leejet714@gmail.com>

2025-12-21 18:06:47 +08:00

.github

chore: add compute kernels to Windows CUDA build (#1062 )

2025-12-07 22:12:50 +08:00

assets

docs: update logo

2025-12-07 15:09:32 +08:00

docs

docs: document usage of tae for VRAM reduction using wan (#1108 )

2025-12-19 23:31:09 +08:00

examples

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

ggml @ 3e9f2ba3b9

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

thirdparty

feat: simple openai image generation api compatiple server (#1037 )

2025-12-13 13:53:21 +08:00

.clang-format

style: format code

2024-01-29 23:05:18 +08:00

.clang-tidy

chore: add .clang-tidy configuration and apply modernize checks (#902 )

2025-10-18 23:23:40 +08:00

.dockerignore

chore: add sd Dockerfile

2023-08-22 22:14:20 +08:00

.gitignore

feat: add image preview support (#522 )

2025-11-10 00:12:02 +08:00

.gitmodules

feat: add wan2.1/2.2 support (#778 )

2025-09-06 18:08:03 +08:00

clip.hpp

refactor: optimize the handling of LoRA models (#1070 )

2025-12-10 00:26:07 +08:00

CMakeLists.txt

feat: embed version string and git commit hash (#1008 )

2025-12-09 22:38:54 +08:00

common.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

conditioner.hpp

fix: resolve embedding loading issue when calling generate_image multiple times (#1078 )

2025-12-12 23:08:12 +08:00

control.hpp

feat: handle ggml compute failures without crashing the program (#1003 )

2025-12-04 22:04:27 +08:00

denoiser.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

diffusion_model.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

Dockerfile

feat: simple openai image generation api compatiple server (#1037 )

2025-12-13 13:53:21 +08:00

Dockerfile.musa

feat: simple openai image generation api compatiple server (#1037 )

2025-12-13 13:53:21 +08:00

Dockerfile.sycl

feat: simple openai image generation api compatiple server (#1037 )

2025-12-13 13:53:21 +08:00

easycache.hpp

feat: add easycache support (#940 )

2025-11-19 23:19:32 +08:00

esrgan.hpp

feat: support custom upscale tile size (#896 )

2025-12-10 22:25:19 +08:00

face_detect.py

feat: add PhotoMaker Version 2 support (#358 )

2024-11-23 11:50:14 +08:00

flux.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

format-code.sh

feat: simple openai image generation api compatiple server (#1037 )

2025-12-13 13:53:21 +08:00

ggml_extend.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

gguf_reader.hpp

feat: add wan2.1/2.2 support (#778 )

2025-09-06 18:08:03 +08:00

gits_noise.inl

fix: clang complains about needless braces (#618 )

2025-03-09 12:26:41 +08:00

latent-preview.h

feat: add Flux.2 VAE proj matrix for previews (#1017 )

2025-12-09 22:00:45 +08:00

LICENSE

Initial commit

2023-08-13 16:00:22 +08:00

llm.hpp

feat: add ovis image support (#1057 )

2025-12-07 12:32:56 +08:00

lora.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

ltxv.hpp

refactor: introduce GGMLRunnerContext (#928 )

2025-11-02 02:11:04 +08:00

mmdit.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

model.cpp

feat: add support for Chroma Radiance x0 (#1091 )

2025-12-20 00:55:57 +08:00

model.h

feat: add ovis image support (#1057 )

2025-12-07 12:32:56 +08:00

name_conversion.cpp

feat: add support for underline style lora of flux (#1103 )

2025-12-18 21:44:16 +08:00

name_conversion.h

feat: support applying LoRA at runtime (#969 )

2025-11-13 21:48:44 +08:00

ordered_map.hpp

refactor: optimize the logic for name conversion and the processing of the LoRA model (#955 )

2025-11-10 00:12:20 +08:00

pmid.hpp

feat: handle ggml compute failures without crashing the program (#1003 )

2025-12-04 22:04:27 +08:00

preprocessing.hpp

refactor: unify the naming style of ggml extension functions (#921 )

2025-10-28 23:26:48 +08:00

qwen_image.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

README.md

feat: simple openai image generation api compatiple server (#1037 )

2025-12-13 13:53:21 +08:00

rng_mt19937.hpp

feat: add cpu rng (#977 )

2025-11-16 14:48:15 +08:00

rng_philox.hpp

chore: add .clang-tidy configuration and apply modernize checks (#902 )

2025-10-18 23:23:40 +08:00

rng.hpp

chore: add .clang-tidy configuration and apply modernize checks (#902 )

2025-10-18 23:23:40 +08:00

rope.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

stable-diffusion.cpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

stable-diffusion.h

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

t5.hpp

feat: handle ggml compute failures without crashing the program (#1003 )

2025-12-04 22:04:27 +08:00

tae.hpp

feat: add taehv support for Wan/Qwen (#937 )

2025-12-16 22:57:34 +08:00

tokenize_util.cpp

feat: add flux2 support (#1016 )

2025-11-30 11:32:56 +08:00

tokenize_util.h

feat: add Qwen Image support (#851 )

2025-10-12 23:23:19 +08:00

unet.hpp

feat: handle ggml compute failures without crashing the program (#1003 )

2025-12-04 22:04:27 +08:00

upscaler.cpp

feat: support custom upscale tile size (#896 )

2025-12-10 22:25:19 +08:00

util.cpp

refactor: optimize the handling of LoRA models (#1070 )

2025-12-10 00:26:07 +08:00

util.h

refactor: optimize the handling of LoRA models (#1070 )

2025-12-10 00:26:07 +08:00

vae.hpp

feat: handle ggml compute failures without crashing the program (#1003 )

2025-12-04 22:04:27 +08:00

version.cpp

feat: embed version string and git commit hash (#1008 )

2025-12-09 22:38:54 +08:00

vocab_mistral.hpp

feat: add flux2 support (#1016 )

2025-11-30 11:32:56 +08:00

vocab_qwen.hpp

feat: add Qwen Image support (#851 )

2025-10-12 23:23:19 +08:00

vocab_umt5.hpp

feat: add wan2.1/2.2 support (#778 )

2025-09-06 18:08:03 +08:00

vocab.hpp

feat: add sd3 support (#298 )

2024-07-28 15:44:08 +08:00

wan.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

z_image.hpp

feat: add seamless texture generation support (#914 )

2025-12-21 18:06:47 +08:00

README.md

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
  - 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 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)
- 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 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/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

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.

Contributors

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

README.md

stable-diffusion.cpp

🔥Important News

Features

Quick Start

Get the sd executable

Download model weights

Generate an image with just one command

Performance

More Guides

Bindings

UIs

Contributors

Star History

References