Troubleshooting Guide for OpenVINO™ Installation & Configuration¶
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 one of the following options:
Add the download source using the
-iparameter with the Python
pipcommand. For example:
pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/
--trusted-host parameter if the URL above is
http instead of
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/
For C++ developers, if you have installed OpenVINO Runtime via APT, YUM, or the archive file, and then installed OpenVINO Development Tools via PyPI, you may run into issues. To resolve that, install the components in
requirements.txtby using the following command:
pip install -r <INSTALL_DIR>/tools/requirements.txt
For APT and YUM users, replace the
Issues with Installing OpenVINO on Linux from Docker
If you met proxy issues during the installation with Docker, you need set up proxy settings for Docker. See the Docker guide for more details.
Issues with Creating a Yocto Image for OpenVINO
When using the
bitbake-layers add-layer meta-intel command, the following error might occur:
NOTE: Starting bitbake server...
ERROR: The following required tools (as specified by HOSTTOOLS) appear to be unavailable in PATH, please install them in order to proceed: chrpath diffstat pzstd zstd
To resolve the issue, install the
chrpath diffstat zstd tools:
sudo apt-get install chrpath diffstat zstd
3. If you run into issues while installing or configuring OpenVINO™, you can try the following methods to do some quick checks first.
Check the versions of OpenVINO Runtime and Development Tools
To check the version of OpenVINO Development Tools, use the following command:
from openvino.tools.mo import convert_model
ov_model = convert_model(version=True)
To check the version of OpenVINO Runtime, use the following code:
from openvino.runtime import get_version
Check the versions of Python and PIP
To check your Python version, run
python -VV or
python --version. The supported Python versions should be 64-bit and between 3.8 and 3.11. If you are using Python 3.7, you are recommended to upgrade the version to 3.8 or higher.
If your Python version does not meet the requirements, update Python:
For Windows, do not install Python from a Windows Store as it can cause issues. You are highly recommended to install Python from official website .
For Linux and macOS systems, download and install a proper Python version from 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
.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
PATH /.bashrcor Windows environment variables. After restarting your environment, you should see similar information as below:
[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
.bashrcfile, make sure that the command is correctly written and the file is found in the
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 was successfully installed, you will see a list of available devices.
If you installed 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 installed OpenVINO Runtime from APT, use the
apt list --installed | grep openvinocommand to list the installed OpenVINO packages.
If you installed OpenVINO Runtime from YUM, use the
yum list installed 'openvino*'command to list the installed OpenVINO packages.
Check if GPU driver is installed
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.