CLI Install - Qualcomm® AI Hub GenieX

The CLI ships as a native Windows ARM64 executable, and as a Linux ARM64 Docker image for Dragonwing QCS9075 and similar IoT devices.

Windows ARM64
Linux ARM64 (Native)

Prerequisites

Snapdragon X-series chipset (X Elite or X2 Elite). See Supported platforms.
PowerShell or any shell available on Windows ARM64.

Download

GenieX CLI installer

Latest GenieX CLI for Windows ARM64. Click the downloaded .exe and follow the prompts.

The installer is not yet code-signed — Windows SmartScreen will warn you. Click More info → Run anyway.

Add to PATH

Make geniex available in your shell:

windows

Set-Alias geniex (where.exe geniex)

Verify

windows

geniex --help

Now jump to the Quickstart.

Install directly on a Dragonwing ARM64 Linux host (EVK, container, or any device with a Qualcomm BSP) — no Docker required.

Prerequisites

Linux ARM64 host.
Dragonwing IoT chipset — see Supported platforms.

Install

If HOME is not set (common in minimal containers or sudo -s sessions), export it first so the installer knows where to place binaries:

bash

export HOME=/root

Then run the install script:

bash

curl -fsSL https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-geniex/install.sh | sh

The script downloads the latest stable release, verifies its SHA256, and installs without sudo. If the launcher directory isn’t already on your PATH, it prints the exact export line to append — for example:

bash

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc / ~/.profile

Open a new shell or source that file to pick up the change.

If the script reports missing shared libraries (libCB.so.1, libOpenCL_adreno.so.1, libcdsprpc.so.1.0.0, etc.), install the Qualcomm driver packages first — see Troubleshooting → Linux.

Verify

bash

geniex --help

If geniex isn’t found, open a new shell — or follow the PATH line the installer printed at the end of its output.

Advanced

Install locations

The script runs without sudo and picks a location based on who you are:

Root (EVK / container) → binary in /usr/local/lib/geniex/, launcher at /usr/local/bin/geniex.
Non-root → binary in ${XDG_DATA_HOME:-~/.local/share}/geniex/, launcher at ~/.local/bin/geniex.

It downloads the latest stable release, verifies its SHA256, and installs atomically.

Pin a version or use a custom prefix

Pass flags after sh -s --:

bash

# Pin a specific version
curl -fsSL .../install.sh | sh -s -- --version v0.1.8

# Custom install prefix
curl -fsSL .../install.sh | sh -s -- --prefix /opt/geniex

Add to PATH manually

If the launcher directory isn’t on your PATH, add the line the installer printed — typically:

bash

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc / ~/.profile

Open a new shell or source that file.

Was this page helpful?

Yes

​Prerequisites

​Download

GenieX CLI installer

​Add to PATH

​Verify

​Prerequisites

​Install

​Verify

​Advanced

Prerequisites

Download

Add to PATH

Verify

Prerequisites

Install

Verify

Advanced