CLI 安装

- 骁龙 X 系列芯片（X Elite 或 X2 Elite）。详见[支持的平台](/cn/get-started/platforms)。
- PowerShell 或任意 Windows ARM64 上可用的 shell。

### **下载**

<Card title="GenieX CLI installer" icon="download" href="https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-geniex/geniex-cli.exe">
  最新 Windows ARM64 GenieX CLI。点击下载好的 `.exe` 并按提示完成安装。
</Card>

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

### **加入 PATH**

让 `geniex` 在 shell 中可用：

```powershell windows
Set-Alias geniex (where.exe geniex)
```

### **验证**

```powershell windows
geniex --help
```

现在跳转到[快速入门](/cn/run/cli/quickstart)。

### **前置条件**

- Linux ARM64 主机。
- 跃龙 IoT 芯片——详见[支持的平台](/cn/get-started/platforms)。

### **安装**

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

```bash bash
export HOME=/root
```

然后运行安装脚本：

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

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

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

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

<Note>
  若脚本提示缺少共享库（`libCB.so.1`、`libOpenCL_adreno.so.1`、`libcdsprpc.so.1.0.0` 等），请先安装高通驱动包——参见 [Linux 安装 → 安装宿主机依赖](/cn/run/linux/install#安装宿主机依赖)。
</Note>

### **验证**

```bash bash
geniex --help
```

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

### **高级选项**

<AccordionGroup>
  <Accordion title="安装位置">
    脚本无需 `sudo` 运行，并根据当前用户选择安装位置：

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

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

  <Accordion title="固定版本或使用自定义前缀">
    在 `sh -s --` 后传入参数：

    ```bash 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
    ```
  </Accordion>

  <Accordion title="手动加入 PATH">
    若启动器目录不在 `PATH` 中，将安装脚本打印的行添加进去——一般为：

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

    打开新 shell 或 `source` 该文件。
  </Accordion>
</AccordionGroup>