Repository navigation
Releases
Development Pre-release: version_6.0.0 - 20261114-144340
Latest Build Artifacts
Automatically generated release containing the latest build artifacts for all platforms.
Build Information
- Build Date: 2026-11-14 14:43:42 UTC
- Commit: da5d7b3
- Workflow: Build Pre-Release #76
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 | shWindows (PowerShell)
irm https://github.com/Teriks/dgenerate/releases/download/pre-release/install.ps1 | iexThe script downloads the installer and launches it. Select Development Branch and choose version_6.0.0.
Windows
- Download
dgenerate-installer-win-da5d7b3.exe - 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
- Download
dgenerate-installer-linux-da5d7b3 - Make the file executable:
chmod +x dgenerate-installer-linux-da5d7b3 - Run the installer:
./dgenerate-installer-linux-da5d7b3
macOS (Apple Silicon)
- Download
dgenerate-installer-macos-da5d7b3 - Remove quarantine attribute:
xattr -d com.apple.quarantine dgenerate-installer-macos-da5d7b3 - Make the file executable:
chmod +x dgenerate-installer-macos-da5d7b3 - 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
Installation
Windows
- Download
dgenerate-installer-win-5.0.0.exe - 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
- Download
dgenerate-installer-linux-5.0.0 - Make the file executable:
chmod +x dgenerate-installer-linux-5.0.0 - Run the installer:
./dgenerate-installer-linux-5.0.0
macOS (Apple Silicon)
- Download
dgenerate-installer-macos-5.0.0 - Open Terminal and navigate to Downloads:
cd ~/Downloads - Remove quarantine attribute:
xattr -d com.apple.quarantine dgenerate-installer-macos-5.0.0 - Make the file executable:
chmod +x dgenerate-installer-macos-5.0.0 - 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
!ENDstatements, 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-modeactive - 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-maskto aid with manual adetailer like editing tasks - adetailer pipeline (adetailer on any image) / adetailer image processor for
--post-processorsusage - 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)
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-inversionslexical 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-seedssyntax to specify an image and a mask. See: example -
Support for
--textual-inversionswith--model-type torch-flux-fill -
Support for
--textual-inversionswith--model-type torch-fluxin basictxt2imgconfiguration, withtxt2img+ Control Nets, and withinpainting+ Control Nets. -
Support for a single
--ip-adaptersweights definition with--model-type torch-fluxin basictxt2imgconfiguration. Does not support Control Net orimg2img / 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
StableDiffusionControlNetPAGInpaintPipelinecaused by typo. -
New Console UI recipes for
--model-type torch-flux-fill -
#9, Remove problematic dependency
bitsandbytesfor now, dependency unused, and PyPI release forbitsandbytescurrently 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)
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-seedssyntax to specify an image and a mask. See: example -
Support for
--textual-inversionswith--model-type torch-flux-fill -
Support for
--textual-inversionswith--model-type torch-fluxin basictxt2imgconfiguration, withtxt2img+ Control Nets, and withinpainting+ Control Nets. -
Support for a single
--ip-adaptersweights definition with--model-type torch-fluxin basictxt2imgconfiguration. Does not support Control Net orimg2img / 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
StableDiffusionControlNetPAGInpaintPipelinecaused by typo. -
New Console UI recipes for
--model-type torch-flux-fill -
#9, Remove problematic dependency
bitsandbytesfor now, dependency unused, and PyPI release forbitsandbytescurrently 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)
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-schedulercan 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-stepsand--guidance-scalesetc. -
New
Edit -> Insert ArgumentConsole 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--helpoutput 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 selectingInsert Argument.
v4.4.1 (Scheduler batching / iteration, UI improvements) Patch
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-schedulercan 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-stepsand--guidance-scalesetc. -
New
Edit -> Insert ArgumentConsole 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--helpoutput 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 selectingInsert Argument.
v4.4.0 (Scheduler batching / iteration, UI improvements)
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-schedulercan 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-stepsand--guidance-scalesetc. -
New
Edit -> Insert ArgumentConsole 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--helpoutput 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 selectingInsert Argument.
v4.3.4 (PAG. Flux Control Nets, img2img & inpainting) Patch
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-scalesare 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-Unionis also supported with--model-type torch-fluxvia amodeURI 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
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
-
--helptext information fix under--text-encoders. Model type keywordT5TextModelcorrected toT5EncoderModel. -
Fix for user configurable environmental variable
DGENERATE_WEB_CACHE_EXPIRY_DELTA, setting value toforeverno longer
triggers a datetime overflow.DGENERATE_WEB_CACHE_EXPIRY_DELTA=forevershould retain files downloaded to dgenerates
cache forever, this cache is unrelated to the cache inHF_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-Unionis also supported with--model-type torch-fluxvia amodeURI 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
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-Unionis also supported with--model-type torch-fluxvia amodeURI 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.