---
title: "CLI - Installation"
description: "Learn how to install the CLI to interact with AI Tools"
url: https://docs.ovhcloud.com/it/guides/public-cloud/ai-machine-learning/ai-cli-install-client
lang: it
lastUpdated: 2023-03-31
---
# CLI - Installation

## Objective

This guide covers the installation of 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://www.ovhcloud.com/en-gb/public-cloud/) in your OVHcloud account
- **AI Training activated** for your account, see [how to submit a job Step 2](/it/guides/public-cloud/ai-machine-learning/ai-training-submit-job.md)
- a user for AI Tools, see [how to create a user](/it/guides/public-cloud/ai-machine-learning/ai-users.md)

## Instructions

### Step 1: Installing the CLI

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

- Gravelines (`GRA`) in France
- Beauharnois (`BHS`) in Canada

:::info
Here by default we will use the region `gra` in each of the commands. You are free to replace it with `bhs` if you want.
:::

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.gra.ai.cloud.ovh.net/install.sh | bash
```

For zsh:

```console
curl https://cli.gra.ai.cloud.ovh.net/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.gra.ai.cloud.ovh.net
```

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
```

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:

![image](/images/public-cloud/ai-machine-learning/cli-10-howto-install-cli/00_oauth2_login.png)
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](/it/guides/public-cloud/ai-machine-learning/ai-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**.

## Feedback

Please send us your questions, feedback and suggestions to improve the service:

- On the OVHcloud [Discord server](https://discord.gg/ovhcloud)

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