Llama SEA LION V3 8B IT

🚀 Llama-SEA-LION-v3-8B-IT

SEA-LION is a collection of Large Language Models (LLMs) pretrained and instruct - tuned for the Southeast Asia (SEA) region, aiming to provide language - related services in multiple Southeast Asian languages.

🚀 Quick Start

Llama-SEA-LION-v3-8B-IT can be run using the 🤗 Transformers library. Here is a basic code example:

import transformers
import torch

model_id = "aisingapore/Llama-SEA-LION-v3-8B-IT"

pipeline = transformers.pipeline(
    "text-generation",
    model=model_id,
    model_kwargs={"torch_dtype": torch.bfloat16},
    device_map="auto",
)
messages = [
    {"role": "user", "content": "Apa sentimen dari kalimat berikut ini?\nKalimat: Buku ini sangat membosankan.\nJawaban: "},
]

outputs = pipeline(
    messages,
    max_new_tokens=256,
)
print(outputs[0]["generated_text"][-1])

✨ Features

• Multilingual Support: Supports multiple Southeast Asian languages, including Burmese, Chinese, English, Filipino, Indonesia, Javanese, Khmer, Lao, Malay, Sundanese, Tamil, Thai, and Vietnamese.
• Instruction - Following: It is an instruction - following model, capable of handling various tasks based on user instructions.

📦 Installation

The model can be used through the 🤗 Transformers library. You can install the Transformers library using the following command:

pip install transformers torch

💻 Usage Examples

Basic Usage

import transformers
import torch

model_id = "aisingapore/Llama-SEA-LION-v3-8B-IT"

pipeline = transformers.pipeline(
    "text-generation",
    model=model_id,
    model_kwargs={"torch_dtype": torch.bfloat16},
    device_map="auto",
)
messages = [
    {"role": "user", "content": "Apa sentimen dari kalimat berikut ini?\nKalimat: Buku ini sangat membosankan.\nJawaban: "},
]

outputs = pipeline(
    messages,
    max_new_tokens=256,
)
print(outputs[0]["generated_text"][-1])

Advanced Usage

If you want to access older revisions of the model, you can use the revision parameter:

import transformers
import torch

model_id = "aisingapore/Llama-SEA-LION-v3-8B-IT"

pipeline = transformers.pipeline(
    "text-generation",
    model=model_id,
    model_kwargs={"torch_dtype": torch.bfloat16},
    revision="18.12.2024", # Specify the revision here.
    device_map="auto",
)
messages = [
    {"role": "user", "content": "Apa sentimen dari kalimat berikut ini?\nKalimat: Buku ini sangat membosankan.\nJawaban: "},
]

outputs = pipeline(
    messages,
    max_new_tokens=256,
)
print(outputs[0]["generated_text"][-1])

📚 Documentation

Model Details

Model Description

We performed instruction tuning in English and also in SEA languages such as Indonesian, Javanese, Sundanese, Tamil, Thai and Vietnamese on our continued pre - trained Llama-SEA-LION-v3-8B, a decoder model using the Llama 3.1 architecture, to create Llama-SEA-LION-v3-8B-IT.

For tokenisation, the model employs the default tokenizer used in Llama 3.1 8B Instruct. The model has a context length of 128k.

Benchmark Performance

We evaluated Llama-SEA-LION-v3-8B-IT on both general language capabilities and instruction - following capabilities.

General Language Capabilities

For the evaluation of general language capabilities, we employed the SEA - HELM evaluation benchmark across a variety of tasks. These tasks include Question Answering (QA), Sentiment Analysis (Sentiment), Toxicity Detection (Toxicity), Translation in both directions (Eng>Lang & Lang>Eng), Abstractive Summarisation (Abssum), Causal Reasoning (Causal), Natural Language Inference (NLI), and linguistic diagnostics (LINDSEA).

Note: SEA - HELM is implemented using prompts to elicit answers in a strict format. For all tasks, the model is expected to provide an answer tag from which the answer is automatically extracted. For tasks where options are provided, the answer should comprise one of the pre - defined options. The scores for each task is normalised to account for baseline performance due to random chance.

The evaluation was done zero - shot with native prompts on a sample of 100 - 1000 instances for each dataset.

Instruction - Following Capabilities

Since Llama-SEA-LION-v3-8B-IT is an instruction - following model, we also evaluated it on instruction - following capabilities with two datasets, SEA - IFEval (based on IFEval) and SEA - MTBench (based on MT - Bench).

As these two datasets were originally in English, the linguists and native speakers in the team worked together to filter, localise and translate the datasets into the respective target languages to ensure that the examples remained reasonable, meaningful and natural.

SEA - IFEval

SEA - IFEval evaluates a model's ability to adhere to constraints provided in the prompt, for example beginning a response with a specific word/phrase or answering with a certain number of sections. Additionally, accuracy is normalised by the proportion of responses in the correct language (if the model performs the task correctly but responds in the wrong language, it is judged to have failed the task).

SEA - MTBench

SEA - MTBench evaluates a model's ability to engage in multi - turn (2 turns) conversations and respond in ways that align with human needs. We use gpt - 4 - 1106 - preview as the judge model and compare against gpt - 3.5 - turbo - 0125 as the baseline model. The metric used is the weighted win rate against the baseline model (i.e. average win rate across each category: Math, Reasoning, STEM, Humanities, Roleplay, Writing, Extraction). A tie is given a score of 0.5.

For more details on Llama-SEA-LION-v3-8B-IT benchmark performance, please refer to the SEA - HELM leaderboard, https://leaderboard.sea - lion.ai/.

Caveats

It is important for users to be aware that our model exhibits certain limitations that warrant consideration. Like many LLMs, the model can hallucinate and occasionally generates irrelevant content, introducing fictional elements that are not grounded in the provided context. Users should also exercise caution in interpreting and validating the model's responses due to the potential inconsistencies in its reasoning.

Limitations

Safety

Current SEA - LION models, including this commercially permissive release, have not been aligned for safety. Developers and users should perform their own safety fine - tuning and related security measures. In no event shall the authors be held liable for any claim, damages, or other liability arising from the use of the released weights and codes.

🔧 Technical Details

• Model Type: Decoder
• Tokenization: Uses the default tokenizer of Llama 3.1 8B Instruct
• Context Length: 128k

📄 License

The model is under the [Llama 3.1 Community License](https://huggingface.co/meta - llama/Llama - 3.1 - 8B - Instruct/blob/main/LICENSE).

Call for Contributions

We encourage researchers, developers, and language enthusiasts to actively contribute to the enhancement and expansion of SEA - LION. Contributions can involve identifying and reporting bugs, sharing pre - training, instruction, and preference data, improving documentation usability, proposing and implementing new model evaluation tasks and metrics, or training versions of the model in additional Southeast Asian languages. Join us in shaping the future of SEA - LION by sharing your expertise and insights to make these models more accessible, accurate, and versatile. Please check out our GitHub for further information on the call for contributions.

The Team

Chan Adwin, Cheng Nicholas, Choa Esther, Huang Yuli, Hulagadri Adithya Venkatadri, Lau Wayne, Lee Chwan Ren, Leong Wai Yi, Leong Wei Qi, Limkonchotiwat Peerat, Liu Bing Jie Darius, Montalan Jann Railey, Ng Boon Cheong Raymond, Ngui Jian Gang, Nguyen Thanh Ngan, Ong Brandon, Ong Tat - Wee David, Ong Zhi Hao, Rengarajan Hamsawardhini, Siow Bryan, Susanto Yosephine, Tai Ngee Chia, Tan Choon Meng, Teng Walter, Teo Eng Sipp Leslie, Teo Wei Yi, Tjhi William, Yeo Yeow Tong, Yong Xianbin

Acknowledgements

AI Singapore is a national programme supported by the National Research Foundation, Singapore and hosted by the National University of Singapore. Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not reflect the views of the National Research Foundation or the National University of Singapore.

Contact

For more info, please contact us using this SEA - LION Inquiry Form

Link to SEA - LION's GitHub repository

Disclaimer

This is the repository for the commercial instruction - tuned model. The model has not been aligned for safety. Developers and users should perform their own safety fine - tuning and related security measures. In no event shall the authors be held liable for any claims, damages, or other liabilities arising from the use of the released weights and codes.