Skip to content

Latest commit

 

History

History
59 lines (46 loc) · 3.63 KB

Versioning.md

File metadata and controls

59 lines (46 loc) · 3.63 KB

Versioning

API

ONNX Runtime follows Semantic Versioning 2.0 for its public API. Each release has the form MAJOR.MINOR.PATCH. The meanings of MAJOR, MINOR and PATCH are same as what is described in the semantic versioning doc linked above.

Current stable release version

The version number of the current stable release can be found here.

Release cadence

See Release Management

Compatibility

ONNX Compatibility

ONNX Runtime supports both backwards and forward compatibility.

Backwards compatibility

All versions of ONNX Runtime will support ONNX opsets all the way back to (and including) opset version 7. In other words if an ONNX Runtime release implements ONNX opset ver 9, it'll be able to run all models that are stamped with ONNX opset verions in the range [7-9].

Forward compatibility

A release version that supports opset ver 8 will be able to run all models that are stamped with opset ver 9 provided the model doesn't use ops that were newly introduced in opset ver 9.

Version matrix

Following table summarizes the relationship between the ONNX Runtime version and the ONNX opset version implemented in that release. Please note the Backwards and Forward compatiblity notes above. For more details on ONNX Release versions, see this page.

ONNX Runtime release version ONNX release version ONNX opset version ONNX ML opset version Supported ONNX IR version WinML compatibility
1.1.0 1.6 down to 1.2 11 2 6 --
1.0.0 1.6 down to 1.2 11 2 6 --
0.5.0 1.5 down to 1.2 10 1 5 --
0.4.0 1.5 down to 1.2 10 1 5 --
0.3.1
0.3.0
1.4 down to 1.2 9 1 3 --
0.2.1
0.2.0
1.3 down to 1.2 8 1 3 1903 (19H1)+
0.1.5
0.1.4
1.3 down to 1.2 8 1 3 1809 (RS5)+

Tool Compatibility

A variety of tools can be used to create ONNX models. Unless otherwise noted, please use the latest released version of the tools to convert/export the ONNX model. Many tools are backwards compatible and support multiple ONNX versions. Join this with the table above to evaluate ONNX Runtime compatibility.

Tool Recommended Version Supported ONNX version(s)
PyTorch Latest stable 1.2-1.5
ONNXMLTools
CoreML, LightGBM, XGBoost, LibSVM
Latest stable 1.2-1.5
ONNXMLTools
SparkML
Latest stable 1.4-1.5
SKLearn-ONNX Latest stable 1.2-1.5
Keras-ONNX Latest stable 1.2-1.5
Tensorflow-ONNX Latest stable 1.2-1.5
WinMLTools Latest stable 1.2-1.4
AutoML 1.0.39+ 1.5
1.0.33 1.4