This guide explains how to install Hailo’s hailo_pci driver, hailortcli and tappas.
It was tested on

Required packages

sudo apt-get update
sudo apt-get upgrade

sudo apt-get install -y rsync ffmpeg g++-12 x11-utils python3-dev python3-pip python3-setuptools python3-virtualenv python-gi-dev libgirepository1.0-dev gcc-9 g++-9 cmake git libzmq3-dev unzip

sudo apt-get install -y libopencv-dev python3-opencv

sudo apt-get install -y libcairo2-dev libgirepository1.0-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-gtk3 gstreamer1.0-qt5 gstreamer1.0-pulseaudio gcc-9 g++-9 python-gi-dev

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0

Driver compilation and installation

Clone the driver repository

# If using Host, clone:
git clone https://github.com/hailo-ai/hailort-drivers.git 
git checkout hailo8

# If using Docker (driver V4.15 is required), download:
wget https://github.com/hailo-ai/hailort-drivers/archive/refs/tags/v4.15.0.zip

Compile the driver

cd hailort-drivers/linux/pcie 
make all

Install the driver

sudo make install

Check installation

sudo modprobe hailo_pci

Download firmware

cd ../..
./download_firmware.sh 
mkdir /lib/firmware/hailo 
sudo mv hailo8_fw.<VERSION>.bin /lib/firmware/hailo/hailo8_fw.bin

Optional (set udev rules and reload the rules)

sudo cp ./linux/pcie/51-hailo-udev.rules /etc/udev/rules.d/ 
sudo udevadm control --reload-rules && sudo udevadm trigger

Method 1 Host

Installing HailortCli

Clone the Hailort repository

git clone https://github.com/hailo-ai/hailort.git
git checkout hailort-v4.22.0

Compile sources

cd hailort
cmake . -Bbuild -DCMAKE_BUILD_TYPE=Release -DHAILO_BUILD_GSTREAMER=1 -DCMAKE_INSTALL_PREFIX=/usr
sudo cmake --build build --target install

Testing

Run:

sudo hailortcli fw-control identify

If for some reason the –target install does not install hailortcli to the machine run the following line and try retesting:

cp build/hailort/hailortcli/hailortcli /usr/bin/

Output will look something like this:

Output will look somewhat like this: 
# hailortcli fw-control identify 
Executing on device: 0000:01:00.0 
Identifying board 
Control Protocol Version: 2 
Firmware Version: 4.16.2 (release,app,extended context switch buffer) 
Logger Version: 0 
Board Name: Hailo-8 
Device Architecture: HAILO8 
Serial Number: xxxxxxxxxxxxxxx
Part Number: xxxxxxxxxxx 
Product Name: HAILO-8 AI ACC M.2 M KEY MODULE EXT TEMP

Installing TAPPAS

Clone & set-up tappas repostitory

git clone https://github.com/hailo-ai/tappas.git 
cd tappas

# Use this only on ubuntu 23.04
cp tools/run_app/requirements_20_04.txt tools/run_app/requirements_23_04.txt

sudo ln -s /usr/lib/x86_64-linux-gnu/libhailort.so.<version> /usr/lib/libhailort.so 
sudo ln -s /usr/lib/x86_64-linux-gnu/libgsthailo.so /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgsthailo.so

Ubuntu 23.04 requires to change pybind version from 2.9 to 2.10 in:
hailo-ai/tappas/scripts/build_scripts/clone_external_packages.sh
To change version, use this command from tappas source directory:

sed -i 's|v2.9.0 https://github.com/pybind/pybind11.git|v2.10.0 https://github.com/pybind/pybind11.git -b v2.10.0|' scripts/build_scripts/clone_external_packages.sh

Install

./install.sh --skip-hailort

Method 2 Docker

Download TAPPAS container

Go to: hailo website → developer zone → software downloads
Download the Tappas docker container:

Hailo 8 Driver, hailortcli & tappas installation