Skip to content

Releases

Development Pre-release: version_6.0.0 - 20261114-144340

Choose a tag to compare

@Teriks Teriks released this 27 Mar 20:48

Latest Build Artifacts

Automatically generated release containing the latest build artifacts for all platforms.

Build Information

Available Downloads

Installers

  • Windows: dgenerate-installer-win-da5d7b3.exe
  • Linux: dgenerate-installer-linux-da5d7b3
  • macOS (Apple Silicon): dgenerate-installer-macos-da5d7b3

Bootstrap scripts

  • Linux / macOS: install.sh
  • Windows: install.ps1

Python Wheels

  • Windows: dgenerate-6.0.0-da5d7b3-py3-none-win_amd64.whl
  • Linux/Universal: dgenerate-6.0.0-da5d7b3-py3-none-any.whl
  • macOS (Apple Silicon): dgenerate-6.0.0-da5d7b3-py3-none-macosx_11_0_arm64.whl
  • Source Distribution: dgenerate-6.0.0.tar.gz

Installation

Quick install

Linux / macOS (Apple Silicon)

curl -fsSL https://github.com/Teriks/dgenerate/releases/download/pre-release/install.sh | sh

Windows (PowerShell)

irm https://github.com/Teriks/dgenerate/releases/download/pre-release/install.ps1 | iex

The script downloads the installer and launches it. Select Development Branch and choose version_6.0.0.

Windows

  1. Download dgenerate-installer-win-da5d7b3.exe
  2. Run the installer

Note for Windows users: Windows Defender may flag the installer as potentially harmful since it's unsigned. If you see a warning, click "More info" and then "Run anyway" to proceed with the installation.

If you previously installed dgenerate using the older MSI installer, please uninstall it before installing with the network installer.

Linux

  1. Download dgenerate-installer-linux-da5d7b3
  2. Make the file executable: chmod +x dgenerate-installer-linux-da5d7b3
  3. Run the installer: ./dgenerate-installer-linux-da5d7b3

macOS (Apple Silicon)

  1. Download dgenerate-installer-macos-da5d7b3
  2. Remove quarantine attribute: xattr -d com.apple.quarantine dgenerate-installer-macos-da5d7b3
  3. Make the file executable: chmod +x dgenerate-installer-macos-da5d7b3
  4. Run the installer: ./dgenerate-installer-macos-da5d7b3

Note for macOS users: The xattr command is required to prevent macOS from quarantining the binary, which would otherwise prevent execution.

Important: Pre-release Installation

To install the pre-release version 6.0.0, when running the installer, make sure to select "Development Branch" and choose version_6.0.0 from the available options in the installer UI. This will install the latest pre-release build instead of the stable release.


This release is automatically updated with each successful build.

Version 5.0.0

Choose a tag to compare

@Teriks Teriks released this 15 Oct 09:23

Installation

Windows

  1. Download dgenerate-installer-win-5.0.0.exe
  2. Run the installer

Note for Windows users: Windows Defender may flag the installer as potentially harmful since it's unsigned. If you see a warning, click "More info" and then "Run anyway" to proceed with the installation.

Linux

  1. Download dgenerate-installer-linux-5.0.0
  2. Make the file executable: chmod +x dgenerate-installer-linux-5.0.0
  3. Run the installer: ./dgenerate-installer-linux-5.0.0

macOS (Apple Silicon)

  1. Download dgenerate-installer-macos-5.0.0
  2. Open Terminal and navigate to Downloads: cd ~/Downloads
  3. Remove quarantine attribute: xattr -d com.apple.quarantine dgenerate-installer-macos-5.0.0
  4. Make the file executable: chmod +x dgenerate-installer-macos-5.0.0
  5. Run the installer: ./dgenerate-installer-macos-5.0.0

Note for macOS users: The xattr command is required to prevent macOS from quarantining the binary, which would otherwise prevent execution.


Build Date: 2025-10-15 09:25:46 UTC
Workflow: Build and Publish Release #1


Patch Notes

  • Python 3.13, torch 2.8.0
  • Vastly improved shell syntax, no more !END statements, proper parsing of control structures
  • Speed / resolution enhancement options: HiDiffusion, DeepCache, TeaCache, RAS, SADA, freeu etc.
  • Prompt argument embedding (for certain arguments)
  • LLM4GEN prompt weighter for SD1.5
  • compel prompt weighter now supports Flux
  • Local LLM based prompt upscaler plugins (GPT4ALL / transformers) and language translation via argostranslate or transformers (Helsinki NLP)
  • Flux Kontext pipelines, SD3 Pix2Pix pipelines
  • Enhanced offline mode for typical single file checkpoints (CivitAI), vendored HuggingFace configs used when --offline-mode active
  • DynamicPrompts combinatoric prompting, and random attention (as prompt upscalers)
  • Quantization support, backends bitsandbytes & sdnq (SD.Next quantization)
  • Quantization support for single file checkpoints such as those from CivitAI, including with LoRAs
  • Quantization specifiable on a per sub-model or global basis
  • Quantization support for transformers based LLM prompt upscaler (souped up MagicPrompts)
  • All applicable ControlNet union pipelines
  • Automatic crop to inpaint area capability similar to Invoke
  • All Kolors pipelines including new custom ControlNet pipelines
  • Full scheduler argument parameterization from the command line / shell
  • Partial denoising and latents interchange (latents as output / input)
  • Latents processor plugins including conversion (interposer) / noise / scale
  • Options for manipulation of pipeline sigmas, including built in expression parser for easy scaling
  • patchmatch CPU based inpainting image processor implemented in Cython
  • inpaint image processor (spandrel based MAT/LaMa)
  • Segment Anything and YOLO mask generation / detection image processors via Ultralytics
  • New image processors such as paste / crop-to-mask to aid with manual adetailer like editing tasks
  • adetailer pipeline (adetailer on any image) / adetailer image processor for --post-processors usage
  • image processor arch overhaul, use image processors at any pixel alignment
  • SigLIP IP Adapter for SD3
  • GPU memory management overhaul, mostly internal architecture
  • Experimental XPU support
  • Fix outdated timm library reliance in controlnet_aux
  • Command line argument compression, but also even more arguments / parameterizations
  • (Console UI) Cross platform OpenGL accelerated image viewer with pan/zoom, bounding box and point selection tools
  • (Console UI) Countless UI improvements to Recipe / URI insertion UIs, a form for every possible URI argument
  • (Console UI) A few new color schemes
  • (Console UI) Many stability fixes
  • Move to cross platform network installer instead of PyInstaller + WiX

v4.5.1 (Flux Textual Inversion, minor fix)

Choose a tag to compare

@Teriks Teriks released this 17 Jan 10:17

v4.5.1 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.5.1 Patch

  • Default --textual-inversions lexical token name for Flux should mimic behavior of the default token name for SDXL, i.e. the token name should be set to the model filename (spaces to underscores, no extension), when no token name is provided.

  • Documentation fixes.

4.5.0 Features & Fixes

  • Support for Flux fill (Infill / Outfill) via --model-type torch-flux-fill, this model type uses the inpainting --image-seeds syntax to specify an image and a mask. See: example

  • Support for --textual-inversions with --model-type torch-flux-fill

  • Support for --textual-inversions with --model-type torch-flux in basic txt2img configuration, with txt2img + Control Nets, and with inpainting + Control Nets.

  • Support for a single --ip-adapters weights definition with --model-type torch-flux in basic txt2img configuration. Does not support Control Net or img2img / inpaint / fill. See: example

  • Dynamic feature availability checking for LoRA, Textual Inversion, and IP Adapter support on supported diffusers pipelines using introspection, refactored input validation for these features in particular.

  • Fix for unusable StableDiffusionControlNetPAGInpaintPipeline caused by typo.

  • New Console UI recipes for --model-type torch-flux-fill

  • #9, Remove problematic dependency bitsandbytes for now, dependency unused, and PyPI release for bitsandbytes currently incompatible with MPS and ROCm

  • Update to diffusers==0.32.2, and update other pinned deps where possible.

  • #8, Fix PyPI package python spec and related documentation, not compatible with python 3.13 due to dependencies, spec is now >=3.10,<3.13

  • #7, recommend / use --extra-index-url https://download.pytorch.org/whl/rocm6.2/, latest ROCm backend for ROCm install

v4.5.0 (Flux Fill, Flux IP Adapter, Flux Textual Inversion)

Choose a tag to compare

@Teriks Teriks released this 17 Jan 01:26

v4.5.0 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.5.0 Features & Fixes

  • Support for Flux fill (Infill / Outfill) via --model-type torch-flux-fill, this model type uses the inpainting --image-seeds syntax to specify an image and a mask. See: example

  • Support for --textual-inversions with --model-type torch-flux-fill

  • Support for --textual-inversions with --model-type torch-flux in basic txt2img configuration, with txt2img + Control Nets, and with inpainting + Control Nets.

  • Support for a single --ip-adapters weights definition with --model-type torch-flux in basic txt2img configuration. Does not support Control Net or img2img / inpaint / fill. See: example

  • Dynamic feature availability checking for LoRA, Textual Inversion, and IP Adapter support on supported diffusers pipelines using introspection, refactored input validation for these features in particular.

  • Fix for unusable StableDiffusionControlNetPAGInpaintPipeline caused by typo.

  • New Console UI recipes for --model-type torch-flux-fill

  • #9, Remove problematic dependency bitsandbytes for now, dependency unused, and PyPI release for bitsandbytes currently incompatible with MPS and ROCm

  • Update to diffusers==0.32.2, and update other pinned deps where possible.

  • #8, Fix PyPI package python spec and related documentation, not compatible with python 3.13 due to dependencies, spec is now >=3.10,<3.13

  • #7, recommend / use --extra-index-url https://download.pytorch.org/whl/rocm6.2/, latest ROCm backend for ROCm install

v4.4.2 (Dependency updates, URL Escaping & Web cache fixes)

Choose a tag to compare

@Teriks Teriks released this 05 Jan 07:42

v4.4.2 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.4.2 Patch

Update to latest diffusers release, update all dependencies where possible.

Ability to escape % and $ with \ to prevent environmental variable expansion in dgenerate config / shell language, this is needed to be able to utilize (download from) URLs that contain these characters. This escape mechanism is also understood from the command line if needed.

pygments (syntax highlighting) lexer updated to understand new escape sequences in URLs.

Minor fixes to on disk file cache behavior for downloaded files. Mainly issues arising from files
that are unexpectedly missing on disk but present in DB, that prevented self healing in certain cases.

4.4.0 Features

  • --scheduler, --sdxl-refiner-scheduler, and --s-cascade-decoder-scheduler can now handle being passed multiple URIs, this allows you to iterate over different schedulers (samplers) directly from the CLI with one command and no further scripting. These arguments now also have pluralized aliases: --schedulers, --sdxl-refiner-schedulers, and --s-cascade-decoder-schedulers, to help with potentially annoying typos. Using multiple schedulers contributes to generation steps combinatorically, in the same way as other diffusion parameter arguments such as --inference-steps and --guidance-scales etc.

  • New Edit -> Insert Argument Console UI dialog, you can now select dgenerate arguments from a drop down and insert them into the config. This new dialog has a help button which will display the help text for the selected argument from dgenerates --help output in isolation, similar to the help window available in the image processor selection UI. This dialog is also available by right clicking the text input area in the Console UI and selecting Insert Argument.

v4.4.1 (Scheduler batching / iteration, UI improvements) Patch

Choose a tag to compare

@Teriks Teriks released this 10 Nov 10:52

v4.4.1 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.4.1 Patch

Insert Argument Console UI dialog arguments are now sorted alphabetically, buttons are disabled if nothing is selected, and initial selection is set to empty.

Fix --help text formatting for --output-overwrite.

4.4.0 Features

  • --scheduler, --sdxl-refiner-scheduler, and --s-cascade-decoder-scheduler can now handle being passed multiple URIs, this allows you to iterate over different schedulers (samplers) directly from the CLI with one command and no further scripting. These arguments now also have pluralized aliases: --schedulers, --sdxl-refiner-schedulers, and --s-cascade-decoder-schedulers, to help with potentially annoying typos. Using multiple schedulers contributes to generation steps combinatorically, in the same way as other diffusion parameter arguments such as --inference-steps and --guidance-scales etc.

  • New Edit -> Insert Argument Console UI dialog, you can now select dgenerate arguments from a drop down and insert them into the config. This new dialog has a help button which will display the help text for the selected argument from dgenerates --help output in isolation, similar to the help window available in the image processor selection UI. This dialog is also available by right clicking the text input area in the Console UI and selecting Insert Argument.

v4.4.0 (Scheduler batching / iteration, UI improvements)

Choose a tag to compare

@Teriks Teriks released this 10 Nov 05:43

v4.4.0 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.4.0 Features

  • --scheduler, --sdxl-refiner-scheduler, and --s-cascade-decoder-scheduler can now handle being passed multiple URIs, this allows you to iterate over different schedulers (samplers) directly from the CLI with one command and no further scripting. These arguments now also have pluralized aliases: --schedulers, --sdxl-refiner-schedulers, and --s-cascade-decoder-schedulers, to help with potentially annoying typos. Using multiple schedulers contributes to generation steps combinatorically, in the same way as other diffusion parameter arguments such as --inference-steps and --guidance-scales etc.

  • New Edit -> Insert Argument Console UI dialog, you can now select dgenerate arguments from a drop down and insert them into the config. This new dialog has a help button which will display the help text for the selected argument from dgenerates --help output in isolation, similar to the help window available in the image processor selection UI. This dialog is also available by right clicking the text input area in the Console UI and selecting Insert Argument.

v4.3.4 (PAG. Flux Control Nets, img2img & inpainting) Patch

Choose a tag to compare

@Teriks Teriks released this 06 Nov 06:25

v4.3.4 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.3.4 Patch

  • --pag-scales, --pag-adaptive-scales, --sdxl-refiner-pag-scales, and --sdxl-refiner-pag-adaptive-scales are now properly reproduced in configuration produced by --output-configs. Previously they were left un-pluralized (typo)

4.3.0 Features

  • Flux img2img, inpainting, and Control Net support. InstantX/FLUX.1-dev-Controlnet-Union is also supported with --model-type torch-flux via a mode URI argument to --control-nets, see: Flux Union Control Net Mode in the README.

  • PAG perturbed attention guidance support for Stable Diffusion, SDXL, and SD3, see: Feature Table for support caveats. New arguments have been added for working with PAG: --pag, --pag-scales, --pag-adaptive-scales, --sdxl-refiner-pag, --sdxl-refiner-pag-scales, and --sdxl-refiner-pag-adaptive-scales.

  • Console UI recipe form updates for Flux control nets, added basic UI for specifying one control net model, control net scale, and control net mode for Flux ControlNet Union.

v4.3.3 (PAG. Flux Control Nets, img2img & inpainting) Patch

Choose a tag to compare

@Teriks Teriks released this 04 Nov 08:25

v4.3.3 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.3.3 Patch

  • --help text information fix under --text-encoders. Model type keyword T5TextModel corrected to T5EncoderModel.

  • Fix for user configurable environmental variable DGENERATE_WEB_CACHE_EXPIRY_DELTA, setting value to forever no longer
    triggers a datetime overflow. DGENERATE_WEB_CACHE_EXPIRY_DELTA=forever should retain files downloaded to dgenerates
    cache forever, this cache is unrelated to the cache in HF_HOME, and is used for models / files downloaded from locations other than huggingface.

4.3.0 Features

  • Flux img2img, inpainting, and Control Net support. InstantX/FLUX.1-dev-Controlnet-Union is also supported with --model-type torch-flux via a mode URI argument to --control-nets, see: Flux Union Control Net Mode in the README.

  • PAG perturbed attention guidance support for Stable Diffusion, SDXL, and SD3, see: Feature Table for support caveats. New arguments have been added for working with PAG: --pag, --pag-scales, --pag-adaptive-scales, --sdxl-refiner-pag, --sdxl-refiner-pag-scales, and --sdxl-refiner-pag-adaptive-scales.

  • Console UI recipe form updates for Flux control nets, added basic UI for specifying one control net model, control net scale, and control net mode for Flux ControlNet Union.

v4.3.2 (PAG. Flux Control Nets, img2img & inpainting) Patch

Choose a tag to compare

@Teriks Teriks released this 03 Nov 11:11

v4.3.2 release with Windows installer.

Due to the size of the packaged python environment, the installer is within a multi-part zip file.

The multipart zip can be extracted using 7-Zip: https://www.7-zip.org/

Download both dgenerate_installer.zip.001 and dgenerate_installer.zip.002 to a folder.

Unzip dgenerate_installer.zip.001 to a directory (Right click, 7-Zip -> Extract to "dgenerate_installer") and then run dgenerate_installer\dgenerate.msi to install.

dgenerate will be installed under C:\Program Files\dgenerate by default with an isolated python environment provided.

The install directory will be added to PATH, and dgenerate will be available from the command line.

Portable Install

A portable install is provided via dgenerate_portable.zip.001 and dgenerate_portable.zip.002, these contain
nothing but the dgenerate executable and a frozen python environment which can be placed anywhere.

4.3.2 Patch

Fix for --model-cpu-offload with 8 bit bitsandbytes quantized weights.

Fix for diffusers / accelerate randn_tensor device mismatch error, occasionally occurring in the following scripted construct upon subsequent invocations:

#! /usr/bin/env dgenerate --file
#! dgenerate 4.3.2

# Iterate over any scheduler options

\setp schedulers [ \
    'EulerAncestralDiscreteScheduler', \
    'KDPM2AncestralDiscreteScheduler', \
    'EulerDiscreteScheduler', \
    'KDPM2DiscreteScheduler', \
    'HeunDiscreteScheduler']

{% for scheduler in schedulers %}
    stabilityai/stable-diffusion-xl-base-1.0
    --model-type torch-sdxl
    --dtype float16
    --variant fp16
    --scheduler {{ scheduler }}
    --model-cpu-offload
    --prompts "add your prompt here"
{% endfor %} !END

Issue only occurred with --model-cpu-offload/--model-sequential-offload enabled due to quirks with accelerate offloading and high memory usage.

4.3.0 Features

  • Flux img2img, inpainting, and Control Net support. InstantX/FLUX.1-dev-Controlnet-Union is also supported with --model-type torch-flux via a mode URI argument to --control-nets, see: Flux Union Control Net Mode in the README.

  • PAG perturbed attention guidance support for Stable Diffusion, SDXL, and SD3, see: Feature Table for support caveats. New arguments have been added for working with PAG: --pag, --pag-scales, --pag-adaptive-scales, --sdxl-refiner-pag, --sdxl-refiner-pag-scales, and --sdxl-refiner-pag-adaptive-scales.

  • Console UI recipe form updates for Flux control nets, added basic UI for specifying one control net model, control net scale, and control net mode for Flux ControlNet Union.