InvokeAI is an implementation of Stable Diffusion, the open source text-to-image and image-to-image generator. It provides a streamlined process with various new features and options to aid the image generation process. It runs on Windows, Mac and Linux machines, and runs on GPU cards with as little as 4 GB or RAM.
This fork is rapidly evolving. Please use the Issues tab to report bugs and make feature requests. Be sure to use the provided templates. They will help aid diagnose issues faster.
This fork is supported across Linux, Windows and Macintosh. Linux users can use either an Nvidia-based card (with CUDA support) or an AMD card (using the ROCm driver).
First time users, please see Automated Installer for a walkthrough of getting InvokeAI up and running on your system. For alternative installation and upgrade instructions, please see: InvokeAI Installation Overview
Users who wish to make use of the PyPatchMatch inpainting functions will need to perform a bit of extra work to enable this module. Instructions can be found at Installing PyPatchMatch.
If you have an NVIDIA card, you can benefit from the significant memory savings and performance benefits provided by Facebook Lab's xFormers module. Instructions for Linux and Windows users can be found at Installing xFormers.
You wil need one of the following:
- An NVIDIA-based graphics card with 4 GB or more VRAM memory.
- An AMD-based graphics card with 4 GB or more VRAM memory (Linux only)
- An Apple computer with an M1 chip.
We do not recommend the following video cards due to issues with their running in half-precision mode and having insufficient VRAM to render 512x512 images in full-precision mode:
- NVIDIA 10xx series cards such as the 1080ti
- GTX 1650 series cards
- GTX 1660 series cards
- At least 12 GB Main Memory RAM.
- At least 18 GB of free disk space for the machine learning model, Python, and all its dependencies.
Precision is auto configured based on the device. If however you encounter errors like
expected type Float but found Half or
not implemented for Half you can try starting
invoke.py with the
- The InvokeAI Web Interface - WebGUI hotkey reference guide - WebGUI Unified Canvas for Img2Img, inpainting and outpainting
- The Command Line Interace - Image2Image - Inpainting - Outpainting - Adding custom styles and subjects - Upscaling and Face Reconstruction
v2.2.4 (11 December 2022)#
Previously there were two directories to worry about, the directory that
contained the InvokeAI source code and the launcher scripts, and the
directory that contained the models files, embeddings, configuration and
outputs. With the 2.2.4 release, this dual system is done away with, and
everything, including the
invoke.sh launcher scripts, now
live in a directory named
invokeai. By default this directory is located in
your home directory (e.g.
\Users\yourname on Windows), but you can select
where it goes at install time.
After installation, you can delete the install directory (the one that the zip
file creates when it unpacks). Do not delete or move the
You can place frequently-used startup options in this file, such as the default
number of steps or your preferred sampler. To keep everything in one place, this
file has now been moved into the
invokeai directory and is named
To update from Version 2.2.3#
The easiest route is to download and unpack one of the 2.2.4 installer files.
When it asks you for the location of the
invokeai runtime directory, respond
with the path to the directory that contains your 2.2.3
invokeai. That is, if
invokeai lives at
C:\Users\fred\invokeai, then answer with
and answer "Y" when asked if you want to reuse the directory.
update.bat) script that came with the 2.2.3 source installer
does not know about the new directory layout and won't be fully functional.
To update to 2.2.5 (and beyond) there's now an update path.#
As they become available, you can update to more recent versions of InvokeAI
update.bat) script located in the
Running it without any arguments will install the most recent version of
InvokeAI. Alternatively, you can get set releases by running the
script with an argument in the command shell. This syntax accepts the path to
the desired release's zip file, which you can find by clicking on the green
"Code" button on this repository's home page.
Other 2.2.4 Improvements#
- Fix InvokeAI GUI initialization by @addianto in #1687
- fix link in documentation by @lstein in #1728
- Fix broken link by @ShawnZhong in #1736
- Remove reference to binary installer by @lstein in #1731
- documentation fixes for 2.2.3 by @lstein in #1740
- Modify installer links to point closer to the source installer by @ebr in #1745
- add documentation warning about 1650/60 cards by @lstein in #1753
- Fix Linux source URL in installation docs by @andybearman in #1756
- Make install instructions discoverable in readme by @damian0815 in #1752
- typo fix by @ofirkris in #1755
- Non-interactive model download (support HUGGINGFACE_TOKEN) by @ebr in #1578
- fix(srcinstall): shell installer - cp scripts instead of linking by @tildebyte in #1765
- stability and usage improvements to binary & source installers by @lstein in #1760
- fix off-by-one bug in cross-attention-control by @damian0815 in #1774
- Eventually update APP_VERSION to 2.2.3 by @spezialspezial in #1768
- invoke script cds to its location before running by @lstein in #1805
- Make PaperCut and VoxelArt models load again by @lstein in #1730
- Fix --embedding_directory / --embedding_path not working by @blessedcoolant in #1817
- Clean up readme by @hipsterusername in #1820
- Optimized Docker build with support for external working directory by @ebr in #1544
- disable pushing the cloud container by @mauwii in #1831
- Fix docker push github action and expand with additional metadata by @ebr in #1837
- Fix Broken Link To Notebook by @VedantMadane in #1821
- Account for flat models by @spezialspezial in #1766
- Update invoke.bat.in isolate environment variables by @lynnewu in #1833
- Arch Linux Specific PatchMatch Instructions & fixing conda install on linux by @SammCheese in #1848
- Make force free GPU memory work in img2img by @addianto in #1844
- New installer by @lstein
For older changelogs, please visit the CHANGELOG.
Please check out our Q&A to get solutions for common installation problems and other issues.
Anyone who wishes to contribute to this project, whether documentation, features, bug fixes, code cleanup, testing, or code reviews, is very much encouraged to do so. If you are unfamiliar with how to contribute to GitHub projects, here is a Getting Started Guide.
A full set of contribution guidelines, along with templates, are in progress, but for now the most important thing is to make your pull request against the "development" branch, and not against "main". This will help keep public breakage to a minimum and will allow you to propose more radical changes.
This fork is a combined effort of various people from across the world. Check out the list of all these amazing people. We thank them for their time, hard work and effort.
For support, please use this repository's GitHub Issues tracking service. Feel free to send me an email if you use and like the script.
Original portions of the software are Copyright © 2020 Lincoln D. Stein
Please see the original README for more information on this software and underlying algorithm, located in the file README-CompViz.md.
Created: September 15, 2022