mirror of
https://github.com/invoke-ai/InvokeAI.git
synced 2026-02-16 00:25:25 -05:00
107 lines
3.6 KiB
Markdown
107 lines
3.6 KiB
Markdown
---
|
|
title: Manual Installation, Linux
|
|
---
|
|
|
|
# :fontawesome-brands-linux: Linux
|
|
|
|
## Installation
|
|
|
|
1. You will need to install the following prerequisites if they are not already
|
|
available. Use your operating system's preferred installer.
|
|
|
|
- Python (version 3.8.5 recommended; higher may work)
|
|
- git
|
|
|
|
2. Install the Python Anaconda environment manager.
|
|
|
|
```bash
|
|
~$ wget https://repo.anaconda.com/archive/Anaconda3-2022.05-Linux-x86_64.sh
|
|
~$ chmod +x Anaconda3-2022.05-Linux-x86_64.sh
|
|
~$ ./Anaconda3-2022.05-Linux-x86_64.sh
|
|
```
|
|
|
|
After installing anaconda, you should log out of your system and log back in. If
|
|
the installation worked, your command prompt will be prefixed by the name of the
|
|
current anaconda environment - `(base)`.
|
|
|
|
3. Copy the InvokeAI source code from GitHub:
|
|
|
|
```bash
|
|
(base) ~$ git clone https://github.com/invoke-ai/InvokeAI.git
|
|
```
|
|
|
|
This will create InvokeAI folder where you will follow the rest of the steps.
|
|
|
|
4. Enter the newly-created InvokeAI folder. From this step forward make sure that you are working in the InvokeAI directory!
|
|
|
|
```bash
|
|
(base) ~$ cd InvokeAI
|
|
(base) ~/InvokeAI$
|
|
```
|
|
|
|
5. Use anaconda to copy necessary python packages, create a new python
|
|
environment named `invokeai` and activate the environment.
|
|
|
|
```bash
|
|
(base) rm -rf src # (this is a precaution in case there is already a src directory)
|
|
(base) ~/InvokeAI$ conda env create
|
|
(base) ~/InvokeAI$ conda activate invokeai
|
|
(invokeai) ~/InvokeAI$
|
|
```
|
|
|
|
After these steps, your command prompt will be prefixed by `(invokeai)` as shown
|
|
above.
|
|
|
|
6. Load the big stable diffusion weights files and a couple of smaller machine-learning models:
|
|
|
|
```bash
|
|
(invokeai) ~/InvokeAI$ python3 scripts/preload_models.py
|
|
```
|
|
|
|
!!! note
|
|
This script will lead you through the process of creating an account on Hugging Face,
|
|
accepting the terms and conditions of the Stable Diffusion model license, and
|
|
obtaining an access token for downloading. It will then download and install the
|
|
weights files for you.
|
|
|
|
Please see [../features/INSTALLING_MODELS.md] for a manual process for doing the
|
|
same thing.
|
|
|
|
7. Start generating images!
|
|
|
|
# Command-line interface
|
|
(invokeai) python scripts/invoke.py
|
|
|
|
# or run the web interface on localhost:9090!
|
|
(invokeai) python scripts/invoke.py --web
|
|
|
|
# or run the web interface on your machine's network interface!
|
|
(invokeai) python scripts/invoke.py --web --host 0.0.0.0
|
|
|
|
To use an alternative model you may invoke the `!switch` command in
|
|
the CLI, or pass `--model <model_name>` during `invoke.py` launch for
|
|
either the CLI or the Web UI. See [Command Line
|
|
Client](../features/CLI.md#model-selection-and-importation). The
|
|
model names are defined in `configs/models.yaml`.
|
|
|
|
9. Subsequently, to relaunch the script, be sure to run "conda
|
|
activate invokeai" (step 5, second command), enter the `InvokeAI`
|
|
directory, and then launch the invoke script (step 8). If you forget
|
|
to activate the 'invokeai' environment, the script will fail with
|
|
multiple `ModuleNotFound` errors.
|
|
|
|
## Updating to newer versions of the script
|
|
|
|
This distribution is changing rapidly. If you used the `git clone`
|
|
method (step 5) to download the InvokeAI directory, then to update to
|
|
the latest and greatest version, launch the Anaconda window, enter
|
|
`InvokeAI` and type:
|
|
|
|
```bash
|
|
(invokeai) ~/InvokeAI$ git pull
|
|
(invokeai) ~/InvokeAI$ rm -rf src # prevents conda freezing errors
|
|
(invokeai) ~/InvokeAI$ conda env update -f environment.yml
|
|
```
|
|
|
|
This will bring your local copy into sync with the remote one.
|