# Bug Report: hailo-gen-ai-model-zoo 5.3.0 Uninstallable on Raspberry Pi with Hailo-10H

Bug Report: hailo-gen-ai-model-zoo 5.3.0 Uninstallable on Raspberry Pi with Hailo-10H

Summary

The hailo-gen-ai-model-zoo_5.3.0_arm64.deb package cannot be properly installed on Raspberry Pi 5 with Hailo-10H due to incorrect package dependencies. The .deb requires the generic hailort package (intended for Hailo-8L), but Hailo-10H requires the architecture-specific h10-hailort package.

Result: hailo-ollama binary crashes at runtime with missing shared library error.


System Configuration

Hardware

  • Device: Raspberry Pi 5
  • Accelerator: Hailo-10H AI Kit
  • OS: Debian 13 (Trixie)

Software Stack

  • Kernel: ARMv8 (ARM 64-bit)
  • Python: 3.13.5
  • Installation Date: May 1, 2026

Installed Hailo Packages

hailo-gen-ai-model-zoo        5.3.0 (arm64)
h10-hailort                   5.2.0-1 (arm64) [installed per Hailo-10H requirements]
hailo-tappas-core            5.2.0 (arm64)
python3-h10-hailort          5.2.0-1 (arm64)
rpicam-apps-hailo-postprocess 1.11.1-1 (arm64)

hailo-apps Installation

hailo-apps                    26.3.0
hailort (Python binding)      5.2.0
hailo-tappas-core (Python)    5.1.0

Steps to Reproduce

Step 1: Prepare System

# Start with clean Hailo-10H installation
sudo apt update
sudo apt upgrade

# Install Hailo-10H required packages (following official guide)
sudo apt install h10-hailort python3-h10-hailort

Step 2: Attempt Standard Installation (README Method)

# Download hailo-gen-ai-model-zoo from Developer Zone
wget https://hailo.ai/developer-zone/hailo_gen_ai_model_zoo_5.3.0_arm64.deb

# Install via apt (as per README)
sudo apt install ./hailo_gen_ai_model_zoo_5.3.0_arm64.deb

Result: APT attempts to downgrade h10-hailort to generic hailort 4.23.0, causing conflicts.


Error Messages

Error 1: APT Dependency Conflict

Installiere:
  hailo-gen-ai-model-zoo

Installiere Abhängigkeiten: 
  hailort (4.23.0)  ← WRONG VERSION FOR H10!

ENTFERNE:
  h10-hailort  hailo-h10-all  python3-h10-hailort

ERROR: Pakete müssen entfernt werden, aber Entfernen ist abgeschaltet.

Error 2: dpkg Installation Failure

$ sudo dpkg -i hailo_gen_ai_model_zoo_5.3.0_arm64.deb

dpkg: Abhängigkeitsprobleme verhindern Konfiguration von hailo-gen-ai-model-zoo:
 hailo-gen-ai-model-zoo hängt ab von hailort; aber:
  Paket hailort ist nicht installiert.

dpkg: Fehler beim Bearbeiten des Paketes hailo-gen-ai-model-zoo (--install):
 Abhängigkeitsprobleme - verbleibt unkonfiguriert

Error 3: Runtime Library Missing

$ hailo-ollama --help

hailo-ollama: error while loading shared libraries: libhailort.so.5.3.0: 
  cannot open shared object file: No such file or directory

Root Cause Analysis

Problem 1: Incorrect Package Dependency

The .deb file declares:

Depends: hailort

Expected for Hailo-10H:

Depends: h10-hailort (>= 5.2.0)

Issue: The generic hailort package (v4.23.0) is for Hailo-8L and contains libhailort.so.4.23.0, but the hailo-ollama binary is compiled for libhailort.so.5.3.0 (Hailo-10H).

Problem 2: Version Mismatch

hailo-gen-ai-model-zoo 5.3.0
    ↓ Requires (Incorrect)
hailort (generic) → 4.23.0 for Hailo-8L
    ↓ But hailo-ollama binary needs
libhailort.so.5.3.0 (Hailo-10H specific)

Problem 3: No Architecture Detection

The package doesn’t adapt dependencies based on detected hardware. Should detect h10-hailort and require it accordingly.


Failed Workaround Attempts

Attempt 1: Force Dependencies

sudo dpkg --force-all -i hailo_gen_ai_model_zoo_5.3.0_arm64.deb
# Result: Installs but binary still crashes (missing libhailort.so.5.3.0)

Attempt 2: Manual hailort Installation

sudo apt install hailort=5.2.0
# Result: Causes conflicts, APT removes h10-hailort instead

Expected Behavior

After installation:

$ hailo-ollama
Listening on http://0.0.0.0:8000

Should work with h10-hailort installed and libraries available:

$ ldd /usr/bin/hailo-ollama | grep hailort
    libhailort.so.5.3.0 => /usr/lib/libhailort.so.5.3.0

Impact

  • :cross_mark: Cannot use hailo-ollama CLI tool on Hailo-10H
  • :cross_mark: Cannot follow official README installation instructions
  • :cross_mark: Blocks integration with Open WebUI
  • :white_check_mark: Workaround exists: Use hailo-apps venv instead

Workaround (Until Fix)

Use the bundled GenAI apps from hailo-apps instead of system package:

# Activate hailo-apps venv
source ~/hailo-apps/venv_hailo_apps/bin/activate

# Run LLM server (has correct dependencies)
python -m hailo_apps.python.gen_ai_apps.simple_llm_chat.simple_llm_chat --mode server --port 8000

# In another terminal: Run Open WebUI
docker run -d --network host \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Result: Both services work correctly without package conflicts.


Requested Fix

Option A (Recommended): Update .deb package

  • Change Depends: hailort to Depends: h10-hailort (>= 5.2.0)
  • Add hardware detection to select correct dependency
  • Rebuild and publish corrected version

Option B (Alternative): Provide separate package

  • hailo-gen-ai-model-zoo-h10_5.3.0_arm64.deb (for Hailo-10H, requires h10-hailort)
  • hailo-gen-ai-model-zoo-8l_5.3.0_arm64.deb (for Hailo-8L, requires hailort)

Option C (Documentation): Update README

  • Document the dependency issue
  • Provide manual installation workarounds
  • Link to venv-based alternative

Additional Information

  • Package Date: April 4, 2026
  • Build Date: Published to Raspberry Pi repository (trixie/main)
  • Affected Versions: hailo-gen-ai-model-zoo 5.3.0 (at minimum)
  • Hardware: Hailo-10H (possibly also other H-series devices)

Files Affected

  • .deb file: hailo-gen-ai-model-zoo_5.3.0_arm64.deb
  • Binary: /usr/bin/hailo-ollama
  • Documentation: hailo_apps/python/gen_ai_apps/hailo_ollama/README.md

Reproducibility

:green_circle: Always reproducible on Raspberry Pi 5 + Hailo-10H with Debian 13


Contact Information

  • User: PromiseYouDE
  • Hardware: Hailo-10H on Raspberry Pi 5
  • Use Case: Robotics AI integration (Vision + LLM)

**Thank you for your attention to this issue. Happy to provide additional logs or testing if needed.
**
(The installation attempts were assisted by AI, specifically the LLM Claude Haiku 4.5 via Copilot (github.com).

Hi @Achim_Haber,

There are 2 separate parts to my answer:

  1. Last week there was an issue with the sudo apt install hailo-h10-all command - This was fixed ASAP as we noticed. However this installation currently carries the 5.1 suite.
  2. For the 5.3 bump - manual installation is required by downloading all necessary files from our developer zone. Please note, that for this direction - a complete uninstall of old artifact is required to start from fresh clean environment: Raspberry Trixie Error with Guide (Pi 5, AI Hat 2) - #18 by Michael

Thanks,

Dear Michael,

I hope this message finds you well. I’m writing to follow up on my recent bug report posted in the Hailo forum regarding the hailo-gen-ai-model-zoo 5.3.0 package being uninstalled on Raspberry Pi 5 with Hailo-10H due to dependency conflicts.

As mentioned in the report, I’ve successfully installed the full hailo-apps stack four times without issue. However, when attempting to run hailo-ollama (required for Open WebUI integration), the process fails due to a library version mismatch:

  • The .deb package incorrectly depends on the generic hailort (for Hailo-8L), but Hailo-10H requires the architecture-specific h10-hailort.
  • This forces APT to downgrade h10-hailort to hailort 4.23.0, causing runtime crashes (libhailort.so.5.3.0 missing).

In the hailo-apps repository, the python/gen_ai_apps README directs users to follow the Hailo Ollama integration guide for Open WebUI setup. However, following these instructions leads back to the same dependency conflict described in my bug report.

Key questions:

  1. Is there a workaround to use hailo-ollama with Hailo-10H without triggering the downgrade?
  2. Should the hailo-gen-ai-model-zoo package dependencies be updated to explicitly require h10-hailort for Hailo-10H systems?
  3. Are there plans to split the package into architecture-specific versions (as suggested in my report’s “Option B”)?

I’m happy to provide additional logs, system details, or test potential fixes. Thank you for your support in resolving this!

Best regards,
Achim Haber
(Erstellt mit Qwen VL 235b)

It’s usable on my pi 5 and hailo 10h with raspbian trixie.

Drop everything hailo related from pi so that it’s clean and then install 5.3.0 everything from software download center. Don’t touch apt versions at all - they have 5.1.0.

Note that hailo ollama 5.3.0 is broken right now and doesn’t escape characters correctly so prompts with “enter \n” are giving 500s

Hi @Spaier ,

You’re right and we are working to fix this.

Thanks,

Hello Michael,
no matter which guide I follow, I always fail because as soon as I want to install the hailo-gen-ai-model-zoo (no matter if 5.2.0 with apt, or 5.3.0 from the hailo download page. In both cases I get the message that existing h10-hailo packages should be removed, and instead of h10-hailort hailort should be installed again, but here is the incompatibility.
You wrote in another post, there will be a fix, and then again, you have to wait for a new update. My question now, how long do we have to wait approximately?

Hi @Achim_Haber,

  1. Here are the instructions for complete uninstall: Raspberry Trixie Error with Guide (Pi 5, AI Hat 2) - #18 by Michael

  2. It’s possible to install manually 5.1/5.2/5.3 by downloading relevant Debian files from our developer zone.

  3. The inconsistency was a temporary issue with the special quick install on Raspberry Pi (sudo apt install hailo-h10-all) that spares manually downloading and installing Debian files from our dev zone. It was quickly corrected and sudo apt install hailo-h10-all now works just fine as usually.

  4. In hailo-ollama 5.3 there is a bug related to escape characters, and in the upcoming release it will be fixed.

Thanks,
Michael.

Hello Michael

Unfortunately, I still can’t get any further. I uninstalled everything, and installed everything again according to your script. Installation Verification
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📁 Virtual environment: ✅ OK
🐍 hailo_apps package: ✅ OK
📦 HailoRT Python binding: ✅ OK
📦 TAPPAS Core Python binding: ✅ OK
🏗️ Hailo Architecture: hailo10h
📦 Model Zoo Version: v5.1.0
📁 Resources symlink: ✅ OK
Found 22 model files (.hef)
📄 Environment file: ✅ OK (/usr/local/hailo/resources/.env)
🔨 C++ postprocess libs: ✅ 15 libraries

════════════════════════════════════════════════════════════════
Installation Summary
════════════════════════════════════════════════════════════════

✅ User Detection User: cloud-adm, Group: cloud-adm
✅ Prerequisites Check All required components found
✅ System Packages Packages installed
✅ Resources Setup Resources at /usr/local/hailo/resources
✅ Virtual Environment venv: /home/cloud-adm/hailo-apps/venv_hailo_apps
✅ Python Packages Packages installed
✅ Post-Installation Post-install done

✅ Installation completed successfully!

Virtual environment: /home/cloud-adm/hailo-apps/venv_hailo_apps
To activate: source /home/cloud-adm/hailo-apps/setup_env.sh

Log file: /home/cloud-adm/hailo-apps/logs/install_20260517_154230.log

But when I call up “Hailo-Ollama”, nothing happens. Nix Ollama-Server but if I now follow the instructions on github to run WebUI and hailo-ollama, I should do the following

Part 1: Hailo-Ollama Installation and Setup Step 1: Download and Install Hailo GenAI Model Zoo Visit: https://hailo.ai/developer-zone/ Download the appropriate package for your architecture Important: The supported version is 5.1.1, 5.2.0 & 5.3.0 Install the package: sudo apt install hailo_gen_ai_model_zoo_ _.deb Step 2: Start Hailo-Ollama Service In a terminal window, start the Hailo-Ollama service: hailo-ollama – Since I already have the hailo-gen-ai-model-zoo, apt ruins everything again (takes the hailort instead of h10-hailort again)

If I follow this guide now, I am where I was before, because apt now wants to replace the h10 elements again h10-hailort becomes hailort, and there is another bang.

So my question is still open, can the hailo-ollama server be put into operation, or is there already a fix that I can’t find?

I am still very proficient in English, and I use various translation machines, Since the forum is in English, it is very very very possible that one or the other information passes me by, because I have translated it incorrectly (i.e. in the Brain from English to German)

Hi @Achim_Haber,

Can you please repost? Something happen to the text…

Thanks,

Hi Michael,

Here is my complete report again, this time without the error messages.

I successfully installed the Hailo-10H, including the hailo-apps package.

The verification test was successful:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Installation Verification
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📁 Virtual environment: ✅ OK
🐍 hailo_apps package: ✅ OK
📦 HailoRT Python binding: ✅ OK
📦 TAPPAS Core Python binding: ✅ OK
🏗️ Hailo Architecture: hailo10h
📦 Model Zoo Version: v5.1.0
📁 Resources symlink: ✅ OK
Found 22 model files (.hef)
📄 Environment file: ✅ OK (/usr/local/hailo/resources/.env)
🔨 C++ postprocess libs: ✅ 15 libraries

════════════════════════════════════════════════════════════════
Installation Summary
════════════════════════════════════════════════════════════════

✅ User Detection User: cloud-adm, Group: cloud-adm
✅ Prerequisites Check All required components found
✅ System Packages Packages installed
✅ Resources Setup Resources at /usr/local/hailo/resources
✅ Virtual Environment venv: /home/cloud-adm/hailo-apps/venv_hailo_apps
✅ Python Packages Packages installed
✅ Post-Installation Post-install done

✅ Installation completed successfully!

Virtual environment: /home/cloud-adm/hailo-apps/venv_hailo_apps
To activate: source /home/cloud-adm/hailo-apps/setup_env.sh

Log file: /home/cloud-adm/hailo-apps/logs/install_20260517_154230.log

Now I would like to use OpenWebUI again as the frontend for the LLM, as I did before.

For this, I used the hailo-ollama server.

Inside the folder /home/cloud-adm/hailo-apps, there is an installation guide located at:

/home/cloud-adm/hailo-apps/hailo_apps/python/gen_ai_apps/hailo_ollama

Following this guide, I downloaded the package from the Hailo Developer Zone:

https://hailo.ai/developer-zone/software-downloads/?product=ai_accelerators&device=hailo_10h

Package:
Hailo Model Zoo GenAI - Ubuntu package (deb) for arm64
hailo_gen_ai_model_zoo_5.3.0_arm64.deb

However, when I try to install it with:

sudo apt install hailo-gen-ai-model-zoo

I get the following result:

The following packages were automatically installed and are no longer required:
...
Use sudo apt autoremove to remove them.

Install:
hailo-gen-ai-model-zoo

Install dependencies:
hailort

REMOVE:
h10-hailort
hailo-h10-all
python3-h10-hailort

Summary:
Upgrade: 0, Install: 2, Remove: 3, Not upgraded: 0

If I continue, the H10-specific components are removed and replaced with the older HailoRT version, which then no longer works.

So my question is:

How can I install and use hailo-ollama correctly so that OpenWebUI can run together with the Hailo-10H installation without replacing the required H10 packages?

cloud-adm@PY-Net-CloudAI:~$ sudo apt install /home/cloud-adm/Downloads/hailo_gen_ai_model_zoo_5.3.0_arm64.deb
[sudo] Passwort für cloud-adm:
Hinweis: »hailo-gen-ai-model-zoo« wird an Stelle von »/home/cloud-adm/Downloads/hailo_gen_ai_model_zoo_5.3.0_arm64.deb« gewählt.
Die folgenden Pakete wurden automatisch installiert und werden nicht mehr benötigt:
cmake libfyba0t64 libnorm-dev libpng-tools
….
libfontconfig-dev libmount-dev libpixman-1-dev
libfreetype-dev libmunge2 libpmix2t64
libfreexl1 libnetcdf22 libpng-dev
Verwenden Sie »sudo apt autoremove«, um sie zu entfernen.

Installiere:
hailo-gen-ai-model-zoo

Installiere Abhängigkeiten:
hailort

ENTFERNE:
h10-hailort hailo-h10-all python3-h10-hailort

Zusammenfassung:
Aktualisiere: 0, Installiere: 2, Entferne: 3, Aktualisiere nicht: 0
Herunterlade-Größe: 5.604 kB / 6.106 kB
Benötigter Platz: 3.735 kB / 929 GB verfügbar

Fortfahren? [J/n] n
Abbruch.

i have post the wrong installation with apt.
This ist the result from /Download

Hi @Achim_Haber,

I apologize - Now I realized the actual issue: Indeed there is a conflict in the names<->dependencies:
hailo_gen_ai_model_zoo .deb declares a dependency on the generic hailort package, but Raspberry Pi system uses h10-hailort naming instead, so apt tries to swap them. You might try installing with sudo dpkg -i hailo_gen_ai_model_zoo_5.3.0_arm64.deb instead of sudo apt install , since dpkg won’t attempt automatic dependency resolution - if it still complains about an unmet dependency on hailort, you could add --force-depends (i.e. sudo dpkg -i --force-depends hailo_gen_ai_model_zoo_5.3.0_arm64.deb ) because your h10-hailort already provides the actual HailoRT libraries that hailo-ollama needs at runtime. After that, hailo-ollama should be available and you can start it and point Open WebUI at http://localhost:8000 as before.

@Achim_Haber

However, officially for Pi only version hailo_gen_ai_model_zoo_5.1.1 is supported (compatible to versions obtained from the official installation for PI: sudo apt install hailo-h10-all: https://www.raspberrypi.com/documentation/computers/ai.html), and this version does not requires hailort, you can validate: dpkg-deb --info /path-to/hailo_gen_ai_model_zoo_5.1.1_arm64.deb | grep Depends

Translation

Hi Michael,

thanks for your help, but I’m still stuck.
Below are the outputs from the attempts to install with dpkg:

cloud-adm@PY-Net-CloudAI:~$ cd Downloads/
cloud-adm@PY-Net-CloudAI:~/Downloads$ sudo dpkg -i hailo_gen_ai_model_zoo_5.3.0_arm64.deb 
[sudo] password for cloud-adm: 
Previously unselected package hailo-gen-ai-model-zoo is now selected.
(Reading database ... 216325 files and directories currently installed.)
Preparing to unpack hailo_gen_ai_model_zoo_5.3.0_arm64.deb ...
Unpacking hailo-gen-ai-model-zoo (5.3.0) ...
dpkg: dependency problems - leaving unconfigured
 hailo-gen-ai-model-zoo depends on hailort; however:
  Package hailort is not installed.

dpkg: error processing package hailo-gen-ai-model-zoo (--install):
 dependency problems - leaving unconfigured
Errors were encountered while processing:
 hailo-gen-ai-model-zoo
cloud-adm@PY-Net-CloudAI:~/Downloads$ sudo dpkg -i --force-depends hailo_gen_ai_model_zoo_5.3.0_arm64.deb 
(Reading database ... 216351 files and directories currently installed.)
Preparing to unpack hailo_gen_ai_model_zoo_5.3.0_arm64.deb ...
Unpacking hailo-gen-ai-model-zoo (5.3.0) over (5.3.0) ...
dpkg: hailo-gen-ai-model-zoo: dependency problems, but configuring anyway as requested:
 hailo-gen-ai-model-zoo depends on hailort; however:
  Package hailort is not installed.

Setting up hailo-gen-ai-model-zoo (5.3.0) ...

Hi @Achim_Haber , please see also my recent comment: # Bug Report: hailo-gen-ai-model-zoo 5.3.0 Uninstallable on Raspberry Pi with Hailo-10H - #13 by Michael

Hello Michael,

I just downloaded and installed model-zoo 5.1.1 from the dev zone, and that’s it. Unfortunately, it was not displayed before, because I (as I noticed today) always searched for the latest (default), and the 5.1.1 was never displayed. Thank you very much that both zoo’s (i.e. 5.3 and 5.1) can now be seen in the list.

Install and run

cloud-adm@PY-Net-CloudAI:~/Downloads$ sudo dpkg -i hailo_gen_ai_model_zoo_5.1.1_arm64.deb
[sudo] Passwort für cloud-adm:
dpkg: Warnung: Paket hailo-gen-ai-model-zoo (5.3.0) wird durch ältere Version (5.1.1) ersetzt
(Lese Datenbank … 216351 Dateien und Verzeichnisse sind derzeit installiert.)
Vorbereitung zum Entpacken von hailo_gen_ai_model_zoo_5.1.1_arm64.deb …
Entpacken von hailo-gen-ai-model-zoo (5.1.1) über (5.3.0) …
hailo-gen-ai-model-zoo (5.1.1) wird eingerichtet …
cloud-adm@PY-Net-CloudAI:~/Downloads$ hailo-ollama
I |2026-05-18 20:14:33 1779128073028177| MyApp:Server running on port 8000
^C I |2026-05-18 20:14:41 1779128081230839| MyApp:Stop signal received, please wait for server shutdown
I |2026-05-18 20:14:41 1779128081230977| generation_context:stop received

Environment:
objectsCount = 0
objectsCreated = 72
1 Like

Hello Michael,

Yesterday APT Upgrade tried to install version 5.2.2 of the Hailo Gen AI Zoo, which failed due to the hailort. I have just marked 5.2.2 in the apt to go over, and wanted to install the 5.1.1 again. (dpkg -i ./hailo_gen_ai_model_zoo_5.1.1_arm64.deb and also apt install ./hailo_gen_ai_model_zoo_5.1.1_arm64.deb)

Now I get the error hailo-gen-ai-model-zoo (5.1.1) is being set up…

chmod: Unable to access ‘/usr/share/hailo-ollama/models’: File or directory not found

dpkg: Error editing package hailo-gen-ai-model-zoo (–configure):“installed post-installation script of package hailo-gen-ai-model-zoo” subprocess returned error value 1

Error occurred while editing:hailo-gen-ai-model-zooI checked, and under /usr/share/ there is no folder ‘hailo-ollama/models’

For me, the folder /usr/share/hailo-models is where can I find the script that triggers the error? Can you help me with this error?

Hi @Achim_Haber,

I want to understand your setup, because Hailo Gen AI Zoo is not part of hailo-all APT list of packages.
This is the current list:

Hi Michael,

The new error stems from apt or, more precisely, the package manager on the Raspberry Pi.
The Raspberry Pi system is trying to install hailo-gen-ai-model-zoo version 5.2.2.
When I followed that prompt, I fell into the familiar trap again.
I had to reset the system back to 5.1.1 following your instructions.

Now, I’ve prevented package upgrades by running:

bash

Kopieren

sudo apt-cache search hailo | grep "^hailo" | awk '{print $1}' | xargs sudo apt-mark hold

Here’s an excerpt from apt showing the current state:

bash

Kopieren

sudo apt list --upgradable -a
hailo-gen-ai-model-zoo/stable 5.2.0 arm64 [upgradeable from: 5.1.1]
hailo-gen-ai-model-zoo/now 5.1.1 arm64  [Installed, upgradeable to: 5.2.0]

So, the issue lies with the Raspberry Pi package manager, not with Hailo itself :slight_smile:

Thanks @Achim_Haber - we will check it ASAP.