Files
ort/docs/content/migrating/version-mapping.mdx
2026-03-20 19:58:18 -05:00

41 lines
1.5 KiB
Plaintext

---
title: Version mapping
description: Information about `ort`'s versioning and relation to ONNX Runtime versioning.
---
import Ort from '../../components/Ort';
# Version mapping
## Versions of ONNX Runtime used by <Ort/>
| **ort** | **ONNX Runtime** |
| -------- | ----------------:|
| v2.0.0+ | v1.24.4 |
| v1.16.0-v1.16.2 | v1.16.0 |
| v1.15.0-v1.15.5 | v1.15.1 |
| v1.14.2-v1.14.8 | v1.14.1 |
| v1.14.0-v1.14.1 | v1.14.0 |
| v1.13.1-v1.13.3 | v1.13.1 |
| v1.13.0 | v1.12.1 |
## Supported ONNX opsets by <Ort/> version
Note that this only applies to the default ONNX Runtime backend.
| **ort** | **ONNX opset version** | **ONNX ML opset version** |
| -------- |:----------------------:|:-------------------------:|
| v2.0.0+ | 24 | 4 |
| v1.16.0-v1.16.2 | 19 | 3 |
| v1.15.0-v1.15.5 | 19 | 3 |
| v1.14.0-v1.14.8 | 18 | 3 |
| v1.13.0-v1.13.3 | 17 | 3 |
## A note on SemVer
<Ort/> versions pre-2.0 were not SemVer compatible. From v2.0 onwards, breaking API changes are accompanied by a **major version update**.
Updates to the version of ONNX Runtime used by <Ort/> may occur on **minor** version updates, i.e. 2.0 ships with ONNX Runtime 1.24, but 2.1 may ship with 1.25. ONNX Runtime is generally forward compatible, but in case you require a specific version of ONNX Runtime, you should pin <Ort/>'s minor version in your `Cargo.toml` using a [tilde requirement](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#tilde-requirements):
```toml filename="Cargo.toml"
[dependencies]
ort = { version = "~2.0", ... }
```