Install OpenVINO™ Packages

Add the OpenVINO™ APT repository

The following steps will add the OpenVINO™ APT repository to your package management.

  1. Install the OpenVINO™ GPG key:

    wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | gpg --dearmor | sudo tee /usr/share/keyrings/openvino-archive-keyring.gpg
    
    Copy to clipboard
  2. Add the Deb package sources for OpenVINO™ 2023 and OpenVINO™ 2024. This will allow you to choose your preferred OpenVINO™ version to be installed.

    echo "deb [signed-by=/usr/share/keyrings/openvino-archive-keyring.gpg] https://apt.repos.intel.com/openvino/2023 ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-openvino-2023.list
    echo "deb [signed-by=/usr/share/keyrings/openvino-archive-keyring.gpg] https://apt.repos.intel.com/openvino/2024 ubuntu22 main" | sudo tee /etc/apt/sources.list.d/intel-openvino-2024.list
    
    Copy to clipboard
  3. Run the following commands to create the file /etc/apt/preferences.d/intel-openvino. This will pin the OpenVINO™ version to 2024.2.0. Earlier versions of OpenVINO™ might not support inferencing on the NPU of Intel® Core™ Ultra processors.

    echo -e "\nPackage: openvino-libraries-dev\nPin: version 2024.2.0*\nPin-Priority: 1001" | sudo tee /etc/apt/preferences.d/intel-openvino
    echo -e "\nPackage: openvino\nPin: version 2024.2.0*\nPin-Priority: 1001" | sudo tee -a /etc/apt/preferences.d/intel-openvino
    echo -e "\nPackage: ros-humble-openvino-wrapper-lib\nPin: version 2024.2.0*\nPin-Priority: 1002" | sudo tee -a /etc/apt/preferences.d/intel-openvino
    echo -e "\nPackage: ros-humble-openvino-node\nPin: version 2024.2.0*\nPin-Priority: 1002" | sudo tee -a /etc/apt/preferences.d/intel-openvino
    
    Copy to clipboard

    If you decide to use a different OpenVINO™ version, ensure that all four packages (openvino-libraries-dev, openvino, ros-humble-openvino-wrapper-lib, and ros-humble-openvino-node) are pinned to the same OpenVINO™ version.

Install the OpenVINO™ Runtime and the ROS 2 OpenVINO™ Toolkit

The following steps will install the OpenVINO™ packages:

  1. Ensure all APT repositories are updated:

    sudo apt update
    
    Copy to clipboard
  2. Install the debconf-utilities:

    sudo apt install debconf-utils
    
    Copy to clipboard
  3. Clear any previous installation configurations:

    sudo apt purge ros-humble-openvino-node
    sudo apt autoremove -y
    echo PURGE | sudo debconf-communicate ros-humble-openvino-node
    
    Copy to clipboard
  4. Install the OpenVINO™ Runtime:

    sudo apt install openvino
    
    Copy to clipboard
  5. Install the the ROS 2 OpenVINO™ Toolkit:

    sudo apt install ros-humble-openvino-node
    
    Copy to clipboard

    During the installation of the ros-humble-openvino-node package, you will be prompted to decide whether to install the OpenVINO™ IR formatted models. Since some tutorials in the Intel® Robotics SDK, which are based on OpenVINO™, depend on these models; it is crucial to respond with ‘yes’ to this query.

    ../_images/configure_ros-humble-openvino-node.png
  6. Several Robotics SDK tutorials allow you to perform OpenVINO™ inference on the integrated GPU device of Intel® processors. To enable this feature, install the Intel® Graphics Compute Runtime with the following command:

    sudo apt install -y libze1 libze-intel-gpu1
    
    Copy to clipboard

    Note

    While you may encounter GPU driver installation guides that involve downloading *.deb files for manual installation, this method does not support automatic update. Therefore, it is advisable to install packages from an APT package feed for easier updates, as described above.

OpenVINO™ Re-Installation and Troubleshooting

If you need to reinstall OpenVINO™ or clean your system after a failed installation, run the following commands:

sudo apt purge ros-humble-openvino-node
sudo apt autoremove -y
echo PURGE | sudo debconf-communicate ros-humble-openvino-node
sudo apt install ros-humble-openvino-node
Copy to clipboard