Pixtral 12b FP8 Dynamic

🚀 pixtral-12b-FP8-dynamic

A quantized text-generation model optimized for multi-language commercial and research use, offering efficient inference with vLLM.

✨ Features

• Model Architecture: Pixtral (Llava) with text/image input and text output.
• Optimizations: Weight and activation quantization to FP8, reducing disk size and GPU memory requirements by about 50%.
• Multilingual Support: Available in languages such as English, German, French, Italian, Portuguese, Hindi, Spanish, and Thai.
• Intended Use: Suitable for assistant-like chat in commercial and research scenarios.

📦 Installation

No specific installation steps provided in the original document.

💻 Usage Examples

Basic Usage

This model can be deployed efficiently using the vLLM backend.

from vllm import LLM, SamplingParams

# Initialize the LLM
model_name = "neuralmagic/pixtral-12b-FP8-dynamic"
llm = LLM(model=model_name, max_model_len=10000)

# Create the prompt
image_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
messages = [
    {
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe the image."},
            {"type": "image_url", "image_url": {"url": image_url}},
        ],
    },
]

# Set up sampling parameters
sampling_params = SamplingParams(temperature=0.2, max_tokens=100)

# Generate the response
outputs = llm.chat(messages, sampling_params=sampling_params)

# Print the generated text
for output in outputs:
    print(output.outputs[0].text)

Advanced Usage

vLLM also supports OpenAI-compatible serving.

vllm serve neuralmagic/pixtral-12b-FP8-dynamic

📚 Documentation

Model Overview

• Model Architecture: Pixtral (Llava)
  • Input: Text/Image
  • Output: Text
• Model Optimizations:
  • Weight quantization: FP8
  • Activation quantization: FP8
• Intended Use Cases: Intended for commercial and research use in multiple languages. Similar to mistralai/Pixtral-12B-2409, this model 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: 11/1/2024
• Version: 1.0
• License(s): Apache 2.0
• Model Developers: Neural Magic

This is a quantized version of mistral-community/pixtral-12b.

Model Optimizations

This model was obtained by quantizing the weights and activations of mistral-community/pixtral-12b to FP8 data type, ready for inference with vLLM built from source. This optimization reduces the number of bits per parameter from 16 to 8, reducing the disk size and GPU memory requirements by approximately 50%.

Only the weights and activations of the linear operators within transformers blocks are quantized. Symmetric per-channel quantization is applied, in which a linear scaling per output dimension maps the FP8 representations of the quantized weights and activations. Activations are also quantized on a per-token dynamic basis. LLM Compressor is used for quantization.

Creation

This model was created by applying LLM Compressor.

from transformers import AutoProcessor, LlavaForConditionalGeneration

from llmcompressor.modifiers.quantization import QuantizationModifier
from llmcompressor.transformers import oneshot, wrap_hf_model_class

MODEL_ID = "mistral-community/pixtral-12b"

# Load model.
model_class = wrap_hf_model_class(LlavaForConditionalGeneration)
model = model_class.from_pretrained(MODEL_ID, device_map="auto", torch_dtype="auto")
processor = AutoProcessor.from_pretrained(MODEL_ID)

# Configure the quantization algorithm and scheme.
# In this case, we:
#   * quantize the weights to fp8 with per channel via ptq
#   * quantize the activations to fp8 with dynamic per token
recipe = QuantizationModifier(
    targets="Linear",
    scheme="FP8_DYNAMIC",
    ignore=["re:.*lm_head", "re:multi_modal_projector.*", "re:vision_model.*"],
)

# Apply quantization and save to disk in compressed-tensors format.
SAVE_DIR = MODEL_ID.split("/")[1] + "-FP8-Dynamic"
oneshot(model=model, recipe=recipe, output_dir=SAVE_DIR)
processor.save_pretrained(SAVE_DIR)

# Confirm generations of the quantized model look sane.
print("========== SAMPLE GENERATION ==============")
input_ids = processor(text="Hello my name is", return_tensors="pt").input_ids.to("cuda")
output = model.generate(input_ids, max_new_tokens=20)
print(processor.decode(output[0]))
print("==========================================")

Evaluation

Multimodal Benchmarks

Text Benchmarks

Reproduction

TBD

📄 License

This model is released under the Apache 2.0 license.