Installation

The fastest path is the install script, which downloads the prebuilt binary for your OS from the latest GitHub Release and puts cadenza on your PATH.

Install the binary

macOS / Linux
Windows (PowerShell)

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.

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.

Verify

cadenza --version
# cadenza 0.2.0

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

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.

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+.

Clone and install

git clone https://github.com/aparekh02/cadenza.git
cd cadenza-cli
pip install -e .

This exposes the cadenza-cli command.

Add extras (optional)

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

Run

cadenza-cli            # interactive shell
cadenza-cli --version

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.

Quickstart

Configuration

Extras, API keys, and environment variables.

Introduction

Configure

Using the CLI

Megan

Reference

Install the binary

Verify

Install from source

Next

Quickstart

Configuration

​Install the binary

​Verify

​Install from source

​Next

Quickstart

Configuration

Install the binary

Verify

Install from source

Next