InvokeAI 2.3.5
We are pleased to announce a features update to InvokeAI with the release of version 2.3.5. This is currently a pre-release for community testing and bug reporting.
- What's New
- Installation and Upgrading
- Known Bugs
- Getting Help
- Development Roadmap
- Detailed Change Log
- Acknowledgements
What's New in 2.3.5
This release expands support for additional LoRA and LyCORIS models, upgrades diffusers
to 0.15.1, and fixes a few bugs.
LoRA and LyCORIS Support Improvement
- A number of LoRA/LyCORIS fine-tune files (those which alter the text encoder as well as the unet model) were not having the desired effect in InvokeAI. This bug has now been fixed. Full documentation of LoRA support is available at InvokeAI LoRA Support.
- Previously, InvokeAI did not distinguish between LoRA/LyCORIS models based on Stable Diffusion v1.5 vs those based on v2.0 and 2.1, leading to a crash when an incompatible model was loaded. This has now been fixed. In addition, the web pulldown menus for LoRA and Textual Inversion selection have been enhanced to show only those files that are compatible with the currently-selected Stable Diffusion model.
- Support for the newer LoKR LyCORIS files has been added.
Diffusers 0.15.1
- This version updates the diffusers module to version 0.15.1 and is no longer compatible with 0.14. This provides a number of performance improvements and bug fixes.
Performance Improvements
- When a model is loaded for the first time, InvokeAI calculates its checksum for incorporation into the PNG metadata. This process could take up to a minute on network-mounted disks and WSL mounts. This release noticeably speeds up the process.
Bug Fixes
- The "import models from directory" and "import from URL" functionality in the console-based model installer has now been fixed.
Installation / Upgrading
To install or upgrade to InvokeAI 2.3.5 please download the zip file at the bottom of the release notes (under "Assets"), unpack it, and then double-click to launch the script install.sh
(Macintosh, Linux) or install.bat
(Windows). Alternatively, you can open a command-line window and execute the installation script directly.
InvokeAI-installer-v2.3.5.zip
To update from versions 2.3.1 or higher, select the "update" option (choice 6) in the invoke.sh
/invoke.bat
launcher script and choose the option to update to 2.3.5. Alternatively, you may use the installer zip file to update. When it asks you to confirm the location of the invokeai
directory, type in the path to the directory you are already using, if not the same as the one selected automatically by the installer. When the installer asks you to confirm that you want to install into an existing directory, simply indicate "yes".
Developers and power users can upgrade to the current version by activating the InvokeAI environment and then using pip install --use-pep517 --upgrade InvokeAI
. You may specify a particular version by adding the version number to the command, as in InvokeAI==2.3.5
. To upgrade to an xformers
version if you are not currently using xformers
, use pip install --use-pep517 --upgrade InvokeAI[xformers]
. You can see which versions are available by going to The PyPI InvokeAI Project Page
Known Bugs in 2.3.5
These are known bugs in the release.
- Windows Defender will sometimes raise Trojan or backdoor alerts for the
codeformer.pth
face restoration model, as well as theCIDAS/clipseg
andrunwayml/stable-diffusion-v1.5
models. These are false positives and can be safely ignored. InvokeAI performs a malware scan on all models as they are loaded. For additional security, you should use safetensors models whenever they are available. - If the
xformers
memory-efficient attention module is used, each image generated with the same prompt and settings will be slightly different.xformers 0.0.19
reduces or eliminates this problem, but hasn't been extensively tested with InvokeAI. If you wish to upgrade, you may do so by entering the InvokeAI "developer's console" and giving the commandpip install xformers==0.0.19
. You may see a message about InvokeAI being incompatible with this version, which you can safely ignore. Be sure to report any unexpected behavior to the Issues pages.
Getting Help
Please see the InvokeAI Issues Board or the InvokeAI Discord for assistance from the development team.
Development Roadmap
This is very likely to be the last release on the v2.3
source code branch. All new features are being added to the main
branch. At the current time (late April, 2023), the main
branch is only partially functional due to a complex transition to an architecture in which all operations are implemented via flexible and extensible pipelines of "nodes".
If you are looking for a stable version of InvokeAI, either use this release, install from the v2.3
source code branch, or use the pre-nodes
tag from the main
branch. Developers seeking to contribute to InvokeAI should use the head of the main
branch. Please be sure to check out the dev-chat channel of the InvokeAI Discord, and the architecture documentation located at Contributing to come up to speed.
Change Log
- fix the "import from directory" function in console model installer by @lstein in #3211
- [Feature] Add support for LoKR LyCORIS format by @StAlKeR7779 in #3216
- CODEOWNERS update - 2.3 branch by @lstein in #3230
- Enable LoRAs to patch the text_encoder as well as the unet by @damian0815 in #3214
- improvements to the installation and upgrade processes by @lstein in #3186
- Revert "improvements to the installation and upgrade processes" by @lstein in #3266
- [Enhancement] distinguish v1 from v2 LoRA models by @lstein in #3175
- increase sha256 chunksize when calculating model hash by @lstein in #3162
- bump version number to 2.3.5-rc1 by @lstein in #3267
- [Bugfix] Renames in 0.15.0 diffusers by @StAlKeR7779 in #3184
New Contributors and Acknowledgements
- @AbdBarho contributed the checksum performance improvements
- @StAlKeR7779 (Sergey Borisov) contributed the LoKR support, did the diffusers 0.15 port, and cleaned up the code in multiple places.
Many thanks to these individuals, as well as @damian0815 for his contribution to this release.
Full Changelog: v2.3.4.post1...v2.3.5-rc1