text-generation-webui/docs/GPTQ-models-(4-bit-mode).md

229 lines
8.1 KiB
Markdown
Raw Permalink Normal View History

2023-04-22 07:34:13 +02:00
GPTQ is a clever quantization algorithm that lightly reoptimizes the weights during quantization so that the accuracy loss is compensated relative to a round-to-nearest quantization. See the paper for more details: https://arxiv.org/abs/2210.17323
2023-05-30 03:20:55 +02:00
4-bit GPTQ models reduce VRAM usage by about 75%. So LLaMA-7B fits into a 6GB GPU, and LLaMA-30B fits into a 24GB GPU.
2023-05-29 19:56:05 +02:00
2023-05-30 03:20:55 +02:00
## Overview
2023-05-29 19:56:05 +02:00
2023-05-30 03:20:55 +02:00
There are two ways of loading GPTQ models in the web UI at the moment:
2023-05-29 19:56:05 +02:00
2023-05-30 03:20:55 +02:00
* Using AutoGPTQ:
* supports more models
* standardized (no need to guess any parameter)
* is a proper Python library
* ~no wheels are presently available so it requires manual compilation~
2023-05-30 03:20:55 +02:00
* supports loading both triton and cuda models
2023-05-29 19:56:05 +02:00
2023-06-05 20:55:00 +02:00
* Using GPTQ-for-LLaMa directly:
* faster CPU offloading
* faster multi-GPU inference
* supports loading LoRAs using a monkey patch
* requires you to manually figure out the wbits/groupsize/model_type parameters for the model to be able to load it
* supports either only cuda or only triton depending on the branch
2023-05-30 03:20:55 +02:00
For creating new quantizations, I recommend using AutoGPTQ: https://github.com/PanQiWei/AutoGPTQ
2023-05-29 19:56:05 +02:00
2023-06-05 20:55:00 +02:00
## AutoGPTQ
### Installation
No additional steps are necessary as AutoGPTQ is already in the `requirements.txt` for the webui. If you still want or need to install it manually for whatever reason, these are the commands:
```
conda activate textgen
git clone https://github.com/PanQiWei/AutoGPTQ.git && cd AutoGPTQ
pip install .
```
The last command requires `nvcc` to be installed (see the [instructions above](https://github.com/oobabooga/text-generation-webui/blob/main/docs/GPTQ-models-(4-bit-mode).md#step-1-install-nvcc)).
### Usage
When you quantize a model using AutoGPTQ, a folder containing a filed called `quantize_config.json` will be generated. Place that folder inside your `models/` folder and load it with the `--autogptq` flag:
```
python server.py --autogptq --model model_name
```
Alternatively, check the `autogptq` box in the "Model" tab of the UI before loading the model.
### Offloading
In order to do CPU offloading or multi-gpu inference with AutoGPTQ, use the `--gpu-memory` flag. It is currently somewhat slower than offloading with the `--pre_layer` option in GPTQ-for-LLaMA.
For CPU offloading:
```
python server.py --autogptq --gpu-memory 3000MiB --model model_name
```
For multi-GPU inference:
```
python server.py --autogptq --gpu-memory 3000MiB 6000MiB --model model_name
```
### Using LoRAs with AutoGPTQ
Not supported yet.
2023-05-29 19:56:05 +02:00
## GPTQ-for-LLaMa
2023-05-30 03:20:55 +02:00
GPTQ-for-LLaMa is the original adaptation of GPTQ for the LLaMA model. It was made possible by [@qwopqwop200](https://github.com/qwopqwop200/GPTQ-for-LLaMa): https://github.com/qwopqwop200/GPTQ-for-LLaMa
2023-05-29 19:56:05 +02:00
Different branches of GPTQ-for-LLaMa are currently available, including:
2023-04-22 17:48:20 +02:00
| Branch | Comment |
|----|----|
| [Old CUDA branch (recommended)](https://github.com/oobabooga/GPTQ-for-LLaMa/) | The fastest branch, works on Windows and Linux. |
2023-04-22 20:12:14 +02:00
| [Up-to-date triton branch](https://github.com/qwopqwop200/GPTQ-for-LLaMa) | Slightly more precise than the old CUDA branch from 13b upwards, significantly more precise for 7b. 2x slower for small context size and only works on Linux. |
2023-04-22 17:48:20 +02:00
| [Up-to-date CUDA branch](https://github.com/qwopqwop200/GPTQ-for-LLaMa/tree/cuda) | As precise as the up-to-date triton branch, 10x slower than the old cuda branch for small context size. |
Overall, I recommend using the old CUDA branch. It is included by default in the one-click-installer for this web UI.
2023-06-01 04:38:15 +02:00
### Installation
Start by cloning GPTQ-for-LLaMa into your `text-generation-webui/repositories` folder:
```
mkdir repositories
cd repositories
git clone https://github.com/oobabooga/GPTQ-for-LLaMa.git -b cuda
```
If you want to you to use the up-to-date CUDA or triton branches instead of the old CUDA branch, use these commands:
```
git clone https://github.com/qwopqwop200/GPTQ-for-LLaMa.git -b cuda
```
```
git clone https://github.com/qwopqwop200/GPTQ-for-LLaMa.git -b triton
```
Next you need to install the CUDA extensions. You can do that either by installing the precompiled wheels, or by compiling the wheels yourself.
### Precompiled wheels
2023-05-29 20:07:59 +02:00
2023-05-30 03:35:49 +02:00
Kindly provided by our friend jllllll: https://github.com/jllllll/GPTQ-for-LLaMa-Wheels
Windows:
```
pip install https://github.com/jllllll/GPTQ-for-LLaMa-Wheels/raw/main/quant_cuda-0.0.0-cp310-cp310-win_amd64.whl
```
Linux:
```
pip install https://github.com/jllllll/GPTQ-for-LLaMa-Wheels/raw/Linux-x64/quant_cuda-0.0.0-cp310-cp310-linux_x86_64.whl
```
2023-05-29 20:07:59 +02:00
### Manual installation
2023-04-22 07:34:13 +02:00
2023-06-01 04:38:15 +02:00
#### Step 1: install nvcc
2023-04-22 07:34:13 +02:00
```
conda activate textgen
conda install -c conda-forge cudatoolkit-dev
```
The command above takes some 10 minutes to run and shows no progress bar or updates along the way.
2023-06-01 04:49:00 +02:00
You are also going to need to have a C++ compiler installed. On Linux, `sudo apt install build-essential` or equivalent is enough.
2023-04-22 07:34:13 +02:00
2023-06-01 04:38:15 +02:00
If you're using an older version of CUDA toolkit (e.g. 11.7) but the latest version of `gcc` and `g++` (12.0+), you should downgrade with: `conda install -c conda-forge gxx==11.3.0`. Kernel compilation will fail otherwise.
2023-04-22 07:34:13 +02:00
2023-06-01 04:38:15 +02:00
#### Step 2: compile the CUDA extensions
2023-04-22 07:34:13 +02:00
```
2023-06-01 04:38:15 +02:00
cd repositories/GPTQ-for-LLaMa
2023-04-22 07:34:13 +02:00
python setup_cuda.py install
```
2023-06-01 04:49:00 +02:00
### Getting pre-converted LLaMA weights
2023-07-17 21:51:01 +02:00
* Direct download (recommended):
2023-04-22 07:34:13 +02:00
2023-07-17 21:51:01 +02:00
https://huggingface.co/Neko-Institute-of-Science/LLaMA-7B-4bit-128g
2023-04-22 07:34:13 +02:00
2023-07-17 21:51:01 +02:00
https://huggingface.co/Neko-Institute-of-Science/LLaMA-13B-4bit-128g
https://huggingface.co/Neko-Institute-of-Science/LLaMA-30B-4bit-128g
https://huggingface.co/Neko-Institute-of-Science/LLaMA-65B-4bit-128g
These models were converted with `desc_act=True`. They work just fine with ExLlama. For AutoGPTQ, they will only work on Linux with the `triton` option checked.
* Torrent:
https://github.com/oobabooga/text-generation-webui/pull/530#issuecomment-1483891617
https://github.com/oobabooga/text-generation-webui/pull/530#issuecomment-1483941105
These models were converted with `desc_act=False`. As such, they are less accurate, but they work with AutoGPTQ on Windows. The `128g` versions are better from 13b upwards, and worse for 7b. The tokenizer files in the torrents are outdated, in particular the files called `tokenizer_config.json` and `special_tokens_map.json`. Here you can find those files: https://huggingface.co/oobabooga/llama-tokenizer
2023-04-22 07:34:13 +02:00
2023-06-01 04:38:15 +02:00
### Starting the web UI:
2023-04-22 07:34:13 +02:00
2023-06-05 20:55:00 +02:00
Use the `--gptq-for-llama` flag.
2023-04-22 07:34:13 +02:00
For the models converted without `group-size`:
```
2023-06-05 20:55:00 +02:00
python server.py --model llama-7b-4bit --gptq-for-llama
2023-04-22 07:34:13 +02:00
```
For the models converted with `group-size`:
```
2023-06-05 20:55:00 +02:00
python server.py --model llama-13b-4bit-128g --gptq-for-llama --wbits 4 --groupsize 128
2023-04-22 07:34:13 +02:00
```
2023-06-05 20:55:00 +02:00
The command-line flags `--wbits` and `--groupsize` are automatically detected based on the folder names in many cases.
2023-04-22 07:34:13 +02:00
2023-05-29 19:56:05 +02:00
### CPU offloading
2023-04-22 07:34:13 +02:00
It is possible to offload part of the layers of the 4-bit model to the CPU with the `--pre_layer` flag. The higher the number after `--pre_layer`, the more layers will be allocated to the GPU.
With this command, I can run llama-7b with 4GB VRAM:
```
python server.py --model llama-7b-4bit --pre_layer 20
```
This is the performance:
```
Output generated in 123.79 seconds (1.61 tokens/s, 199 tokens)
```
You can also use multiple GPUs with `pre_layer` if using the oobabooga fork of GPTQ, eg `--pre_layer 30 60` will load a LLaMA-30B model half onto your first GPU and half onto your second, or `--pre_layer 20 40` will load 20 layers onto GPU-0, 20 layers onto GPU-1, and 20 layers offloaded to CPU.
2023-05-29 19:56:05 +02:00
### Using LoRAs with GPTQ-for-LLaMa
2023-04-22 07:34:13 +02:00
2023-05-29 20:07:59 +02:00
This requires using a monkey patch that is supported by this web UI: https://github.com/johnsmith0031/alpaca_lora_4bit
2023-04-22 07:34:13 +02:00
2023-05-29 20:07:59 +02:00
To use it:
2023-04-22 07:34:13 +02:00
2023-05-29 20:07:59 +02:00
1. Clone `johnsmith0031/alpaca_lora_4bit` into the repositories folder:
2023-04-22 07:34:13 +02:00
```
cd text-generation-webui/repositories
git clone https://github.com/johnsmith0031/alpaca_lora_4bit
```
2023-05-03 19:49:25 +02:00
⚠️ I have tested it with the following commit specifically: `2f704b93c961bf202937b10aac9322b092afdce0`
2023-04-26 02:20:26 +02:00
2023-05-29 20:07:59 +02:00
2. Install https://github.com/sterlind/GPTQ-for-LLaMa with this command:
2023-04-22 07:34:13 +02:00
```
pip install git+https://github.com/sterlind/GPTQ-for-LLaMa.git@lora_4bit
```
2023-05-29 20:07:59 +02:00
3. Start the UI with the `--monkey-patch` flag:
2023-04-22 07:34:13 +02:00
```
python server.py --model llama-7b-4bit-128g --listen --lora tloen_alpaca-lora-7b --monkey-patch
```
2023-05-30 03:20:55 +02:00