BuildingForLinux

Build on Linux Systems

The software was validated on:

• Ubuntu 18.04 (64-bit) with default GCC* 7.5.0
• Ubuntu 20.04 (64-bit) with default GCC* 9.3.0
• Red Hat Enterprise Linux 8.2 (64-bit) with default GCC* 8.5.0

NOTE: To build on CentOS* 7 (64-bit), please refer to Building OpenVINO on CentOS 7 Guide

Table of content:

• Software Requirements
• Build Steps
• Additional Build Options

Software Requirements

• CMake 3.13 or higher
• GCC 7.5 or higher to build OpenVINO Runtime
• Python 3.6 or higher for OpenVINO Runtime Python API
• (Optional) Install Intel® Graphics Compute Runtime for OpenCL™ Driver package 19.41.14441 to enable inference on Intel integrated GPUs.

Build Steps

1. Clone submodules:

   git clone https://github.com/openvinotoolkit/openvino.git
   cd openvino
   git submodule update --init --recursive

   (Optional) For users in China, clone submodules via gitee mirrors:

   cd openvino
   chmod +x scripts/submodule_update_with_gitee.sh
   ./scripts/submodule_update_with_gitee.sh
   

2. Install build dependencies using the install_build_dependencies.sh script in the project root folder.

   chmod +x install_build_dependencies.sh

   ./install_build_dependencies.sh

   NOTE: By default, the build enables the OpenVINO Runtime GPU plugin to infer models on your Intel® Processor Graphics. This requires you to Install Intel® Graphics Compute Runtime for OpenCL™ Driver package 19.41.14441 before running the build. If you don't want to use the GPU plugin, use the -DENABLE_INTEL_GPU=OFF CMake build option and skip the installation of the Intel® Graphics Compute Runtime for OpenCL™ Driver.

3. Create a build folder:

  mkdir build && cd build

4. OpenVINO Runtime uses a CMake-based build system. In the created build directory, run cmake to fetch project dependencies and create Unix makefiles, then run make to build the project:

  cmake -DCMAKE_BUILD_TYPE=Release ..
  make --jobs=$(nproc --all)

The process may take some time to finish.

Additional Build Options

You can use the following additional build options:

• Threading Building Blocks (TBB) is used by default. To build the OpenVINO Runtime with OpenMP* threading set the -DTHREADING=OMP option.

• For IA32 operation systems, use ia32.linux.toolchain.cmake CMake toolchain file:

  cmake -DCMAKE_TOOLCHAIN_FILE=<openvino_repo>/cmake/toolchains/ia32.linux.toolchain.cmake ..

• Required versions of TBB and OpenCV packages are downloaded automatically by the CMake-based script. If you want to use the automatically downloaded packages but you have already installed TBB or OpenCV packages configured in your environment, you may need to clean the TBBROOT and OpenCV_DIR environment variables before running the cmake command, otherwise they will not be downloaded and the build may fail if incompatible versions were installed.

• If the CMake-based build script can not find and download the OpenCV package that is supported on your platform, or if you want to use a custom build of the OpenCV library, see how to Use Custom OpenCV Builds.

• To build the OpenVINO Runtime Python API:

  1. Install all additional packages (e.g., cython and opencv) listed in the /src/bindings/python/src/compatibility/openvino/requirements-dev.txt file:

     pip install -r requirements_dev.txt

  2. Enable the -DENABLE_PYTHON=ON option in the CMake step above (Step 4). To specify an exact Python version, use the following options:

     -DPYTHON_EXECUTABLE=`which python3.7` \
     -DPYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.7m.so \
     -DPYTHON_INCLUDE_DIR=/usr/include/python3.7
     

  3. To build a wheel package (.whl), enable the -DENABLE_WHEEL=ON option in the CMake step above (Step 4):
  4. After the build process finishes, export the newly built Python libraries to the user environment variables:

     export PYTHONPATH=PYTHONPATH:<openvino_repo>/bin/intel64/Release/lib/python_api/python3.7/
     export LD_LIBRARY_PATH=LD_LIBRARY_PATH:<openvino_repo>/bin/intel64/Release/lib/
     

     or install the wheel with pip:

     pip install <openvino_repo>/build/wheel/openvino-2022.2.0-000-cp37-cp37-manylinux_2_35_x86_64.whl
     

• To switch the CPU and GPU plugins off/on, use the cmake options -DENABLE_INTEL_CPU=ON/OFF and -DENABLE_INTEL_GPU=ON/OFF respectively.

• OpenVINO runtime compilation options: -DENABLE_OV_ONNX_FRONTEND=ON enables the building of the ONNX importer.