InvokeAI Version 2.2.4 - A Stable Diffusion Toolkit

With InvokeAI 2.2, this project now provides enthusiasts and professionals a robust workflow solution for creating AI-generated and human facilitated compositions. Additional enhancements have been made as well, improving safety, ease of use, and installation.

Optimized for efficiency, InvokeAI needs only ~3.5GB of VRAM to generate a 512x768 image (and less for smaller images), and is compatible with Windows/Linux/Mac (M1 & M2).

You can see the release video here, which introduces the main WebUI enhancement for version 2.2 - The Unified Canvas. This new workflow is the biggest enhancement added to the WebUI to date, and unlocks a stunning amount of potential for users to create and iterate on their creations. The following sections describe what's new for InvokeAI.

Version 2.2.4 is a bugfix release. The major user-visible change is that we have overhauled the installation experience to make it faster and more stable. Please see Installation Overview for instructions on using the new installer, and see the .zip files in the Assets section below for the installer for your preferred platform. Note that you will need to install Python 3.9 or 3.10 to use the new installation method.

The new installers are located here. They have been updated 13 December in order to prevent a segfault crash on certain Macintosh systems.

There are a number of installation-related changes that previous InvokeAI users should be aware of:

Everything now lives in the invokeai directory.

Previously there were two directories to worry about, the directory that contained the InvokeAI source code and the launcher scripts, and the invokeai 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.bat and 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.

InvokeAI-installer-2.2.4-p5-linux.zip
InvokeAI-installer-2.2.4-p5-mac.zip
InvokeAI-installer-2.2.4-p5-windows.zip

After installation, you can delete the install directory (the one that the zip file creates when it unpacks). Do not delete or move the invokeai directory!

The .invokeai initialization file has been renamed invokeai/invokeai.init

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 invokeai.init.

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 C:\Users\fred and answer "Y" when asked if you want to reuse the directory.

The update.sh (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 using an update.sh (update.bat) script located in the invokeai directory. Running it without any arguments will install the most recent version of InvokeAI. Alternatively, you can get set releases by running the update.sh 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. Here are some examples:

# 2.2.4 release
update.sh https://github.com/invoke-ai/InvokeAI/archive/refs/tags/v2.2.4.zip

# 2.2.5 release  (don't try; it doesn't exist yet!)
update.sh https://github.com/invoke-ai/InvokeAI/archive/refs/tags/v2.2.5.zip

# current development version
update.sh https://github.com/invoke-ai/InvokeAI/archive/main.zip

# feature branch 3d-movies (don't try; it doesn't exist yet!)
update.sh https://github.com/invoke-ai/InvokeAI/archive/3d-movies.zip

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

New Contributors

• @ebr made their first contribution in #1727
• @addianto made their first contribution in #1687
• @ShawnZhong made their first contribution in #1736
• @andybearman made their first contribution in #1756
• @ofirkris made their first contribution in #1755
• @VedantMadane made their first contribution in #1821
• @lynnewu made their first contribution in #1833
• @SammCheese made their first contribution in #1848

Full Changelog: v2.2.3...v2.2.4