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

# wandb artifact put

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    Source GitHub
  </a>;

<GitHubLink url="https://github.com/wandb/wandb/blob/v0.28.0/wandb/cli/cli.py#L2831" />

<div id="usage">
  ## Utilisation
</div>

```bash theme={null}
put [OPTIONS] PATH
```

<div id="description">
  ## Description
</div>

Téléverser un artefact vers W\&B.

Téléverser un fichier, un répertoire ou une référence d’URL en tant qu’artefact versionné.

Le PATH peut être un fichier local, un répertoire local ou une URL
(contenant `://`) à enregistrer comme artefact de référence.

Si `--name` n’est pas spécifié, le nom de l’artefact prend par défaut le
nom de base du chemin. Si le projet ne peut pas être déduit du
nom, vous êtes invité à en saisir un.

Par exemple, pour téléverser tous les fichiers d’un répertoire local ./data/training comme
artefact de dataset dans W\&B :

```bash theme={null}
wandb artifact put --type dataset ./data/training
```

Pour téléverser model.pt dans le projet "foobar" et attribuer à l’artefact le nom "trained-model" :

```bash theme={null}
wandb artifact put --name foobar/trained-model --type model ./model.pt
```

Pour étiqueter l’artefact avec à la fois "latest" et "v2.0" afin qu’il puisse être
référencé par l’un ou l’autre de ces alias :

```bash theme={null}
wandb artifact put --alias latest --alias v2.0 --type model ./model.pt
```

Pour enregistrer un chemin Amazon S3 en tant que référence, sans télécharger ni téléverser à nouveau les données :

```bash theme={null}
wandb artifact put --type dataset s3://my-bucket/datasets/training
```

Pour joindre à un artefact de dataset une description lisible par l’humain à des fins de documentation :

```bash theme={null}
wandb artifact put --type dataset --description "Training data, Jan 2025" ./data/training
```

<div id="arguments">
  ## Arguments
</div>

| Nom    | Valeur par défaut | Type |
| ------ | ----------------- | ---- |
| `path` | STR               | True |

<div id="options">
  ## Options
</div>

| Flag                | Type      | Description                                                                                                                |
| ------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------- |
| `--name, -n`        | STR       | Nom de l'artefact au format project/artifact\_name. Par défaut, utilise le nom de base du chemin. **Par défaut** : None    |
| `--description, -d` | STR       | Description de cet artefact. **Par défaut** : None                                                                         |
| `--type, -t`        | STR       | Type de l'artefact. Par défaut, 'dataset'. **Par défaut** : dataset                                                        |
| `--alias, -a`       | STR       | Alias à appliquer à cet artefact. Peut être spécifié plusieurs fois. Par défaut, 'latest'. **Par défaut** : \['latest']    |
| `--id`              | STR       | Téléverser vers un run existant avec cet ID. **Par défaut** : None                                                         |
| `--resume`          | BOOL Flag | Reprendre le dernier run depuis votre répertoire actuel. **Par défaut** : None                                             |
| `--skip_cache`      | BOOL Flag | Ignorer la mise en cache lors du téléversement des fichiers d'artefact. **Par défaut** : False                             |
| `--policy`          | Choice    | Définit la stratégie de stockage des fichiers d'artefact : 'mutable' (par défaut) ou 'immutable'. **Par défaut** : mutable |