Back to Nexa Sdk

CLI Install

docs/en/run/cli/install.mdx

0.3.163.8 KB
Original Source

import Feedback from "/snippets/page-feedback.mdx";

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
Set-Alias geniex (where.exe geniex)
```

### **Verify**

```powershell windows
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
export HOME=/root
```

Then run the install script:

```bash bash
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
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 [Linux install → Install host dependencies](/en/run/linux/install#install-host-dependencies).
</Note>

### **Verify**

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

    Open a new shell or `source` that file.
  </Accordion>
</AccordionGroup>
</Tab> </Tabs> <Feedback/>