| | --- |
| | license: apache-2.0 |
| | language: |
| | - en |
| | --- |
| | |
| | <p align="center" width="100%"> |
| | <img width="35%" src="Assets/Diffuse-Logo-512.png"> |
| | </p> |
| | |
| | `Diffuse` is a Windows desktop UI for `Huggingface Diffusers`. It integrates directly with Python using the Python C API via `CSnakes`, enabling high-performance interop between .NET and Python for running diffusion models. |
| |
|
| | --- |
| |
|
| | ## Features |
| | - Automatic installation of isolated portable Python |
| | - Device-specific Python virtual environments |
| | - Automatic model downloads from Huggingface repositories |
| |
|
| | --- |
| |
|
| | ## Supported Pipelines |
| | - **Z-Image:** ZImagePipeline, ZImageImg2ImgPipeline |
| | - **Qwen Image:** QwenImagePipeline, QwenImageImg2ImgPipeline, QwenImageEditPlusPipeline |
| | - **FLUX.1:** FluxPipeline, FluxImg2ImgPipeline, FluxKontextPipeline, FluxControlNetPipeline |
| | - **FLUX.2:** Flux2Pipeline |
| | - **Chroma:** ChromaPipeline, ChromaImg2ImgPipeline |
| | - **LTX-Video:** LTXPipeline, LTXImageToVideoPipeline |
| | - **Wan Video:** WanPipeline, WanImageToVideoPipeline |
| | - **CogVideoX:** CogVideoXPipeline, CogVideoXImageToVideoPipeline, CogVideoXVideoToVideoPipeline |
| | - **Kandinsky5:** Kandinsky5T2IPipeline, Kandinsky5I2IPipeline, Kandinsky5T2VPipeline, Kandinsky5I2VPipeline |
| | - **StableDiffusionXL:** StableDiffusionXLPipeline, StableDiffusionXLImg2ImgPipeline, StableDiffusionXLControlNetPipeline, StableDiffusionXLControlNetImg2ImgPipeline |
| |
|
| | --- |
| |
|
| | ## Installation |
| |
|
| | 1. Download and extract **Diffuse.zip** |
| | *A fast SSD with plenty of free space is recommended, as model downloads can be large.* |
| |
|
| | 2. Run **Diffuse.exe** |
| |
|
| | 3. Load a model |
| | Diffuse will automatically: |
| | - Install an isolated portable Python runtime |
| | - Create the required virtual environment |
| | - Download the selected model from Hugging Face |
| |
|
| | ### First-run notice |
| | On first launch or when loading a model for the first time, setup may take several minutes while Python, dependencies, and model files are downloaded and initialized. This is expected behavior. |
| |
|
| | No manual Python setup is required. |
| |
|
| |
|
| | --- |
| |
|
| | ## Project Roadmap |
| |
|
| | ### Alpha |
| | Proof of concept, Focus on core functionality. |
| | - Portable Python installation and management |
| | - Device-specific virtual environments |
| | - Minimal but functional Windows UI |
| | - Basic Diffusers pipeline support |
| |
|
| | ### Beta |
| | Focus on usability, stability, and feature expansion. |
| | - Fully isolated Python execution |
| | - Installer and deployment tooling |
| | - Advanced UI and workflow options |
| | - Upscaling and interpolation support |
| | - Extractor pipeline support |
| | - Stability, performance, and reliability improvements |
| |
|
| | --- |
| |
|
| | ## Screenshots |
| |
|
| | ### TextToImage |
| | <p align="center" width="100%"> |
| | <img src="Assets/Screenshots/TextToImage.png"> |
| | </p> |
| | |
| | ### ImageToImage |
| | <p align="center" width="100%"> |
| | <img src="Assets/Screenshots/ImageToImage.png"> |
| | </p> |
| | |
| | ### ImageEdit |
| | <p align="center" width="100%"> |
| | <img src="Assets/Screenshots/ImgeEdit.png"> |
| | </p> |
| | |
| | ### ImageEdit-Multi |
| | <p align="center" width="100%"> |
| | <img src="Assets/Screenshots/ImgeEdit-Multi.png"> |
| | </p> |
| | |
| | ### TextToVideo |
| | <p align="center" width="100%"> |
| | <img src="Assets/Screenshots/TextToVideo.png"> |
| | </p> |
| | |
| | ### ImageToVideo |
| | <p align="center" width="100%"> |
| | <img src="Assets/Screenshots/ImageToVideo.png"> |
| | </p> |
