Polyaxon CLI is a tool and a client to interact with Polyaxon, it allows you to manage your cluster, projects, and experiments.
To install Polyaxon CLI please refer to the installation documentation.
To get help from The Polyaxon CLI, you can run the following
$ polyaxon --help
To get help for any Polyaxon CLI Command, you can run the following
$ polyaxon command --help
- Auth (Polyaxon Cloud and Polyaxon EE)
When using the Polyaxon CLI to run a command requiring a project or a run, you can always specify the values for these options, for example:
$ polyaxon project --project=user_1/project_10 get
$ polyaxon ops --project=user_1/project_10 --uid=UUID get
Polyaxon CLI allows also you to omit these options for project and runs, the CLI does the following:
- When a username is missing, the username of the logged-in user is used, if no use is found the default owner is used.
- When a project name is missing, the name of the currently initialized project is used.
- When a run is missing, the last value is used.
- If no values are found, the CLI will show an error.
All commands and sub-command of
ops support caching:
$ polyaxon project ls
$ polyaxon project get
$ polyaxon ops ls
$ polyaxon ops get
$ polyaxon ops logs
By default, Polyaxon will cache all information on the global path, if you want to enable caching on local project folder(s), you can use the init command:
$ polyaxon init PROJECT_NAME
This will create a local cache folder for the project and its runs.
Anytime you use the cli, it will look first locally, then default to the global path.
Users don't have to change to a new project to access information about that project, and its ops.
All commands allow to change the project context by providing
-p project or
You can as well check other users/organizations projects without initializing the projects,
-p owner/project or
Here are some examples:
Getting other projects experiments:
polyaxon project -p mnist ops -s "-created_at"
polyaxon project --project=adam/mnist ops -q "status: failed"
Getting services named
tensorboardfor some projects:
polyaxon ops --project=mnist ls --query="name: tensorboard" --sort="-created_at"
polyaxon tensorboards -p adam/mnist ls --query="name: tensorboard, status: running"
Getting information about a specific experiment:
polyaxon ops -p mnist -uid UUID get
polyaxon ops -p adam/mnist --uid=UUID get