From 746e97ea1d053b67d869fbd41e9fa2db3e196d1a Mon Sep 17 00:00:00 2001 From: Lincoln Stein Date: Sat, 14 Jan 2023 19:28:14 -0500 Subject: [PATCH 1/7] enhance the installer (#2299) 1. create_installers.sh now asks before tagging and committing the current repo 2. trailing whitespace removed from user-provided location of invokeai directory in install.bat --- installer/create_installer.sh | 19 ++++++++++++------- installer/install.bat.in | 13 ++++++++++++- 2 files changed, 24 insertions(+), 8 deletions(-) diff --git a/installer/create_installer.sh b/installer/create_installer.sh index 3488d4e5bb..0302e4192c 100755 --- a/installer/create_installer.sh +++ b/installer/create_installer.sh @@ -9,16 +9,21 @@ VERSION="v${VERSION}${PATCH}" echo "Be certain that you're in the 'installer' directory before continuing." read -p "Press any key to continue, or CTRL-C to exit..." -git commit -a +read -e -p "Commit and tag this repo with ${VERSION} and 'latest'? [n]: " input +RESPONSE=${input:='n'} +if [ "$RESPONSE" == 'y' ]; then -if ! git tag $VERSION ; then - echo "Existing/invalid tag" - exit -1 + git commit -a + + if ! git tag $VERSION ; then + echo "Existing/invalid tag" + exit -1 + fi + + git push origin :refs/tags/latest + git tag -fa latest fi -git push origin :refs/tags/latest -git tag -fa latest - echo Building installer zip fles for InvokeAI $VERSION # get rid of any old ones diff --git a/installer/install.bat.in b/installer/install.bat.in index 12bce8f10d..5aa222b8f0 100644 --- a/installer/install.bat.in +++ b/installer/install.bat.in @@ -33,7 +33,7 @@ echo 1. Install python 3.9 or higher. echo 2. Double-click on the file WinLongPathsEnabled.reg in order to echo enable long path support on your system. echo 3. Install the Visual C++ core libraries. -echo Pleaase download and install the libraries from: +echo Please download and install the libraries from: echo https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170 echo. echo See %INSTRUCTIONS% for more details. @@ -78,6 +78,7 @@ set "selection=" set /p selection=Select the path to install InvokeAI's directory into [%UserProfile%]: if not defined selection set selection=%UserProfile% set selection=%selection:"=% + call :Trim selection !selection! set dest="%selection%\invokeai" if exist %dest% ( set response=y @@ -96,6 +97,8 @@ goto :pick_rootdir set rootdir=%rootdir:"=% + + @rem ---------------------- Initialize the runtime directory --------------------- echo. echo *** Creating Runtime Directory %rootdir% *** @@ -150,6 +153,7 @@ if %errorlevel% neq 0 ( goto :err_exit ) POPD + copy .\templates\invoke.bat.in "%rootdir%\invoke.bat" copy .\templates\update.bat.in "%rootdir%\update.bat" @@ -217,3 +221,10 @@ pause exit /b pause + +:Trim +SetLocal EnableDelayedExpansion +set Params=%* +for /f "tokens=1*" %%a in ("!Params!") do EndLocal & set %1=%%b +exit /b + From 4dd74cdc68bd0369548ba524a1544432d34ae1ef Mon Sep 17 00:00:00 2001 From: Kent Keirsey <31807370+hipsterusername@users.noreply.github.com> Date: Sat, 14 Jan 2023 20:13:11 -0500 Subject: [PATCH 2/7] update Readme (#2278) * Update Readme & Assets * Update Canvas Assets * Updated Readme to correct missing refs * Correcting refs * Updating Canvas Preview size Co-authored-by: Lincoln Stein --- README.md | 91 ++++++++++++--------------------- docs/assets/canvas_preview.png | Bin 0 -> 145262 bytes 2 files changed, 33 insertions(+), 58 deletions(-) create mode 100644 docs/assets/canvas_preview.png diff --git a/README.md b/README.md index d01b89023f..e4f841641c 100644 --- a/README.md +++ b/README.md @@ -8,12 +8,10 @@ [![latest release badge]][latest release link] [![github stars badge]][github stars link] [![github forks badge]][github forks link] -[![CI checks on main badge]][CI checks on main link] [![CI checks on dev badge]][CI checks on dev link] [![latest commit to dev badge]][latest commit to dev link] +[![CI checks on main badge]][CI checks on main link] [![latest commit to main badge]][latest commit to main link] [![github open issues badge]][github open issues link] [![github open prs badge]][github open prs link] -[CI checks on dev badge]: https://flat.badgen.net/github/checks/invoke-ai/InvokeAI/development?label=CI%20status%20on%20dev&cache=900&icon=github -[CI checks on dev link]: https://github.com/invoke-ai/InvokeAI/actions?query=branch%3Adevelopment [CI checks on main badge]: https://flat.badgen.net/github/checks/invoke-ai/InvokeAI/main?label=CI%20status%20on%20main&cache=900&icon=github [CI checks on main link]: https://github.com/invoke-ai/InvokeAI/actions/workflows/test-invoke-conda.yml [discord badge]: https://flat.badgen.net/discord/members/ZmtBAhwWhy?icon=discord @@ -26,19 +24,13 @@ [github open prs link]: https://github.com/invoke-ai/InvokeAI/pulls?q=is%3Apr+is%3Aopen [github stars badge]: https://flat.badgen.net/github/stars/invoke-ai/InvokeAI?icon=github [github stars link]: https://github.com/invoke-ai/InvokeAI/stargazers -[latest commit to dev badge]: https://flat.badgen.net/github/last-commit/invoke-ai/InvokeAI/development?icon=github&color=yellow&label=last%20dev%20commit&cache=900 -[latest commit to dev link]: https://github.com/invoke-ai/InvokeAI/commits/development +[latest commit to main badge]: https://flat.badgen.net/github/last-commit/invoke-ai/InvokeAI/main?icon=github&color=yellow&label=last%20dev%20commit&cache=900 +[latest commit to main link]: https://github.com/invoke-ai/InvokeAI/commits/main [latest release badge]: https://flat.badgen.net/github/release/invoke-ai/InvokeAI/development?icon=github [latest release link]: https://github.com/invoke-ai/InvokeAI/releases -This is a fork of -[CompVis/stable-diffusion](https://github.com/CompVis/stable-diffusion), -the open source text-to-image generator. It provides a streamlined -process with various new features and options to aid the image -generation process. It runs on Windows, macOS and Linux machines, with -GPU cards with as little as 4 GB of RAM. It provides both a polished -Web interface (see below), and an easy-to-use command-line interface. +InvokeAI is a leading creative engine built to empower professionals and enthusiasts alike. Generate and create stunning visual media using the latest AI-driven technologies. InvokeAI offers an industry leading Web Interface, interactive Command Line Interface, and also serves as the foundation for multiple commercial products. **Quick links**: [[How to Install](#installation)] [Discord Server] [Documentation and Tutorials] [Code and Downloads] [Bug Reports] [Discussion, Ideas & Q&A] @@ -46,6 +38,9 @@ _Note: InvokeAI is rapidly evolving. Please use the [Issues](https://github.com/invoke-ai/InvokeAI/issues) tab to report bugs and make feature requests. Be sure to use the provided templates. They will help us diagnose issues faster._ + +![canvas preview](docs/assets/canvas_preview.png) + # Getting Started with InvokeAI For full installation and upgrade instructions, please see: @@ -58,10 +53,7 @@ For full installation and upgrade instructions, please see: 5. Wait a while, until it is done. 6. The folder where you ran the installer from will now be filled with lots of files. If you are on Windows, double-click on the `invoke.bat` file. On macOS, open a Terminal window, drag `invoke.sh` from the folder into the Terminal, and press return. On Linux, run `invoke.sh` 7. Press 2 to open the "browser-based UI", press enter/return, wait a minute or two for Stable Diffusion to start up, then open your browser and go to http://localhost:9090. -8. Type `banana sushi` in the box on the top left and click `Invoke`: - -
- +8. Type `banana sushi` in the box on the top left and click `Invoke` ## Table of Contents @@ -76,7 +68,7 @@ For full installation and upgrade instructions, please see: 8. [Support](#support) 9. [Further Reading](#further-reading) -### Installation +## Installation This fork is supported across Linux, Windows and Macintosh. Linux users can use either an Nvidia-based card (with CUDA support) or an @@ -108,52 +100,41 @@ to render 512x512 images. - At least 12 GB of free disk space for the machine learning model, Python, and all its dependencies. -**Note** -If you have a Nvidia 10xx series card (e.g. the 1080ti), please -run the dream script in full-precision mode as shown below. +## Features -Similarly, specify full-precision mode on Apple M1 hardware. +Feature documentation can be reviewed by navigating to [the InvokeAI Documentation page](https://invoke-ai.github.io/InvokeAI/features/) -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 `--precision=float32` flag to your initialization command +### *Web Server & UI* +InvokeAI offers a locally hosted Web Server & React Frontend, with an industry leading user experience. The Web-based UI allows for simple and intuitive workflows, and is responsive for use on mobile devices and tablets accessing the web server. -```bash -(invokeai) ~/InvokeAI$ python scripts/invoke.py --precision=float32 -``` -Or by updating your InvokeAI configuration file with this argument. +### *Unified Canvas* +The Unified Canvas is a fully integrated canvas implementation with support for all core generation capabilities, in/outpainting, brush tools, and more. This creative tool unlocks the capability for artists to create with AI as a creative collaborator, and can be used to augment AI-generated imagery, sketches, photography, renders, and more. -### Features +### *Advanced Prompt Syntax* +InvokeAI's advanced prompt syntax allows for token weighting, cross-attention control, and prompt blending, allowing for fine-tuned tweaking of your invocations and exploration of the latent space. -#### Major Features +### *Command Line Interface* +For users utilizing a terminal-based environment, or who want to take advantage of CLI features, InvokeAI offers an extensive and actively supported command-line interface that provides the full suite of generation functionality available in the tool. -- [Web Server](https://invoke-ai.github.io/InvokeAI/features/WEB/) -- [Interactive Command Line Interface](https://invoke-ai.github.io/InvokeAI/features/CLI/) -- [Image To Image](https://invoke-ai.github.io/InvokeAI/features/IMG2IMG/) -- [Inpainting Support](https://invoke-ai.github.io/InvokeAI/features/INPAINTING/) -- [Outpainting Support](https://invoke-ai.github.io/InvokeAI/features/OUTPAINTING/) -- [Upscaling, face-restoration and outpainting](https://invoke-ai.github.io/InvokeAI/features/POSTPROCESS/) -- [Reading Prompts From File](https://invoke-ai.github.io/InvokeAI/features/PROMPTS/#reading-prompts-from-a-file) -- [Prompt Blending](https://invoke-ai.github.io/InvokeAI/features/PROMPTS/#prompt-blending) -- [Thresholding and Perlin Noise Initialization Options](https://invoke-ai.github.io/InvokeAI/features/OTHER/#thresholding-and-perlin-noise-initialization-options) -- [Negative/Unconditioned Prompts](https://invoke-ai.github.io/InvokeAI/features/PROMPTS/#negative-and-unconditioned-prompts) -- [Variations](https://invoke-ai.github.io/InvokeAI/features/VARIATIONS/) -- [Personalizing Text-to-Image Generation](https://invoke-ai.github.io/InvokeAI/features/TEXTUAL_INVERSION/) -- [Simplified API for text to image generation](https://invoke-ai.github.io/InvokeAI/features/OTHER/#simplified-api) +### Other features +- *Noise Control & Tresholding* +- *Popular Sampler Support* +- *Upscaling & Face Restoration Tools* +- *Embedding Manager & Support* +- *Model Manager & Support* -#### Other Features - -- [Google Colab](https://invoke-ai.github.io/InvokeAI/features/OTHER/#google-colab) -- [Seamless Tiling](https://invoke-ai.github.io/InvokeAI/features/OTHER/#seamless-tiling) -- [Shortcut: Reusing Seeds](https://invoke-ai.github.io/InvokeAI/features/OTHER/#shortcuts-reusing-seeds) -- [Preload Models](https://invoke-ai.github.io/InvokeAI/features/OTHER/#preload-models) +### Coming Soon +- *2.0/2.1 Model Support* +- *Depth2Img Support* +- *Node-Based Architecture & UI* +- And more... ### Latest Changes For our latest changes, view our [Release Notes](https://github.com/invoke-ai/InvokeAI/releases) -### Troubleshooting +## Troubleshooting Please check out our **[Q&A](https://invoke-ai.github.io/InvokeAI/help/TROUBLESHOOT/#faq)** to get solutions for common installation problems and other issues. @@ -183,13 +164,7 @@ their time, hard work and effort. ### Support -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. +For support, please use this repository's GitHub Issues tracking service, or join the Discord. -Original portions of the software are Copyright (c) 2022 -[Lincoln D. Stein](https://github.com/lstein) +Original portions of the software are Copyright (c) 2023 by respective contributors. -### Further Reading - -Please see the original README for more information on this software and underlying algorithm, -located in the file [README-CompViz.md](https://invoke-ai.github.io/InvokeAI/other/README-CompViz/). diff --git a/docs/assets/canvas_preview.png b/docs/assets/canvas_preview.png new file mode 100644 index 0000000000000000000000000000000000000000..dba4ee2ca29173aed21ccc233189fab15c1abfce GIT binary patch literal 145262 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�Ug)Y))wjnY&^(EUjvs3ncE)X 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
X;)$mmII!o=J8znu+puxNmKekI^xOwO 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 Lvt9Ygiz)vFx2W{! literal 0 HcmV?d00001 From c855d2a35009319567293eb37410b05407cfd8ea Mon Sep 17 00:00:00 2001 From: Lincoln Stein Date: Sat, 14 Jan 2023 22:07:21 -0500 Subject: [PATCH 3/7] Consolidate version numbers (#2201) * update version number * print version number at startup * move version number into ldm/invoke/_version.py * bump version to 2.2.6+a0 * handle whitespace better * resolve issues raised by mauwii during PR review --- installer/create_installer.sh | 9 ++++----- ldm/invoke/__init__.py | 5 +++-- ldm/invoke/_version.py | 1 + setup.py | 8 +++++++- 4 files changed, 15 insertions(+), 8 deletions(-) mode change 100755 => 100644 installer/create_installer.sh create mode 100644 ldm/invoke/_version.py diff --git a/installer/create_installer.sh b/installer/create_installer.sh old mode 100755 new mode 100644 index 0302e4192c..5309a5d1c0 --- a/installer/create_installer.sh +++ b/installer/create_installer.sh @@ -2,24 +2,23 @@ cd "$(dirname "$0")" -VERSION=$(grep ^VERSION ../setup.py | awk '{ print $3 }' | sed "s/'//g" ) +VERSION=$(cd ..; python -c "from ldm.invoke import __version__ as version; print(version)") PATCH="" VERSION="v${VERSION}${PATCH}" +echo Building installer for version $VERSION echo "Be certain that you're in the 'installer' directory before continuing." read -p "Press any key to continue, or CTRL-C to exit..." read -e -p "Commit and tag this repo with ${VERSION} and 'latest'? [n]: " input RESPONSE=${input:='n'} if [ "$RESPONSE" == 'y' ]; then - git commit -a if ! git tag $VERSION ; then - echo "Existing/invalid tag" - exit -1 + echo "Existing/invalid tag" + exit -1 fi - git push origin :refs/tags/latest git tag -fa latest fi diff --git a/ldm/invoke/__init__.py b/ldm/invoke/__init__.py index 412e035dbc..9452f54c0a 100644 --- a/ldm/invoke/__init__.py +++ b/ldm/invoke/__init__.py @@ -1,3 +1,4 @@ +from ._version import __version__ + __app_id__= 'invoke-ai/InvokeAI' -__app_name__= 'InvokeAI' -__version__='2.2.5' +__app_name__= 'InvokeAI' \ No newline at end of file diff --git a/ldm/invoke/_version.py b/ldm/invoke/_version.py new file mode 100644 index 0000000000..312ecd88c5 --- /dev/null +++ b/ldm/invoke/_version.py @@ -0,0 +1 @@ +__version__='2.2.6+a0' diff --git a/setup.py b/setup.py index 3324a0184f..c4772aaf0a 100644 --- a/setup.py +++ b/setup.py @@ -1,3 +1,4 @@ +import sys import os import re from setuptools import setup, find_packages @@ -9,7 +10,12 @@ def list_files(directory): listing.append(pair) return listing -VERSION = '2.2.5' +def get_version()->str: + from ldm.invoke import __version__ as version + return version + +# The canonical version number is stored in the file ldm/invoke/_version.py +VERSION = get_version() DESCRIPTION = ('An implementation of Stable Diffusion which provides various new features' ' and options to aid the image generation process') LONG_DESCRIPTION = ('This version of Stable Diffusion features a slick WebGUI, an' From 6fdbc1978dce19913af2e53ce70d15db8951e461 Mon Sep 17 00:00:00 2001 From: Kevin Turner <83819+keturn@users.noreply.github.com> Date: Sun, 15 Jan 2023 06:22:46 -0800 Subject: [PATCH 4/7] =?UTF-8?q?use=20=F0=9F=A7=A8diffusers=20model=20(#158?= =?UTF-8?q?3)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * initial commit of DiffusionPipeline class * spike: proof of concept using diffusers for txt2img * doc: type hints for Generator * refactor(model_cache): factor out load_ckpt * model_cache: add ability to load a diffusers model pipeline and update associated things in Generate & Generator to not instantly fail when that happens * model_cache: fix model default image dimensions * txt2img: support switching diffusers schedulers * diffusers: let the scheduler do its scaling of the initial latents Remove IPNDM scheduler; it is not behaving. * web server: update image_progress callback for diffusers data * diffusers: restore prompt weighting feature * diffusers: fix set-sampler error following model switch * diffusers: use InvokeAIDiffuserComponent for conditioning * cross_attention_control: stub (no-op) implementations for diffusers * model_cache: let offload_model work with DiffusionPipeline, sorta. * models.yaml.example: add diffusers-format model, set as default * test-invoke-conda: use diffusers-format model test-invoke-conda: put huggingface-token where the library can use it * environment-mac: upgrade to diffusers 0.7 (from 0.6) this was already done for linux; mac must have been lost in the merge. * preload_models: explicitly load diffusers models In non-interactive mode too, as long as you're logged in. * fix(model_cache): don't check `model.config` in diffusers format clean-up from recent merge. * diffusers integration: support img2img * dev: upgrade to diffusers 0.8 (from 0.7.1) We get to remove some code by using methods that were factored out in the base class. * refactor: remove backported img2img.get_timesteps now that we can use it directly from diffusers 0.8.1 * ci: use diffusers model * dev: upgrade to diffusers 0.9 (from 0.8.1) * lint: correct annotations for Python 3.9. * lint: correct AttributeError.name reference for Python 3.9. * CI: prefer diffusers-1.4 because it no longer requires a token The RunwayML models still do. * build: there's yet another place to update requirements? * configure: try to download models even without token Models in the CompVis and stabilityai repos no longer require them. (But runwayml still does.) * configure: add troubleshooting info for config-not-found * fix(configure): prepend root to config path * fix(configure): remove second `default: true` from models example * CI: simplify test-on-push logic now that we don't need secrets The "test on push but only in forks" logic was only necessary when tests didn't work for PRs-from-forks. * create an embedding_manager for diffusers * internal: avoid importing diffusers DummyObject see https://github.com/huggingface/diffusers/issues/1479 * fix "config attributes…not expected" diffusers warnings. * fix deprecated scheduler construction * work around an apparent MPS torch bug that causes conditioning to have no effect * 🚧 post-rebase repair * preliminary support for outpainting (no masking yet) * monkey-patch diffusers.attention and use Invoke lowvram code * add always_use_cpu arg to bypass MPS * add cross-attention control support to diffusers (fails on MPS) For unknown reasons MPS produces garbage output with .swap(). Use --always_use_cpu arg to invoke.py for now to test this code on MPS. * diffusers support for the inpainting model * fix debug_image to not crash with non-RGB images. * inpainting for the normal model [WIP] This seems to be performing well until the LAST STEP, at which point it dissolves to confetti. * fix off-by-one bug in cross-attention-control (#1774) prompt token sequences begin with a "beginning-of-sequence" marker and end with a repeated "end-of-sequence" marker - to make a default prompt length of + 75 prompt tokens + . the .swap() code was failing to take the column for at index 0 into account. the changes here do that, and also add extra handling for a single (which may be redundant but which is included for completeness). based on my understanding and some assumptions about how this all works, the reason .swap() nevertheless seemed to do the right thing, to some extent, is because over multiple steps the conditioning process in Stable Diffusion operates as a feedback loop. a change to token n-1 has flow-on effects to how the [1x4x64x64] latent tensor is modified by all the tokens after it, - and as the next step is processed, all the tokens before it as well. intuitively, a token's conditioning effects "echo" throughout the whole length of the prompt. so even though the token at n-1 was being edited when what the user actually wanted was to edit the token at n, it nevertheless still had some non-negligible effect, in roughly the right direction, often enough that it seemed like it was working properly. * refactor common CrossAttention stuff into a mixin so that the old ldm code can still work if necessary * inpainting for the normal model. I think it works this time. * diffusers: reset num_vectors_per_token sync with 44a00555718f1df173c60da0ed646cf700e29537 * diffusers: txt2img2img (hires_fix) with so much slicing and dicing of pipeline methods to stitch them together * refactor(diffusers): reduce some code duplication amongst the different tasks * fixup! refactor(diffusers): reduce some code duplication amongst the different tasks * diffusers: enable DPMSolver++ scheduler * diffusers: upgrade to diffusers 0.10, add Heun scheduler * diffusers(ModelCache): stopgap to make from_cpu compatible with diffusers * CI: default to diffusers-1.5 now that runwayml token requirement is gone * diffusers: update to 0.10 (and transformers to 4.25) * diffusers: use xformers when available diffusers no longer auto-enables this as of 0.10.2. * diffusers: make masked img2img behave better with multi-step schedulers re-randomizing the noise each step was confusing them. * diffusers: work more better with more models. fixed relative path problem with local models. fixed models on hub not always having a `fp16` branch. * diffusers: stopgap fix for attention_maps_callback crash after recent merge * fixup import merge conflicts correction for 061c5369a2247c6c92cd69606bcf54c4f1962a0b * test: add tests/inpainting inputs for masked img2img * diffusers(AddsMaskedGuidance): partial fix for k-schedulers Prevents them from crashing, but results are still hot garbage. * fix --safety_checker arg parsing and add note to diffusers loader about where safety checker gets called * generate: fix import error * CI: don't try to read the old init location * diffusers: support loading an alternate VAE * CI: remove sh-syntax if-statement so it doesn't crash powershell * CI: fold strings in yaml because backslash is not line-continuation in powershell * attention maps callback stuff for diffusers * build: fix syntax error in environment-mac * diffusers: add INITIAL_MODELS with diffusers-compatible repos * re-enable the embedding manager; closes #1778 * Squashed commit of the following: commit e4a956abc37fcb5cf188388b76b617bc5c8fda7d Author: Damian Stewart Date: Sun Dec 18 15:43:07 2022 +0100 import new load handling from EmbeddingManager and cleanup commit c4abe91a5ba0d415b45bf734068385668b7a66e6 Merge: 032e856e 1efc6397 Author: Damian Stewart Date: Sun Dec 18 15:09:53 2022 +0100 Merge branch 'feature_textual_inversion_mgr' into dev/diffusers_with_textual_inversion_manager commit 032e856eefb3bbc39534f5daafd25764bcfcef8b Merge: 8b4f0fe9 bc515e24 Author: Damian Stewart Date: Sun Dec 18 15:08:01 2022 +0100 Merge remote-tracking branch 'upstream/dev/diffusers' into dev/diffusers_with_textual_inversion_manager commit 1efc6397fc6e61c1aff4b0258b93089d61de5955 Author: Damian Stewart Date: Sun Dec 18 15:04:28 2022 +0100 cleanup and add performance notes commit e400f804ac471a0ca2ba432fd658778b20c7bdab Author: Damian Stewart Date: Sun Dec 18 14:45:07 2022 +0100 fix bug and update unit tests commit deb9ae0ae1016750e93ce8275734061f7285a231 Author: Damian Stewart Date: Sun Dec 18 14:28:29 2022 +0100 textual inversion manager seems to work commit 162e02505dec777e91a983c4d0fb52e950d25ff0 Merge: cbad4583 12769b3d Author: Damian Stewart Date: Sun Dec 18 11:58:03 2022 +0100 Merge branch 'main' into feature_textual_inversion_mgr commit cbad45836c6aace6871a90f2621a953f49433131 Author: Damian Stewart Date: Sun Dec 18 11:54:10 2022 +0100 use position embeddings commit 070344c69b0e0db340a183857d0a787b348681d3 Author: Damian Stewart Date: Sun Dec 18 11:53:47 2022 +0100 Don't crash CLI on exceptions commit b035ac8c6772dfd9ba41b8eeb9103181cda028f8 Author: Damian Stewart Date: Sun Dec 18 11:11:55 2022 +0100 add missing position_embeddings commit 12769b3d3562ef71e0f54946b532ad077e10043c Author: Damian Stewart Date: Fri Dec 16 13:33:25 2022 +0100 debugging why it don't work commit bafb7215eabe1515ca5e8388fd3bb2f3ac5362cf Author: Damian Stewart Date: Fri Dec 16 13:21:33 2022 +0100 debugging why it don't work commit 664a6e9e146b42d96703f0cc8baf8f5efec04ee1 Author: Damian Stewart Date: Fri Dec 16 12:48:38 2022 +0100 use TextualInversionManager in place of embeddings (wip, doesn't work) commit 8b4f0fe9d6e4e2643b36dfa27864294785d7ba4e Author: Damian Stewart Date: Fri Dec 16 12:48:38 2022 +0100 use TextualInversionManager in place of embeddings (wip, doesn't work) commit ffbe1ab11163ba712e353d89404e301d0e0c6cdf Merge: 6e4dad60 023df37e Author: Damian Stewart Date: Fri Dec 16 02:37:31 2022 +0100 Merge branch 'feature_textual_inversion_mgr' into dev/diffusers commit 023df37efffa67434f77def7fc3c9dfb29f699fd Author: Damian Stewart Date: Fri Dec 16 02:36:54 2022 +0100 cleanup commit 05fac594eaf79d0058e3c48deee93df603f136c2 Author: Damian Stewart Date: Fri Dec 16 02:07:49 2022 +0100 tweak error checking commit 009f32ed39a7280997c3ffab112adadee0b44279 Author: damian Date: Thu Dec 15 21:29:47 2022 +0100 unit tests passing for embeddings with vector length >1 commit beb1b08d9a98112ed2fe073580568e1a18698da3 Author: Damian Stewart Date: Thu Dec 15 13:39:09 2022 +0100 more explicit equality tests when overwriting commit 44d8a5a7c85cdabc9ce3a54fd0769a10597b3ca9 Author: Damian Stewart Date: Thu Dec 15 13:30:13 2022 +0100 wip textual inversion manager (unit tests passing for 1v embedding overwriting) commit 417c2b57d90924a839616bfb66804faab8039e4c Author: Damian Stewart Date: Thu Dec 15 12:30:55 2022 +0100 wip textual inversion manager (unit tests passing for base stuff + padding) commit 2e80872e3b6f7fd7d8eb8928822bd824b63cb2ff Author: Damian Stewart Date: Thu Dec 15 10:57:57 2022 +0100 wip new TextualInversionManager * stop using WeightedFrozenCLIPEmbedder * store diffusion models locally - configure_invokeai.py reconfigured to store diffusion models rather than CompVis models - hugging face caching model is used, but cache is set to ~/invokeai/models/repo_id - models.yaml does **NOT** use path, just repo_id - "repo_name" changed to "repo_id" to following hugging face conventions - Models are loaded with full precision pending further work. * allow non-local files during development * path takes priority over repo_id * MVP for model_cache and configure_invokeai - Feature complete (almost) - configure_invokeai.py downloads both .ckpt and diffuser models, along with their VAEs. Both types of download are controlled by a unified INITIAL_MODELS.yaml file. - model_cache can load both type of model and switches back and forth in CPU. No memory leaks detected TO DO: 1. I have not yet turned on the LocalOnly flag for diffuser models, so the code will check the Hugging Face repo for updates before using the locally cached models. This will break firewalled systems. I am thinking of putting in a global check for internet connectivity at startup time and setting the LocalOnly flag based on this. It would be good to check updates if there is connectivity. 2. I have not gone completely through INITIAL_MODELS.yaml to check which models are available as diffusers and which are not. So models like PaperCut and VoxelArt may not load properly. The runway and stability models are checked, as well as the Trinart models. 3. Add stanzas for SD 2.0 and 2.1 in INITIAL_MODELS.yaml REMAINING PROBLEMS NOT DIRECTLY RELATED TO MODEL_CACHE: 1. When loading a .ckpt file there are lots of messages like this: Warning! ldm.modules.attention.CrossAttention is no longer being maintained. Please use InvokeAICrossAttention instead. I'm not sure how to address this. 2. The ckpt models ***don't actually run*** due to the lack of special-case support for them in the generator objects. For example, here's the hard crash you get when you run txt2img against the legacy waifu-diffusion-1.3 model: ``` >> An error occurred: Traceback (most recent call last): File "/data/lstein/InvokeAI/ldm/invoke/CLI.py", line 140, in main main_loop(gen, opt) File "/data/lstein/InvokeAI/ldm/invoke/CLI.py", line 371, in main_loop gen.prompt2image( File "/data/lstein/InvokeAI/ldm/generate.py", line 496, in prompt2image results = generator.generate( File "/data/lstein/InvokeAI/ldm/invoke/generator/base.py", line 108, in generate image = make_image(x_T) File "/data/lstein/InvokeAI/ldm/invoke/generator/txt2img.py", line 33, in make_image pipeline_output = pipeline.image_from_embeddings( File "/home/lstein/invokeai/.venv/lib/python3.9/site-packages/torch/nn/modules/module.py", line 1265, in __getattr__ raise AttributeError("'{}' object has no attribute '{}'".format( AttributeError: 'LatentDiffusion' object has no attribute 'image_from_embeddings' ``` 3. The inpainting diffusion model isn't working. Here's the output of "banana sushi" when inpainting-1.5 is loaded: ``` Traceback (most recent call last): File "/data/lstein/InvokeAI/ldm/generate.py", line 496, in prompt2image results = generator.generate( File "/data/lstein/InvokeAI/ldm/invoke/generator/base.py", line 108, in generate image = make_image(x_T) File "/data/lstein/InvokeAI/ldm/invoke/generator/txt2img.py", line 33, in make_image pipeline_output = pipeline.image_from_embeddings( File "/data/lstein/InvokeAI/ldm/invoke/generator/diffusers_pipeline.py", line 301, in image_from_embeddings result_latents, result_attention_map_saver = self.latents_from_embeddings( File "/data/lstein/InvokeAI/ldm/invoke/generator/diffusers_pipeline.py", line 330, in latents_from_embeddings result: PipelineIntermediateState = infer_latents_from_embeddings( File "/data/lstein/InvokeAI/ldm/invoke/generator/diffusers_pipeline.py", line 185, in __call__ for result in self.generator_method(*args, **kwargs): File "/data/lstein/InvokeAI/ldm/invoke/generator/diffusers_pipeline.py", line 367, in generate_latents_from_embeddings step_output = self.step(batched_t, latents, guidance_scale, File "/home/lstein/invokeai/.venv/lib/python3.9/site-packages/torch/autograd/grad_mode.py", line 27, in decorate_context return func(*args, **kwargs) File "/data/lstein/InvokeAI/ldm/invoke/generator/diffusers_pipeline.py", line 409, in step step_output = self.scheduler.step(noise_pred, timestep, latents, **extra_step_kwargs) File "/home/lstein/invokeai/.venv/lib/python3.9/site-packages/diffusers/schedulers/scheduling_lms_discrete.py", line 223, in step pred_original_sample = sample - sigma * model_output RuntimeError: The size of tensor a (9) must match the size of tensor b (4) at non-singleton dimension 1 ``` * proper support for float32/float16 - configure script now correctly detects user's preference for fp16/32 and downloads the correct diffuser version. If fp16 version not available, falls back to fp32 version. - misc code cleanup and simplification in model_cache * add on-the-fly conversion of .ckpt to diffusers models 1. On-the-fly conversion code can be found in the file ldm/invoke/ckpt_to_diffusers.py. 2. A new !optimize command has been added to the CLI. Should be ported to Web GUI. User experience on the CLI is this: ``` invoke> !optimize /home/lstein/invokeai/models/ldm/stable-diffusion-v1/sd-v1-4.ckpt INFO: Converting legacy weights file /home/lstein/invokeai/models/ldm/stable-diffusion-v1/sd-v1-4.ckpt to optimized diffuser model. This operation will take 30-60s to complete. Success. Optimized model is now located at /home/lstein/tmp/invokeai/models/optimized-ckpts/sd-v1-4 Writing new config file entry for sd-v1-4... >> New configuration: sd-v1-4: description: Optimized version of sd-v1-4 format: diffusers path: /home/lstein/tmp/invokeai/models/optimized-ckpts/sd-v1-4 OK to import [n]? y >> Verifying that new model loads... >> Current VRAM usage: 2.60G >> Offloading stable-diffusion-2.1 to CPU >> Loading diffusers model from /home/lstein/tmp/invokeai/models/optimized-ckpts/sd-v1-4 | Using faster float16 precision You have disabled the safety checker for by passing `safety_checker=None`. Ensure that you abide to the conditions of the Stable Diffusion \ license and do not expose unfiltered results in services or applications open to the public. Both the diffusers team and Hugging Face strongly recommend to keep the safety filter enabled in all public facing circumstances,\ disabling it only for use-cases that involve analyzing network behavior or auditing its results. For more information, please have a look at https://github.com/huggingface/diffusers/pull/254 . | training width x height = (512 x 512) >> Model loaded in 3.48s >> Max VRAM used to load the model: 2.17G >> Current VRAM usage:2.17G >> Textual inversions available: >> Setting Sampler to k_lms (LMSDiscreteScheduler) Keep model loaded? [y] ``` * add parallel set of generator files for ckpt legacy generation * generation using legacy ckpt models now working * diffusers: fix missing attention_maps_callback fix for 23eb80b40421b2bb8f4b6d3dd30490d11c447b36 * associate legacy CrossAttention with .ckpt models * enable autoconvert New --autoconvert CLI option will scan a designated directory for new .ckpt files, convert them into diffuser models, and import them into models.yaml. Works like this: invoke.py --autoconvert /path/to/weights/directory In ModelCache added two new methods: autoconvert_weights(config_path, weights_directory_path, models_directory_path) convert_and_import(ckpt_path, diffuser_path) * diffusers: update to diffusers 0.11 (from 0.10.2) * fix vae loading & width/height calculation * refactor: encapsulate these conditioning data into one container * diffusers: fix some noise-scaling issues by pushing the noise-mixing down to the common function * add support for safetensors and accelerate * set local_files_only when internet unreachable * diffusers: fix error-handling path when model repo has no fp16 branch * fix generatorinpaint error Fixes : "ModuleNotFoundError: No module named 'ldm.invoke.generatorinpaint' https://github.com/invoke-ai/InvokeAI/pull/1583#issuecomment-1363634318 * quench diffuser safety-checker warning * diffusers: support stochastic DDIM eta parameter * fix conda env creation on macos * fix cross-attention with diffusers 0.11 * diffusers: the VAE needs to be tiling as well as the U-Net * diffusers: comment on subfolders * diffusers: embiggen! * diffusers: make model_cache.list_models serializable * diffusers(inpaint): restore scaling functionality * fix requirements clash between numba and numpy 1.24 * diffusers: allow inpainting model to do non-inpainting tasks * start expanding model_cache functionality * add import_ckpt_model() and import_diffuser_model() methods to model_manager - in addition, model_cache.py is now renamed to model_manager.py * allow "recommended" flag to be optional in INITIAL_MODELS.yaml * configure_invokeai now downloads VAE diffusers in advance * rename ModelCache to ModelManager * remove support for `repo_name` in models.yaml * check for and refuse to load embeddings trained on incompatible models * models.yaml.example: s/repo_name/repo_id and remove extra INITIAL_MODELS now that the main one has diffusers models in it. * add MVP textual inversion script * refactor(InvokeAIDiffuserComponent): factor out _combine() * InvokeAIDiffuserComponent: implement threshold * InvokeAIDiffuserComponent: diagnostic logs for threshold ...this does not look right * add a curses-based frontend to textual inversion - not quite working yet - requires npyscreen installed - on windows will also have the windows-curses requirement, but not added to requirements yet * add curses-based interface for textual inversion * fix crash in convert_and_import() - This corrects a "local variable referenced before assignment" error in model_manager.convert_and_import() * potential workaround for no 'state_dict' key error - As reported in https://github.com/huggingface/diffusers/issues/1876 * create TI output dir if needed * Update environment-lin-cuda.yml (#2159) Fixing line 42 to be the proper order to define the transformers requirement: ~= instead of =~ * diffusers: update sampler-to-scheduler mapping based on https://github.com/huggingface/diffusers/issues/277#issuecomment-1371428672 * improve user exp for ckt to diffusers conversion - !optimize_models command now operates on an existing ckpt file entry in models.yaml - replaces existing entry, rather than adding a new one - offers to delete the ckpt file after conversion * web: adapt progress callback to deal with old generator or new diffusers pipeline * clean-up model_manager code - add_model() verified to work for .ckpt local paths, .ckpt remote URLs, diffusers local paths, and diffusers repo_ids - convert_and_import() verified to work for local and remove .ckpt files * handle edge cases for import_model() and convert_model() * add support for safetensor .ckpt files * fix name error * code cleanup with pyflake * improve model setting behavior - If the user enters an invalid model name at startup time, will not try to load it, warn, and use default model - CLI UI enhancement: include currently active model in the command line prompt. * update test-invoke-pip.yml - fix model cache path to point to runwayml/stable-diffusion-v1-5 - remove `skip-sd-weights` from configure_invokeai.py args * exclude dev/diffusers from "fail for draft PRs" * disable "fail on PR jobs" * re-add `--skip-sd-weights` since no space * update workflow environments - include `INVOKE_MODEL_RECONFIGURE: '--yes'` * clean up model load failure handling - Allow CLI to run even when no model is defined or loadable. - Inhibit stack trace when model load fails - only show last error - Give user *option* to run configure_invokeai.py when no models successfully load. - Restart invokeai after reconfiguration. * further edge-case handling 1) only one model in models.yaml file, and that model is broken 2) no models in models.yaml 3) models.yaml doesn't exist at all * fix incorrect model status listing - "cached" was not being returned from list_models() - normalize handling of exceptions during model loading: - Passing an invalid model name to generate.set_model() will return a KeyError - All other exceptions are returned as the appropriate Exception * CI: do download weights (if not already cached) * diffusers: fix scheduler loading in offline mode * CI: fix model name (no longer has `diffusers-` prefix) * Update txt2img2img.py (#2256) * fixes to share models with HuggingFace cache system - If HF_HOME environment variable is defined, then all huggingface models are stored in that directory following the standard conventions. - For seamless interoperability, set HF_HOME to ~/.cache/huggingface - If HF_HOME not defined, then models are stored in ~/invokeai/models. This is equivalent to setting HF_HOME to ~/invokeai/models A future commit will add a migration mechanism so that this change doesn't break previous installs. * feat - make model storage compatible with hugging face caching system This commit alters the InvokeAI model directory to be compatible with hugging face, making it easier to share diffusers (and other models) across different programs. - If the HF_HOME environment variable is not set, then models are cached in ~/invokeai/models in a format that is identical to the HuggingFace cache. - If HF_HOME is set, then models are cached wherever HF_HOME points. - To enable sharing with other HuggingFace library clients, set HF_HOME to ~/.cache/huggingface to set the default cache location or to ~/invokeai/models to have huggingface cache inside InvokeAI. * fixes to share models with HuggingFace cache system - If HF_HOME environment variable is defined, then all huggingface models are stored in that directory following the standard conventions. - For seamless interoperability, set HF_HOME to ~/.cache/huggingface - If HF_HOME not defined, then models are stored in ~/invokeai/models. This is equivalent to setting HF_HOME to ~/invokeai/models A future commit will add a migration mechanism so that this change doesn't break previous installs. * fix error "no attribute CkptInpaint" * model_manager.list_models() returns entire model config stanza+status * Initial Draft - Model Manager Diffusers * added hash function to diffusers * implement sha256 hashes on diffusers models * Add Model Manager Support for Diffusers * fix various problems with model manager - in cli import functions, fix not enough values to unpack from _get_name_and_desc() - fix crash when using old-style vae: value with new-style diffuser * rebuild frontend * fix dictconfig-not-serializable issue * fix NoneType' object is not subscriptable crash in model_manager * fix "str has no attribute get" error in model_manager list_models() * Add path and repo_id support for Diffusers Model Manager Also fixes bugs * Fix tooltip IT localization not working * Add Version Number To WebUI * Optimize Model Search * Fix incorrect font on the Model Manager UI * Fix image degradation on merge fixes - [Experimental] This change should effectively fix a couple of things. - Fix image degradation on subsequent merges of the canvas layers. - Fix the slight transparent border that is left behind when filling the bounding box with a color. - Fix the left over line of color when filling a bounding box with color. So far there are no side effects for this. If any, please report. * Add local model filtering for Diffusers / Checkpoints * Go to home on modal close for the Add Modal UI * Styling Fixes * Model Manager Diffusers Localization Update * Add Safe Tensor scanning to Model Manager * Fix model edit form dispatching string values instead of numbers. * Resolve VAE handling / edge cases for supplied repos * defer injecting tokens for textual inversions until they're used for the first time * squash a console warning * implement model migration check * add_model() overwrites previous config rather than merges * fix model config file attribute merging * fix precision handling in textual inversion script * allow ckpt conversion script to work with safetensors .ckpts Applied patch here: https://github.com/huggingface/diffusers/commit/beb932c5d111872c5e45387e7b1b2b3dd0524a47 * fix name "args" is not defined crash in textual_inversion_training * fix a second NameError: name 'args' is not defined crash * fix loading of the safety checker from the global cache dir * add installation step to textual inversion frontend - After a successful training run, the script will copy learned_embeds.bin to a subfolder of the embeddings directory. - User given the option to delete the logs and intermediate checkpoints (which together use 7-8G of space) - If textual inversion training fails, reports the error gracefully. * don't crash out on incompatible embeddings - put try: blocks around places where the system tries to load an embedding which is incompatible with the currently loaded model * add support for checkpoint resuming * textual inversion preferences are saved and restored between sessions - Preferences are stored in a file named text-inversion-training/preferences.conf - Currently the resume-from-checkpoint option is not working correctly. Possible bug in textual_inversion_training.py? * copy learned_embeddings.bin into right location * add front end for diffusers model merging - Front end doesn't do anything yet!!!! - Made change to model name parsing in CLI to support ability to have merged models with the "+" character in their names. * improve inpainting experience - recommend ckpt version of inpainting-1.5 to user - fix get_noise() bug in ckpt version of omnibus.py * update environment*yml * tweak instructions to install HuggingFace token * bump version number * enhance update scripts - update scripts will now fetch new INITIAL_MODELS.yaml so that configure_invokeai.py will know about the diffusers versions. * enhance invoke.sh/invoke.bat launchers - added configure_invokeai.py to menu - menu defaults to browser-based invoke * remove conda workflow (#2321) * fix `token_ids has shape torch.Size([79]) - expected [77]` * update CHANGELOG.md with 2.3.* info - Add information on how formats have changed and the upgrade process. - Add short bug list. Co-authored-by: Damian Stewart Co-authored-by: Damian Stewart Co-authored-by: Lincoln Stein Co-authored-by: Wybartel-luxmc <37852506+Wybartel-luxmc@users.noreply.github.com> Co-authored-by: mauwii Co-authored-by: mickr777 <115216705+mickr777@users.noreply.github.com> Co-authored-by: blessedcoolant <54517381+blessedcoolant@users.noreply.github.com> Co-authored-by: Eugene Brodsky Co-authored-by: Matthias Wild <40327258+mauwii@users.noreply.github.com> --- .github/workflows/test-invoke-conda.yml | 161 --- .github/workflows/test-invoke-pip.yml | 81 +- README.md | 9 +- backend/invoke_ai_web_server.py | 76 +- backend/modules/parameters.py | 2 + binary_installer/requirements.in | 5 +- configs/INITIAL_MODELS.yaml | 88 +- configs/models.yaml.example | 20 +- configs/stable-diffusion/v2-inference-v.yaml | 68 ++ docs/CHANGELOG.md | 91 ++ .../environment-lin-aarch64.yml | 7 +- .../environment-lin-amd.yml | 8 +- .../environment-lin-cuda.yml | 8 +- .../environment-mac.yml | 10 +- .../environment-win-cuda.yml | 9 +- .../requirements-base.txt | 9 +- ...y-5c5a479d.js => index-legacy-474a75fe.js} | 8 +- .../{index.ec2d89c6.js => index.1b59e83a.js} | 98 +- frontend/dist/index.html | 4 +- frontend/public/locales/common/en-US.json | 3 + frontend/public/locales/common/en.json | 1 + .../public/locales/modelmanager/en-US.json | 19 +- frontend/public/locales/modelmanager/en.json | 16 +- frontend/public/locales/tooltip/it.json | 16 +- frontend/public/locales/tooltips/it.json | 15 - frontend/src/app/invokeai.d.ts | 30 +- frontend/src/app/socketio/actions.ts | 6 +- .../features/canvas/util/layerToDataURL.ts | 24 +- .../features/options/store/optionsSlice.ts | 9 + .../src/features/system/components/Modal.scss | 1 + .../ModelManager/AddCheckpointModel.tsx | 328 ++++++ .../ModelManager/AddDiffusersModel.tsx | 310 ++++++ .../components/ModelManager/AddModel.tsx | 357 +------ ...{ModelEdit.tsx => CheckpointModelEdit.tsx} | 12 +- .../ModelManager/DiffusersModelEdit.tsx | 270 +++++ .../components/ModelManager/ModelList.tsx | 179 +++- .../ModelManager/ModelManagerModal.tsx | 30 +- .../components/ModelManager/SearchModels.tsx | 1 + .../system/components/SiteHeader.scss | 4 - .../features/system/components/SiteHeader.tsx | 22 +- installer/templates/invoke.bat.in | 13 +- installer/templates/invoke.sh.in | 13 +- installer/templates/update.bat.in | 3 + installer/templates/update.sh.in | 2 + ldm/generate.py | 248 +++-- ldm/invoke/CLI.py | 416 +++++--- ldm/invoke/__init__.py | 2 +- ldm/invoke/_version.py | 2 +- ldm/invoke/args.py | 70 +- ldm/invoke/ckpt_generator/__init__.py | 4 + ldm/invoke/ckpt_generator/base.py | 338 +++++++ ldm/invoke/ckpt_generator/embiggen.py | 501 +++++++++ ldm/invoke/ckpt_generator/img2img.py | 97 ++ ldm/invoke/ckpt_generator/inpaint.py | 358 +++++++ ldm/invoke/ckpt_generator/omnibus.py | 175 ++++ ldm/invoke/ckpt_generator/txt2img.py | 88 ++ ldm/invoke/ckpt_generator/txt2img2img.py | 182 ++++ ldm/invoke/ckpt_to_diffuser.py | 953 ++++++++++++++++++ ldm/invoke/concepts_lib.py | 14 +- ldm/invoke/conditioning.py | 10 +- ldm/invoke/devices.py | 3 + ldm/invoke/generator/base.py | 32 +- ldm/invoke/generator/diffusers_pipeline.py | 632 ++++++++++++ ldm/invoke/generator/embiggen.py | 32 +- ldm/invoke/generator/img2img.py | 115 +-- ldm/invoke/generator/inpaint.py | 161 ++- ldm/invoke/generator/omnibus.py | 10 +- ldm/invoke/generator/txt2img.py | 71 +- ldm/invoke/generator/txt2img2img.py | 160 +-- ldm/invoke/globals.py | 38 + ldm/invoke/model_cache.py | 451 --------- ldm/invoke/model_manager.py | 953 ++++++++++++++++++ ldm/invoke/readline.py | 41 +- ldm/invoke/seamless.py | 1 + ldm/invoke/textual_inversion_training.py | 799 +++++++++++++++ .../diffusion/cross_attention_control.py | 22 +- ldm/models/diffusion/ddpm.py | 8 + ldm/models/diffusion/ksampler.py | 10 +- .../diffusion/shared_invokeai_diffusion.py | 79 +- ldm/modules/attention.py | 1 - ldm/modules/embedding_manager.py | 106 +- ldm/modules/encoders/modules.py | 140 ++- ldm/modules/prompt_to_embeddings_converter.py | 236 +++++ ldm/modules/textual_inversion_manager.py | 293 ++++++ ldm/util.py | 52 +- scripts/configure_invokeai.py | 224 ++-- scripts/merge_fe.py | 156 +++ scripts/textual_inversion.py | 11 + scripts/textual_inversion_fe.py | 333 ++++++ setup.py | 4 +- tests/inpainting/coyote-inpainting.prompt | 14 + tests/inpainting/coyote-input.webp | Bin 0 -> 36320 bytes tests/inpainting/coyote-mask.webp | Bin 0 -> 1576 bytes tests/inpainting/original.json | 30 + tests/test_textual_inversion.py | 301 ++++++ 95 files changed, 9387 insertions(+), 2036 deletions(-) delete mode 100644 .github/workflows/test-invoke-conda.yml create mode 100644 configs/stable-diffusion/v2-inference-v.yaml rename frontend/dist/assets/{index-legacy-5c5a479d.js => index-legacy-474a75fe.js} (78%) rename frontend/dist/assets/{index.ec2d89c6.js => index.1b59e83a.js} (65%) delete mode 100644 frontend/public/locales/tooltips/it.json create mode 100644 frontend/src/features/system/components/ModelManager/AddCheckpointModel.tsx create mode 100644 frontend/src/features/system/components/ModelManager/AddDiffusersModel.tsx rename frontend/src/features/system/components/ModelManager/{ModelEdit.tsx => CheckpointModelEdit.tsx} (97%) create mode 100644 frontend/src/features/system/components/ModelManager/DiffusersModelEdit.tsx create mode 100644 ldm/invoke/ckpt_generator/__init__.py create mode 100644 ldm/invoke/ckpt_generator/base.py create mode 100644 ldm/invoke/ckpt_generator/embiggen.py create mode 100644 ldm/invoke/ckpt_generator/img2img.py create mode 100644 ldm/invoke/ckpt_generator/inpaint.py create mode 100644 ldm/invoke/ckpt_generator/omnibus.py create mode 100644 ldm/invoke/ckpt_generator/txt2img.py create mode 100644 ldm/invoke/ckpt_generator/txt2img2img.py create mode 100644 ldm/invoke/ckpt_to_diffuser.py create mode 100644 ldm/invoke/generator/diffusers_pipeline.py delete mode 100644 ldm/invoke/model_cache.py create mode 100644 ldm/invoke/model_manager.py create mode 100644 ldm/invoke/textual_inversion_training.py create mode 100644 ldm/modules/prompt_to_embeddings_converter.py create mode 100644 ldm/modules/textual_inversion_manager.py create mode 100644 scripts/merge_fe.py create mode 100755 scripts/textual_inversion.py create mode 100755 scripts/textual_inversion_fe.py create mode 100644 tests/inpainting/coyote-inpainting.prompt create mode 100644 tests/inpainting/coyote-input.webp create mode 100644 tests/inpainting/coyote-mask.webp create mode 100644 tests/inpainting/original.json create mode 100644 tests/test_textual_inversion.py diff --git a/.github/workflows/test-invoke-conda.yml b/.github/workflows/test-invoke-conda.yml deleted file mode 100644 index fd6caf47fe..0000000000 --- a/.github/workflows/test-invoke-conda.yml +++ /dev/null @@ -1,161 +0,0 @@ -name: Test invoke.py -on: - push: - branches: - - 'main' - pull_request: - branches: - - 'main' - types: - - 'ready_for_review' - - 'opened' - - 'synchronize' - - 'converted_to_draft' - -concurrency: - group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }} - cancel-in-progress: true - -jobs: - fail_if_pull_request_is_draft: - if: github.event.pull_request.draft == true - runs-on: ubuntu-22.04 - steps: - - name: Fails in order to indicate that pull request needs to be marked as ready to review and unit tests workflow needs to pass. - run: exit 1 - - matrix: - if: github.event.pull_request.draft == false - strategy: - matrix: - stable-diffusion-model: - - 'stable-diffusion-1.5' - environment-yaml: - - environment-lin-amd.yml - - environment-lin-cuda.yml - - environment-mac.yml - - environment-win-cuda.yml - include: - - environment-yaml: environment-lin-amd.yml - os: ubuntu-22.04 - curl-command: curl - github-env: $GITHUB_ENV - default-shell: bash -l {0} - - environment-yaml: environment-lin-cuda.yml - os: ubuntu-22.04 - curl-command: curl - github-env: $GITHUB_ENV - default-shell: bash -l {0} - - environment-yaml: environment-mac.yml - os: macos-12 - curl-command: curl - github-env: $GITHUB_ENV - default-shell: bash -l {0} - - environment-yaml: environment-win-cuda.yml - os: windows-2022 - curl-command: curl.exe - github-env: $env:GITHUB_ENV - default-shell: pwsh - - stable-diffusion-model: stable-diffusion-1.5 - stable-diffusion-model-url: https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.ckpt - stable-diffusion-model-dl-path: models/ldm/stable-diffusion-v1 - stable-diffusion-model-dl-name: v1-5-pruned-emaonly.ckpt - name: ${{ matrix.environment-yaml }} on ${{ matrix.os }} - runs-on: ${{ matrix.os }} - env: - CONDA_ENV_NAME: invokeai - INVOKEAI_ROOT: '${{ github.workspace }}/invokeai' - defaults: - run: - shell: ${{ matrix.default-shell }} - steps: - - name: Checkout sources - id: checkout-sources - uses: actions/checkout@v3 - - - name: create models.yaml from example - run: | - mkdir -p ${{ env.INVOKEAI_ROOT }}/configs - cp configs/models.yaml.example ${{ env.INVOKEAI_ROOT }}/configs/models.yaml - - - name: create environment.yml - run: cp "environments-and-requirements/${{ matrix.environment-yaml }}" environment.yml - - - name: Use cached conda packages - id: use-cached-conda-packages - uses: actions/cache@v3 - with: - path: ~/conda_pkgs_dir - key: conda-pkgs-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles(matrix.environment-yaml) }} - - - name: Activate Conda Env - id: activate-conda-env - uses: conda-incubator/setup-miniconda@v2 - with: - activate-environment: ${{ env.CONDA_ENV_NAME }} - environment-file: environment.yml - miniconda-version: latest - - - name: set test prompt to main branch validation - if: ${{ github.ref == 'refs/heads/main' }} - run: echo "TEST_PROMPTS=tests/preflight_prompts.txt" >> ${{ matrix.github-env }} - - - name: set test prompt to development branch validation - if: ${{ github.ref == 'refs/heads/development' }} - run: echo "TEST_PROMPTS=tests/dev_prompts.txt" >> ${{ matrix.github-env }} - - - name: set test prompt to Pull Request validation - if: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/development' }} - run: echo "TEST_PROMPTS=tests/validate_pr_prompt.txt" >> ${{ matrix.github-env }} - - - name: Use Cached Stable Diffusion Model - id: cache-sd-model - uses: actions/cache@v3 - env: - cache-name: cache-${{ matrix.stable-diffusion-model }} - with: - path: ${{ env.INVOKEAI_ROOT }}/${{ matrix.stable-diffusion-model-dl-path }} - key: ${{ env.cache-name }} - - - name: Download ${{ matrix.stable-diffusion-model }} - id: download-stable-diffusion-model - if: ${{ steps.cache-sd-model.outputs.cache-hit != 'true' }} - run: | - mkdir -p "${{ env.INVOKEAI_ROOT }}/${{ matrix.stable-diffusion-model-dl-path }}" - ${{ matrix.curl-command }} -H "Authorization: Bearer ${{ secrets.HUGGINGFACE_TOKEN }}" -o "${{ env.INVOKEAI_ROOT }}/${{ matrix.stable-diffusion-model-dl-path }}/${{ matrix.stable-diffusion-model-dl-name }}" -L ${{ matrix.stable-diffusion-model-url }} - - - name: run configure_invokeai.py - id: run-preload-models - run: | - python scripts/configure_invokeai.py --skip-sd-weights --yes - - - name: cat invokeai.init - id: cat-invokeai - run: cat ${{ env.INVOKEAI_ROOT }}/invokeai.init - - - name: Run the tests - id: run-tests - if: matrix.os != 'windows-2022' - run: | - time python scripts/invoke.py \ - --no-patchmatch \ - --no-nsfw_checker \ - --model ${{ matrix.stable-diffusion-model }} \ - --from_file ${{ env.TEST_PROMPTS }} \ - --root="${{ env.INVOKEAI_ROOT }}" \ - --outdir="${{ env.INVOKEAI_ROOT }}/outputs" - - - name: export conda env - id: export-conda-env - if: matrix.os != 'windows-2022' - run: | - mkdir -p outputs/img-samples - conda env export --name ${{ env.CONDA_ENV_NAME }} > ${{ env.INVOKEAI_ROOT }}/outputs/environment-${{ runner.os }}-${{ runner.arch }}.yml - - - name: Archive results - if: matrix.os != 'windows-2022' - id: archive-results - uses: actions/upload-artifact@v3 - with: - name: results_${{ matrix.requirements-file }}_${{ matrix.python-version }} - path: ${{ env.INVOKEAI_ROOT }}/outputs diff --git a/.github/workflows/test-invoke-pip.yml b/.github/workflows/test-invoke-pip.yml index b12a7ca879..34c90f10c5 100644 --- a/.github/workflows/test-invoke-pip.yml +++ b/.github/workflows/test-invoke-pip.yml @@ -4,8 +4,6 @@ on: branches: - 'main' pull_request: - branches: - - 'main' types: - 'ready_for_review' - 'opened' @@ -17,14 +15,14 @@ concurrency: cancel-in-progress: true jobs: - fail_if_pull_request_is_draft: - if: github.event.pull_request.draft == true - runs-on: ubuntu-18.04 - steps: - - name: Fails in order to indicate that pull request needs to be marked as ready to review and unit tests workflow needs to pass. - run: exit 1 + # fail_if_pull_request_is_draft: + # if: github.event.pull_request.draft == true && github.head_ref != 'dev/diffusers' + # runs-on: ubuntu-18.04 + # steps: + # - name: Fails in order to indicate that pull request needs to be marked as ready to review and unit tests workflow needs to pass. + # run: exit 1 matrix: - if: github.event.pull_request.draft == false + if: github.event.pull_request.draft == false || github.head_ref == 'dev/diffusers' strategy: matrix: stable-diffusion-model: @@ -40,26 +38,23 @@ jobs: include: - requirements-file: requirements-lin-cuda.txt os: ubuntu-22.04 - curl-command: curl github-env: $GITHUB_ENV - requirements-file: requirements-lin-amd.txt os: ubuntu-22.04 - curl-command: curl github-env: $GITHUB_ENV - requirements-file: requirements-mac-mps-cpu.txt os: macOS-12 - curl-command: curl github-env: $GITHUB_ENV - requirements-file: requirements-win-colab-cuda.txt os: windows-2022 - curl-command: curl.exe github-env: $env:GITHUB_ENV - - stable-diffusion-model: stable-diffusion-1.5 - stable-diffusion-model-url: https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.ckpt - stable-diffusion-model-dl-path: models/ldm/stable-diffusion-v1 - stable-diffusion-model-dl-name: v1-5-pruned-emaonly.ckpt name: ${{ matrix.requirements-file }} on ${{ matrix.python-version }} runs-on: ${{ matrix.os }} + env: + INVOKE_MODEL_RECONFIGURE: '--yes' + INVOKEAI_ROOT: '${{ github.workspace }}/invokeai' + PYTHONUNBUFFERED: 1 + HAVE_SECRETS: ${{ secrets.HUGGINGFACE_TOKEN != '' }} steps: - name: Checkout sources id: checkout-sources @@ -77,10 +72,17 @@ jobs: echo "INVOKEAI_ROOT=${{ github.workspace }}/invokeai" >> ${{ matrix.github-env }} echo "INVOKEAI_OUTDIR=${{ github.workspace }}/invokeai/outputs" >> ${{ matrix.github-env }} - - name: create models.yaml from example - run: | - mkdir -p ${{ env.INVOKEAI_ROOT }}/configs - cp configs/models.yaml.example ${{ env.INVOKEAI_ROOT }}/configs/models.yaml + - name: Use Cached diffusers-1.5 + id: cache-sd-model + uses: actions/cache@v3 + env: + cache-name: huggingface-${{ matrix.stable-diffusion-model }} + with: + path: | + ${{ env.INVOKEAI_ROOT }}/models/runwayml + ${{ env.INVOKEAI_ROOT }}/models/stabilityai + ${{ env.INVOKEAI_ROOT }}/models/CompVis + key: ${{ env.cache-name }} - name: set test prompt to main branch validation if: ${{ github.ref == 'refs/heads/main' }} @@ -110,30 +112,31 @@ jobs: - name: install requirements run: pip3 install -r '${{ matrix.requirements-file }}' - - name: Use Cached Stable Diffusion Model - id: cache-sd-model - uses: actions/cache@v3 - env: - cache-name: cache-${{ matrix.stable-diffusion-model }} - with: - path: ${{ env.INVOKEAI_ROOT }}/${{ matrix.stable-diffusion-model-dl-path }} - key: ${{ env.cache-name }} - - - name: Download ${{ matrix.stable-diffusion-model }} - id: download-stable-diffusion-model - if: ${{ steps.cache-sd-model.outputs.cache-hit != 'true' }} - run: | - mkdir -p "${{ env.INVOKEAI_ROOT }}/${{ matrix.stable-diffusion-model-dl-path }}" - ${{ matrix.curl-command }} -H "Authorization: Bearer ${{ secrets.HUGGINGFACE_TOKEN }}" -o "${{ env.INVOKEAI_ROOT }}/${{ matrix.stable-diffusion-model-dl-path }}/${{ matrix.stable-diffusion-model-dl-name }}" -L ${{ matrix.stable-diffusion-model-url }} - - name: run configure_invokeai.py id: run-preload-models - run: python3 scripts/configure_invokeai.py --skip-sd-weights --yes + env: + HUGGING_FACE_HUB_TOKEN: ${{ secrets.HUGGINGFACE_TOKEN }} + run: > + configure_invokeai.py + --yes + --full-precision # can't use fp16 weights without a GPU - name: Run the tests id: run-tests if: matrix.os != 'windows-2022' - run: python3 scripts/invoke.py --no-patchmatch --no-nsfw_checker --model ${{ matrix.stable-diffusion-model }} --from_file ${{ env.TEST_PROMPTS }} --root="${{ env.INVOKEAI_ROOT }}" --outdir="${{ env.INVOKEAI_OUTDIR }}" + env: + # Set offline mode to make sure configure preloaded successfully. + HF_HUB_OFFLINE: 1 + HF_DATASETS_OFFLINE: 1 + TRANSFORMERS_OFFLINE: 1 + run: > + python3 scripts/invoke.py + --no-patchmatch + --no-nsfw_checker + --model ${{ matrix.stable-diffusion-model }} + --from_file ${{ env.TEST_PROMPTS }} + --root="${{ env.INVOKEAI_ROOT }}" + --outdir="${{ env.INVOKEAI_OUTDIR }}" - name: Archive results id: archive-results diff --git a/README.md b/README.md index e4f841641c..07501a4242 100644 --- a/README.md +++ b/README.md @@ -100,7 +100,6 @@ to render 512x512 images. - At least 12 GB of free disk space for the machine learning model, Python, and all its dependencies. - ## Features Feature documentation can be reviewed by navigating to [the InvokeAI Documentation page](https://invoke-ai.github.io/InvokeAI/features/) @@ -118,6 +117,8 @@ InvokeAI's advanced prompt syntax allows for token weighting, cross-attention co For users utilizing a terminal-based environment, or who want to take advantage of CLI features, InvokeAI offers an extensive and actively supported command-line interface that provides the full suite of generation functionality available in the tool. ### Other features +- *Support for both ckpt and diffusers models* +- *SD 2.0, 2.1 support* - *Noise Control & Tresholding* - *Popular Sampler Support* - *Upscaling & Face Restoration Tools* @@ -125,14 +126,14 @@ For users utilizing a terminal-based environment, or who want to take advantage - *Model Manager & Support* ### Coming Soon -- *2.0/2.1 Model Support* -- *Depth2Img Support* - *Node-Based Architecture & UI* - And more... ### Latest Changes -For our latest changes, view our [Release Notes](https://github.com/invoke-ai/InvokeAI/releases) +For our latest changes, view our [Release +Notes](https://github.com/invoke-ai/InvokeAI/releases) and the +[CHANGELOG](docs/CHANGELOG.md). ## Troubleshooting diff --git a/backend/invoke_ai_web_server.py b/backend/invoke_ai_web_server.py index 02e8504589..1720c44f28 100644 --- a/backend/invoke_ai_web_server.py +++ b/backend/invoke_ai_web_server.py @@ -1,35 +1,34 @@ -import eventlet +import base64 import glob +import io +import json +import math +import mimetypes import os import shutil -import mimetypes import traceback -import math -import io -import base64 -import os -import json +from threading import Event +from uuid import uuid4 -from werkzeug.utils import secure_filename +import eventlet +from PIL import Image +from PIL.Image import Image as ImageType from flask import Flask, redirect, send_from_directory, request, make_response from flask_socketio import SocketIO -from PIL import Image, ImageOps -from PIL.Image import Image as ImageType -from uuid import uuid4 -from threading import Event +from werkzeug.utils import secure_filename -from ldm.generate import Generate -from ldm.invoke.args import Args, APP_ID, APP_VERSION, calculate_init_img_hash -from ldm.invoke.conditioning import get_tokens_for_prompt, get_prompt_structure -from ldm.invoke.globals import Globals -from ldm.invoke.pngwriter import PngWriter, retrieve_metadata -from ldm.invoke.prompt_parser import split_weighted_subprompts, Blend -from ldm.invoke.generator.inpaint import infill_methods - -from backend.modules.parameters import parameters_to_command from backend.modules.get_canvas_generation_mode import ( get_canvas_generation_mode, ) +from backend.modules.parameters import parameters_to_command +from ldm.generate import Generate +from ldm.invoke.args import Args, APP_ID, APP_VERSION, calculate_init_img_hash +from ldm.invoke.conditioning import get_tokens_for_prompt, get_prompt_structure +from ldm.invoke.generator.diffusers_pipeline import PipelineIntermediateState +from ldm.invoke.generator.inpaint import infill_methods +from ldm.invoke.globals import Globals +from ldm.invoke.pngwriter import PngWriter, retrieve_metadata +from ldm.invoke.prompt_parser import split_weighted_subprompts, Blend # Loading Arguments opt = Args() @@ -304,7 +303,7 @@ class InvokeAIWebServer: def handle_request_capabilities(): print(f">> System config requested") config = self.get_system_config() - config["model_list"] = self.generate.model_cache.list_models() + config["model_list"] = self.generate.model_manager.list_models() config["infill_methods"] = infill_methods() socketio.emit("systemConfig", config) @@ -317,11 +316,11 @@ class InvokeAIWebServer: {'search_folder': None, 'found_models': None}, ) else: - search_folder, found_models = self.generate.model_cache.search_models(search_folder) + search_folder, found_models = self.generate.model_manager.search_models(search_folder) socketio.emit( "foundModels", {'search_folder': search_folder, 'found_models': found_models}, - ) + ) except Exception as e: self.socketio.emit("error", {"message": (str(e))}) print("\n") @@ -335,18 +334,20 @@ class InvokeAIWebServer: model_name = new_model_config['name'] del new_model_config['name'] model_attributes = new_model_config + if len(model_attributes['vae']) == 0: + del model_attributes['vae'] update = False - current_model_list = self.generate.model_cache.list_models() + current_model_list = self.generate.model_manager.list_models() if model_name in current_model_list: update = True print(f">> Adding New Model: {model_name}") - self.generate.model_cache.add_model( + self.generate.model_manager.add_model( model_name=model_name, model_attributes=model_attributes, clobber=True) - self.generate.model_cache.commit(opt.conf) + self.generate.model_manager.commit(opt.conf) - new_model_list = self.generate.model_cache.list_models() + new_model_list = self.generate.model_manager.list_models() socketio.emit( "newModelAdded", {"new_model_name": model_name, @@ -364,9 +365,9 @@ class InvokeAIWebServer: def handle_delete_model(model_name: str): try: print(f">> Deleting Model: {model_name}") - self.generate.model_cache.del_model(model_name) - self.generate.model_cache.commit(opt.conf) - updated_model_list = self.generate.model_cache.list_models() + self.generate.model_manager.del_model(model_name) + self.generate.model_manager.commit(opt.conf) + updated_model_list = self.generate.model_manager.list_models() socketio.emit( "modelDeleted", {"deleted_model_name": model_name, @@ -385,7 +386,7 @@ class InvokeAIWebServer: try: print(f">> Model change requested: {model_name}") model = self.generate.set_model(model_name) - model_list = self.generate.model_cache.list_models() + model_list = self.generate.model_manager.list_models() if model is None: socketio.emit( "modelChangeFailed", @@ -797,7 +798,7 @@ class InvokeAIWebServer: # App Functions def get_system_config(self): - model_list: dict = self.generate.model_cache.list_models() + model_list: dict = self.generate.model_manager.list_models() active_model_name = None for model_name, model_dict in model_list.items(): @@ -1205,9 +1206,16 @@ class InvokeAIWebServer: print(generation_parameters) + def diffusers_step_callback_adapter(*cb_args, **kwargs): + if isinstance(cb_args[0], PipelineIntermediateState): + progress_state: PipelineIntermediateState = cb_args[0] + return image_progress(progress_state.latents, progress_state.step) + else: + return image_progress(*cb_args, **kwargs) + self.generate.prompt2image( **generation_parameters, - step_callback=image_progress, + step_callback=diffusers_step_callback_adapter, image_callback=image_done ) diff --git a/backend/modules/parameters.py b/backend/modules/parameters.py index 10af5ece3a..9055297671 100644 --- a/backend/modules/parameters.py +++ b/backend/modules/parameters.py @@ -12,6 +12,8 @@ SAMPLER_CHOICES = [ "k_heun", "k_lms", "plms", + # diffusers: + "pndm", ] diff --git a/binary_installer/requirements.in b/binary_installer/requirements.in index b4436a6ec0..66e0618f78 100644 --- a/binary_installer/requirements.in +++ b/binary_installer/requirements.in @@ -2,9 +2,10 @@ --extra-index-url https://download.pytorch.org/whl/torch_stable.html --extra-index-url https://download.pytorch.org/whl/cu116 --trusted-host https://download.pytorch.org -accelerate~=0.14 +accelerate~=0.15 albumentations -diffusers +diffusers[torch]~=0.11 +einops eventlet flask_cors flask_socketio diff --git a/configs/INITIAL_MODELS.yaml b/configs/INITIAL_MODELS.yaml index 6cfb863df8..5df64d742d 100644 --- a/configs/INITIAL_MODELS.yaml +++ b/configs/INITIAL_MODELS.yaml @@ -1,9 +1,15 @@ +stable-diffusion-2.1: + description: Stable Diffusion version 2.1 diffusers model (5.21 GB) + repo_id: stabilityai/stable-diffusion-2-1 + format: diffusers + recommended: True stable-diffusion-1.5: - description: The newest Stable Diffusion version 1.5 weight file (4.27 GB) + description: Stable Diffusion version 1.5 weight file (4.27 GB) repo_id: runwayml/stable-diffusion-v1-5 - config: v1-inference.yaml - file: v1-5-pruned-emaonly.ckpt - recommended: true + format: diffusers + recommended: True + vae: + repo_id: stabilityai/sd-vae-ft-mse width: 512 height: 512 inpainting-1.5: @@ -11,23 +17,20 @@ inpainting-1.5: repo_id: runwayml/stable-diffusion-inpainting config: v1-inpainting-inference.yaml file: sd-v1-5-inpainting.ckpt - recommended: True - width: 512 - height: 512 -ft-mse-improved-autoencoder-840000: - description: StabilityAI improved autoencoder fine-tuned for human faces (recommended; 335 MB) - repo_id: stabilityai/sd-vae-ft-mse-original - config: VAE/default - file: vae-ft-mse-840000-ema-pruned.ckpt + format: ckpt + vae: + repo_id: stabilityai/sd-vae-ft-mse-original + file: vae-ft-mse-840000-ema-pruned.ckpt recommended: True width: 512 height: 512 stable-diffusion-1.4: description: The original Stable Diffusion version 1.4 weight file (4.27 GB) - repo_id: CompVis/stable-diffusion-v-1-4-original - config: v1-inference.yaml - file: sd-v1-4.ckpt + repo_id: CompVis/stable-diffusion-v1-4 recommended: False + format: diffusers + vae: + repo_id: stabilityai/sd-vae-ft-mse width: 512 height: 512 waifu-diffusion-1.3: @@ -35,38 +38,40 @@ waifu-diffusion-1.3: repo_id: hakurei/waifu-diffusion-v1-3 config: v1-inference.yaml file: model-epoch09-float32.ckpt + format: ckpt + vae: + repo_id: stabilityai/sd-vae-ft-mse-original + file: vae-ft-mse-840000-ema-pruned.ckpt recommended: False width: 512 height: 512 trinart-2.0: description: An SD model finetuned with ~40,000 assorted high resolution manga/anime-style pictures (2.13 GB) repo_id: naclbit/trinart_stable_diffusion_v2 - config: v1-inference.yaml - file: trinart2_step95000.ckpt + format: diffusers recommended: False + vae: + repo_id: stabilityai/sd-vae-ft-mse width: 512 height: 512 -trinart_characters-1.0: - description: An SD model finetuned with 19.2M anime/manga style images (2.13 GB) - repo_id: naclbit/trinart_characters_19.2m_stable_diffusion_v1 +trinart_characters-2.0: + description: An SD model finetuned with 19.2M anime/manga style images (4.27 GB) + repo_id: naclbit/trinart_derrida_characters_v2_stable_diffusion config: v1-inference.yaml - file: trinart_characters_it4_v1.ckpt - recommended: False - width: 512 - height: 512 -trinart_vae: - description: Custom autoencoder for trinart_characters - repo_id: naclbit/trinart_characters_19.2m_stable_diffusion_v1 - config: VAE/trinart - file: autoencoder_fix_kl-f8-trinart_characters.ckpt + file: derrida_final.ckpt + format: ckpt + vae: + repo_id: naclbit/trinart_derrida_characters_v2_stable_diffusion + file: autoencoder_fix_kl-f8-trinart_characters.ckpt recommended: False width: 512 height: 512 papercut-1.0: description: SD 1.5 fine-tuned for papercut art (use "PaperCut" in your prompts) (2.13 GB) repo_id: Fictiverse/Stable_Diffusion_PaperCut_Model - config: v1-inference.yaml - file: PaperCut_v1.ckpt + format: diffusers + vae: + repo_id: stabilityai/sd-vae-ft-mse recommended: False width: 512 height: 512 @@ -75,6 +80,27 @@ voxel_art-1.0: repo_id: Fictiverse/Stable_Diffusion_VoxelArt_Model config: v1-inference.yaml file: VoxelArt_v1.ckpt + format: ckpt + vae: + repo_id: stabilityai/sd-vae-ft-mse + recommended: False + width: 512 + height: 512 +ft-mse-improved-autoencoder-840000: + description: StabilityAI improved autoencoder fine-tuned for human faces. Use with legacy .ckpt models ONLY (335 MB) + repo_id: stabilityai/sd-vae-ft-mse-original + format: ckpt + config: VAE/default + file: vae-ft-mse-840000-ema-pruned.ckpt + recommended: False + width: 512 + height: 512 +trinart_vae: + description: Custom autoencoder for trinart_characters for legacy .ckpt models only (335 MB) + repo_id: naclbit/trinart_characters_19.2m_stable_diffusion_v1 + config: VAE/trinart + format: ckpt + file: autoencoder_fix_kl-f8-trinart_characters.ckpt recommended: False width: 512 height: 512 diff --git a/configs/models.yaml.example b/configs/models.yaml.example index 61e1fe24be..98f8f77e62 100644 --- a/configs/models.yaml.example +++ b/configs/models.yaml.example @@ -5,6 +5,25 @@ # model requires a model config file, a weights file, # and the width and height of the images it # was trained on. +diffusers-1.4: + description: 🤗🧨 Stable Diffusion v1.4 + format: diffusers + repo_id: CompVis/stable-diffusion-v1-4 +diffusers-1.5: + description: 🤗🧨 Stable Diffusion v1.5 + format: diffusers + repo_id: runwayml/stable-diffusion-v1-5 + default: true +diffusers-1.5+mse: + description: 🤗🧨 Stable Diffusion v1.5 + MSE-finetuned VAE + format: diffusers + repo_id: runwayml/stable-diffusion-v1-5 + vae: + repo_id: stabilityai/sd-vae-ft-mse +diffusers-inpainting-1.5: + description: 🤗🧨 inpainting for Stable Diffusion v1.5 + format: diffusers + repo_id: runwayml/stable-diffusion-inpainting stable-diffusion-1.5: description: The newest Stable Diffusion version 1.5 weight file (4.27 GB) weights: models/ldm/stable-diffusion-v1/v1-5-pruned-emaonly.ckpt @@ -12,7 +31,6 @@ stable-diffusion-1.5: width: 512 height: 512 vae: ./models/ldm/stable-diffusion-v1/vae-ft-mse-840000-ema-pruned.ckpt - default: true stable-diffusion-1.4: description: Stable Diffusion inference model version 1.4 config: configs/stable-diffusion/v1-inference.yaml diff --git a/configs/stable-diffusion/v2-inference-v.yaml b/configs/stable-diffusion/v2-inference-v.yaml new file mode 100644 index 0000000000..8ec8dfbfef --- /dev/null +++ b/configs/stable-diffusion/v2-inference-v.yaml @@ -0,0 +1,68 @@ +model: + base_learning_rate: 1.0e-4 + target: ldm.models.diffusion.ddpm.LatentDiffusion + params: + parameterization: "v" + linear_start: 0.00085 + linear_end: 0.0120 + num_timesteps_cond: 1 + log_every_t: 200 + timesteps: 1000 + first_stage_key: "jpg" + cond_stage_key: "txt" + image_size: 64 + channels: 4 + cond_stage_trainable: false + conditioning_key: crossattn + monitor: val/loss_simple_ema + scale_factor: 0.18215 + use_ema: False # we set this to false because this is an inference only config + + unet_config: + target: ldm.modules.diffusionmodules.openaimodel.UNetModel + params: + use_checkpoint: True + use_fp16: True + image_size: 32 # unused + in_channels: 4 + out_channels: 4 + model_channels: 320 + attention_resolutions: [ 4, 2, 1 ] + num_res_blocks: 2 + channel_mult: [ 1, 2, 4, 4 ] + num_head_channels: 64 # need to fix for flash-attn + use_spatial_transformer: True + use_linear_in_transformer: True + transformer_depth: 1 + context_dim: 1024 + legacy: False + + first_stage_config: + target: ldm.models.autoencoder.AutoencoderKL + params: + embed_dim: 4 + monitor: val/rec_loss + ddconfig: + #attn_type: "vanilla-xformers" + double_z: true + z_channels: 4 + resolution: 256 + in_channels: 3 + out_ch: 3 + ch: 128 + ch_mult: + - 1 + - 2 + - 4 + - 4 + num_res_blocks: 2 + attn_resolutions: [] + dropout: 0.0 + lossconfig: + target: torch.nn.Identity + + cond_stage_config: + target: ldm.modules.encoders.modules.FrozenOpenCLIPEmbedder + params: + freeze: True + layer: "penultimate" diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 639a9a9466..e9461264db 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -4,6 +4,97 @@ title: Changelog # :octicons-log-16: **Changelog** +## v2.3.0 (15 January 2023) + +**Transition to diffusers + +Version 2.3 provides support for both the traditional `.ckpt` weight +checkpoint files as well as the HuggingFace `diffusers` format. This +introduces several changes you should know about. + +1. The models.yaml format has been updated. There are now two + different type of configuration stanza. The traditional ckpt + one will look like this, with a `format` of `ckpt` and a + `weights` field that points to the absolute or ROOTDIR-relative + location of the ckpt file. + + ``` + inpainting-1.5: + description: RunwayML SD 1.5 model optimized for inpainting (4.27 GB) + repo_id: runwayml/stable-diffusion-inpainting + format: ckpt + width: 512 + height: 512 + weights: models/ldm/stable-diffusion-v1/sd-v1-5-inpainting.ckpt + config: configs/stable-diffusion/v1-inpainting-inference.yaml + vae: models/ldm/stable-diffusion-v1/vae-ft-mse-840000-ema-pruned.ckpt + ``` + + A configuration stanza for a diffusers model hosted at HuggingFace will look like this, + with a `format` of `diffusers` and a `repo_id` that points to the + repository ID of the model on HuggingFace: + + ``` + stable-diffusion-2.1: + description: Stable Diffusion version 2.1 diffusers model (5.21 GB) + repo_id: stabilityai/stable-diffusion-2-1 + format: diffusers + ``` + + A configuration stanza for a diffuers model stored locally should + look like this, with a `format` of `diffusers`, but a `path` field + that points at the directory that contains `model_index.json`: + + ``` + waifu-diffusion: + description: Latest waifu diffusion 1.4 + format: diffusers + path: models/diffusers/hakurei-haifu-diffusion-1.4 + ``` + +2. The format of the models directory has changed to mimic the + HuggingFace cache directory. By default, diffusers models are + now automatically downloaded and retrieved from the directory + `ROOTDIR/models/diffusers`, while other models are stored in + the directory `ROOTDIR/models/hub`. This organization is the + same as that used by HuggingFace for its cache management. + + This allows you to share diffusers and ckpt model files easily with + other machine learning applications that use the HuggingFace + libraries. To do this, set the environment variable HF_HOME + before starting up InvokeAI to tell it what directory to + cache models in. To tell InvokeAI to use the standard HuggingFace + cache directory, you would set HF_HOME like this (Linux/Mac): + + `export HF_HOME=~/.cache/hugging_face` + +3. If you upgrade to InvokeAI 2.3.* from an earlier version, there + will be a one-time migration from the old models directory format + to the new one. You will see a message about this the first time + you start `invoke.py`. + +4. Both the front end back ends of the model manager have been + rewritten to accommodate diffusers. You can import models using + their local file path, using their URLs, or their HuggingFace + repo_ids. On the command line, all these syntaxes work: + + ``` + !import_model stabilityai/stable-diffusion-2-1-base + !import_model /opt/sd-models/sd-1.4.ckpt + !import_model https://huggingface.co/Fictiverse/Stable_Diffusion_PaperCut_Model/blob/main/PaperCut_v1.ckpt + ``` + +**KNOWN BUGS (15 January 2023) + +1. On CUDA systems, the 768 pixel stable-diffusion-2.0 and + stable-diffusion-2.1 models can only be run as `diffusers` models + when the `xformer` library is installed and configured. Without + `xformers`, InvokeAI returns black images. + +2. Inpainting and outpainting have regressed in quality. + +Both these issues are being actively worked on. + ## v2.2.4 (11 December 2022) **the `invokeai` directory** diff --git a/environments-and-requirements/environment-lin-aarch64.yml b/environments-and-requirements/environment-lin-aarch64.yml index c1e7553a28..9dc49c1255 100644 --- a/environments-and-requirements/environment-lin-aarch64.yml +++ b/environments-and-requirements/environment-lin-aarch64.yml @@ -28,13 +28,18 @@ dependencies: - torch-fidelity=0.3.0 - torchmetrics=0.7.0 - torchvision - - transformers=4.21.3 + - transformers~=4.25 - pip: + - accelerate + - diffusers[torch]~=0.11 - getpass_asterisk + - huggingface-hub>=0.11.1 - omegaconf==2.1.1 - picklescan - pyreadline3 - realesrgan + - requests==2.25.1 + - safetensors - taming-transformers-rom1504 - test-tube>=0.7.5 - git+https://github.com/openai/CLIP.git@main#egg=clip diff --git a/environments-and-requirements/environment-lin-amd.yml b/environments-and-requirements/environment-lin-amd.yml index 42ebf37266..cbddbb5fc8 100644 --- a/environments-and-requirements/environment-lin-amd.yml +++ b/environments-and-requirements/environment-lin-amd.yml @@ -9,14 +9,16 @@ dependencies: - numpy=1.23.3 - pip: - --extra-index-url https://download.pytorch.org/whl/rocm5.2/ + - accelerate - albumentations==0.4.3 - - diffusers==0.6.0 + - diffusers[torch]~=0.11 - einops==0.3.0 - eventlet - flask==2.1.3 - flask_cors==3.0.10 - flask_socketio==5.3.0 - getpass_asterisk + - huggingface-hub>=0.11.1 - imageio-ffmpeg==0.4.2 - imageio==2.9.0 - kornia==0.6.0 @@ -28,6 +30,8 @@ dependencies: - pyreadline3 - pytorch-lightning==1.7.7 - realesrgan + - requests==2.25.1 + - safetensors - send2trash==1.8.0 - streamlit==1.12.0 - taming-transformers-rom1504 @@ -38,7 +42,7 @@ dependencies: - torchaudio - torchmetrics==0.7.0 - torchvision - - transformers==4.21.3 + - transformers~=4.25 - git+https://github.com/openai/CLIP.git@main#egg=clip - git+https://github.com/Birch-san/k-diffusion.git@mps#egg=k-diffusion - git+https://github.com/invoke-ai/clipseg.git@relaxed-python-requirement#egg=clipseg diff --git a/environments-and-requirements/environment-lin-cuda.yml b/environments-and-requirements/environment-lin-cuda.yml index ce60cfd96b..20cc636624 100644 --- a/environments-and-requirements/environment-lin-cuda.yml +++ b/environments-and-requirements/environment-lin-cuda.yml @@ -12,14 +12,16 @@ dependencies: - pytorch=1.12.1 - cudatoolkit=11.6 - pip: + - accelerate~=0.13 - albumentations==0.4.3 - - diffusers==0.6.0 + - diffusers[torch]~=0.11 - einops==0.3.0 - eventlet - flask==2.1.3 - flask_cors==3.0.10 - flask_socketio==5.3.0 - getpass_asterisk + - huggingface-hub>=0.11.1 - imageio-ffmpeg==0.4.2 - imageio==2.9.0 - kornia==0.6.0 @@ -31,13 +33,15 @@ dependencies: - pyreadline3 - pytorch-lightning==1.7.7 - realesrgan + - requests==2.25.1 + - safetensors~=0.2 - send2trash==1.8.0 - streamlit==1.12.0 - taming-transformers-rom1504 - test-tube>=0.7.5 - torch-fidelity==0.3.0 - torchmetrics==0.7.0 - - transformers==4.21.3 + - transformers~=4.25 - git+https://github.com/openai/CLIP.git@main#egg=clip - git+https://github.com/Birch-san/k-diffusion.git@mps#egg=k-diffusion - git+https://github.com/invoke-ai/clipseg.git@relaxed-python-requirement#egg=clipseg diff --git a/environments-and-requirements/environment-mac.yml b/environments-and-requirements/environment-mac.yml index 3e78d9ac95..7ced428ebf 100644 --- a/environments-and-requirements/environment-mac.yml +++ b/environments-and-requirements/environment-mac.yml @@ -1,6 +1,7 @@ name: invokeai channels: - pytorch + - huggingface - conda-forge - defaults dependencies: @@ -19,10 +20,9 @@ dependencies: # sed -E 's/invokeai/invokeai-updated/;20,99s/- ([^=]+)==.+/- \1/' environment-mac.yml > environment-mac-updated.yml # CONDA_SUBDIR=osx-arm64 conda env create -f environment-mac-updated.yml && conda list -n invokeai-updated | awk ' {print " - " $1 "==" $2;} ' # ``` - + - accelerate - albumentations=1.2 - coloredlogs=15.0 - - diffusers=0.6 - einops=0.3 - eventlet - grpcio=1.46 @@ -49,10 +49,14 @@ dependencies: - sympy=1.10 - send2trash=1.8 - tensorboard=2.10 - - transformers=4.23 + - transformers~=4.25 - pip: + - diffusers[torch]~=0.11 + - safetensors~=0.2 - getpass_asterisk + - huggingface-hub - picklescan + - requests==2.25.1 - taming-transformers-rom1504 - test-tube==0.7.5 - git+https://github.com/openai/CLIP.git@main#egg=clip diff --git a/environments-and-requirements/environment-win-cuda.yml b/environments-and-requirements/environment-win-cuda.yml index 580f84f8ec..c7ad599641 100644 --- a/environments-and-requirements/environment-win-cuda.yml +++ b/environments-and-requirements/environment-win-cuda.yml @@ -12,14 +12,16 @@ dependencies: - pytorch=1.12.1 - cudatoolkit=11.6 - pip: + - accelerate - albumentations==0.4.3 - - diffusers==0.6.0 + - diffusers[torch]~=0.11 - einops==0.3.0 - eventlet - flask==2.1.3 - flask_cors==3.0.10 - flask_socketio==5.3.0 - getpass_asterisk + - huggingface-hub>=0.11.1 - imageio-ffmpeg==0.4.2 - imageio==2.9.0 - kornia==0.6.0 @@ -31,13 +33,16 @@ dependencies: - pyreadline3 - pytorch-lightning==1.7.7 - realesrgan + - requests==2.25.1 + - safetensors - send2trash==1.8.0 - streamlit==1.12.0 - taming-transformers-rom1504 - test-tube>=0.7.5 - torch-fidelity==0.3.0 - torchmetrics==0.7.0 - - transformers==4.21.3 + - transformers~=4.25 + - windows-curses - git+https://github.com/openai/CLIP.git@main#egg=clip - git+https://github.com/Birch-san/k-diffusion.git@mps#egg=k_diffusion - git+https://github.com/invoke-ai/clipseg.git@relaxed-python-requirement#egg=clipseg diff --git a/environments-and-requirements/requirements-base.txt b/environments-and-requirements/requirements-base.txt index f52df20b5c..882e1c8b4b 100644 --- a/environments-and-requirements/requirements-base.txt +++ b/environments-and-requirements/requirements-base.txt @@ -1,6 +1,8 @@ # pip will resolve the version which matches torch +accelerate albumentations -diffusers==0.10.* +datasets +diffusers[torch]~=0.11 einops eventlet facexlib @@ -14,6 +16,7 @@ huggingface-hub>=0.11.1 imageio imageio-ffmpeg kornia +npyscreen numpy==1.23.* omegaconf opencv-python @@ -25,6 +28,7 @@ pyreadline3 pytorch-lightning==1.7.7 realesrgan requests==2.25.1 +safetensors scikit-image>=0.19 send2trash streamlit @@ -32,7 +36,8 @@ taming-transformers-rom1504 test-tube>=0.7.5 torch-fidelity torchmetrics -transformers==4.25.* +transformers~=4.25 +windows-curses; sys_platform == 'win32' https://github.com/Birch-san/k-diffusion/archive/refs/heads/mps.zip#egg=k-diffusion https://github.com/invoke-ai/PyPatchMatch/archive/refs/tags/0.1.5.zip#egg=pypatchmatch https://github.com/openai/CLIP/archive/eaa22acb90a5876642d0507623e859909230a52d.zip#egg=clip diff --git a/frontend/dist/assets/index-legacy-5c5a479d.js b/frontend/dist/assets/index-legacy-474a75fe.js similarity index 78% rename from frontend/dist/assets/index-legacy-5c5a479d.js rename to frontend/dist/assets/index-legacy-474a75fe.js index 3babd3134a..b48c03f8f8 100644 --- a/frontend/dist/assets/index-legacy-5c5a479d.js +++ b/frontend/dist/assets/index-legacy-474a75fe.js @@ -18,7 +18,7 @@ * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. */ -var Y=a.exports,Z=G.exports;function X(e){for(var t="https://reactjs.org/docs/error-decoder.html?invariant="+e,n=1;n