[](https://dev.azure.com/onnxruntime/onnxruntime/_build/latest?definitionId=9) [](https://dev.azure.com/onnxruntime/onnxruntime/_build/latest?definitionId=10) [](https://dev.azure.com/onnxruntime/onnxruntime/_build/latest?definitionId=11) [](https://dev.azure.com/onnxruntime/onnxruntime/_build/latest?definitionId=12) [](https://dev.azure.com/onnxruntime/onnxruntime/_build/latest?definitionId=13) **ONNX Runtime** is an open-source scoring engine for Open Neural Network Exchange (ONNX) models. ONNX is an open format for machine learning (ML) models that is supported by various ML and DNN frameworks and tools. This format makes it easier to interoperate between frameworks and to maximize the reach of your hardware optimization investments. Learn more about ONNX on [https://onnx.ai](https://onnx.ai) or view the [Github Repo](https://github.com/onnx/onnx). # Why use ONNX Runtime ONNX Runtime is an open architecture that is continually evolving to adapt to and address the newest developments and challenges in AI and Deep Learning. We will keep ONNX Runtime up to date with the ONNX standard, supporting all ONNX releases with future compatibliity while maintaining backwards compatibility with prior releases. ONNX Runtime continuously strives to provide top performance for a broad and growing number of usage scenarios in Machine Learning. Our investments focus on these 3 core areas: 1. Run any ONNX model 2. High performance 3. Cross platform ## Run any ONNX model ### Alignment with ONNX Releases ONNX Runtime provides comprehensive support of the ONNX spec and can be used to run all models based on ONNX v1.2.1 and higher. See ONNX version release details [here](https://github.com/onnx/onnx/releases). As of November 2018, ONNX Runtime supports the latest released version of ONNX (1.3). Once 1.4 is released, ONNX Runtime will align with the updated spec, adding support for new operators and other capabilities. ### Traditional ML support ONNX Runtime fully supports the ONNX-ML profile of the ONNX spec for traditional ML scenarios. ## High Performance You can use ONNX Runtime with both CPU and GPU hardware. You can also plug in additional execution providers to ONNX Runtime. With many graph optimizations and various accelerators, ONNX Runtime can often provide lower latency and higher efficiency compared to other runtimes. This provides smoother end-to-end customer experiences and lower costs from improved machine utilization. Currently ONNX Runtime supports CUDA and MKL-DNN (with option to build with MKL) for computation acceleration. To add an execution provider, please refer to [this page](docs/AddingExecutionProvider.md). We are continuously working to integrate new execution providers to provide improvements in latency and efficiency. We have ongoing collaborations to integrate the following with ONNX Runtime: * Intel MKL-DNN and nGraph * NVIDIA TensorRT ## Cross Platform ONNX Runtime offers: * APIs for Python, C#, and C (experimental) * Available for Linux, Windows, and Mac  See API documentation and package installation instructions [below](#Installation). Looking ahead: To broaden the reach of the runtime, we will continue investments to make ONNX Runtime available and compatible with more platforms. These include but are not limited to: * C# for Linux, Mac * C# supporting GPU * C packages * [ARM](BUILD.md##arm-builds) # Getting Started If you need a model: * Check out the [ONNX Model Zoo](https://github.com/onnx/models) for ready-to-use pre-trained models. * To get an ONNX model by exporting from various frameworks, see [ONNX Tutorials](https://github.com/onnx/tutorials). If you already have an ONNX model, just [install the runtime](#Installation) for your machine to try it out. One easy way to deploy the model on the cloud is by using [Azure Machine Learning](https://azure.microsoft.com/en-us/services/machine-learning-service). See detailed instructions [here](https://docs.microsoft.com/en-us/azure/machine-learning/service/how-to-build-deploy-onnx). # Installation ## APIs and Official Builds | API Documentation | CPU package | GPU package | |-----|-------------|-------------| | [Python](https://docs.microsoft.com/en-us/python/api/overview/azure/onnx/intro?view=azure-onnx-py) | [Windows](https://pypi.org/project/onnxruntime/)
[Linux](https://pypi.org/project/onnxruntime/)
[Mac](https://pypi.org/project/onnxruntime/)| [Windows](https://pypi.org/project/onnxruntime-gpu)
[Linux](https://pypi.org/project/onnxruntime-gpu/) | | [C#](docs/CSharp_API.md) | [Windows](https://www.nuget.org/packages/Microsoft.ML.OnnxRuntime/)
Linux - Coming Soon
Mac - Coming Soon| [Windows](https://www.nuget.org/packages/Microsoft.ML.OnnxRuntime.Gpu/)
Linux - Coming Soon
Mac - Coming Soon| | [C (experimental)](docs/C_API.md) | Coming Soon | Coming Soon | | [C++](onnxruntime/core/session/inference_session.h) | TBD | TBD | ## Build Details For details on the build configurations and information on how to create a build, see [Build ONNX Runtime](BUILD.md). ## Versioning See more details on API and ABI Versioning and ONNX Compatibility in [Versioning](docs/Versioning.md). # Design and Key Features For an overview of the high level architecture and key decisions in the technical design of ONNX Runtime, see [Engineering Design](docs/HighLevelDesign.md). ONNX Runtime is built with an extensible design that makes it versatile to support a wide array of models with high performance. * [Add a custom operator/kernel](docs/AddingCustomOp.md) * [Add an execution provider](docs/AddingExecutionProvider.md) * [Add a new graph transform](include/onnxruntime/core/graph/graph_transformer.h) * [Add a new rewrite rule](include/onnxruntime/core/graph/rewrite_rule.h) # Contribute We welcome your contributions! Please see the [contribution guidelines](CONTRIBUTING.md). ## Feedback For any feedback or to report a bug, please file a [GitHub Issue](https://github.com/Microsoft/onnxruntime/issues). ## Code of Conduct This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. # License [MIT License](LICENSE)