dgenerate
dgenerate is a scriptable command-line tool (and library) for generating/editing images and processing animated inputs with AI.
Whether you’re generating or editing single images, batch processing hundreds of variations, or transforming entire videos frame-by-frame, dgenerate provides a flexible, scriptable interface for a multitude of image generation and editing tasks.
For the extensive usage manual, manual installation guide, and API documentation, visit readthedocs.
What You Can Do
Image Generation
Generate images using a number of popular model architectures such as: SD, SDXL, SD3, Flux, and Kolors
Batch process multiple parameter combinations combinatorially to generate variations
Run large models on limited hardware with inference optimizations and quantization
Utilize models from HuggingFace and CivitAI for generation
Advanced prompt weighting (LPW), SD-WebUI (Common syntax), InvokeAI syntax, and llm4gen (SD1.5 only)
Control Nets, T2I Adapters, IP Adapters, LoRA, and Textual Inversion (embeddings)
Text to image, image to image, and inpainting
Diffusion-based image upscaling
Image Processing
Easily chain image processors together for advanced scripted image manipulation
Utilize built-in image processors for edge detection, depth mapping, segmentation, feature detection, and more
Run upscaling / image restoration models such as ESRGAN, SwinIR, etc… via spandrel
Run image processors generically on any image
Animation & Video Processing
Transform videos into artistic non-temporally consistent animations
Process GIF, WebP, APNG, MP4, and any other video format supported by av (ffmpeg)
Memory-efficient, streamed processing of video content from disk
Apply image processors to any animated input, for example upscaling / classification / mask generation
Scripting
Utilize the built-in shell language to script generation tasks, work in REPL mode from the Console UI
Write scripted workflows with intelligent VRAM/RAM memory management, garbage collection, and caching
Write plugins such as image processors, prompt weighters, shell language features, etc. in Python if desired
Getting Started
Quick Install
Download an install wizard for your platform from the releases page for a hassle-free setup into an isolated Python environment.
Manual Install
System Requirements
GPU: NVIDIA (CUDA 12.1+), AMD (ROCm on Linux), or Apple Silicon
Python: 3.11 to 3.13
OS: Windows, macOS, or Linux
Note: CPU rendering is possible but extremely slow unless the given model is tailored for it.
Two Ways to Use dgenerate
Command Line
Perfect for automation and batch processing:
dgenerate stable-diffusion-v1-5/stable-diffusion-v1-5 --prompts "a cute cat" --inference-steps 15 20 30
dgenerate --file workflow-config.dgenInteractive GUI
# launch the Console UI
dgenerate --consoleFeatures a syntax-highlighting console / editor:
REPL / code editor for the built in shell language to assist with building complex workflows
OpenGL accelerated image preview, featuring smooth zoom / pan, and bounding box / coordinate picker
Various templating utilities (recipes, and URI builders) for quickly creating scripts and working interactively
In editor documentation for all arguments, and built in image processors / plugins
Lightweight multiplatform Tkinter-based UI
1 maintainer
Metadata
1 maintainer
Release files for dgenerate 5.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dgenerate-5.0.0.tar.gz | 21.6 MB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dgenerate-5.0.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| dgenerate-5.0.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| dgenerate-5.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 88.8 MB
Release files / dgenerate-5.0.0.tar.gz
| Download URL | dgenerate-5.0.0.tar.gz |
|---|---|
| Size | 21.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cdb51a1d2c613c1aa645412f7b80c9fcc8a7afec2efc07b63a3ca777ccf855d6
|
|
BLAKE2b-256 checksum How to use checksums |
04709421ccb7490db031e44fd731482bec03168458aeefb6f86f48b8ecb202f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / dgenerate-5.0.0-py3-none-win_amd64.whl
| Download URL | dgenerate-5.0.0-py3-none-win_amd64.whl |
|---|---|
| Size | 22.4 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
397da68788123b35660e2de50f74aab16bf7cdc1e9e3d836a2e7433ea02488d2
|
|
BLAKE2b-256 checksum How to use checksums |
e3b385f1093196a9d0bb1fe1565b16ded81d05d75bf964baf12be0890c19b392
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / dgenerate-5.0.0-py3-none-macosx_11_0_arm64.whl
| Download URL | dgenerate-5.0.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 22.4 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
31afe7625e4ade207dc171cb216e70578ce5a9aee37634798cd9dcba66a4b6ed
|
|
BLAKE2b-256 checksum How to use checksums |
06ecd81a2ed70458f40ca307d81d4728d461255c7988fc9f8b923fd369c44940
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / dgenerate-5.0.0-py3-none-any.whl
| Download URL | dgenerate-5.0.0-py3-none-any.whl |
|---|---|
| Size | 22.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
89a8797e9b4a1f541996e5c3ebce30570ee7d9e7922f525913041aeec3ae30e3
|
|
BLAKE2b-256 checksum How to use checksums |
82a2821355890fe64c0e80a08e290252ce612916e016ceee09e747a3398df682
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
