Skip to content

Commit d98734b

Browse files
authored
Merge pull request turboderp-org#16 from sidewaysthought/patch-1
Create manual-install.md
2 parents 85fc116 + 110722b commit d98734b

File tree

1 file changed

+53
-0
lines changed

1 file changed

+53
-0
lines changed

Diff for: doc/manual-install.md

+53
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# Manually Installing PyTorch and Exllamav2
2+
If you own a video adapter or computer with NVidia graphics, and get CUDA errors starting exui, you may need to install precompiled wheels
3+
for PyTorch and/or exllamav2. These instructions are written with Windows 11 in mind but they may also work for Windows 10.
4+
5+
## Before you begin
6+
* Before doing anything, make sure official NVidia drivers are installed. Versions installed automatically during Windows installation may not
7+
function as expected. [Download drivers from the NVidia Download page](https://www.nvidia.com/Download/index.aspx).
8+
* Uninstall torch and exllama2.
9+
10+
```
11+
pip uninstall torch
12+
pip uninstall exllamav2
13+
```
14+
15+
## Finding the CUDA version for your NVidia graphics adapter
16+
NVidia [documents which products support CUDA](https://developer.nvidia.com/cuda-gpus), and basically any NVidia GT, GTX and RTX device will
17+
support CUDA. However they *do not* document which CUDA versions are supported for each card. General guidance: Newer GTX and all RTX cards
18+
likely support CUDA 12.1 or later. Older cards are more likely to support CUDA 11.8.
19+
20+
* Play it safe: use CUDA 11.8
21+
* Have newer gaming hardware? Try CUDA 12.1
22+
23+
## Installing Pre-Complied PyTorch
24+
Visit the [PyTorch Get Started Locally page](https://pytorch.org/get-started/locally/). Choose the appropriate options to be given the PIP URL
25+
to intall PyTorch.
26+
27+
1. PyTorch Build: stable
28+
2. Your OS
29+
3. Package type: PIP
30+
4. Language: Python
31+
5. Computer Platform: select the CUDA version that matches your video adapter.
32+
33+
Copy and paste the command given by the PyTorch website into your Terminal.
34+
35+
```
36+
Example: pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121
37+
```
38+
Once PyTorch is installed, it is time to install exllamav2.
39+
40+
## Installing Pre-Complied Exllamav2
41+
42+
1. [Download the correct pre-compiled wheel](https://github.com/turboderp/exllamav2/releases). Choose the correct wheel. For example if
43+
you have Windows 11 or Windows 10 running on a 64-bit CPU (most common), are using CUDA 12.1, and Python 3.10, download
44+
```exllamav2-0.0.9+cu121-cp310-cp310-win_amd64.whl```. If you are using Python 3.11, choose
45+
```exllamav2-0.0.9+cu121-cp311-cp311-win_amd64.whl```.
46+
2. Use pip to install the downloaded wheel:
47+
48+
```
49+
Example: pip install path\to\downloaded\file\exllamav2-0.0.9+cu121-cp311-cp311-win_amd64.whl.
50+
```
51+
## Start exui
52+
53+
With those packages installed, you should now be able to launch exui by entering ```python server.py``` in the Terminal.

0 commit comments

Comments
 (0)