Hailo Environment and Compilation Troubleshooting
Resolve common issues when installing the Hailo SDK and compiling models.
When working with the Hailo SDK you may encounter environment or compilation errors. Here are solutions to common problems:
Environment Issues
No DNN in stream executororInvalidArgumentError– Install a CUDNN version that matches your CUDA installation. Verify withnvcc --versionanddpkg -l | grep cudnn. Use CPU mode (export CUDA_VISIBLE_DEVICES="") if necessary.hailomz: command not found– Activate your virtual environment:source ~/hailo_venv/bin/activate.ImportError: cannot import name 'one_of' from 'pyparsing'– Use a fresh virtual environment and install only the Hailo wheels.ERROR: No matching distribution found for hailort– Install the wheel downloaded from the Hailo developer portal, not from PyPI.ERROR: Requirement libgraphviz-dev not found– Install withsudo apt install libgraphviz-dev.- Docker containers cannot see GPUs – Install
nvidia-container-toolkitand run Docker with--gpus all. ImportError: libhailo.so– Ensure the Hailo SDK is installed andLD_LIBRARY_PATHincludes its libraries.
Compilation Issues
- ONNX file has only one output – Re-export the model with
simplify=Falseanddynamic=False. ValueError: None values not supported– Check that the NMS JSON matches the number of output layers.invalid choice: 'hailo8'– Use the legacy AI Suite (v3/v4) when targeting Hailo‑8.- Poor accuracy – Provide at least 200 calibration images from your dataset.
- No
.hefproduced – Look for errors earlier in the log, often due to incorrect output mappings. CUDA out of memory– Reduce batch size or use CPU mode.- Python version mismatch – Create your virtual environment with Python 3.10.
Refer to the Hailo documentation for more detailed guidance.