Phi-3 Medium-4K-Instruct ONNX CUDA models

This repository hosts the optimized versions of Phi-3-medium-4k-instruct to accelerate inference with ONNX Runtime for your machines with NVIDIA GPUs.

Phi-3 Medium is a 14B parameter, lightweight, state-of-the-art open model trained with the Phi-3 datasets, which include both synthetic data and the filtered publicly available websites data, with a focus on high-quality and reasoning dense properties. The model belongs to the Phi-3 family with the medium version in two variants: 4K and 128K, which are the context lengths (in tokens) that they can support.

The base model has undergone a post-training process that incorporates both supervised fine-tuning and direct preference optimization for the instruction following and safety measures. When assessed against benchmarks testing common sense, language understanding, math, code, long context, and logical reasoning, Phi-3-Medium-4K-Instruct showcased a robust and state-of-the-art performance among models of the same-size and next-size-up.

Optimized variants of the Phi-3 Medium models are published here in ONNX format and run with ONNX Runtime on CPU and GPU across devices, including server platforms, Windows, and Linux, with the precision best suited to each of these targets.

ONNX Models

Here are some of the optimized configurations we have added:

ONNX model for FP16 CUDA: ONNX model for NVIDIA GPUs.
ONNX model for INT4 CUDA: ONNX model for NVIDIA GPUs using int4 quantization via RTN.

How do you know which is the best ONNX model for you:

Are you on a Windows machine with GPU?
- I don't know → Review this guide to see whether you have a GPU in your Windows machine.
- Yes → Access the Hugging Face DirectML ONNX models and instructions at Phi-3-medium-4k-instruct-onnx-directml.
- No → Do you have a NVIDIA GPU?
  - I don't know → Review this guide to see whether you have a CUDA-capable GPU.
  - Yes → Access the Hugging Face CUDA ONNX models and instructions at Phi-3-medium-4k-instruct-onnx-cuda for NVIDIA GPUs.
  - No → Access the Hugging Face ONNX models for CPU devices and instructions at Phi-3-medium-4k-instruct-onnx-cpu

Note: Using the Hugging Face CLI, you can download sub folders and not all models if you are limited on disk space. The FP16 model is recommended for larger batch sizes, while the INT4 model optimizes performance for lower batch sizes.

Example:

# Download just the FP16 model
$ huggingface-cli download microsoft/Phi-3-small-8k-instruct-onnx-cuda --include cuda-fp16/* --local-dir .  --local-dir-use-symlinks False

How to Get Started with the Model

To support the Phi-3 models across a range of devices, platforms, and EP backends, we introduce a new API to wrap several aspects of generative AI inferencing. This API makes it easy to drag and drop LLMs straight into your app. To run the early version of these models with ONNX, follow the steps here.

Hardware Supported

The models are tested on:

1 A100 GPU, SKU: Standard_ND96amsr_A100_v4 (CUDA)

Minimum Configuration Required:

CUDA: NVIDIA GPU with Compute Capability >= 7.0

Model Description

Developed by: Microsoft
Model type: ONNX
Language(s) (NLP): Python, C, C++
License: MIT
Model Description: This is a conversion of the Phi-3 Medium-4K-Instruct model for ONNX Runtime inference.

Additional Details

Performance Metrics

CUDA

Phi-3 Medium-4K-Instruct performs better with ONNX Runtime compared to PyTorch for all batch size, prompt length combinations. For FP16 CUDA, ORT performs up to 5X faster than PyTorch, while with INT4 CUDA, it's up to 10X faster than PyTorch. It is also up to 3X faster than llama.cpp for large batch sizes.

The table below shows the average throughput of the first 256 tokens generated (tps) for FP16 and INT4 precisions on CUDA as measured on 1 A100 80GB GPU, SKU: Standard_ND96amsr_A100_v4.

Batch Size, Prompt Length	ORT FP16 CUDA	PyTorch Eager FP16 CUDA	Speed Up ORT/PyTorch
1, 16	47.32	14.41	3.28
4, 16	190.05	84.43	2.25
16, 16	707.68	347.52	2.04
16, 64	698.22	342.83	2.04

Batch Size, Prompt Length	ORT INT4 CUDA	PyTorch Eager INT4 CUDA	Speed Up ORT/PyTorch
1, 16	115.68	14.89	7.77
4, 16	88.53	45.22	1.96
16, 16	341.8	168.36	2.03

Package Versions

Pip package name	Version
torch	2.3.0
triton	2.3.0
onnxruntime-gpu	1.18.0
transformers	4.40.2
bitsandbytes	0.43.1

Appendix

Model Card Contact

parinitarahi, kvaishnavi, natke

Contributors

Kunal Vaishnavi, Sunghoon Choi, Yufeng Li, Sheetal Arun Kadam, Rui Ren, Natalie Kershaw, Parinita Rahi

microsoft/Phi-3-medium-4k-instruct-onnx-cuda