> ## 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 Install

> Install the GenieX CLI on Windows ARM64, or run it via Docker on Linux ARM64.

The CLI ships as a native Windows ARM64 executable, and as a Linux ARM64 Docker image for Dragonwing QCS9075 and similar IoT devices.

<Tabs>
  <Tab title="Windows ARM64">
    ### **Prerequisites**

    * Snapdragon X-series chipset (X Elite or X2 Elite). See [Supported platforms](/en/get-started/platforms).
    * PowerShell or any shell available on Windows ARM64.

    ### **Download**

    <Card title="GenieX CLI installer" icon="download" href="https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-geniex/geniex-cli.exe">
      Latest GenieX CLI for Windows ARM64. Click the downloaded `.exe` and follow the prompts.
    </Card>

    The installer is not yet code-signed — Windows SmartScreen will warn you. Click **More info → Run anyway**.

    ### **Add to PATH**

    Make `geniex` available in your shell:

    ```powershell windows theme={"dark"}
    Set-Alias geniex (where.exe geniex)
    ```

    ### **Verify**

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

    Now jump to the [Quickstart](/en/run/cli/quickstart).
  </Tab>

  <Tab title="Linux ARM64 (Native)">
    Install directly on a Dragonwing ARM64 Linux host (EVK, container, or any device with a Qualcomm BSP) — no Docker required.

    ### **Prerequisites**

    * Linux ARM64 host.
    * Dragonwing IoT chipset — see [Supported platforms](/en/get-started/platforms).

    ### **Install**

    If `HOME` is not set (common in minimal containers or `sudo -s` sessions), export it first so the installer knows where to place binaries:

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

    Then run the install script:

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

    The script downloads the latest stable release, verifies its SHA256, and installs without `sudo`. If the launcher directory isn't already on your `PATH`, it prints the exact export line to append — for example:

    ```bash bash theme={"dark"}
    echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc / ~/.profile
    ```

    Open a new shell or `source` that file to pick up the change.

    <Note>
      If the script reports missing shared libraries (`libCB.so.1`, `libOpenCL_adreno.so.1`, `libcdsprpc.so.1.0.0`, etc.), install the Qualcomm driver packages first — see [Troubleshooting → Linux](/en/resources/troubleshooting#linux).
    </Note>

    ### **Verify**

    ```bash bash theme={"dark"}
    geniex --help
    ```

    If `geniex` isn't found, open a new shell — or follow the `PATH` line the installer printed at the end of its output.

    ### **Advanced**

    <AccordionGroup>
      <Accordion title="Install locations">
        The script runs without `sudo` and picks a location based on who you are:

        * **Root** (EVK / container) → binary in `/usr/local/lib/geniex/`, launcher at `/usr/local/bin/geniex`.
        * **Non-root** → binary in `${XDG_DATA_HOME:-~/.local/share}/geniex/`, launcher at `~/.local/bin/geniex`.

        It downloads the latest stable release, verifies its SHA256, and installs atomically.
      </Accordion>

      <Accordion title="Pin a version or use a custom prefix">
        Pass flags after `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="Add to PATH manually">
        If the launcher directory isn't on your `PATH`, add the line the installer printed — typically:

        ```bash bash theme={"dark"}
        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc / ~/.profile
        ```

        Open a new shell or `source` that file.
      </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>
