magpie

This is the official repository for "Alignment Data Synthesis from Scratch by Prompting Aligned LLMs with Nothing". Magpie generates high-quality alignment data by prompting aligned LLMs with their pre-query templates. Unlike many existing synthetic data generation methods, Magpie doesn't rely on prompt engineering or seed questions for generating synthetic data. Instead, it uses the prompt template of an aligned LLM to generate both the user query and an LLM response.

• 🤗 Huggingface (Models and Datasets)
• 🧭 Dataset Navigation
• 🕸️ Website
• 📄 Technical Report
• 🤗 Magpie Demo (Thanks a lot for the implementation from @davanstrien!)
• 🐦 Chat with Magpie

🐦 News

• [2024/09/17] Ship two new models with SOTA performance: 𝙼𝚊𝚐𝚙𝚒𝚎𝙻𝙼-𝙲𝚑𝚊𝚝 (4B & 8B)! See collection here!
• [2024/08/19] Three preference optimization datasets, Magpie-Air-DPO-100K-v0.1, Magpie-Pro-DPO-100K-v0.1, and Magpie-Llama-3.1-Pro-DPO-100K-v0.1 are out!
• [2024/07/25] Magpie Llama-3.1 dataset is out! 1M from Meta-Llama-3.1-70B-Instruct! More friendly license compared with Llama-3 😃!
• [2024/07/21] Magpie Gemma2 dataset is out! 534K from Gemma-2-27b-it!
• [2024/07/19] Llama-3-8B-Magpie-Align-v0.3 is out with enhanced Chinese question-answering ability, thanks to our new Chinese instruction dataset!
• [2024/07/14] Llama-3-8B-Magpie-Align-v0.2 is out with enhanced reasoning ability, thanks to our new reasoning booster dataset!
• [2024/07/04] Magpie Qwen2 dataset is out! 1M from Qwen2 72B and 3M from Qwen2 7B.
• [2024/07/03] 🏆 Our open aligned model, Llama-3-8B-Magpie-Align-v0.1 is out! It is 🏆 the best <30B Model in AI2 WildBench Leaderboard! Even better than the official Meta-Llama-3-8B-Instruct model!
• [2024/06/24] Magpie Phi 3 dataset is out! 1M from Phi 3 Medium.
• [2024/06/12] Magpie Llama-3 dataset is out! 1M from Llama-3 70B and 3M from Llama-3 8B.
• [2024/06/12] Magpie technical report is out! Let's make high-quality alignment data open for all!

Magpie Supports

Currently, Magpie has been tested on the Llama-3, Qwen2, Phi 3 and Gemma-2 series. Please submit an issue for more model support.

• ✅: Works so great!
• ⭕️: It works! We can get something interesting, but we may need to apply an additional filter and/or a logit processor.
• ❌: Not work.
• ❓: Untested.

The navigation of all available Magpie datasets can be found here.

We hope Magpie can contribute to the democratization of AI with enhanced transparency of model alignment processes!

Abstract

Overview

Installation

Build environment

git clone https://github.com/magpie-align/magpie.git
cd magpie
conda create -n magpie python=3.10 -y
conda activate magpie
pip install -r requirements.txt

Get access to Llama-3 models from 🤗 Huggingface

You can apply for Llama-3 model access here. To login in the terminal, enter:

huggingface-cli login

then enter your Huggingface private key beginning with "hf_".

Toy Example

Play with Jupyter Notebook

The toy example can be found in demo.ipynb. Have fun!

Batched Data Generation

We use Llama-3-8B-Instruct as an example to demonstrate the batched data generation process. To run batched generation, you can simply run:

cd scripts
bash magpie.sh

The script will generate both instructions and responses in the data folder. It has been tested on an RTX 4090 24G GPU. If you are using GPUs with less memory, consider implementing quantization.

We also provide scripts for other models in the scripts folder. You can use this navigation to find specific Magpie scripts. Note that for model sizes greater than 8B, you may need 4*A100 GPUs to run the scripts.

Batched Multi-turn Data Generation [Optional]

After generating instruction-response pairs, you can extend them to multi-turn conversations. To do so, simply run the following command:

bash magpie-multi-turn.sh ***_ins_res.json

where ***_ins_res.json is the single-turn instruction-response pairs generated in the previous step.

Dataset Filtering

1. Tagging

To tag the generated instruction-response pairs, you can run:

cd scripts
bash unitag.sh ***_ins_res.json all

This script will automatically generate quality, difficulty, task category, safety, reward, and language for the generated dataset. You can also generate one tag at a time. For example, if you just want to generate the safety label using device 0, you can run:

cd scripts
bash unitag.sh ***_ins_res.json safety 0

2. Data Concatenation and Converting

You may generate datasets with different generation configurations. We provide a Jupyter notebook here for concatenating all datasets and converting them to ShareGPT format, which is fully supported by Axolotl for fine-tuning.

3. Removing Repetition

Once you have a full dataset converted to ShareGPT format, you can calculate the minimum neighbor distance of each instruction and remove repetitions. To do so, run:

cd exp
python gen_dis.py --input_file ***_sharegpt.jsonl

where ***_sharegpt.jsonl is the dataset path obtained in the previous step. The Python script will take care of building the FAISS index and calculating the minimum distance.

4. Design and Apply Your Filter

We provide a Jupyter notebook here for simple filtering. You can adjust the filtering parameters to design and apply your own filter based on your needs.

Fine-tuning

Please take a look at the recipes directory for instructions and our Magpie model recipes.

Citation

If you find the model, data, or code useful, please cite our paper 🤩:

@article{xu2024magpie,
  title={Magpie: Alignment Data Synthesis from Scratch by Prompting Aligned LLMs with Nothing},
  author={Zhangchen Xu and Fengqing Jiang and Luyao Niu and Yuntian Deng and Radha Poovendran and Yejin Choi and Bill Yuchen Lin},
  journal={ArXiv},
  year={2024},
  volume={abs/2406.08464},
  url={https://api.semanticscholar.org/CorpusID:270391432}
}

Star History