---
title: "CLI - Installation"
description: "Learn how to install the ovhai CLI. The CLI is the recommended means of interaction with AI Training, AI Notebooks, or AI Deploy services."
url: https://docs.us.ovhcloud.com/en/public-cloud/ai-machine-learning/cli-install-client
lang: en
---
> For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt.

# CLI - Installation

**Learn how to install the ovhai CLI. The CLI is the recommended means of interaction with AI Training, AI Notebooks, or AI Deploy services.**

 

## Requirements

- a [Public Cloud project](https://us.ovhcloud.com/public-cloud/) in your OVHcloud account
- **AI Training activated** for your account, see [how to submit a job here](https://docs.us.ovhcloud.com/en/public-cloud/ai-machine-learning/ai-training-submit-job.md)
- a user for AI Tools, see [how to create a user](https://docs.us.ovhcloud.com/en/public-cloud/ai-machine-learning/manage-users-roles.md)

 

## Instructions

### Step 1: Installing the CLI

You can choose the cluster location for the **ovhai** CLI:

- Vint Hill (`US-EAST-VA`) in Virginia

You can then choose between two methods to install the `ovhai` CLI.

 

#### Install ovhai CLI with a curl command

You can install the `ovhai` CLI with a single command line.

For bash:

```console
curl https://cli.us-east-va.ai.cloud.ovh.us/install.sh | bash
```

For zsh:

```console
curl https://cli.us-east-va.ai.cloud.ovh.us/install.sh | zsh
```

Once done, go to **Step 2**.

If you encounter any issue with the automated installation you can also install manually.

 

#### Install ovhai CLI thanks to a zip file

You can also install the cli by following the link below:

```console
https://cli.us-east-va.ai.cloud.ovh.us
```

After downloading the right zip for your platform, unzip it and add it to your `PATH`:

```console
unzip ovhai-<platform>.zip
mkdir -p $HOME/bin
mv ovhai $HOME/bin/ovhai
export PATH=$PATH:$HOME/bin/
```

 

### Step 2: Authenticating

Once the **ovhai** CLI is installed, you need to authenticate with the **AI Training** service.

```console
ovhai login
```

**Warning:**

**NOTE:** If prompted to update, select YES.

You have the choice between two methods to log in:

- terminal: you can authenticate yourself from within the terminal.
- browser: you will reach an authentication page similar to this:

Use the credentials of your **AI Training** user to log in.

 

### Step 3: Using the command line CLI

You can use the command `ovhai --help` to list available actions and `ovhai <action> --help` for more information about a specific action.

The documentation of the CLI is available at [CLI documentation](https://docs.us.ovhcloud.com/en/public-cloud/ai-machine-learning/cli-overview.md).

In addition, when performing any action in the **AI Training, AI Notebooks, or AI Deploy** sections of the OVHcloud Control Panel you are provided with the equivalent command to get you started with the **ovhai CLI**.

 

## Go further

Browse all the [AI & Machine Learning guides](https://docs.us.ovhcloud.com/en/public-cloud/ai-machine-learning/landing-page-ai-machine-learning.md).

Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services.

Learn more about [AI & Machine Learning](https://us.ovhcloud.com/public-cloud/ai-machine-learning/) on the OVHcloud US website.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://us.ovhcloud.com/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project.