Troubleshooting Guide for OpenVINO™ Installation & Configuration#

This guide provides general troubleshooting steps and solutions to possible issues that may be encountered while installing and configuring OpenVINO™. For a comprehensive database of support topics on OpenVINO, go to:
Support for OpenVINO™ toolkit
Errors with Installing via PIP for Users in China

Users in China might encounter errors while downloading sources via PIP during OpenVINO™ installation. To resolve the issues, try adding the download source using the -i parameter with the Python pip command. For example:

pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/

Use the --trusted-host parameter if the URL above is http instead of https. You can also run the following command to install specific framework. For example:

pip install openvino-dev[tensorflow2] -i https://mirrors.aliyun.com/pypi/simple/
Issues with Installing OpenVINO on Linux from Docker

If you meet proxy issues during the installation with Docker, you need set up proxy settings for Docker. See the Docker guide for more details.

Check the version of OpenVINO Runtime

To check the version of OpenVINO Runtime, use the following command:

from openvino.runtime import get_version
get_version()
Check the versions of Python and PIP

To check your Python version, run python -VV or python --version. The supported Python versions are 64-bit, between 3.8 and 3.11. If your Python version does not meet the requirements, you need to upgrade:

  • For Windows, do not install Python from the Windows Store as it can cause issues. It is highly recommended that you install Python from the official website .

  • For Linux and macOS systems, download and install a proper Python version from the official website. See the Python Beginners’ Guide for more information on selecting a version. Note that macOS 10.x comes with python 2.7 installed, which is not supported, so you must install Python from the official website.

For PIP, make sure that you have installed the latest version. To check and upgrade your PIP version, run the following command:

python -m pip install --upgrade pip
Check if environment variables are set correctly

  • For Python developers, if you previously installed OpenVINO using the archive file, and are now installing OpenVINO using PIP, remove all the PATH settings and the lines with setupvars from .bashrc. Note that if you installed OpenVINO with PIP in a virtual environment, you don’t need to set any environment variables.

  • If you have installed OpenVINO before, you probably have added setupvars to your PATH /.bashrc or Windows environment variables. After restarting your environment, you should see an information similar to the following:

    [setupvars.sh] OpenVINO™ environment initialized

  • If you don’t see the information above, your PATH variables may be configured incorrectly. Check if you have typed the correct <INSTALL_DIR> or you are trying to activate in the correct directory.

  • If you added it to a .bashrc file, make sure that the command is correctly written and the file is found in the ~/.bashrc folder.

Verify that OpenVINO is correctly installed

  • For Python developers, to verify if OpenVINO is correctly installed, use the following command:

    python -c "from openvino import Core; print(Core().available_devices)"

    If OpenVINO has been successfully installed, you will see a list of available devices.

  • If you install OpenVINO Runtime using the archive file, you can search “openvino” in Apps & Features on a Windows system, or check your installation directory on Linux to see if OpenVINO is there.

  • If you install OpenVINO Runtime from APT, use the apt list --installed | grep openvino command to list the installed OpenVINO packages.

  • If you install OpenVINO Runtime from YUM, use the yum list installed 'openvino*' command to list the installed OpenVINO packages.

Check if proper drivers are installed

Additional configurations may be required in order to use OpenVINO with different hardware, such as Intel® GPU and NPU. Make sure that the device you want to use for inference has the required driver installed, as described in additional configurations for GPU.

Check firewall and network settings

Make sure that your firewall and network settings are configured correctly. For example, consider configuring system-wide proxy settings and specifying options for using PIP behind the proxy:

pip install --proxy http://address:port --trusted-host pypi.org openvino

For specific issues, see Errors with Installing via PIP for Users in China and Proxy issues with installing OpenVINO on Linux from Docker questions above.