> ## Documentation Index
> Fetch the complete documentation index at: https://geniex.aihub.qualcomm.com/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 镜像。

<Tabs>
  <Tab title="Windows ARM64">
    ### **前置条件**

    * 骁龙 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 theme={"dark"}
    Set-Alias geniex (where.exe geniex)
    ```

    ### **验证**

    ```powershell windows theme={"dark"}
    geniex --help
    ```

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

  <Tab title="Linux ARM64 (Native)">
    直接安装到跃龙 ARM64 Linux 主机（EVK、容器或任何带有高通 BSP 的设备）——无需 Docker。

    ### **前置条件**

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

    ### **安装**

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

    ```bash bash theme={"dark"}
    export HOME=/root
    ```

    然后运行安装脚本：

    ```bash bash theme={"dark"}
    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={"dark"}
    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/resources/troubleshooting#linux)。
    </Note>

    ### **验证**

    ```bash bash theme={"dark"}
    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 theme={"dark"}
        # 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 theme={"dark"}
        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc   # 或 ~/.zshrc / ~/.profile
        ```

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

<br />

<div class="feedback-wrapper">
  <span class="feedback-label">Was this page helpful?</span>

  <div class="feedback-toggle">
    <input type="radio" name="feedback" id="feedback-yes" class="feedback-input" />

    <label for="feedback-yes" class="feedback-button">
      <img src="https://mintcdn.com/qualcomm-0801e48b/VijZ6eXFSGIGNc9Z/Images/FeedBack/thumbs-up.svg?fit=max&auto=format&n=VijZ6eXFSGIGNc9Z&q=85&s=9fa1e132909ee8667d02f775cd8bc108" alt="Thumbs up" class="feedback-icon" noZoom width="14" height="14" data-path="Images/FeedBack/thumbs-up.svg" />

      Yes
    </label>

    <input type="radio" name="feedback" id="feedback-no" class="feedback-input" />

    <label for="feedback-no" class="feedback-button">
      <img src="https://mintcdn.com/qualcomm-0801e48b/VijZ6eXFSGIGNc9Z/Images/FeedBack/thumbs-down.svg?fit=max&auto=format&n=VijZ6eXFSGIGNc9Z&q=85&s=7f5f8865b502b5262849a700e6989278" alt="Thumbs down" class="feedback-icon" noZoom width="14" height="14" data-path="Images/FeedBack/thumbs-down.svg" />

      No
    </label>
  </div>
</div>
