Troubleshooting

  1. OpenVINO can’t detect GPU device

    $ python3 -c "from openvino import Core; ie = Core(); print(ie.available_devices)"
    ['CPU']
    

    Please firstly make sure you have installed the firmware and driver for GPU. If you are still encountering this issue:

    $ export OCL_ICD_VENDORS=/etc/OpenCL/vendors
    
  2. MESA: warning: Driver does not support the 0x7d51 PCI ID

    MESA: warning: driver does not support the 0x7d51 PCI ID.
    DRI3 not available
    

    Please update mesa to fix this issue.

    $ sudo apt update
    $ sudo apt install mesa-utils libgl1-mesa-dri libglx-mesa0 libigc2
    
  3. IPEX workloads are incompatible with the NPU driver

    RuntimeError: Native API failed. Native API returns: -1102 (PI_ERROR_UNINITIALIZED) -1102 (PI_ERROR_UNINITIALIZED)
    

    To run IPEX workloads, please uninstall the NPU debs package installed as according to NPU firmware.

    $ sudo dpkg --purge --force-remove-reinstreq intel-driver-compiler-npu intel-fw-npu intel-level-zero-npu
    
  4. DepthAnythingV2 checkpoint download failed

    Please modify the following download link in the script <Depth-Anything-ONNX_project_dir>/depth_anything_v2/config.py.

    Encoder.vitb: {
        None: "https://hf-mirror.com/depth-anything/Depth-Anything-V2-Base/resolve/main/depth_anything_v2_vitb.pth?download=true",
        ..
    },
    
  5. OpenVINO inference failed

    If you encounter some errors when running OpenVINO inference of models from Model Tutorials, please check the OpenVINO version used for model conversion and the runtime version used for inference. The OpenVINO version used for model conversion should be the same as the runtime version used for inference. Otherwise, unexpected errors may occur, especially if the model is converted using a newer version and the runtime is an older version.

    You can check the OpenVINO version used for model conversion at the end of the OpenVINO IR file *.xml. For example:

    ...
     <rt_info>
            <Runtime_version value="2025.0.0-17942-1f68be9f594-releases/2025/0" />
            <conversion_parameters>
                    <framework value="pytorch" />
                    <is_python_object value="True" />
            </conversion_parameters>
    </rt_info>
    ...