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 today

Where in Arena

Commands shown

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)

On-prem training cluster → class Config

arena on-prem install, arena on-prem teardown

Experiment setup, environments, and most training work still happen in the web UI. On-prem cluster install is the main training-related terminal workflow today. See On-prem CLI and Commands for exact strings.

This documentation covers arena … commands and UI labels. For anything beyond what Arena shows in the app, use arena --help in the installed CLI package.

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.