From 9114b6d7eaf6274584a4bf5d6b29b6e09b926dc6 Mon Sep 17 00:00:00 2001 From: ModelHub XC Date: Wed, 20 May 2026 16:04:33 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=96=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=EF=BC=8C=E7=94=B1ModelHub=20XC=E7=A4=BE=E5=8C=BA=E6=8F=90?= =?UTF-8?q?=E4=BE=9B=E6=A8=A1=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Model: RedHatAI/Meta-Llama-3-8B-Instruct-quantized.w4a16 Source: Original Platform --- .gitattributes | 35 ++++++ README.md | 260 ++++++++++++++++++++++++++++++++++++++++ config.json | 3 + configuration.json | 1 + model.safetensors | 3 + quantize_config.json | 13 ++ special_tokens_map.json | 16 +++ tokenizer.json | 3 + tokenizer_config.json | 3 + 9 files changed, 337 insertions(+) create mode 100644 .gitattributes create mode 100644 README.md create mode 100644 config.json create mode 100644 configuration.json create mode 100644 model.safetensors create mode 100644 quantize_config.json create mode 100644 special_tokens_map.json create mode 100644 tokenizer.json create mode 100644 tokenizer_config.json diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..a6344aa --- /dev/null +++ b/.gitattributes @@ -0,0 +1,35 @@ +*.7z filter=lfs diff=lfs merge=lfs -text +*.arrow filter=lfs diff=lfs merge=lfs -text +*.bin filter=lfs diff=lfs merge=lfs -text +*.bz2 filter=lfs diff=lfs merge=lfs -text +*.ckpt filter=lfs diff=lfs merge=lfs -text +*.ftz filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.h5 filter=lfs diff=lfs merge=lfs -text +*.joblib filter=lfs diff=lfs merge=lfs -text +*.lfs.* filter=lfs diff=lfs merge=lfs -text +*.mlmodel filter=lfs diff=lfs merge=lfs -text +*.model filter=lfs diff=lfs merge=lfs -text +*.msgpack filter=lfs diff=lfs merge=lfs -text +*.npy filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text +*.onnx filter=lfs diff=lfs merge=lfs -text +*.ot filter=lfs diff=lfs merge=lfs -text +*.parquet filter=lfs diff=lfs merge=lfs -text +*.pb filter=lfs diff=lfs merge=lfs -text +*.pickle filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.pt filter=lfs diff=lfs merge=lfs -text +*.pth filter=lfs diff=lfs merge=lfs -text +*.rar filter=lfs diff=lfs merge=lfs -text +*.safetensors filter=lfs diff=lfs merge=lfs -text +saved_model/**/* filter=lfs diff=lfs merge=lfs -text +*.tar.* filter=lfs diff=lfs merge=lfs -text +*.tar filter=lfs diff=lfs merge=lfs -text +*.tflite filter=lfs diff=lfs merge=lfs -text +*.tgz filter=lfs diff=lfs merge=lfs -text +*.wasm filter=lfs diff=lfs merge=lfs -text +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text +*tfevents* filter=lfs diff=lfs merge=lfs -text diff --git a/README.md b/README.md new file mode 100644 index 0000000..acbe740 --- /dev/null +++ b/README.md @@ -0,0 +1,260 @@ +--- +language: +- en +pipeline_tag: text-generation +license: llama3 +license_link: https://llama.meta.com/llama3/license/ +--- + +# Meta-Llama-3-8B-Instruct-quantized.w4a16 + +## Model Overview +- **Model Architecture:** Meta-Llama-3 + - **Input:** Text + - **Output:** Text +- **Model Optimizations:** + - **Weight quantization:** INT4 +- **Intended Use Cases:** Intended for commercial and research use in English. Similarly to [Meta-Llama-3-8B-Instruct](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct), this models is intended for assistant-like chat. +- **Out-of-scope:** Use in any manner that violates applicable laws or regulations (including trade compliance laws). Use in languages other than English. +- **Release Date:** 7/11/2024 +- **Version:** 1.0 +- **License(s):** [Llama3](https://llama.meta.com/llama3/license/) +- **Model Developers:** Neural Magic + +Quantized version of [Meta-Llama-3-8B-Instruct](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct). +It achieves an average score of 67.23 on the [OpenLLM](https://huggingface.co/spaces/open-llm-leaderboard/open_llm_leaderboard) benchmark (version 1), whereas the unquantized model achieves 67.53. + +### Model Optimizations + +This model was obtained by quantizing the weights of [Meta-Llama-3-8B-Instruct](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct) to INT4 data type. +This optimization reduces the number of bits per parameter from 16 to 4, reducing the disk size and GPU memory requirements by approximately 25%. + +Only the weights of the linear operators within transformers blocks are quantized. Symmetric group-wise quantization is applied, in which a linear scaling per group maps the INT4 and floating point representations of the quantized weights. +[AutoGPTQ](https://github.com/AutoGPTQ/AutoGPTQ) is used for quantization with 10% damping factor, group-size as 128 and 512 sequences sampled from [Open-Platypus](https://huggingface.co/datasets/garage-bAInd/Open-Platypus). + + +## Deployment + +### Use with vLLM + +This model can be deployed efficiently using the [vLLM](https://docs.vllm.ai/en/latest/) backend, as shown in the example below. + +```python +from vllm import LLM, SamplingParams +from transformers import AutoTokenizer + +model_id = "neuralmagic/Meta-Llama-3-8B-Instruct-quantized.w4a16" + +sampling_params = SamplingParams(temperature=0.6, top_p=0.9, max_tokens=256) + +tokenizer = AutoTokenizer.from_pretrained(model_id) + +messages = [ + {"role": "system", "content": "You are a pirate chatbot who always responds in pirate speak!"}, + {"role": "user", "content": "Who are you?"}, +] + +prompts = tokenizer.apply_chat_template(messages, tokenize=False, add_generation_prompt=True) + +llm = LLM(model=model_id, tensor_parallel_size=1) + +outputs = llm.generate(prompts, sampling_params) + +generated_text = outputs[0].outputs[0].text +print(generated_text) +``` + +vLLM aslo supports OpenAI-compatible serving. See the [documentation](https://docs.vllm.ai/en/latest/) for more details. + +### Use with transformers + +This model is supported by Transformers leveraging the integration with the [AutoGPTQ](https://github.com/AutoGPTQ/AutoGPTQ) data format. +The following example contemplates how the model can be used using the `generate()` function. + +```python +from transformers import AutoTokenizer, AutoModelForCausalLM + +model_id = "neuralmagic/Meta-Llama-3-8B-Instruct-quantized.w4a16" + +tokenizer = AutoTokenizer.from_pretrained(model_id) +model = AutoModelForCausalLM.from_pretrained( + model_id, + torch_dtype="auto", + device_map="auto", +) + +messages = [ + {"role": "system", "content": "You are a pirate chatbot who always responds in pirate speak!"}, + {"role": "user", "content": "Who are you?"}, +] + +input_ids = tokenizer.apply_chat_template( + messages, + add_generation_prompt=True, + return_tensors="pt" +).to(model.device) + +terminators = [ + tokenizer.eos_token_id, + tokenizer.convert_tokens_to_ids("<|eot_id|>") +] + +outputs = model.generate( + input_ids, + max_new_tokens=256, + eos_token_id=terminators, + do_sample=True, + temperature=0.6, + top_p=0.9, +) +response = outputs[0][input_ids.shape[-1]:] +print(tokenizer.decode(response, skip_special_tokens=True)) +``` + +## Creation + +This model was created by applying the [AutoGPTQ](https://github.com/AutoGPTQ/AutoGPTQ) library as presented in the code snipet below. +Although AutoGPTQ was used for this particular model, Neural Magic is transitioning to using [llm-compressor](https://github.com/vllm-project/llm-compressor) which supports several quantization schemes and models not supported by AutoGPTQ. + +```python +from transformers import AutoTokenizer +from auto_gptq import AutoGPTQForCausalLM, BaseQuantizeConfig +from datasets import load_dataset +import random + +model_id = "meta-llama/Meta-Llama-3-8B-Instruct" + +num_samples = 512 +max_seq_len = 4096 + +tokenizer = AutoTokenizer.from_pretrained(model_id) + +preprocess_fn = lambda example: {"text": "Below is an instruction that describes a task. Write a response that appropriately completes the request.\n\n{text}".format_map(example)} + +dataset_name = "neuralmagic/LLM_compression_calibration" +dataset = load_dataset(dataset_name, split="train") +ds = dataset.shuffle().select(range(num_samples)) +ds = ds.map(preprocess_fn) + +examples = [ + tokenizer( + example["text"], padding=False, max_length=max_seq_len, truncation=True, + ) for example in ds +] + +quantize_config = BaseQuantizeConfig( + bits=4, + group_size=128, + desc_act=True, + model_file_base_name="model", + damp_percent=0.1, +) + +model = AutoGPTQForCausalLM.from_pretrained( + model_id, + quantize_config, + device_map="auto", +) + +model.quantize(examples) +model.save_pretrained("Meta-Llama-3-8B-Instruct-quantized.w4a16") +``` + + + +## Evaluation + +The model was evaluated on the [OpenLLM](https://huggingface.co/spaces/open-llm-leaderboard/open_llm_leaderboard) leaderboard tasks (version 1) with the [lm-evaluation-harness](https://github.com/EleutherAI/lm-evaluation-harness/tree/383bbd54bc621086e05aa1b030d8d4d5635b25e6) (commit 383bbd54bc621086e05aa1b030d8d4d5635b25e6) and the [vLLM](https://docs.vllm.ai/en/stable/) engine, using the following command: +``` +lm_eval \ + --model vllm \ + --model_args pretrained="neuralmagic/Meta-Llama-3-8B-Instruct-quantized.w4a16",dtype=auto,tensor_parallel_size=2,gpu_memory_utilization=0.4,add_bos_token=True,max_model_len=4096 \ + --tasks openllm \ + --batch_size auto +``` + +### Accuracy + +#### Open LLM Leaderboard evaluation scores + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Benchmark + Meta-Llama-3-8B-Instruct + Meta-Llama-3-8B-Instruct-quantized.w4a16(this model) + Recovery +
MMLU (5-shot) + 66.53 + 65.44 + 98.36% +
ARC Challenge (25-shot) + 62.62 + 60.66 + 96.87% +
GSM-8K (5-shot, strict-match) + 75.21 + 72.25 + 96.07% +
Hellaswag (10-shot) + 78.81 + 77.7 + 98.60% +
Winogrande (5-shot) + 76.47 + 75.53 + 98.77% +
TruthfulQA (0-shot) + 45.58 + 51.84 + 113.73% +
Average + 67.53 + 67.23 + 99.56% +
\ No newline at end of file diff --git a/config.json b/config.json new file mode 100644 index 0000000..b4a0f28 --- /dev/null +++ b/config.json @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d1e0d5568591ed07f7fe44264248be738cbc6bb2ce68ad0c5d76fa4cd9b813fb +size 1047 diff --git a/configuration.json b/configuration.json new file mode 100644 index 0000000..bbeeda1 --- /dev/null +++ b/configuration.json @@ -0,0 +1 @@ +{"framework": "pytorch", "task": "text-generation", "allow_remote": true} \ No newline at end of file diff --git a/model.safetensors b/model.safetensors new file mode 100644 index 0000000..ed8e650 --- /dev/null +++ b/model.safetensors @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a821c5702b42444df25945aba220b5bfd8a3f8c35ecd8739e1c6111ef125e1e8 +size 5732943784 diff --git a/quantize_config.json b/quantize_config.json new file mode 100644 index 0000000..1304c61 --- /dev/null +++ b/quantize_config.json @@ -0,0 +1,13 @@ +{ + "bits": 4, + "group_size": 128, + "damp_percent": 0.1, + "desc_act": true, + "static_groups": false, + "sym": true, + "true_sequential": true, + "model_name_or_path": null, + "model_file_base_name": "model", + "quant_method": "gptq", + "checkpoint_format": "gptq" +} \ No newline at end of file diff --git a/special_tokens_map.json b/special_tokens_map.json new file mode 100644 index 0000000..02ee80b --- /dev/null +++ b/special_tokens_map.json @@ -0,0 +1,16 @@ +{ + "bos_token": { + "content": "<|begin_of_text|>", + "lstrip": false, + "normalized": false, + "rstrip": false, + "single_word": false + }, + "eos_token": { + "content": "<|eot_id|>", + "lstrip": false, + "normalized": false, + "rstrip": false, + "single_word": false + } +} diff --git a/tokenizer.json b/tokenizer.json new file mode 100644 index 0000000..10a4d5a --- /dev/null +++ b/tokenizer.json @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d4015e3d1c556e924ede3e6a5328d3fd47a6be75cd662730e0a61e4df515d951 +size 9085797 diff --git a/tokenizer_config.json b/tokenizer_config.json new file mode 100644 index 0000000..a251eec --- /dev/null +++ b/tokenizer_config.json @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:da0e3a7cce6e4d787e85eb1c24d548420e0d7fe2c7a214e192795c46e40d75bb +size 50977