README.md

---
license: llama3.1
language:
  - en
tags:
  - llama3.1
  - rag
  - brag
  - chatrag
  - chatqa
---
# BRAG-Llama-3.1-8b-v0.1 Model Card

## Model Description

BRAG-Llama-3.1-8b-v0.1 is part of the [BRAG series of SLMs (Small Language Models)](https://huggingface.co/collections/maximalists/brag-v01-66aefc10e3a6c29c496c7476), specifically trained for RAG (Retrieval-Augmented Generation) tasks, including:

	1.	RAG with tables and text.
	2.	RAG with conversational chat.

**Authors**: [Pratik Bhavasar](https://www.linkedin.com/in/bhavsarpratik/), [Ravi Theja](https://www.linkedin.com/in/ravidesetty/)

## Key Features

- **Capabilities**: RAG tasks with both tables and text, as well as conversational chat.
- **Model Size**: 8 billion parameters
- **Context Length**: Supports up to 128k tokens
- **Language**: Trained and evaluated for English, but the base model has multi-lingual capabilities.

## Other Resources

[BRAG-v0.1 Model Collection](https://huggingface.co/collections/maximalists/brag-v01-66aefc10e3a6c29c496c7476) | [Blog](https://themaximalists.substack.com/p/brag)

## Performance

| Model Type | Model Name                | Model Size | Context Length | ChatRAG-Bench (all) |
|------------|---------------------------|------------|----------------|---------------------|
| LLM        | Command-R-Plus            | --         | 128k           | 50.93               |
| LLM        | GPT-4-Turbo-2024-04-09    | --         | 128k           | 54.03               |
| SLM        | ChatQA-1.5-8B             | 8b         | 8k             | 55.17               |
| BRAG SLM   | BRAG-Qwen2-7b-v0.1        | 7b         | 128k           | 53.23               |
| BRAG SLM   | BRAG-Llama-3.1-8b-v0.1    | 8b         | 128k           | 52.29               |
| BRAG SLM   | BRAG-Llama-3-8b-v0.1      | 8b         | 8k             | 51.70               |
| BRAG Ultra SLM | BRAG-Qwen2-1.5b-v0.1      | 1.5b       | 32k            | 46.43               |

## Usage

#### Prompt Format

Below is the message prompt format required for using the model.

```
messages = [
    {"role": "system", "content": "You are an assistant who gives helpful, detailed, and polite answers to the user's questions based on the context with appropriate reasoning as required. Indicate when the answer cannot be found in the context."},
    {"role": "user", "content": """Context: <CONTEXT INFORMATION> \n\n <USER QUERY>"""},
]

```

#### Running with the `pipeline` API

```python
import transformers
import torch

model_id = "maximalists/BRAG-Llama-3.1-8b-v0.1"

pipeline = transformers.pipeline(
    "text-generation",
    model=model_id,
    model_kwargs={"torch_dtype": torch.bfloat16},
    device_map="auto",
)

messages = [
    {"role": "system", "content": "You are an assistant who gives helpful, detailed, and polite answers to the user's questions based on the context with appropriate reasoning as required. Indicate when the answer cannot be found in the context."},
    {"role": "user", "content": """Context:\nArchitecturally, the school has a Catholic character. Atop the Main Building\'s gold dome is a golden statue of the Virgin Mary. Immediately in front of the Main Building and facing it, is a copper statue of Christ with arms upraised with the legend "Venite Ad Me Omnes". Next to the Main Building is the Basilica of the Sacred Heart. Immediately behind the basilica is the Grotto, a Marian place of prayer and reflection. It is a replica of the grotto at Lourdes, France where the Virgin Mary reputedly appeared to Saint Bernadette Soubirous in 1858. At the end of the main drive (and in a direct line that connects through 3 statues and the Gold Dome), is a simple, modern stone statue of Mary.\n\nTo whom did the Virgin Mary allegedly appear in 1858 in Lourdes France?"""},
]

outputs = pipeline(
    messages,
    max_new_tokens=256,
)

print(outputs[0]["generated_text"][-1])
```

#### Running the model on a single / multi GPU

```python
# pip install accelerate
from transformers import AutoTokenizer, AutoModelForCausalLM
import torch

model_id = "maximalists/BRAG-Llama-3.1-8b-v0.1"

tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForCausalLM.from_pretrained(
    model_id,
    device_map="auto",
)

messages = [
    {"role": "system", "content": "You are an assistant who gives helpful, detailed, and polite answers to the user's questions based on the context with appropriate reasoning as required. Indicate when the answer cannot be found in the context."},
    {"role": "user", "content": """Context:\nArchitecturally, the school has a Catholic character. Atop the Main Building\'s gold dome is a golden statue of the Virgin Mary. Immediately in front of the Main Building and facing it, is a copper statue of Christ with arms upraised with the legend "Venite Ad Me Omnes". Next to the Main Building is the Basilica of the Sacred Heart. Immediately behind the basilica is the Grotto, a Marian place of prayer and reflection. It is a replica of the grotto at Lourdes, France where the Virgin Mary reputedly appeared to Saint Bernadette Soubirous in 1858. At the end of the main drive (and in a direct line that connects through 3 statues and the Gold Dome), is a simple, modern stone statue of Mary.\n\nTo whom did the Virgin Mary allegedly appear in 1858 in Lourdes France?"""},
]

text = tokenizer.apply_chat_template(
    messages,
    tokenize=False,
    add_generation_prompt=True
)
model_inputs = tokenizer([text], return_tensors="pt").to("cuda")

generated_ids = model.generate(
    model_inputs.input_ids,
    max_new_tokens=256
)
generated_ids = [
    output_ids[len(input_ids):] for input_ids, output_ids in zip(model_inputs.input_ids, generated_ids)
]

response = tokenizer.batch_decode(generated_ids, skip_special_tokens=True)[0]

print(response)
```


## Limitations

The model is specifically trained for short contexts and may not perform well with longer ones. It has been fine-tuned on an English dataset. To avoid underperformance and the potential for hallucinations, please use the system prompt mentioned above.

## Citation

To cite this model, please use the following:

```bibtex
@misc{BRAG-Llama-3.1-8b-v0.1,
  title = {BRAG-Llama-3.1-8b-v0.1},
  year = {2024},
  publisher = {HuggingFace},
  url = {https://huggingface.co/maximalists/BRAG-Llama-3.1-8b-v0.1},
  author = {Pratik Bhavsar and Ravi Theja}
}
```

## Additional Information

For more details on the BRAG series and updates, please refer to the official [blog](https://themaximalists.substack.com/p/brag).