> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# checkpoint push

> Upload checkpoint files to FlexAI from local or remote storage

Upload files to create a new checkpoint in FlexAI

## Usage

```bash theme={null}
flexai checkpoint push <checkpoint_name> [(--file <path_in_filesystem> ... | --file <path_in_filesystem>=<path_in_checkpoint> ...) | (--storage-provider <storage_provider_name> --source-path <source_path>)] [flags]
```

## Arguments

| Argument          | Type   | Required | Description                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `checkpoint_name` | string | Yes      | Pushes a new Checkpoint to FlexAI from either the host machine running the FlexAI CLI or from a [Remote Storage Provider Connection](/cli/reference/storage), such as Hugging Face, Amazon S3, Cloudflare R2 or GCP Cloud Storage. |

## Flags

| Flag                 | Short | Type      | Description                                                                                                                                                                                                                                                                                             |
| -------------------- | ----- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--file`             | `-f`  | key-value | Pushes a new Checkpoint to FlexAI from either the host machine running the FlexAI CLI or from a [Remote Storage Provider Connection](/cli/reference/storage), such as Hugging Face, Amazon S3, Cloudflare R2 or GCP Cloud Storage. 'Key=Value' path pair: `<path_in_filesystem>`=`<path_in_checkpoint>` |
| `--help`             | `-h`  | boolean   | Displays this help page.                                                                                                                                                                                                                                                                                |
| `--source-path`      |       | string    | The path to the source checkpoint files.                                                                                                                                                                                                                                                                |
| `--storage-provider` |       | string    | The name of the Remote Storage Provider Connection to use for the Checkpoint upload.                                                                                                                                                                                                                    |
| `--verbose`          | `-v`  | boolean   | Provides more detailed output when pushing a Checkpoint.                                                                                                                                                                                                                                                |

## Examples

### Push checkpoint from local files

flexai checkpoint push my-checkpoint --file /path/to/checkpoint/

```bash theme={null}
flexai checkpoint push my-checkpoint --file /path/to/checkpoint/
```

### Push checkpoint from storage provider

flexai checkpoint push my-checkpoint --storage-provider my-s3-provider --source-path bucket-name/checkpoints/model/

```bash theme={null}
flexai checkpoint push my-checkpoint --storage-provider my-s3-provider --source-path bucket-name/checkpoints/model/
```