Install and Configure Intel® Distribution of OpenVINO™ toolkit for macOS*¶
The Intel® Distribution of OpenVINO™ is supported on macOS* version 10.15.x with Intel® processor-based machines.
By default, the OpenVINO™ Toolkit installation on this page installs the following components:
This tool imports, converts, and optimizes models that were trained in popular frameworks to a format usable by Intel tools, especially the Inference Engine. Popular frameworks include Caffe*, TensorFlow*, MXNet*, Kaldi* and ONNX*.
This is the engine that runs the deep learning model. It includes a set of libraries for an easy inference integration into your applications
OpenCV* community version compiled for Intel® hardware
A set of simple command-line applications demonstrating how to utilize specific OpenVINO capabilities in an application and how to perform specific tasks, such as loading a model, running inference, querying specific device capabilities, and more.
A set of command-line applications that serve as robust templates to help you implement multi-stage pipelines and specific deep learning scenarios.
Documentation for the pre-trained models available in the Open Model Zoo repo .
The current version of the Intel® Distribution of OpenVINO™ toolkit for macOS* supports inference on Intel CPUs and Intel® Neural Compute Stick 2 devices only.
6th to 12th generation Intel® Core™ processors and Intel® Xeon® processors
3rd generation Intel® Xeon® Scalable processor (formerly code named Cooper Lake)
Intel® Xeon® Scalable processor (formerly Skylake and Cascade Lake)
Intel® Neural Compute Stick 2
CMake 3.13 or higher
Install (choose “macOS 10.13 or later”)
/Applications/CMake.app/Contents/binto path (for default install)
Python 3.6 - 3.8
Install (choose 3.6.x - 3.8.x, not latest)
Add to path
Apple Xcode* Command Line Tools
In the terminal, run
xcode-select --installfrom any directory
(Optional) Apple Xcode* IDE (not required for OpenVINO, but useful for development)
This guide provides step-by-step instructions on how to install the Intel® Distribution of OpenVINO™ toolkit for macOS*. The following steps will be covered:
Step 1: Install the Intel® Distribution of OpenVINO™ Toolkit Core Components¶
If you have a previous version of the Intel® Distribution of OpenVINO™ toolkit installed, rename or delete these two directories:
Download the latest version of OpenVINO toolkit for macOS*, then return to this guide to proceed with the installation.
Install the OpenVINO toolkit core components:
Go to the directory where you downloaded the Intel® Distribution of OpenVINO™ toolkit. This document assumes this is your
Downloadsdirectory. By default, the disk image file is saved as
m_openvino_toolkit_p_<version>.dmgfile to mount. The disk image is mounted to
/Volumes/m_openvino_toolkit_p_<version>and automatically opens in a separate window.
Run the installation wizard application
On the User Selection screen, choose a user account for the installation:
The default installation directory path depends on the privileges you choose for the installation.
Follow the instructions on your screen. Watch for informational messages such as the following in case you must complete additional steps:
The Installation summary screen shows you the default component set to install. By default, the Intel® Distribution of OpenVINO™ is installed in the following directory, referred to as
<INSTALL_DIR>elsewhere in the documentation:
For root or administrator:
For regular users:
For simplicity, a symbolic link to the latest installation is also created:
Optional : You can choose Customize to change the installation directory or the components you want to install.
If there is an OpenVINO™ toolkit version previously installed on your system, the installer will use the same destination directory for next installations. If you want to install a newer version to a different directory, you need to uninstall the previously installed versions.
The Finish screen indicates that the core components have been installed:
Once you click Finish to close the installation wizard, a new browser window opens with the document you’re reading now (in case you installed without it) and jumps to the section with the next installation steps.
The core components are now installed. If you received a message that you were missing external software dependencies (list available under Software Requirements at the top of this guide), you need to install them now before continuing to the next section.
Step 2: Configure the Environment¶
If you installed OpenVINO to a non-default installation directory, replace
/opt/intel/ with the directory where you installed the software.
You must update several environment variables before you can compile and run OpenVINO™ applications. Set persistent environment variables as follows, using vi (as below) or your preferred editor in the terminal:
.bash_profilefile in the current user home directory:
Press the i key to switch to insert mode.
Add this line to the end of the file:
If you didn’t choose the default installation option, replace
/opt/intel/openvino_2021with your directory.
Save and close the file: press the Esc key, type
:wqand press the Enter key.
To verify the change, open a new terminal. You will see
[setupvars.sh] OpenVINO environment initialized.
Optional: If you don’t want to change your shell profile, you can run the following script to temporarily set your environment variables when working with the OpenVINO* toolkit:
The environment variables are set. Continue to the next section to configure the Model Optimizer.
Step 3: Configure the Model Optimizer¶
The Model Optimizer is a Python*-based command line tool for importing trained models from popular deep learning frameworks such as Caffe*, TensorFlow*, Apache MXNet*, ONNX* and Kaldi*.
The Model Optimizer is a key component of the OpenVINO toolkit. You cannot perform inference on your trained model without running the model through the Model Optimizer. When you run a pre-trained model through the Model Optimizer, your output is an Intermediate Representation (IR) of the network. The IR is a pair of files that describe the whole model:
.xml: Describes the network topology
.bin: Contains the weights and biases binary data
The Inference Engine reads, loads, and infers the IR files, using a common API on the CPU hardware.
For more information about the Model Optimizer, see the Model Optimizer Developer Guide.
If you see error messages, verify that you installed all dependencies listed under Software Requirements at the top of this guide.
Go to the Model Optimizer prerequisites directory:
Run the script to configure the Model Optimizer for Caffe, TensorFlow 2.x, MXNet, Kaldi*, and ONNX:
Optional: You can choose to configure each framework separately instead, to save disk space. In the same directory are individual scripts for Caffe, TensorFlow 1.x, TensorFlow 2.x, MXNet, Kaldi, and ONNX: install_prerequisites_caffe.sh, etc. You can run more than one script. If you see error messages, make sure you installed all dependencies. Configure individual frameworks separately ONLY if you did not select Option 1 above.
The Model Optimizer is configured for one or more frameworks.
You have completed all required installation, configuration and build steps in this guide to use your CPU to work with your trained models.
To enable inference on Intel® Neural Compute Stick 2, see the Configure the Intel® Neural Compute Stick 2.
Or proceed to the Start Using the Toolkit section to learn the basic OpenVINO™ toolkit workflow and run code samples and demo applications.
Step 4 (Optional): Configure the Intel® Neural Compute Stick 2¶
These steps are required only if you want to perform inference on Intel® Neural Compute Stick 2 powered by the Intel® Movidius™ Myriad™ X VPU. For more details, see also the Get Started page for Intel® Neural Compute Stick 2.
To perform inference on Intel® Neural Compute Stick 2, the
libusb library is required. You can build it from the source code or install using the macOS package manager you prefer: Homebrew*, MacPorts* or other.
For example, to install the
libusb library using Homebrew*, use the following command:
brew install libusb
You’ve completed all required configuration steps to perform inference on your Intel® Neural Compute Stick 2. Proceed to the Start Using the Toolkit section to learn the basic OpenVINO™ toolkit workflow and run code samples and demo applications.
Step 5: Start Using the Toolkit¶
Now you are ready to try out the toolkit. To continue, see the ../get_started/get_started.md “Get Started Guide” section to learn the basic OpenVINO™ toolkit workflow and run code samples and demo applications with pre-trained models on different inference devices.
Uninstall the Intel® Distribution of OpenVINO™ Toolkit¶
To uninstall, follow the steps on the Uninstalling page.
Get started with samples and demos: Get Started Guide
Intel® Distribution of OpenVINO™ toolkit home page: https://software.intel.com/en-us/openvino-toolkit
Convert models for use with OpenVINO™: Model Optimizer Developer Guide
Write your own OpenVINO™ applications: Inference Engine Developer Guide
Information on sample applications: Inference Engine Samples Overview
Information on a supplied set of models: Overview of OpenVINO™ Toolkit Pre-Trained Models
IoT libraries and code samples: Intel® IoT Developer Kit
To learn more about converting models from specific frameworks, go to: