Skip to main content
The core CLI runs with no configuration. A few features need an extra package or an API key.

Optional extras

Install these into a source install (pip install -e .). The standalone binary can’t load them.
ExtraInstallUnlocks
gympip install -e ".[gym]"MuJoCo simulator. Required for env run, env show rendering, and the SDK.
lorapip install -e ".[lora]"LoRA fine-tuning of the action head. Required for env lora and env run --policy lora.
Both pull in cadenza-lab (the SDK). lora also installs torch.

Environment variables

VariableUsed byPurpose
GROQ_API_KEYenv trainAPI key for the Groq LLM-as-Judge that rewrites a project’s system prompt.
CADENZA_NO_NOTIFYshellSet to 1 to silence the terminal bell/notification after long runs.
XDG_CACHE_HOMEshellOverrides the base cache directory (default ~/.cache).
Self-hosting the backend additionally reads SUPABASE_URL and SUPABASE_ANON_KEY (or SUPABASE_KEY). For local development these can live in a .env file at the repo root. See the project README.
export GROQ_API_KEY="gsk_..."     # then: cadenza env train my-project

Files & directories

PathContents
~/.cadenza/config.jsonYour saved sign-in session (token).
<project>/env.jsonThe mission specification for a project.
<project>/.cadenza-env/Per-run logs and fine-tune records.