Arena CLI

The Arena Python CLI is the arena command you install on your laptop or runner. It talks to your Arena organization the same way the web app does, but from a terminal.

Install it from PyPI with the arena extra:

pip install "agilerl[arena]"

The arena command ships in the agilerl-arena package, so pip install agilerl-arena works too if you do not need core AgileRL. Use a virtual environment if your team standard requires one. After install, confirm the CLI is on your path:

arena --help

Then sign in once (see Authentication) and run commands from your shell or scripts.

What you can do from the terminal

Where in Arena

Commands

Projects

arena projects create

Datasets

arena datasets create

Environments

arena env validate, arena env entrypoints

Experiments

arena experiments submit, arena experiments list, arena experiments checkpoints

Compute

arena resources list

Profile management → CLI API key

ARENA_API_KEY, or arena login instead of a key

Agents → LLM deployment Arena CLI tab

arena agent generate (LLM deployments only)

Bring your own compute (BYOC) → Install

arena cluster register, arena cluster rotate-token, arena cluster unregister, arena cluster provision — full list in BYOC CLI

Your own Snowflake account

arena snowflake setup, arena snowflake submit, arena snowflake publish (install agilerl-arena[snowflake]). Walkthrough: Snowflake

Use arena to create projects and datasets, validate gyms, and submit experiments. The Results tab stays in the web app. See Commands for examples and BYOC CLI for cluster install. For other flags, run arena --help.

Configuration

  • arena login: opens a browser sign-in and stores a session on disk. See Authentication.

  • ARENA_API_KEY: long-lived personal access token from Profile (arena_pat_<uuid>_<secret>). Same page: create, rotate, revoke.