> ## Documentation Index
> Fetch the complete documentation index at: https://qualcomm-0801e48b-fix-serve-reasoning-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# CLI 安装
> 在 Windows ARM64 上安装 GenieX CLI，或在 Linux ARM64 上通过 Docker 运行。
CLI 提供 Windows ARM64 原生可执行文件，以及面向跃龙 QCS9075 等 IoT 设备的 Linux ARM64 Docker 镜像。
### **前置条件**
* 骁龙 X 系列芯片（X Elite 或 X2 Elite）。详见[支持的平台](/cn/get-started/platforms)。
* PowerShell 或任意 Windows ARM64 上可用的 shell。
### **下载**
最新 Windows ARM64 GenieX CLI。点击下载好的 `.exe` 并按提示完成安装。
安装包尚未代码签名——Windows SmartScreen 会发出告警。点击 **More info → Run anyway**。
### **加入 PATH**
让 `geniex` 在 shell 中可用：
```powershell windows theme={null}
Set-Alias geniex (where.exe geniex)
```
### **验证**
```powershell windows theme={null}
geniex --help
```
现在跳转到[快速入门](/cn/run/cli/quickstart)。
直接在跃龙 ARM64 Linux 主机（EVK 或任何带有高通 BSP 的设备）上安装 `geniex`。若你更希望在容器中运行，请参见 [Linux (Docker) 安装](/cn/run/linux/install)。
### **前置条件**
* Linux ARM64 主机。
* 跃龙 IoT 芯片——详见[支持的平台](/cn/get-started/platforms)。
### **安装宿主机依赖**
`geniex` 通过宿主机的高通驱动库来访问 NPU。请在运行 `geniex` 之前分两步安装这些库：
**1. 标准 APT 包**
提供 `libatomic1`、`libglib2.0-0`，以及通用 OpenCL ICD loader：
```bash bash theme={null}
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 bash theme={null}
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 bash theme={null}
export HOME=/root
```
然后运行安装脚本：
```bash bash theme={null}
curl -fsSL https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-geniex/install.sh | sh
```
脚本会下载最新稳定版本、校验 SHA256，并无需 `sudo` 完成安装。若启动器目录尚未加入 `PATH`，脚本会打印需要追加的确切 export 行——例如：
```bash bash theme={null}
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 bash theme={null}
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 bash theme={null}
# 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` 中，将安装脚本打印的行添加进去——一般为：
```bash bash theme={null}
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc # 或 ~/.zshrc / ~/.profile
```
打开新 shell 或 `source` 该文件。