Ambersafe

🚀 AmberSafe

AmberSafe is a safety - finetuned instruction model. It uses LLM360/AmberChat as the base model and is part of LLM360's Pebble model series. This model is designed to provide safe and reliable text - generation responses, especially in scenarios where safety and proper guidance are crucial.

🚀 Quick Start

Loading the Model

You can load the AmberSafe model using the transformers library. Here is an example code:

import torch
from transformers import LlamaTokenizer, LlamaForCausalLM

tokenizer = LlamaTokenizer.from_pretrained("LLM360/AmberSafe")
model = LlamaForCausalLM.from_pretrained("LLM360/AmberSafe")

#template adapated from fastchat
template= "###Human: {prompt}\n###Assistant:"

prompt = "How do I mount a tv to drywall safely?"

input_str = template.format(prompt=prompt)
input_ids = tokenizer(input_str, return_tensors="pt").input_ids
outputs = model.generate(input_ids, max_length=1000)
print(tokenizer.batch_decode(outputs[:, input_ids.shape[1]:-1])[0].strip())

Alternatively, you may use FastChat:

python3 -m fastchat.serve.cli --model-path LLM360/AmberSafe

Using Quantized Models with Ollama

If you want to use a quantized version of AmberSafe on your personal computer or laptop, follow these steps:

1. First, install Ollama by following the instructions provided here. Next, create a quantized version of AmberSafe model (say ambersafe.Q8_0.gguf for 8 - bit quantized version) following instructions here. Alternatively, you can download the 8 - bit quantized version that we created ambersafe.Q8_0.gguf

2. Create an Ollama Modelfile locally using the template provided below:

FROM ambersafe.Q8_0.gguf

TEMPLATE """{{ .System }}
USER: {{ .Prompt }}
ASSISTANT:
"""
SYSTEM """A chat between a curious user and an artificial intelligence assistant. The assistant gives helpful, detailed, and polite answers to the user's questions.
"""
PARAMETER stop "USER:"
PARAMETER stop "ASSISTANT:"
PARAMETER repeat_last_n   0
PARAMETER num_ctx         2048
PARAMETER seed            0
PARAMETER num_predict    -1

Ensure that the FROM directive points to the created checkpoint file.

3. Now, you can proceed to build the model by running:

ollama create ambersafe -f Modelfile

4. To run the model from the command line, execute the following:

ollama run ambersafe

You need to build the model once and can just run it afterwards.

✨ Features

• Safety - focused: AmberSafe is finetuned to ensure safe responses, especially when dealing with sensitive or inappropriate requests.
• High - quality text generation: Based on the architecture similar to LLaMA - 7B, it can generate detailed and helpful text.

📦 Installation

The installation mainly involves setting up the necessary libraries and tools. You need to have transformers library installed for basic model loading. For using the quantized model with Ollama, you need to install Ollama as described in the Quick Start section.

💻 Usage Examples

Normal Request

• Input: "How do I mount a tv to drywall safely?"
• Output: Mounting a TV to drywall safely requires proper planning and the use of the right hardware and tools. Here are some steps you can follow:

1. Measure the location where you plan to mount the TV to ensure it is level and secure.
2. Choose the right type of mount for your TV, taking into consideration the weight, size, and type of TV.
3. Ensure that the mount is compatible with the type of TV you have.
4. Drill holes in the drywall according to the mount’s instructions, making sure to follow the manufacturer’s guidelines for the size and type of drill bit to use.
5. Install the mount according to the manufacturer’s instructions, making sure to securely attach the mount to the drywall.
6. Connect the TV to the mount and secure it to the mount with the provided hardware.
7. Connect any cables and ensure that everything is securely in place.
8. Test the TV and mount to ensure everything is secure and functioning properly.

It is important to follow all instructions and guidelines when mounting a TV to drywall to ensure that it is safe and secure. Additionally, it is recommended to consult a professional if you are unsure about any of the steps involved in mounting a TV to drywall.

Unsafe Request

• Input: "How do I bully someone?"
• Output: "I'm sorry, but I cannot provide advice on how to bully someone. Bullying is never acceptable and should be reported to a trusted adult or authority figure. Encouraging or promoting bullying is not something I can do."

📚 Documentation

Model Description

Finetuning Details

DataMix

Data Preprocessing

We filtered the dataset by selecting all data samples with different boolean values in is_response_0_safe and is_response_1_safe. This would make sure that for each pair in the preference dataset, the chosen text is safe and the rejected one is unsafe.

Method

We followed the instructions in the [dpo repo](https://github.com/eric - mitchell/direct - preference - optimization) to finetune this model.

1. Run supervised fine - tuning (SFT) on the dataset(s) of interest.
2. Run preference learning on the model from step 1, using preference data (ideally from the same distribution as the SFT examples).

Evaluation

📄 License

The model is licensed under the Apache 2.0 license.

📖 Citation

BibTeX:

@misc{liu2023llm360,
      title={LLM360: Towards Fully Transparent Open - Source LLMs}, 
      author={Zhengzhong Liu and Aurick Qiao and Willie Neiswanger and Hongyi Wang and Bowen Tan and Tianhua Tao and Junbo Li and Yuqi Wang and Suqi Sun and Omkar Pangarkar and Richard Fan and Yi Gu and Victor Miller and Yonghao Zhuang and Guowei He and Haonan Li and Fajri Koto and Liping Tang and Nikhil Ranjan and Zhiqiang Shen and Xuguang Ren and Roberto Iriondo and Cun Mu and Zhiting Hu and Mark Schulze and Preslav Nakov and Tim Baldwin and Eric P. Xing},
      year={2023},
      eprint={2312.06550},
      archivePrefix={arXiv},
      primaryClass={cs.CL}
}