mirror of
https://github.com/invoke-ai/InvokeAI
synced 2024-08-30 20:32:17 +00:00
update troubleshooting guide with ~ydantic and SDXL unet issue workarounds
This commit is contained in:
parent
062a369044
commit
3da0be7eb9
@ -80,11 +80,11 @@ Q&A</a>]
|
|||||||
|
|
||||||
!!! note
|
!!! 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
|
## :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
|
either an Nvidia-based card (with CUDA support) or an AMD card (using the ROCm
|
||||||
driver).
|
driver).
|
||||||
|
|
||||||
@ -95,6 +95,8 @@ driver).
|
|||||||
This method is recommended for experienced users and developers
|
This method is recommended for experienced users and developers
|
||||||
#### [Docker Installation](installation/040_INSTALL_DOCKER.md)
|
#### [Docker Installation](installation/040_INSTALL_DOCKER.md)
|
||||||
This method is recommended for those familiar with running Docker containers
|
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
|
### Other Installation Guides
|
||||||
- [PyPatchMatch](installation/060_INSTALL_PATCHMATCH.md)
|
- [PyPatchMatch](installation/060_INSTALL_PATCHMATCH.md)
|
||||||
- [XFormers](installation/070_INSTALL_XFORMERS.md)
|
- [XFormers](installation/070_INSTALL_XFORMERS.md)
|
||||||
@ -230,7 +232,7 @@ encouraged to do so.
|
|||||||
|
|
||||||
## :octicons-person-24: Contributors
|
## :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
|
[Check out the list of all these amazing people](other/CONTRIBUTORS.md). We
|
||||||
thank them for their time, hard work and effort.
|
thank them for their time, hard work and effort.
|
||||||
|
|
||||||
|
@ -372,8 +372,71 @@ experimental versions later.
|
|||||||
Once InvokeAI is installed, do not move or remove this directory."
|
Once InvokeAI is installed, do not move or remove this directory."
|
||||||
|
|
||||||
|
|
||||||
|
<a name="troubleshooting"></a>
|
||||||
## Troubleshooting
|
## 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_
|
### _Package dependency conflicts_
|
||||||
|
|
||||||
If you have previously installed InvokeAI or another Stable Diffusion
|
If you have previously installed InvokeAI or another Stable Diffusion
|
||||||
|
Loading…
Reference in New Issue
Block a user