Update README.md
Browse files
README.md
CHANGED
@@ -1,3 +1,59 @@
|
|
1 |
-
---
|
2 |
-
|
3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
library_name: transformers
|
3 |
+
license: apache-2.0
|
4 |
+
language:
|
5 |
+
- en
|
6 |
+
tags:
|
7 |
+
- llama-cpp
|
8 |
+
- gguf
|
9 |
+
- quantized
|
10 |
+
- smol
|
11 |
+
- tulu
|
12 |
+
base_model:
|
13 |
+
- SultanR/SmolTulu-1.7b-Instruct
|
14 |
+
pipeline_tag: text-generation
|
15 |
+
---
|
16 |
+
|
17 |
+
# SmolTulu.GGUF
|
18 |
+
|
19 |
+
This is the GGUF version of [SmolTulu-1.7b-Instruct](https://huggingface.co/SultanR/SmolTulu-1.7b-Instruct), quantized to Q4_K_M!
|
20 |
+
|
21 |
+
## Use with llama.cpp
|
22 |
+
Install llama.cpp through brew (works on Mac and Linux)
|
23 |
+
|
24 |
+
```bash
|
25 |
+
brew install llama.cpp
|
26 |
+
|
27 |
+
```
|
28 |
+
Invoke the llama.cpp server or the CLI.
|
29 |
+
|
30 |
+
### CLI:
|
31 |
+
```bash
|
32 |
+
llama-cli --hf-repo SultanR/SmolTulu-1.7b-Instruct-GGUF --hf-file smoltulu-1.7b-instruct-q4_k_m.gguf -p "The meaning to life and the universe is"
|
33 |
+
```
|
34 |
+
|
35 |
+
### Server:
|
36 |
+
```bash
|
37 |
+
llama-server --hf-repo SultanR/SmolTulu-1.7b-Instruct-GGUF --hf-file smoltulu-1.7b-instruct-q4_k_m.gguf -c 2048
|
38 |
+
```
|
39 |
+
|
40 |
+
Note: You can also use this checkpoint directly through the [usage steps](https://github.com/ggerganov/llama.cpp?tab=readme-ov-file#usage) listed in the Llama.cpp repo as well.
|
41 |
+
|
42 |
+
Step 1: Clone llama.cpp from GitHub.
|
43 |
+
```
|
44 |
+
git clone https://github.com/ggerganov/llama.cpp
|
45 |
+
```
|
46 |
+
|
47 |
+
Step 2: Move into the llama.cpp folder and build it with `LLAMA_CURL=1` flag along with other hardware-specific flags (for ex: LLAMA_CUDA=1 for Nvidia GPUs on Linux).
|
48 |
+
```
|
49 |
+
cd llama.cpp && LLAMA_CURL=1 make
|
50 |
+
```
|
51 |
+
|
52 |
+
Step 3: Run inference through the main binary.
|
53 |
+
```
|
54 |
+
./llama-cli --hf-repo SultanR/SmolTulu-1.7b-Instruct-GGUF --hf-file smoltulu-1.7b-instruct-q4_k_m.gguf -p "The meaning to life and the universe is"
|
55 |
+
```
|
56 |
+
or
|
57 |
+
```
|
58 |
+
./llama-server --hf-repo SultanR/SmolTulu-1.7b-Instruct-GGUF --hf-file smoltulu-1.7b-instruct-q4_k_m.gguf -c 2048
|
59 |
+
```
|