CLI Install

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.

Update NPU and GPU drivers

Install the latest Qualcomm drivers before running GenieX:

Adreno GPU — Download the latest Windows Graphics Driver, run the installer, and restart Windows. In Device Manager, confirm that the GPU appears under Display adapters.
Hexagon NPU — Download the latest Qualcomm NPU Driver, run the installer, and restart Windows. In Device Manager, confirm that the Hexagon NPU appears under Neural processors.

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 geniex directly on a Dragonwing ARM64 Linux host (EVK or any device with a Qualcomm BSP). If you’d rather run it inside a container, see Linux (Docker) Install instead.

Prerequisites

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

Install host dependencies

geniex reaches the NPU through the host’s Qualcomm driver libraries. Install them before running geniex, in two steps.1. Standard APT packagesProvides libatomic1, libglib2.0-0, and a generic OpenCL ICD loader:

bash

sudo apt update
sudo apt install -y \
  libatomic1 \
  libglib2.0-0 \
  ocl-icd-libopencl1

ocl-icd-libopencl1 is replaced by qcom-adreno1 in the next step.

2. Qualcomm driver packages (via ubuntu-qcom-iot PPA)Provides the Qualcomm-proprietary libraries the NPU needs:

Library	Provided by
`libOpenCL_adreno.so.1`, `libCB.so.1`, `libadreno_utils.so.1`, `libgsl.so.1`, `libllvm-*.so.1`	`qcom-adreno1`
`libdmabufheap.so.0.0.0`	`qcom-libdmabufheap` (auto-dep of `qcom-adreno1`)
`libpropertyvault.so.0.0.0`	`qcom-property-vault` (auto-dep of `qcom-adreno1`)
`libcdsprpc.so.1.0.0`	`qcom-fastrpc1`

bash

sudo apt-get install -y qcom-adreno1 qcom-fastrpc1 libqnn1

The PPA (ppa:ubuntu-qcom-iot/qcom-ppa) is pre-configured on the IQ9075 EVK Ubuntu image. qcom-adreno1 automatically pulls in qcom-libdmabufheap and qcom-property-vault.

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 Install host dependencies above.

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

Get Started

Run

Tutorials

Resources

Prerequisites

Update NPU and GPU drivers

Download

GenieX CLI installer

Add to PATH

Verify

Prerequisites

Install host dependencies

Install

Verify

Advanced

​Prerequisites

​Update NPU and GPU drivers

​Download

GenieX CLI installer

​Add to PATH

​Verify

​Prerequisites

​Install host dependencies

​Install

​Verify

​Advanced

Prerequisites

Update NPU and GPU drivers

Download

Add to PATH

Verify

Prerequisites

Install host dependencies

Install

Verify

Advanced