Instructions to use mlabonne/Monarch-7B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use mlabonne/Monarch-7B with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="mlabonne/Monarch-7B")

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("mlabonne/Monarch-7B")
model = AutoModelForCausalLM.from_pretrained("mlabonne/Monarch-7B")

Inference
Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use mlabonne/Monarch-7B with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "mlabonne/Monarch-7B"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "mlabonne/Monarch-7B",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Use Docker

docker model run hf.co/mlabonne/Monarch-7B

SGLang

How to use mlabonne/Monarch-7B with SGLang:

Install from pip and serve model

# Install SGLang from pip:
pip install sglang
# Start the SGLang server:
python3 -m sglang.launch_server \
    --model-path "mlabonne/Monarch-7B" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "mlabonne/Monarch-7B",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Use Docker images

docker run --gpus all \
    --shm-size 32g \
    -p 30000:30000 \
    -v ~/.cache/huggingface:/root/.cache/huggingface \
    --env "HF_TOKEN=<secret>" \
    --ipc=host \
    lmsysorg/sglang:latest \
    python3 -m sglang.launch_server \
        --model-path "mlabonne/Monarch-7B" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "mlabonne/Monarch-7B",
		"prompt": "Once upon a time,",
		"max_tokens": 512,
		"temperature": 0.5
	}'

Docker Model Runner
How to use mlabonne/Monarch-7B with Docker Model Runner:
```
docker model run hf.co/mlabonne/Monarch-7B
```
Browse Quantizations to use this model in llama.cpp, Ollama, LM Studio, or any compatible app.

Monarch-7B

Update 13/02/24: Monarch-7B is the best-performing model on the YALL leaderboard.

Monarch-7B is a merge of the following models using LazyMergekit:

🏆 Evaluation

The evaluation was performed using LLM AutoEval on Nous suite. See the entire leaderboard here.

Model	Average	AGIEval	GPT4All	TruthfulQA	Bigbench
Monarch-7B 📄	62.68	45.48	77.07	78.04	50.14
teknium/OpenHermes-2.5-Mistral-7B 📄	52.42	42.75	72.99	52.99	40.94
mlabonne/NeuralHermes-2.5-Mistral-7B 📄	53.51	43.67	73.24	55.37	41.76
mlabonne/NeuralBeagle14-7B 📄	60.25	46.06	76.77	70.32	47.86
eren23/dpo-binarized-NeuralTrix-7B 📄	62.5	44.57	76.34	79.81	49.27
CultriX/NeuralTrix-7B-dpo 📄	62.5	44.61	76.33	79.8	49.24

🧩 Configuration

models:
  - model: mistralai/Mistral-7B-v0.1
    # no parameters necessary for base model
  - model: mlabonne/OmniTruthyBeagle-7B-v0
    parameters:
      density: 0.65
      weight: 0.36
  - model: mlabonne/NeuBeagle-7B
    parameters:
      density: 0.6
      weight: 0.34
  - model: mlabonne/NeuralOmniBeagle-7B 
    parameters:
      density: 0.6
      weight: 0.3
merge_method: dare_ties
base_model: mistralai/Mistral-7B-v0.1
parameters:
  int8_mask: true
dtype: bfloat16
random_seed: 0

💻 Usage

!pip install -qU transformers accelerate

from transformers import AutoTokenizer
import transformers
import torch

model = "mlabonne/Monarch-7B"
messages = [{"role": "user", "content": "What is a large language model?"}]

tokenizer = AutoTokenizer.from_pretrained(model)
prompt = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
pipeline = transformers.pipeline(
    "text-generation",
    model=model,
    torch_dtype=torch.float16,
    device_map="auto",
)

outputs = pipeline(prompt, max_new_tokens=256, do_sample=True, temperature=0.7, top_k=50, top_p=0.95)
print(outputs[0]["generated_text"])

Open LLM Leaderboard Evaluation Results

Detailed results can be found here

Metric	Value
Avg.	76.25
AI2 Reasoning Challenge (25-Shot)	73.04
HellaSwag (10-Shot)	89.03
MMLU (5-Shot)	64.41
TruthfulQA (0-shot)	77.35
Winogrande (5-shot)	84.61
GSM8k (5-shot)	69.07