text-generation-webui/README.md

191 lines
10 KiB
Markdown
Raw Normal View History

2023-01-16 14:31:13 +01:00
# Text generation web UI
2022-12-21 20:49:30 +01:00
2023-02-23 05:32:05 +01:00
A gradio web UI for running Large Language Models like GPT-J 6B, OPT, GALACTICA, GPT-Neo, and Pygmalion.
2022-12-21 20:49:30 +01:00
Its goal is to become the [AUTOMATIC1111/stable-diffusion-webui](https://github.com/AUTOMATIC1111/stable-diffusion-webui) of text generation.
2022-12-21 17:17:06 +01:00
2023-02-06 03:14:25 +01:00
[[Try it on Google Colab]](https://colab.research.google.com/github/oobabooga/AI-Notebooks/blob/main/Colab-TextGen-GPU.ipynb)
2023-01-22 23:29:24 +01:00
2023-01-22 21:28:51 +01:00
|![Image1](https://github.com/oobabooga/screenshots/raw/main/qa.png) | ![Image2](https://github.com/oobabooga/screenshots/raw/main/cai3.png) |
2023-01-15 03:25:05 +01:00
|:---:|:---:|
2023-01-15 08:27:22 +01:00
|![Image3](https://github.com/oobabooga/screenshots/raw/main/gpt4chan.png) | ![Image4](https://github.com/oobabooga/screenshots/raw/main/galactica.png) |
2022-12-21 18:04:51 +01:00
2023-01-07 22:40:51 +01:00
## Features
* Switch between different models using a dropdown menu.
* Notebook mode that resembles OpenAI's playground.
2023-01-22 05:30:55 +01:00
* Chat mode for conversation and role playing.
2023-01-23 14:02:35 +01:00
* Generate nice HTML output for GPT-4chan.
* Generate Markdown output for [GALACTICA](https://github.com/paperswithcode/galai), including LaTeX support.
2023-02-03 14:14:52 +01:00
* Support for [Pygmalion](https://huggingface.co/models?search=pygmalionai/pygmalion) and custom characters in JSON or TavernAI Character Card formats ([FAQ](https://github.com/oobabooga/text-generation-webui/wiki/Pygmalion-chat-model-FAQ)).
2023-02-16 21:29:48 +01:00
* Advanced chat features (send images, get audio responses with TTS).
2023-01-23 14:02:35 +01:00
* Stream the text output in real time.
2023-01-07 22:40:51 +01:00
* Load parameter presets from text files.
* Load large models in 8-bit mode ([see here](https://github.com/oobabooga/text-generation-webui/issues/20#issuecomment-1411650652) if you are on Windows).
2023-01-23 14:02:35 +01:00
* Split large models across your GPU(s), CPU, and disk.
2023-01-09 15:11:05 +01:00
* CPU mode.
2023-02-22 05:54:12 +01:00
* [FlexGen offload](https://github.com/oobabooga/text-generation-webui/wiki/FlexGen).
2023-02-20 16:44:31 +01:00
* [DeepSpeed ZeRO-3 offload](https://github.com/oobabooga/text-generation-webui/wiki/DeepSpeed).
* [Get responses via API](https://github.com/oobabooga/text-generation-webui/blob/main/api-example.py).
2023-02-13 19:52:49 +01:00
* Supports softprompts.
2023-02-25 22:56:43 +01:00
* [Supports extensions](https://github.com/oobabooga/text-generation-webui/wiki/Extensions)
2023-02-20 16:44:31 +01:00
* [Works on Google Colab](https://github.com/oobabooga/text-generation-webui/wiki/Running-on-Colab).
2023-01-07 22:40:51 +01:00
## Installation option 1: conda
2022-12-21 17:17:06 +01:00
Open a terminal and copy and paste these commands one at a time ([install conda](https://docs.conda.io/en/latest/miniconda.html) first if you don't have it already):
2023-01-13 05:29:36 +01:00
```
conda create -n textgen
conda activate textgen
conda install torchvision torchaudio pytorch-cuda=11.7 git -c pytorch -c nvidia
2023-01-20 04:20:35 +01:00
git clone https://github.com/oobabooga/text-generation-webui
cd text-generation-webui
pip install -r requirements.txt
2023-01-20 04:20:35 +01:00
```
The third line assumes that you have an NVIDIA GPU.
2023-02-11 11:56:12 +01:00
* If you have an AMD GPU, replace the third command with this one:
```
pip3 install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/rocm5.2
```
2023-02-11 08:13:06 +01:00
2023-02-11 11:56:12 +01:00
* If you are running in CPU mode, replace the third command with this one:
2023-01-13 05:29:36 +01:00
```
conda install pytorch torchvision torchaudio git -c pytorch
2023-01-13 05:29:36 +01:00
```
2022-12-21 17:17:06 +01:00
2023-02-12 04:34:55 +01:00
## Installation option 2: one-click installers
2023-02-10 21:09:53 +01:00
[oobabooga-windows.zip](https://github.com/oobabooga/text-generation-webui/releases/download/installers/oobabooga-windows.zip)
[oobabooga-linux.zip](https://github.com/oobabooga/text-generation-webui/releases/download/installers/oobabooga-linux.zip)
2023-02-11 01:46:29 +01:00
Just download the zip above, extract it, and double click on "install". The web UI and all its dependencies will be installed in the same folder.
* To download a model, double click on "download-model"
* To start the web UI, double click on "start-webui"
2022-12-21 18:37:50 +01:00
## Downloading models
2023-01-16 15:19:23 +01:00
Models should be placed under `models/model-name`. For instance, `models/gpt-j-6B` for [GPT-J 6B](https://huggingface.co/EleutherAI/gpt-j-6B/tree/main).
2022-12-21 18:37:50 +01:00
2023-01-15 07:35:57 +01:00
#### Hugging Face
2022-12-21 18:37:50 +01:00
2023-01-15 07:35:57 +01:00
[Hugging Face](https://huggingface.co/models?pipeline_tag=text-generation&sort=downloads) is the main place to download models. These are some noteworthy examples:
2022-12-21 18:37:50 +01:00
2023-01-16 15:19:23 +01:00
* [GPT-J 6B](https://huggingface.co/EleutherAI/gpt-j-6B/tree/main)
* [GPT-Neo](https://huggingface.co/models?pipeline_tag=text-generation&sort=downloads&search=eleutherai+%2F+gpt-neo)
2023-02-24 15:38:01 +01:00
* [Pythia](https://huggingface.co/models?search=eleutherai/pythia)
2023-01-07 23:19:55 +01:00
* [OPT](https://huggingface.co/models?search=facebook/opt)
* [GALACTICA](https://huggingface.co/models?search=facebook/galactica)
2023-01-06 04:13:26 +01:00
* [\*-Erebus](https://huggingface.co/models?search=erebus)
2023-01-13 13:33:38 +01:00
* [Pygmalion](https://huggingface.co/models?search=pygmalion)
2023-01-06 04:13:26 +01:00
2023-02-14 01:49:19 +01:00
You can automatically download a model from HF using the script `download-model.py`:
2023-01-07 00:00:58 +01:00
python download-model.py organization/model
For instance:
python download-model.py facebook/opt-1.3b
2023-02-14 17:06:26 +01:00
If you want to download a model manually, note that all you need are the json, txt, and pytorch\*.bin (or model*.safetensors) files. The remaining files are not necessary.
2023-01-23 14:02:35 +01:00
2023-01-09 20:19:57 +01:00
#### GPT-4chan
2022-12-21 18:37:50 +01:00
2023-01-09 20:19:57 +01:00
[GPT-4chan](https://huggingface.co/ykilcher/gpt-4chan) has been shut down from Hugging Face, so you need to download it elsewhere. You have two options:
2022-12-21 18:37:50 +01:00
* Torrent: [16-bit](https://archive.org/details/gpt4chan_model_float16) / [32-bit](https://archive.org/details/gpt4chan_model)
* Direct download: [16-bit](https://theswissbay.ch/pdf/_notpdf_/gpt4chan_model_float16/) / [32-bit](https://theswissbay.ch/pdf/_notpdf_/gpt4chan_model/)
2023-01-13 05:39:09 +01:00
The 32-bit version is only relevant if you intend to run the model in CPU mode. Otherwise, you should use the 16-bit version.
2023-01-13 05:37:12 +01:00
After downloading the model, follow these steps:
1. Place the files under `models/gpt4chan_model_float16` or `models/gpt4chan_model`.
2023-01-16 15:19:23 +01:00
2. Place GPT-J 6B's config.json file in that same folder: [config.json](https://huggingface.co/EleutherAI/gpt-j-6B/raw/main/config.json).
3. Download GPT-J 6B's tokenizer files (they will be automatically detected when you attempt to load GPT-4chan):
2023-01-12 03:01:50 +01:00
2023-01-12 03:04:06 +01:00
```
python download-model.py EleutherAI/gpt-j-6B --text-only
2023-01-12 03:04:06 +01:00
```
2023-01-08 03:13:43 +01:00
2023-01-16 14:07:00 +01:00
## Starting the web UI
2022-12-21 17:17:06 +01:00
conda activate textgen
python server.py
2023-01-07 00:00:58 +01:00
Then browse to
`http://localhost:7860/?__theme=dark`
2023-01-07 00:07:58 +01:00
Optionally, you can use the following command-line flags:
2023-01-07 00:00:58 +01:00
2023-01-15 19:40:03 +01:00
| Flag | Description |
|-------------|-------------|
2023-01-15 19:41:36 +01:00
| `-h`, `--help` | show this help message and exit |
| `--model MODEL` | Name of the model to load by default. |
2023-01-16 14:07:00 +01:00
| `--notebook` | Launch the web UI in notebook mode, where the output is written to the same text box as the input. |
| `--chat` | Launch the web UI in chat mode.|
2023-01-25 23:43:30 +01:00
| `--cai-chat` | Launch the web UI in chat mode with a style similar to Character.AI's. If the file `img_bot.png` or `img_bot.jpg` exists in the same folder as server.py, this image will be used as the bot's profile picture. Similarly, `img_me.png` or `img_me.jpg` will be used as your profile picture. |
2023-01-15 19:41:36 +01:00
| `--cpu` | Use the CPU to generate text.|
| `--load-in-8bit` | Load the model with 8-bit precision.|
2023-02-16 21:29:48 +01:00
| `--bf16` | Load the model with bfloat16 precision. Requires NVIDIA Ampere GPU. |
| `--auto-devices` | Automatically split the model across the available GPU(s) and CPU.|
| `--disk` | If the model is too large for your GPU(s) and CPU combined, send the remaining layers to the disk. |
| `--disk-cache-dir DISK_CACHE_DIR` | Directory to save the disk cache to. Defaults to `cache/`. |
2023-02-24 16:01:07 +01:00
| `--gpu-memory GPU_MEMORY [GPU_MEMORY ...]` | Maxmimum GPU memory in GiB to be allocated per GPU. Example: `--gpu-memory 10` for a single GPU, `--gpu-memory 10 5` for two GPUs. |
2023-01-21 07:05:55 +01:00
| `--cpu-memory CPU_MEMORY` | Maximum CPU memory in GiB to allocate for offloaded weights. Must be an integer number. Defaults to 99.|
2023-02-23 14:04:07 +01:00
| `--flexgen` | Enable the use of FlexGen offloading. |
| `--percent PERCENT [PERCENT ...]` | FlexGen: allocation percentages. Must be 6 numbers separated by spaces (default: 0, 100, 100, 0, 100, 0). |
| `--compress-weight` | FlexGen: Whether to compress weight (default: False).|
2023-02-16 21:29:48 +01:00
| `--deepspeed` | Enable the use of DeepSpeed ZeRO-3 for inference via the Transformers integration. |
| `--nvme-offload-dir NVME_OFFLOAD_DIR` | DeepSpeed: Directory to use for ZeRO-3 NVME offloading. |
| `--local_rank LOCAL_RANK` | DeepSpeed: Optional argument for distributed setups. |
| `--no-stream` | Don't stream the text output in real time. This improves the text generation performance.|
2023-01-16 20:35:45 +01:00
| `--settings SETTINGS_FILE` | Load the default interface settings from this json file. See `settings-template.json` for an example.|
2023-02-24 13:03:09 +01:00
| `--extensions EXTENSIONS [EXTENSIONS ...]` | The list of extensions to load. If you want to load more than one extension, write the names separated by spaces. |
2023-01-21 03:45:16 +01:00
| `--listen` | Make the web UI reachable from your local network.|
2023-01-29 06:54:36 +01:00
| `--listen-port LISTEN_PORT` | The listening port that the server will use. |
2023-01-19 21:31:29 +01:00
| `--share` | Create a public URL. This is useful for running the web UI on Google Colab or similar. |
2023-01-26 06:12:53 +01:00
| `--verbose` | Print the prompts to the terminal. |
2023-01-09 14:58:46 +01:00
2023-01-19 15:25:17 +01:00
Out of memory errors? [Check this guide](https://github.com/oobabooga/text-generation-webui/wiki/Low-VRAM-guide).
2023-01-06 05:33:21 +01:00
## Presets
Inference settings presets can be created under `presets/` as text files. These files are detected automatically at startup.
2023-01-24 00:44:27 +01:00
By default, 10 presets by NovelAI and KoboldAI are included. These were selected out of a sample of 43 presets after applying a K-Means clustering algorithm and selecting the elements closest to the average of each cluster.
2023-01-09 22:12:41 +01:00
## System requirements
2023-01-09 22:18:35 +01:00
Check the [wiki](https://github.com/oobabooga/text-generation-webui/wiki/System-requirements) for some examples of VRAM and RAM usage in both GPU and CPU mode.
2023-01-09 22:12:41 +01:00
2022-12-21 20:52:23 +01:00
## Contributing
2023-01-16 14:07:00 +01:00
Pull requests, suggestions, and issue reports are welcome.
2023-01-09 20:15:54 +01:00
2023-01-29 18:37:05 +01:00
Before reporting a bug, make sure that you have created a conda environment and installed the dependencies exactly as in the *Installation* section above.
2023-02-08 05:17:50 +01:00
These issues are known:
* 8-bit doesn't work properly on Windows or older GPUs.
2023-02-19 02:34:51 +01:00
* DeepSpeed doesn't work properly on Windows.
2023-02-08 05:17:50 +01:00
For these two, please try commenting on an existing issue instead of creating a new one.
2023-01-15 07:00:59 +01:00
## Credits
2023-01-09 20:15:54 +01:00
2023-01-15 08:29:19 +01:00
- NovelAI and KoboldAI presets: https://github.com/KoboldAI/KoboldAI-Client/wiki/Settings-Presets
2023-02-08 04:09:41 +01:00
- Pygmalion preset, code for early stopping in chat mode, code for some of the sliders: https://github.com/PygmalionAI/gradio-ui/
2023-01-16 15:23:45 +01:00
- Verbose preset: Anonymous 4chan user.
2023-02-11 18:49:11 +01:00
- Instruct-Joi preset: https://huggingface.co/Rallio67/joi_12B_instruct_alpha
- Gradio dropdown menu refresh button: https://github.com/AUTOMATIC1111/stable-diffusion-webui