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

**Wan Video**
- WanPipeline
- WanImageToVideoPipeline

**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="Screenshots/TextToImage.png">
</p> 

### ImageToImage
<p align="center" width="100%">
    <img src="Screenshots/ImageToImage.png">
</p> 

### ImageEdit
<p align="center" width="100%">
    <img src="Screenshots/ImgeEdit.png">
</p> 

### ImageEdit-Multi
<p align="center" width="100%">
    <img src="Screenshots/ImgeEdit-Multi.png">
</p> 

### TextToVideo
<p align="center" width="100%">
    <img src="Screenshots/TextToVideo.png">
</p> 

### ImageToVideo
<p align="center" width="100%">
    <img src="Screenshots/ImageToVideo.png">
</p>