CLI 安装

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

Windows ARM64
Linux ARM64 (Native)

前置条件

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

下载

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

开始使用

运行

资源

前置条件

下载

GenieX CLI installer

加入 PATH

验证

前置条件

安装宿主机依赖

安装

验证

高级选项

​前置条件

​下载

GenieX CLI installer

​加入 PATH

​验证

​前置条件

​安装宿主机依赖

​安装

​验证

​高级选项

前置条件

下载

加入 PATH

验证

前置条件

安装宿主机依赖

安装

验证

高级选项