CLI 安装

CLI 提供 Windows ARM64 原生可执行文件，以及面向跃龙 QCS9075 等 IoT 设备的 Linux ARM64 Docker 镜像。

Windows ARM64
Linux ARM64 (Native)

前置条件

骁龙 X 系列芯片（X Elite 或 X2 Elite）。详见支持的平台。
PowerShell 或任意 Windows ARM64 上可用的 shell。

更新 NPU 与 GPU 驱动

运行 GenieX 前，请安装最新的 Qualcomm 驱动：

Adreno GPU —— 下载最新的 Windows Graphics Driver，运行安装程序，然后重启 Windows。在 设备管理器 中，确认 GPU 显示在 显示适配器 下。
Hexagon NPU —— 下载最新的 Qualcomm NPU Driver，运行安装程序，然后重启 Windows。在 设备管理器 中，确认 Hexagon NPU 显示在 神经处理器 下。

下载

GenieX CLI installer

最新 Windows ARM64 GenieX CLI。点击下载好的 .exe 并按提示完成安装。

安装包尚未代码签名——Windows SmartScreen 会发出告警。点击 More info → Run anyway。

加入 PATH

让 geniex 在 shell 中可用：

windows

Set-Alias geniex (where.exe geniex)

验证

windows

geniex --help

现在跳转到快速入门。

直接在跃龙 ARM64 Linux 主机（EVK 或任何带有高通 BSP 的设备）上安装 geniex。若你更希望在容器中运行，请参见 Linux (Docker) 安装。

前置条件

Linux ARM64 主机。
跃龙 IoT 芯片——详见支持的平台。

安装宿主机依赖

geniex 通过宿主机的高通驱动库来访问 NPU。请在运行 geniex 之前分两步安装这些库：1. 标准 APT 包提供 libatomic1、libglib2.0-0，以及通用 OpenCL ICD loader：

bash

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

ocl-icd-libopencl1 会在下一步被 qcom-adreno1 替换。

2. 高通驱动包（来自 ubuntu-qcom-iot PPA）提供 NPU 所需的高通专有库：

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

PPA（ppa:ubuntu-qcom-iot/qcom-ppa）在 IQ9075 EVK Ubuntu 镜像中已预配置。qcom-adreno1 会自动拉入 qcom-libdmabufheap 与 qcom-property-vault。

安装

若 HOME 未设置（在精简容器或 sudo -s 会话中常见），请先导出该变量，以便安装器知道将二进制文件放置在何处：

bash

export HOME=/root

然后运行安装脚本：

bash

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

脚本会下载最新稳定版本、校验 SHA256，并无需 sudo 完成安装。若启动器目录尚未加入 PATH，脚本会打印需要追加的确切 export 行——例如：

bash

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

打开新 shell 或 source 该文件以使更改生效。

若脚本提示缺少共享库（libCB.so.1、libOpenCL_adreno.so.1、libcdsprpc.so.1.0.0 等），请先安装高通驱动包——参见上文安装宿主机依赖。

验证

bash

geniex --help

若找不到 geniex，请打开新 shell——或按照安装脚本在输出末尾打印的 PATH 行操作。

高级选项

安装位置

脚本无需 sudo 运行，并根据当前用户选择安装位置：

Root（EVK / 容器）→ 二进制位于 /usr/local/lib/geniex/，启动器位于 /usr/local/bin/geniex。
非 root → 二进制位于 ${XDG_DATA_HOME:-~/.local/share}/geniex/，启动器位于 ~/.local/bin/geniex。

脚本下载最新稳定版本，校验 SHA256，并原子化安装。

固定版本或使用自定义前缀

在 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

手动加入 PATH

若启动器目录不在 PATH 中，将安装脚本打印的行添加进去——一般为：

bash

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

打开新 shell 或 source 该文件。

Was this page helpful?

Yes

开始使用

运行

教程

资源

前置条件

更新 NPU 与 GPU 驱动

下载

GenieX CLI installer

加入 PATH

验证

前置条件

安装宿主机依赖

安装

验证

高级选项

​前置条件

​更新 NPU 与 GPU 驱动

​下载

GenieX CLI installer

​加入 PATH

​验证

​前置条件

​安装宿主机依赖

​安装

​验证

​高级选项

前置条件

更新 NPU 与 GPU 驱动

下载

加入 PATH

验证

前置条件

安装宿主机依赖

安装

验证

高级选项