# stable-diffusion.cpp **Repository Path**: sieding/stable-diffusion.cpp ## Basic Information - **Project Name**: stable-diffusion.cpp - **Description**: https://github.com/leejet/stable-diffusion.cpp - **Primary Language**: C++ - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-21 - **Last Updated**: 2026-07-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

# stable-diffusion.cpp 纯 C/C++ 实现的扩散模型（SD、Flux、Wan 等）推理引擎，基于 [ggml](https://github.com/ggml-org/ggml)，与 [llama.cpp](https://github.com/ggml-org/llama.cpp) 工作方式一致。 > **本项目由 [leejet/stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp) 镜像而来，并将所有子模块源码整合进单一仓库，形成自包含的"全家桶"版本。** > > 镜像源： --- ## 仓库整合说明 本仓库已将原项目的 4 个 git 子模块（submodule）全部扁平化为普通目录，子模块源码直接纳入主仓库管理。clone 后无需执行 `git submodule update --init`，开箱即用。 ### 整合的模块及源码来源 | 本地路径 | 原始仓库 | 说明 | |---|---|---| | `ggml/` | [github.com/leejet/ggml](https://github.com/leejet/ggml) | 机器学习张量库，CUDA/Vulkan/Metal 等后端依赖 | | `examples/server/frontend/` | [github.com/leejet/sdcpp-webui](https://github.com/leejet/sdcpp-webui) | 嵌入式 Web UI 前端 | | `thirdparty/libwebp/` | [github.com/webmproject/libwebp](https://github.com/webmproject/libwebp) | WebP 图像编解码（可选） | | `thirdparty/libwebm/` | [github.com/webmproject/libwebm](https://github.com/webmproject/libwebm) | WebM 视频封装（可选，依赖 libwebp） | ### 文档中文翻译 `docs/` 目录下所有 46 篇英文文档均已翻译为中文版（`_cn.md` 后缀），方便中文用户查阅。 --- ## 🔥 重要动态 * **2026/06/25** 🚀 现已支持 **Krea2** * **2026/06/04** 🚀 现已支持 **Ideogram4** * **2026/05/31** 🚀 现已支持 **PiD** * **2026/05/27** 🚀 现已支持 **Lens** * **2026/05/17** 🚀 现已支持 **LTX-2.3** * **2026/04/11** 🚀 全新嵌入式 Web UI * **2026/01/18** 🚀 现已支持 **FLUX.2-klein** * **2025/12/01** 🚀 现已支持 **Z-Image** * **2025/11/30** 🚀 现已支持 **FLUX.2-dev** * **2025/10/13** 🚀 现已支持 **Qwen-Image-Edit / Qwen-Image-Edit 2509** * **2025/10/12** 🚀 现已支持 **Qwen-Image** * **2025/09/14** 🚀 现已支持 **Wan2.1 Vace** * **2025/09/06** 🚀 现已支持 **Wan2.1 / Wan2.2** --- ## 特性 - 基于 [ggml](https://github.com/ggml-org/ggml) 的纯 C/C++ 实现 - 极致轻量，无外部依赖 - 支持的模型 - **图像模型：** SD1.x / SD2.x / SDXL / SD3 / SD3.5 / FLUX.1 / FLUX.2 / Lens / Chroma / Qwen Image / PiD / LongCat Image / Z-Image / MiniT2I / Ovis-Image / Anima / ERNIE-Image / Boogu Image / Krea2 / SeFi-Image / HiDream-O1-Image / Ideogram4 - **图像编辑：** FLUX.1-Kontext / Qwen Image Edit / LongCat Image Edit / Boogu Image Edit - **视频模型：** Wan2.1 / Wan2.2 / LTX-2.3 / HunyuanVideo 1.5 / LingBot-Video - PhotoMaker、Control Net、ADetailer - LoRA / LCM / TAESD / ESRGAN - 支持的后端：CPU（AVX/AVX2/AVX512） / CUDA / Vulkan / Metal / OpenCL / SYCL - 支持的权重格式：`.ckpt` / `.safetensors` / `.gguf` - 支持平台：Linux / macOS / Windows / Android - Flash Attention 显存优化 - VAE 平铺处理 - 跨平台可复现性（`--rng cuda` / `--rng cpu`） --- ## 快速开始 ### 克隆仓库 ```sh git clone https://gitee.com/sieding/stable-diffusion.cpp.git cd stable-diffusion.cpp ``` > 所有子模块源码已内置，无需额外操作。 ### 编译 参考 [构建指南](./docs/build.md) 或 [中文构建指南](./docs/build_cn.md)。常见后端示例： ```cmd # 仅 CPU cmake -B build -DCMAKE_BUILD_TYPE=Release cmake --build build --config Release --parallel # CUDA（需安装 CUDA Toolkit） cmake -B build -DCMAKE_BUILD_TYPE=Release -DSD_CUDA=ON cmake --build build --config Release --parallel ``` 详细选项（Vulkan、Metal、ROCm 等）参见构建文档。 > 如果不需要 WebP/WebM 支持，可在 cmake 时添加 `-DSD_WEBP=OFF -DSD_WEBM=OFF`。 ### 下载模型权重 ```sh curl -L -O https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors ``` ### 生成图像 ```sh ./bin/sd-cli -m ../models/v1-5-pruned-emaonly.safetensors -p "a lovely cat" ``` --- ## 文档 | 类别 | 文档 | |---|---| | 构建 | [build.md](./docs/build.md) / [build_cn.md](./docs/build_cn.md) | | 后端 | [backend.md](./docs/backend.md) / [backend_cn.md](./docs/backend_cn.md) | | 性能 | [performance.md](./docs/performance.md) / [performance_cn.md](./docs/performance_cn.md) | | 模型 | [sd.md](./docs/sd.md) / [flux.md](./docs/flux.md) / [wan.md](./docs/wan.md) / ... | | 中文翻译 | `docs/*_cn.md`（46 篇全覆盖） | --- ## 贡献者 感谢 [leejet/stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp) 的所有贡献者！ [![Contributors](https://contrib.rocks/image?repo=leejet/stable-diffusion.cpp)](https://github.com/leejet/stable-diffusion.cpp/graphs/contributors)