Skip to content

v3.8.1 release with Windows installer (Stable Diffusion 3)

Compare
Choose a tag to compare
@Teriks Teriks released this 26 Jun 06:04
· 961 commits to master since this release

v3.8.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.

3.8.1 Patch Fixes

Cleaner shutdown when ctrl-c is used from the terminal to exit the Console UI tkinter app, especially on Linux.

Fix stuck forever behavior when dgenerate --console file.dgen was used from the terminal and file.dgen does not exist. Caused
by sys.exit call on the main thread without the tkinter main loop thread exiting, leaving it waiting forever for events and preventing
the process from shutting down.

3.8.0 Features & Fixes

1.) Support for Stable Diffusion 3 --model-type torch-sd3, supports txt2img, img2img, multiple Control Nets, multiple LoRAs (scale not supported yet by diffusers). Inpainting is not supported currently, neither are textual inversions. Enabling --vae-tiling restricts output to power of 2 sizes. All output / input needs to be aligned by 16 pixels normally. See: Examples

New SD3 Arguments:

  • --sd3-max-sequence-length (max accepted tokens by the T5 encoder, text encoder number 3)
  • --sd3-second-prompts (text encoder number 2 prompts)
  • --sd3-third-prompts (text encoder number 3 prompts)

2.) Support for specifying the text encoders involved in a diffusion pipeline using typical dgenerate URI syntax. All text encoders of any model can be specified, including individual encoders leaving others as defaults, using the new arguments --text-encoders for the main pipeline and --text-encoders2 for the SDXL Refiner or Stable Cascade Decoder. See: Specifying Text Encoders for syntax. This is to better support single file loads when using Stable Diffusion 3. Single file loads for text encoders are not supported and they must be loaded from a huggingface repository or folder on disk containing the model + configuration.

3.) New config directive for clearing the Text Encoder in memory model cache manually: \clear_text_encoder_cache

4.) New config function / template function for converting the enums that exist in the template variables last_model and last_dtype
to a value that is usable for a dgenerate argument. New functions are: format_model_type(last_model) and format_dtype(last_dtype),
they accept the enum values as arguments and return a string.

5.) Improved syntax highlighting in the Console UI for directives which accept a variable name as their first argument such as \set, directive can now be immediately followed by a line continuation before the variable name, and specifying the variable name with a template now highlights and behaves correctly.

6.) Added Stable Diffusion 3 recipe to Console UI recipes menu. Improved auth_token recipe code for Stable Diffusion 3 and Deep Floyd.

7.) Bug fix for the enter key not working in the Console UI find/replace dialog and getting the dialog into a bad state, enter action is now (find next).

8.) Bug fix to (in memory) cache accounting of user specified sub models such as UNets, VAEs, Text Encoders, and Control Nets. Previously
the memory used by these models was not being tracked properly as they entered / exited GPU memory, leading to non optimal garbage collection according to memory constraint settings for these models.

9.) New letterbox image processor for letterboxing input / output images, see: Image Processors, and dgenerate --image-processor-help letterbox