Experiments

Manage experiments with the AX CLI

The ax experiments commands let you create, retrieve, and manage experiments on the Arize platform.

ax experiments list

List all experiments, optionally filtered by dataset.

ax experiments list [--dataset <name-or-id>] [--space <id>] [--limit <n>] [--cursor <cursor>]

Option	Description
--dataset	Filter experiments by dataset name or ID
--space	Space name or ID (required when using a dataset name instead of ID)
--limit	Maximum number of results to return (default: 15)
--cursor	Pagination cursor for the next page

Example:

ax experiments list --dataset ds_xyz789
ax experiments list --dataset my-eval-set --space my-space

ax experiments get

Retrieve an experiment by name or ID.

ax experiments get <name-or-id> [--dataset <name-or-id>] [--space <id>]

Option	Description
--dataset	Dataset name or ID (required when using an experiment name instead of ID)
--space	Space name or ID (required when using a dataset name instead of ID)

Examples:

ax experiments get exp_abc123
ax experiments get my-experiment --dataset my-eval-set --space my-space

ax experiments create

Create a new experiment from a local file. The file must contain example_id and output columns. Extra columns are passed through as additional fields.

ax experiments create --name <name> --dataset <name-or-id> --file <path>

Option	Description
--name	Name for the new experiment
--dataset	Dataset name or ID to attach the experiment to
--file	Path to the data file (CSV, JSON, JSONL, or Parquet) with experiment runs, or - for stdin

Example:

ax experiments create --name "my-experiment" --dataset ds_xyz789 --file ./runs.csv

ax experiments export

Export runs from an experiment to a JSON file.

ax experiments export <name-or-id> [--dataset <name-or-id>] [--space <id>] [--output-dir <path>] [--stdout] [--all]

Option	Description
--dataset	Dataset name or ID (required when using an experiment name instead of ID)
--space	Space name or ID (required when using a dataset name instead of ID)
--output-dir	Directory to write the output file (default: current directory)
--stdout	Print JSON to stdout instead of saving to a file
--all	Use Arrow Flight for bulk export — streams all runs

Examples:

ax experiments export exp_abc123
ax experiments export my-experiment --dataset my-eval-set --space my-space --output-dir ./exports
ax experiments export exp_abc123 --all
ax experiments export exp_abc123 --stdout | jq 'length'

ax experiments delete

Delete an experiment.

ax experiments delete <name-or-id> [--dataset <name-or-id>] [--space <id>] [--force]

Option	Description
--dataset	Dataset name or ID (required when using an experiment name instead of ID)
--space	Space name or ID (required when using a dataset name instead of ID)
--force	Skip the confirmation prompt

Examples:

ax experiments delete exp_abc123
ax experiments delete my-experiment --dataset my-eval-set --space my-space --force