> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cadenzalabs.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Cadenza CLI binary on macOS, Linux, or Windows, or from source.

The fastest path is the install script, which downloads the prebuilt binary for
your OS from the latest [GitHub Release](https://github.com/aparekh02/cadenza/releases)
and puts `cadenza` on your `PATH`.

## Install the binary

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/aparekh02/cadenza-cli/main/install.sh | bash
    ```

    Downloads `cadenza-mac` (macOS) or `cadenza-linux` (Linux), installs it to
    `/usr/local/bin/cadenza`, and marks it executable. You may be prompted for
    `sudo` if `/usr/local/bin` isn't writable.
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    irm https://raw.githubusercontent.com/aparekh02/cadenza-cli/main/install.ps1 | iex
    ```

    Downloads `cadenza.exe` to `%LOCALAPPDATA%\cadenza\` and adds that folder to
    your user `PATH`. Restart your terminal afterwards so the new `PATH` is picked up.
  </Tab>
</Tabs>

### Verify

```bash theme={null}
cadenza --version
# cadenza 0.2.0
```

If `cadenza` isn't found, open a new terminal (so `PATH` refreshes) and try again.

<Note>
  The standalone binary is self-contained and bundles its own Python. It does
  **not** include the optional simulation, fine-tuning, or RL extras (`gym`,
  `lora`, `rl`, `vla`), which require a Python install. For those features, install
  from source below.
</Note>

## Install from source

Use this for development, or to get the simulation (`gym`), fine-tuning (`lora`),
and residual-RL (`rl`) / VLA (`vla`) features. Requires **Python 3.10+**.

<Steps>
  <Step title="Clone and install">
    ```bash theme={null}
    git clone https://github.com/aparekh02/cadenza.git
    cd cadenza-cli
    pip install -e .
    ```

    This exposes the **`cadenza-cli`** command.
  </Step>

  <Step title="Add extras (optional)">
    ```bash theme={null}
    pip install -e ".[gym]"    # MuJoCo simulator, needed for env run
    pip install -e ".[lora]"   # LoRA fine-tuning, needed for env lora / env vla grd
    pip install -e ".[rl]"     # residual RL + distillation (env residual / env distill)
    pip install -e ".[vla]"    # real VLA loaders for env vla --model smolvla|hf|local
    ```
  </Step>

  <Step title="Run">
    ```bash theme={null}
    cadenza-cli            # interactive shell
    cadenza-cli --version
    ```
  </Step>
</Steps>

<Info>
  **`cadenza` vs `cadenza-cli`.** The install script ships a binary named
  `cadenza`. A source install exposes `cadenza-cli`. The commands are otherwise
  identical. These docs use `cadenza`, so substitute `cadenza-cli` if you installed
  from source.
</Info>

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/cli-setup/quickstart">
    Sign in and run your first mission.
  </Card>

  <Card title="Configuration" icon="gear" href="/cli-setup/configuration">
    Extras, API keys, and environment variables.
  </Card>
</CardGroup>