From 3da0be7eb9935a0afc9cb472cf44a749cd8ea085 Mon Sep 17 00:00:00 2001 From: Lincoln Stein Date: Fri, 28 Jul 2023 16:42:57 -0400 Subject: [PATCH] update troubleshooting guide with ~ydantic and SDXL unet issue workarounds --- docs/index.md | 8 +-- docs/installation/010_INSTALL_AUTOMATED.md | 63 ++++++++++++++++++++++ 2 files changed, 68 insertions(+), 3 deletions(-) diff --git a/docs/index.md b/docs/index.md index 319df59bae..5e62445f89 100644 --- a/docs/index.md +++ b/docs/index.md @@ -80,11 +80,11 @@ Q&A] !!! note - This fork is rapidly evolving. Please use the [Issues tab](https://github.com/invoke-ai/InvokeAI/issues) to report bugs and make feature requests. Be sure to use the provided templates. They will help aid diagnose issues faster. + This software is rapidly evolving. Please use the [Issues tab](https://github.com/invoke-ai/InvokeAI/issues) to report bugs and make feature requests. Be sure to use the provided templates. They will help aid diagnose issues faster. ## :octicons-package-dependencies-24: Installation -This fork is supported across Linux, Windows and Macintosh. Linux users can use +This software is supported across Linux, Windows and Macintosh. Linux users can use either an Nvidia-based card (with CUDA support) or an AMD card (using the ROCm driver). @@ -95,6 +95,8 @@ driver). This method is recommended for experienced users and developers #### [Docker Installation](installation/040_INSTALL_DOCKER.md) This method is recommended for those familiar with running Docker containers +#### [Installation Troubleshooting](installation/010_INSTALL_AUTOMATED.md#troubleshooting) +Installation troubleshooting guide. ### Other Installation Guides - [PyPatchMatch](installation/060_INSTALL_PATCHMATCH.md) - [XFormers](installation/070_INSTALL_XFORMERS.md) @@ -230,7 +232,7 @@ encouraged to do so. ## :octicons-person-24: Contributors -This fork is a combined effort of various people from across the world. +This software is a combined effort of various people from across the world. [Check out the list of all these amazing people](other/CONTRIBUTORS.md). We thank them for their time, hard work and effort. diff --git a/docs/installation/010_INSTALL_AUTOMATED.md b/docs/installation/010_INSTALL_AUTOMATED.md index 6eee9799f8..79203f066c 100644 --- a/docs/installation/010_INSTALL_AUTOMATED.md +++ b/docs/installation/010_INSTALL_AUTOMATED.md @@ -372,8 +372,71 @@ experimental versions later. Once InvokeAI is installed, do not move or remove this directory." + ## Troubleshooting +### _OSErrors on Windows while installing dependencies_ + +During a zip file installation or an online update, installation stops +with an error like this: + +![broken-dependency-screenshot](../assets/troubleshooting/broken-dependency.png){:width="800px"} + +This seems to happen particularly often with the `pydantic` and +`numpy` packages. The most reliable solution requires several manual +steps to complete installation. + +Open up a Powershell window and navigate to the `invokeai` directory +created by the installer. Then give the following series of commands: + +```cmd +rm .\.venv -r -force +python -mvenv .venv +.\.venv\Scripts\activate +pip install invokeai +invokeai-configure --root . +``` + +If you see anything marked as an error during this process please stop +and seek help on the Discord [installation support +channel](https://discord.com/channels/1020123559063990373/1041391462190956654). A +few warning messages are OK. + +If you are updating from a previous version, this should restore your +system to a working state. If you are installing from scratch, there +is one additional command to give: + +```cmd +wget -O invoke.bat https://raw.githubusercontent.com/invoke-ai/InvokeAI/main/installer/templates/invoke.bat.in +``` + +This will create the `invoke.bat` script needed to launch InvokeAI and +its related programs. + + +### _Stable Diffusion XL Generation Fails after Trying to Load unet_ + +InvokeAI is working in other respects, but when trying to generate +images with Stable Diffusion XL you get a "Server Error". The text log +in the launch window contains this log line above several more lines of +error messages: + +```INFO --> Loading model:D:\LONG\PATH\TO\MODEL, type sdxl:main:unet``` + +This failure mode occurs when there is a network glitch during +downloading the very large SDXL model. + +To address this, first go to the Web Model Manager and delete the +Stable-Diffusion-XL-base-1.X model. Then navigate to HuggingFace and +manually download the .safetensors version of the model. The 1.0 +version is located at +https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/tree/main +and the file is named `sd_xl_base_1.0.safetensors`. + +Save this file to disk and then reenter the Model Manager. Navigate to +Import Models->Add Model, then type (or drag-and-drop) the path to the +.safetensors file. Press "Add Model". + ### _Package dependency conflicts_ If you have previously installed InvokeAI or another Stable Diffusion