slimfrikha-tii
commited on
Commit
•
464fa53
0
Parent(s):
falcon3 release
Browse files- .gitattributes +44 -0
- Falcon3-3B-Instruct-f16.gguf +3 -0
- Falcon3-3B-Instruct-q2_k.gguf +3 -0
- Falcon3-3B-Instruct-q3_k_m.gguf +3 -0
- Falcon3-3B-Instruct-q4_0.gguf +3 -0
- Falcon3-3B-Instruct-q4_k_m.gguf +3 -0
- Falcon3-3B-Instruct-q5_0.gguf +3 -0
- Falcon3-3B-Instruct-q5_k_m.gguf +3 -0
- Falcon3-3B-Instruct-q6_k.gguf +3 -0
- Falcon3-3B-Instruct-q8_0.gguf +3 -0
- README.md +121 -0
.gitattributes
ADDED
@@ -0,0 +1,44 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
*.7z filter=lfs diff=lfs merge=lfs -text
|
2 |
+
*.arrow filter=lfs diff=lfs merge=lfs -text
|
3 |
+
*.bin filter=lfs diff=lfs merge=lfs -text
|
4 |
+
*.bz2 filter=lfs diff=lfs merge=lfs -text
|
5 |
+
*.ckpt filter=lfs diff=lfs merge=lfs -text
|
6 |
+
*.ftz filter=lfs diff=lfs merge=lfs -text
|
7 |
+
*.gz filter=lfs diff=lfs merge=lfs -text
|
8 |
+
*.h5 filter=lfs diff=lfs merge=lfs -text
|
9 |
+
*.joblib filter=lfs diff=lfs merge=lfs -text
|
10 |
+
*.lfs.* filter=lfs diff=lfs merge=lfs -text
|
11 |
+
*.mlmodel filter=lfs diff=lfs merge=lfs -text
|
12 |
+
*.model filter=lfs diff=lfs merge=lfs -text
|
13 |
+
*.msgpack filter=lfs diff=lfs merge=lfs -text
|
14 |
+
*.npy filter=lfs diff=lfs merge=lfs -text
|
15 |
+
*.npz filter=lfs diff=lfs merge=lfs -text
|
16 |
+
*.onnx filter=lfs diff=lfs merge=lfs -text
|
17 |
+
*.ot filter=lfs diff=lfs merge=lfs -text
|
18 |
+
*.parquet filter=lfs diff=lfs merge=lfs -text
|
19 |
+
*.pb filter=lfs diff=lfs merge=lfs -text
|
20 |
+
*.pickle filter=lfs diff=lfs merge=lfs -text
|
21 |
+
*.pkl filter=lfs diff=lfs merge=lfs -text
|
22 |
+
*.pt filter=lfs diff=lfs merge=lfs -text
|
23 |
+
*.pth filter=lfs diff=lfs merge=lfs -text
|
24 |
+
*.rar filter=lfs diff=lfs merge=lfs -text
|
25 |
+
*.safetensors filter=lfs diff=lfs merge=lfs -text
|
26 |
+
saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
27 |
+
*.tar.* filter=lfs diff=lfs merge=lfs -text
|
28 |
+
*.tar filter=lfs diff=lfs merge=lfs -text
|
29 |
+
*.tflite filter=lfs diff=lfs merge=lfs -text
|
30 |
+
*.tgz filter=lfs diff=lfs merge=lfs -text
|
31 |
+
*.wasm filter=lfs diff=lfs merge=lfs -text
|
32 |
+
*.xz filter=lfs diff=lfs merge=lfs -text
|
33 |
+
*.zip filter=lfs diff=lfs merge=lfs -text
|
34 |
+
*.zst filter=lfs diff=lfs merge=lfs -text
|
35 |
+
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
36 |
+
Falcon3-3B-Instruct-f16.gguf filter=lfs diff=lfs merge=lfs -text
|
37 |
+
Falcon3-3B-Instruct-q2_k.gguf filter=lfs diff=lfs merge=lfs -text
|
38 |
+
Falcon3-3B-Instruct-q3_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
39 |
+
Falcon3-3B-Instruct-q4_0.gguf filter=lfs diff=lfs merge=lfs -text
|
40 |
+
Falcon3-3B-Instruct-q4_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
41 |
+
Falcon3-3B-Instruct-q5_0.gguf filter=lfs diff=lfs merge=lfs -text
|
42 |
+
Falcon3-3B-Instruct-q5_k_m.gguf filter=lfs diff=lfs merge=lfs -text
|
43 |
+
Falcon3-3B-Instruct-q6_k.gguf filter=lfs diff=lfs merge=lfs -text
|
44 |
+
Falcon3-3B-Instruct-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
|
Falcon3-3B-Instruct-f16.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:16cfdfa0df7f660499fdee35694c7735db3909365c60653012cea90867078661
|
3 |
+
size 6460328064
|
Falcon3-3B-Instruct-q2_k.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:9e2f03943cbaaeb3649f3ee39ff06668182a269862aa4df98fdb69d34b78ad3c
|
3 |
+
size 1353877632
|
Falcon3-3B-Instruct-q3_k_m.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:4b1523322e752aa51e45a8bd69441807224c41ac45e4324eb043e3ab1f11e7fc
|
3 |
+
size 1673218176
|
Falcon3-3B-Instruct-q4_0.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:fd948cb66bfbf5f26bbe233077d5c5a1f903d043d8088318df0df3667cfb4941
|
3 |
+
size 1924581504
|
Falcon3-3B-Instruct-q4_k_m.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:81c6b52d221c2f0eea3db172fc74de28534f2fd15f198ecbfcc55577d20cbf8a
|
3 |
+
size 2005682304
|
Falcon3-3B-Instruct-q5_0.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:b7efc43bb02240812e3ae85bf133e97d1300361c17838cd791bbcaaaec010782
|
3 |
+
size 2277689472
|
Falcon3-3B-Instruct-q5_k_m.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:c25d040042b7ceaf2d5b285cf1321452d8fe55cfc31e07ae8abc64b3707b3816
|
3 |
+
size 2319468672
|
Falcon3-3B-Instruct-q6_k.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:f2ace4d71e367b99ba76e97465fdcd1d7a40c9291d4d3c0495a65b9c232afb4e
|
3 |
+
size 2652866688
|
Falcon3-3B-Instruct-q8_0.gguf
ADDED
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
1 |
+
version https://git-lfs.github.com/spec/v1
|
2 |
+
oid sha256:1e077c387e9d5f2de17e14d50caaccc968c3ffc12a001f2f8d0cb7ef9e391cc0
|
3 |
+
size 3434530944
|
README.md
ADDED
@@ -0,0 +1,121 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
language:
|
3 |
+
- en
|
4 |
+
- fr
|
5 |
+
- es
|
6 |
+
- pt
|
7 |
+
tags:
|
8 |
+
- falcon3
|
9 |
+
base_model: tiiuae/Falcon3-3B-Instruct
|
10 |
+
license: other
|
11 |
+
license_name: falcon-llm-license
|
12 |
+
license_link: https://falconllm.tii.ae/falcon-terms-and-conditions.html
|
13 |
+
---
|
14 |
+
|
15 |
+
<div align="center">
|
16 |
+
<img src="https://huggingface.co/datasets/tiiuae/documentation-images/resolve/main/general/falco3-logo.png" alt="drawing" width="500"/>
|
17 |
+
</div>
|
18 |
+
|
19 |
+
# Falcon3-3B-Instruct-GGUF
|
20 |
+
|
21 |
+
|
22 |
+
**Falcon3** family of Open Foundation Models is a set of pretrained and instruct LLMs ranging from 1B to 10B parameters.
|
23 |
+
|
24 |
+
**Falcon3-3B-Instruct** achieves strong results on reasoning, language understanding, instruction following, code and mathematics tasks.
|
25 |
+
Falcon3-3B-Instruct supports 4 languages (English, French, Spanish, Portuguese) and a context length of up to 32K.
|
26 |
+
|
27 |
+
This repository contains the GGUFs instruction-tuned 3B Falcon3 model.
|
28 |
+
|
29 |
+
## Model Details
|
30 |
+
- Architecture
|
31 |
+
- Transformer-based causal decoder-only architecture
|
32 |
+
- 22 decoder blocks
|
33 |
+
- Grouped Query Attention (GQA) for faster inference: 12 query heads and 4 key-value heads
|
34 |
+
- Wider head dimension: 256
|
35 |
+
- High RoPE value to support long context understanding: 1000042
|
36 |
+
- Uses SwiGLU and RMSNorm
|
37 |
+
- 32K context length
|
38 |
+
- 131K vocab size
|
39 |
+
- Pruned and healed from Falcon3-7B-Base on only 100 Gigatokens of datasets comprising of web, code, STEM, high quality and mutlilingual data using 1024 H100 GPU chips
|
40 |
+
- Posttrained on 1.2 million samples of STEM, conversational, code, safety and function call data
|
41 |
+
- Supports EN, FR, ES, PT
|
42 |
+
- Developed by [Technology Innovation Institute](https://www.tii.ae)
|
43 |
+
- License: TII Falcon-LLM License 2.0
|
44 |
+
- Model Release Date: December 2024
|
45 |
+
- Quantization: q2_K, q3_K_M, q4_0, q4_K_M, q5_0, q5_K_M, q6_K, q8_0
|
46 |
+
|
47 |
+
|
48 |
+
## Getting started
|
49 |
+
|
50 |
+
### 1. Download GGUF models from hugging face
|
51 |
+
|
52 |
+
First, download the model from Hugging Face. You can use the `huggingface_hub` library or download it manually:
|
53 |
+
|
54 |
+
|
55 |
+
```bash
|
56 |
+
pip install huggingface_hub
|
57 |
+
huggingface-cli download {model_name}
|
58 |
+
```
|
59 |
+
|
60 |
+
This will download the model to your current directory. Make sure to replace {model_name} with the actual username and model name from your Hugging Face repository.
|
61 |
+
|
62 |
+
|
63 |
+
|
64 |
+
## 2. Install llama.cpp
|
65 |
+
|
66 |
+
You have several options for installing llama.cpp:
|
67 |
+
|
68 |
+
**1. Build from source:**
|
69 |
+
|
70 |
+
This gives you the most flexibility and control. Follow the instructions in the llama.cpp repository to build from source:
|
71 |
+
|
72 |
+
```bash
|
73 |
+
|
74 |
+
git clone https://github.com/ggerganov/llama.cpp
|
75 |
+
cd llama.cpp
|
76 |
+
cmake -B build
|
77 |
+
cmake --build build --config Release
|
78 |
+
```
|
79 |
+
|
80 |
+
For more information about how to build llama.cpp from source please refere to llama.cpp documentation on how to build from source: **[llama.cpp build from source](https://github.com/ggerganov/llama.cpp/blob/master/docs/build.md)**.
|
81 |
+
|
82 |
+
**2. Download pre-built binaries:**
|
83 |
+
|
84 |
+
If you prefer a quicker setup, you can download pre-built binaries for your operating system. Check the llama.cpp repository for available binaries.
|
85 |
+
|
86 |
+
**3. Use Docker:**
|
87 |
+
|
88 |
+
For a more contained environment, you can use the official llama.cpp Docker image. Refer to the llama.cpp documentation for instructions on how to use the Docker image.
|
89 |
+
|
90 |
+
For detailed instructions and more information, please check the llama.cpp documentation on docker: **[llama.cpp docker](https://github.com/ggerganov/llama.cpp/blob/master/docs/docker.mdg)**.
|
91 |
+
|
92 |
+
### 3. Start playing with your model
|
93 |
+
|
94 |
+
Run simple text completion
|
95 |
+
```bash
|
96 |
+
llama-cli -m {path-to-gguf-model} -p "I believe the meaning of life is" -n 128
|
97 |
+
```
|
98 |
+
|
99 |
+
Run in conversation mode
|
100 |
+
```bash
|
101 |
+
llama-cli -m {path-to-gguf-model} -p "You are a helpful assistant" -cnv -co
|
102 |
+
```
|
103 |
+
## Useful links
|
104 |
+
- View our [release blogpost](https://huggingface.co/blog/falcon3).
|
105 |
+
- Feel free to join [our discord server](https://discord.gg/fwXpMyGc) if you have any questions or to interact with our researchers and developers.
|
106 |
+
|
107 |
+
## Technical Report
|
108 |
+
Coming soon....
|
109 |
+
|
110 |
+
## Citation
|
111 |
+
If the Falcon3 family of models were helpful to your work, feel free to give us a cite.
|
112 |
+
|
113 |
+
```
|
114 |
+
@misc{Falcon3,
|
115 |
+
title = {The Falcon 3 Family of Open Models},
|
116 |
+
url = {https://huggingface.co/blog/falcon3},
|
117 |
+
author = {Falcon-LLM Team},
|
118 |
+
month = {December},
|
119 |
+
year = {2024}
|
120 |
+
}
|
121 |
+
```
|