mirror of
https://git.adityakumar.xyz/llama.cpp.git
synced 2024-11-09 15:29:43 +00:00
Updating build instructions to include BLAS support (#1183)
* Updated build information First update to the build instructions to include BLAS. * Update README.md * Update information about BLAS * Better BLAS explanation Adding a clearer BLAS explanation and adding a link to download the CUDA toolkit. * Better BLAS explanation * BLAS for Mac Specifying that BLAS is already supported on Macs using the Accelerate Framework. * Clarify the effect of BLAS * Windows Make instructions Added the instructions to build with Make on Windows * Fixing typo * Fix trailing whitespace
This commit is contained in:
parent
859fee6dfb
commit
ea3ad7eb60
1 changed files with 78 additions and 7 deletions
85
README.md
85
README.md
|
@ -167,15 +167,27 @@ cd llama.cpp
|
||||||
|
|
||||||
### Build
|
### Build
|
||||||
|
|
||||||
Note: For Windows, CMake or Zig can be used.
|
In order to build llama.cpp you have three different options.
|
||||||
|
|
||||||
1. Use `make`
|
- Using `make`:
|
||||||
|
- On Linux or MacOS:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
make
|
make
|
||||||
```
|
```
|
||||||
|
|
||||||
1. Use CMake
|
- On Windows:
|
||||||
|
|
||||||
|
1. Download the latest fortran version of [w64devkit](https://github.com/seeto/w64devkit/releases).
|
||||||
|
2. Extract `w64devkit` on your pc.
|
||||||
|
3. Run `w64devkit.exe`.
|
||||||
|
4. Use the `cd` command to reach the `llama.cpp` folder.
|
||||||
|
5. From here you can run:
|
||||||
|
```bash
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
- Using `CMake`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mkdir build
|
mkdir build
|
||||||
|
@ -184,12 +196,71 @@ Note: For Windows, CMake or Zig can be used.
|
||||||
cmake --build . --config Release
|
cmake --build . --config Release
|
||||||
```
|
```
|
||||||
|
|
||||||
1. Use Zig
|
- Using `Zig`:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
zig build -Drelease-fast
|
zig build -Drelease-fast
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### BLAS Build
|
||||||
|
|
||||||
|
Building the program with BLAS support may lead to some performance improvements in prompt processing using batch sizes higher than 32 (the default is 512). BLAS doesn't affect the normal generation performance. There are currently three different implementations of it:
|
||||||
|
|
||||||
|
- Accelerate Framework:
|
||||||
|
|
||||||
|
This is only available on Mac PCs and it's enabled by default. You can just build using the normal instructions.
|
||||||
|
|
||||||
|
- OpenBLAS:
|
||||||
|
|
||||||
|
This provides BLAS acceleration using only the CPU. Make sure to have OpenBLAS installed on your machine.
|
||||||
|
|
||||||
|
- Using `make`:
|
||||||
|
- On Linux:
|
||||||
|
```bash
|
||||||
|
make LLAMA_OPENBLAS=1
|
||||||
|
```
|
||||||
|
Note: In order to build on Arch Linux with OpenBLAS support enabled you must edit the Makefile adding at the end of the line 105: `-lcblas`
|
||||||
|
|
||||||
|
- On Windows:
|
||||||
|
|
||||||
|
1. Download the latest fortran version of [w64devkit](https://github.com/skeeto/w64devkit/releases).
|
||||||
|
2. Download the latest version of [OpenBLAS for Windows](https://github.com/xianyi/OpenBLAS/releases).
|
||||||
|
3. Extract `w64devkit` on your pc.
|
||||||
|
4. From the OpenBLAS zip that you just downloaded copy `libopenblas.a`, located inside the `lib` folder, inside `w64devkit\x86_64-w64-mingw32\lib`.
|
||||||
|
5. From the same OpenBLAS zip copy the content of the `include` folder inside `w64devkit\x86_64-w64-mingw32\include`.
|
||||||
|
6. Run `w64devkit.exe`.
|
||||||
|
7. Use the `cd` command to reach the `llama.cpp` folder.
|
||||||
|
8. From here you can run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make LLAMA_OPENBLAS=1
|
||||||
|
```
|
||||||
|
|
||||||
|
- Using `CMake` on Linux:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdir build
|
||||||
|
cd build
|
||||||
|
cmake .. -DLLAMA_OPENBLAS=ON
|
||||||
|
cmake --build . --config Release
|
||||||
|
```
|
||||||
|
|
||||||
|
- cuBLAS
|
||||||
|
|
||||||
|
This provides BLAS acceleration using the CUDA cores of your Nvidia GPU. Make sure to have the CUDA toolkit installed. You can download it from your Linux distro's package manager or from here: [CUDA Toolkit](https://developer.nvidia.com/cuda-downloads).
|
||||||
|
- Using `make`:
|
||||||
|
```bash
|
||||||
|
make LLAMA_CUBLAS=1
|
||||||
|
```
|
||||||
|
- Using `CMake`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdir build
|
||||||
|
cd build
|
||||||
|
cmake .. -DLLAMA_CUBLAS=ON
|
||||||
|
cmake --build . --config Release
|
||||||
|
```
|
||||||
|
|
||||||
### Prepare Data & Run
|
### Prepare Data & Run
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|
Loading…
Reference in a new issue