---
base_model: tiiuae/Falcon3-3B-Instruct
library_name: transformers
license: other
license_name: falcon-llm-license
license_link: https://falconllm.tii.ae/falcon-terms-and-conditions.html
tags:
- bitnet
- falcon3
---


![image/png](https://cdn-uploads.huggingface.co/production/uploads/62441d1d9fdefb55a0b7d12c/c-tosr0FvMlKuKQTojx_6.png)


#  Table of Contents

0. [TL;DR](#TL;DR)
1. [Model Details](#model-details)
2. [Training Details](#training-details)
3. [Usage](#usage)
4. [Evaluation](#evaluation)
5. [Citation](#citation)


# TL;DR

# Model Details

## Model Description

- **Developed by:** [https://www.tii.ae](https://www.tii.ae)
- **Model type:** Causal decoder-only - instruct / chat version
- **Architecture:** Pure-transformer - 1.58bit version
- **Language(s) (NLP):** Mainly English
- **License:** TII Falcon License 2.0

# Training details

The model has been trained following the training strategies from the recent [1-bit LLM HF blogpost](https://huggingface.co/blog/1_58_llm_extreme_quantization) and [1-bit LLM paper](https://huggingface.co/papers/2402.17764).
For more details about the training protocol of this model, please refer to the Falcon-3 technical report, section *Compression*.


# Usage

Currently to use this model you can either rely on Hugging Face transformers library or [BitNet](https://github.com/microsoft/BitNet) library. You can also play with the model using the [falcon-1.58bit playground](https://huggingface.co/spaces/tiiuae/falcon3-1.58bit-playground) (only for the 7B instruct version).

## 🤗 transformers

```python
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = "tiiuae/Falcon3-3B-Instruct-1.58bit"

model = AutoModelForCausalLM.from_pretrained(
  model_id,
  torch_dtype=torch.bfloat16,
).to("cuda")

# Perform text generation
```

## BitNet

```
git clone https://github.com/microsoft/BitNet && cd BitNet
pip install -r requirements.txt
python setup_env.py --hf-repo tiiuae/Falcon3-3B-Instruct-1.58bit -q i2_s
python run_inference.py -m models/Falcon3-3B-1.58bit/ggml-model-i2_s.gguf -p "You are a helpful assistant." -cnv
```

# Evaluation
We report in the following table our internal pipeline benchmarks:

**Note evaluation results are normalized score from v2 leaderboard tasks - reported results of original models in the blogpost are raw scores**

<table border="1" style="width: 100%; text-align: center; border-collapse: collapse;">
    <colgroup>
        <col style="width: 10%;">
        <col style="width: 10%;">
        <col style="background-color: rgba(80, 15, 213, 0.5); width: 7%;">
    </colgroup>
    <thead>
        <tr>
            <th>Benchmark</th>
            <th>Llama3-8B-1.58-100B-tokens</th>
            <th>Falcon3-3B-Instruct-1.58bit </th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>IFEval</td>
            <td>17.91</td>
            <td><b>32.52</b></td>
        </tr>      
        <tr>
            <td>MUSR</td>
            <td><b>4.87</b></td>
            <td>2.23</td>
        </tr>
        <tr>
            <td>GPQA</td>
            <td><b>6.95<b></td>
            <td>5.25</td>
        </tr>
        <tr>
            <td>BBH</td>
            <td>5.36</td>
            <td><b>5.79</b></td>
        </tr>
        <tr>
            <td>MMLU-PRO</td>
            <td>2.78</td>
            <td><b>3.41</b></td>
        </tr>      
        <tr>
            <td>MATH</td>
            <td>0.26</td>
            <td><b>0.77</b></td>
        </tr>
        <tr>
            <td>Average</td>
            <td>5.5</td>
            <td><b>8.61</b></td>
        </tr>          
    </tbody>
</table>

## Useful links
- View our [release blogpost](https://huggingface.co/blog/falcon3).
- Feel free to join [our discord server](https://discord.gg/fwXpMyGc) if you have any questions or to interact with our researchers and developers.
  
## Citation
If the Falcon3 family of models were helpful to your work, feel free to give us a cite.

```
@misc{Falcon3,
    title = {The Falcon 3 Family of Open Models},
    author = {Falcon-LLM Team},
    month = {December},
    year = {2024}
}
```