Missing libyolo_hailortpp_postprocess.so for YOLO pipeline on Raspberry Pi 5 + Hailo-8L

I am currently working on an academic project using the Hailo-8L module with a Raspberry Pi 5. I’m using the hailo-rpi5-examples repository to run real-time YOLO inference with camera input.

However, I encountered a segmentation fault during execution due to a missing shared object file:

libyolo_hailortpp_postprocess.so

The detection script looks for this file at:
/usr/local/hailo/resources/so/libyolo_hailortpp_postprocess.so

Unfortunately, this file is not included in the latest Hailo Model Zoo or the RPi examples. It also seems that the source code to build this .so is no longer publicly available.

Could you kindly provide one of the following:

  • A working copy of libyolo_hailortpp_postprocess.so (compatible with Hailo-8L)
  • Or access to the source files (e.g., CMake + .cpp) to compile it myself

This is currently blocking me from completing the integration of the video stream and post-processed inference.

For reference, I’ve already installed:

  • hailort_4.21.0_arm64.deb
  • hailort-pcie-driver_4.21.0_all.deb
  • python3-hailort_4.21.0-1_arm64.deb

Thanks a lot for your support!

Raspberry Pi 5 + Hailo-8L user
(Individual developer / academic usage)

This is our code

import sys
sys.path.insert(0, '/home/ihatakimi/yolo_clean_env/lib/python3.11/site-packages/hailort-4.20.0-py3.11-linux-aarch64.egg')

from hailo_platform.pyhailort import pyhailort
import numpy as np
import time
import cv2

# Hailo alias'ları
HEF = pyhailort.HEF
Device = pyhailort.Device
HailoStreamInterface = pyhailort.HailoStreamInterface

def preprocess_image(image_path, input_shape):
    """Görüntüyü modele uygun hale getir"""
    img = cv2.imread(image_path)
    img = cv2.resize(img, (input_shape[2], input_shape[1]))
    img = cv2.cvtColor(img, cv2.COLOR_BGR2RGB)
    return img

def main():
    print("📸 Hailo Algılama ve FPS Testi Başlıyor...")

    try:
        # HEF ve görüntü yolu
        hef_path = "yolov8s.hef"
        image_path = "test.jpg"

        # HEF yükle
        hef = HEF(hef_path)
        print("✅ HEF yüklendi")

        # Cihazla yapılandır
        with Device() as device:
            network_group = device.configure(hef, interface=HailoStreamInterface.PCIe)
            print("✅ Cihaz yapılandırıldı")

            # Stream bilgileri
            input_stream = network_group.get_input_streams()[0]
            input_shape = input_stream.shape
            print(f"📐 Girdi şekli: {input_shape}")

            # Görüntüyü hazırla
            img = preprocess_image(image_path, input_shape)
            img_np = np.expand_dims(img, axis=0).astype(np.uint8)  # (1, H, W, C)

            # Isınma
            for _ in range(5):
                network_group.run({input_stream: img_np})
            print("🔥 Isınma tamamlandı")

            # FPS Testi
            num_frames = 50
            start = time.time()
            for _ in range(num_frames):
                network_group.run({input_stream: img_np})
            end = time.time()

            fps = num_frames / (end - start)
            print(f"\n🎯 Ortalama FPS: {fps:.2f}")

    except Exception as e:
        print(f"❌ Hata oluştu: {e}")

if _name_ == "_main_":
    main()

This is our error

Traceback (most recent call last):
  File "/home/ihatakimi/yolo_clean_env/fps_test.py", line 1, in <module>
    from hailort import HEF, Device, VDevice, HailoStreamInterface
ModuleNotFoundError: No module named 'hailort'
1 Like

Hey @Burak_Yildirim,

Welcome to the Hailo Community!

The resources you’re missing should have been compiled during the app installation. If you’re running into issues, I’d suggest checking out this repo where the post-processing components come from: GitHub - hailo-ai/hailo-apps-infra

You could also try re-running the install.sh script to make sure everything gets updated to the latest versions and all resources are properly installed.

Regarding the python3-hailort package you mentioned - we actually provide pyhailort.whl and hailort packages. Just to clarify, what exactly are you referring to with “python3-hailort_4.21.0-1_arm64.deb”?

Also, I’d really recommend going with the hailo-all package instead of installing components individually. This helps avoid compatibility issues and ensures all the packages work together properly.

Looking at your error:

Traceback (most recent call last):
  File "/home/ihatakimi/yolo_clean_env/fps_test.py", line 1, in <module>
    from hailort import HEF, Device, VDevice, HailoStreamInterface
ModuleNotFoundError: No module named 'hailort'

This is happening because you don’t have pyhailort installed in your virtual environment. Make sure you’ve installed the pyhailort package in the same environment where you’re trying to run your script.

Hope this helps get you up and running!

Hi @omria ,

Thank you very much for your previous response and guidance.

We are a university student team from Turkey participating in a national UAV (Unmanned Aerial Vehicle) competition, where thousands of teams compete. If we manage to complete this part of our project with Hailo’s integration, our chances of ranking at the top increase by over 80% – making this a critical milestone for us.

We carefully followed all the suggestions in your reply and also reviewed the hailo-ai/hailo-apps-infra repo. Here’s what we did:

:white_check_mark: Activated the correct Python virtual environment (yolo_clean_env)
:white_check_mark: Installed the correct .whl file: hailort-4.20.0-cp311-cp311-linux_aarch64.whl
:white_check_mark: Ran install.sh and all setup scripts
:white_check_mark: Verified the existence of all Hailo software suite components (as shown in attached screenshots)
:white_check_mark: Attempted imports in both fps_test.py and detection.py (still failing with the same error)

However, we still encounter the same error:

bash

KopyalaDüzenle

ModuleNotFoundError: No module named 'hailort'

We have attached all relevant screenshots showing:

  • The project and environment structure
  • The correct .whl files present
  • That we are running the Python script inside the activated virtual environment
  • The hailo-ai-sw-suite structure and artifact files

:pushpin: We are kindly asking:
Is it possible to arrange a brief live debugging session with someone from your support team? We are highly motivated and ready to follow any guidance, but this blocker is seriously delaying our progress. This project means a lot to us and your support could make a real difference for our success.

We also plan to promote Hailo as the core inference engine used in our UAV at the competition, which will have wide visibility.

Thanks again for your time, tools, and innovation.


Best regards,
Burak Yıldırım
Raspberry Pi 5 + Hailo8L Project Team
UAV Competition

Hi @Burak_Yildirim, thanks for sharing the details of your work. It’s clear you and your team have put a lot of effort into this project.

I’m with DeGirum (an official Hailo software partner) and we’d be happy to offer direct support if it would be helpful.

We’ve worked with other teams using Hailo-8L and Raspberry Pi, and we have a Python-based SDK, called PySDK, that might help simplify your pipeline (especially with camera input and postprocessing).

If you’re open to it, I’ll reach out via DM and we can explore whether our tools or team might be able to help you.