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

# Télécharger un artifact depuis un registre

> Téléchargez un artifact lié à une collection du registre en construisant son chemin à l’aide du SDK Python.

Utilisez le SDK Python W\&B pour télécharger un artifact lié à un registre. Pour télécharger et utiliser un artifact, vous devez connaître le nom du registre, le nom de la collection, ainsi que l’alias ou l’index de la version de l’artifact à télécharger.

Une fois ces propriétés de l’artifact connues, vous pouvez [construire le chemin vers l’artifact lié](#construct-path-to-linked-artifact) et télécharger l’artifact. Vous pouvez également [copier-coller un extrait de code prégénéré](#copy-and-paste-pre-generated-code-snippet) depuis l’interface de l’application W\&B pour télécharger un artifact lié à un registre.

<h2 id="construct-path-to-linked-artifact">
  Construire le chemin d’un artifact lié
</h2>

Pour télécharger un artifact lié à un registre, vous devez connaître le chemin de cet artifact lié. Ce chemin se compose du nom du registre, du nom de la collection, ainsi que de l’alias ou de l’index de la version de l’artifact à laquelle vous souhaitez accéder.

Une fois que vous connaissez le registre, la collection et l’alias ou l’index de la version de l’artifact, vous pouvez construire le chemin de l’artifact lié à l’aide du modèle de chaîne suivant :

```python theme={"system"}
# Nom de l’artifact avec indication de l’index de version
f"wandb-registry-{REGISTRY}/{COLLECTION}:v{INDEX}"

# Nom de l’artifact avec indication de l’alias
f"wandb-registry-{REGISTRY}/{COLLECTION}:{ALIAS}"
```

Remplacez les valeurs entre accolades `{}` par le nom du registre et de la collection, ainsi que par l’alias ou l’index de la version de l’artifact à laquelle vous souhaitez accéder.

Une fois le chemin de l’artifact lié obtenu, utilisez la méthode `wandb.Run.use_artifact()` pour accéder à l’artifact et télécharger son contenu. L’extrait de code suivant montre comment utiliser et télécharger un artifact lié au registre. Veillez à remplacer les valeurs entre `<>` par les vôtres :

```python theme={"system"}
import wandb

REGISTRY = '<registry_name>'
COLLECTION = '<collection_name>'
ALIAS = '<artifact_alias>'

with wandb.init(entity = '<team_name>', project = '<project_name>')  as run:
    artifact_name = f"wandb-registry-{REGISTRY}/{COLLECTION}:{ALIAS}"
    # artifact_name = '<artifact_name>' # Copiez-collez le nom complet (Full name) indiqué dans l’interface de Registry
    fetched_artifact = run.use_artifact(artifact_or_name = artifact_name)  
    download_path = fetched_artifact.download()  
```

La méthode `wandb.Run.use_artifact()` crée un [run](/fr/products/wandb/runs) et marque également l’artifact que vous téléchargez comme entrée de ce run.
En marquant un artifact comme entrée d’un run, vous permettez à W\&B d’assurer la traçabilité de cet artifact.

Si vous ne souhaitez pas créer de run, vous pouvez utiliser l’objet `wandb.Api()` pour accéder à l’artifact :

```python theme={"system"}
import wandb

REGISTRY = "<registry_name>"
COLLECTION = "<collection_name>"
VERSION = "<version>"

api = wandb.Api()
artifact_name = f"wandb-registry-{REGISTRY}/{COLLECTION}:{VERSION}"
artifact = api.artifact(name = artifact_name)
```

<details>
  <summary>Exemple : utiliser et télécharger un artifact lié au registre</summary>

  L’exemple de code suivant montre comment un utilisateur peut télécharger un artifact lié à une collection nommée `phi3-finetuned` dans le registre **Fine-tuned Models**. L’alias de la version de l’artifact est défini sur `production`.

  ```python theme={"system"}
  import wandb

  TEAM_ENTITY = "product-team-applications"
  PROJECT_NAME = "user-stories"

  REGISTRY = "Fine-tuned Models"
  COLLECTION = "phi3-finetuned"
  ALIAS = 'production'

  # Initialiser un run dans l’équipe et le projet spécifiés
  with wandb.init(entity=TEAM_ENTITY, project = PROJECT_NAME) as run:

      artifact_name = f"wandb-registry-{REGISTRY}/{COLLECTION}:{ALIAS}"

      # Accéder à un artifact et le marquer comme entrée de votre run pour assurer la traçabilité
      fetched_artifact = run.use_artifact(artifact_or_name = artifact_name)  

      # Télécharger l’artifact. Renvoie le chemin du contenu téléchargé
      downloaded_path = fetched_artifact.download()  
  ```
</details>

Consultez [`wandb.Run.use_artifact()`](/fr/products/wandb/ref/python/experiments/run#method-run-use_artifact) et [`Artifact.download()`](/fr/products/wandb/ref/python/experiments/artifact#method-artifact-download) dans la référence de l’API pour connaître les paramètres et le type de retour.

<Note>
  **Utilisateurs disposant d’une entity personnelle et membres de plusieurs organisations**

  Les utilisateurs disposant d’une entity personnelle et membres de plusieurs organisations doivent également indiquer le nom de leur organisation ou utiliser une entity d’équipe pour accéder aux artifacts liés à un registre.

  ```python theme={"system"}
  import wandb

  REGISTRY = "<registry_name>"
  COLLECTION = "<collection_name>"
  VERSION = "<version>"

  # Assurez-vous d’utiliser votre entity d’équipe pour instancier l’API
  api = wandb.Api(overrides={"entity": "<team-entity>"})
  artifact_name = f"wandb-registry-{REGISTRY}/{COLLECTION}:{VERSION}"
  artifact = api.artifact(name = artifact_name)

  # Construire le chemin
  api = wandb.Api()
  artifact_name = f"wandb-registry-{REGISTRY}/{COLLECTION}:{VERSION}"
  artifact = api.artifact(name = artifact_name)
  ```
</Note>

<h2 id="copy-and-paste-pre-generated-code-snippet">
  Copier-coller un extrait de code prégénéré
</h2>

W\&B génère un extrait de code que vous pouvez copier-coller dans votre script Python, votre notebook ou votre terminal pour télécharger un artifact lié à un registre.

1. Accédez à Registry à l’adresse [https://forge.coreweave.com/registry/](https://forge.coreweave.com/registry/).
2. Sélectionnez le nom du registre qui contient votre artifact.
3. Sélectionnez le nom de la collection.
4. Dans la liste des versions d’artifact, sélectionnez la version à laquelle vous souhaitez accéder.
5. Sélectionnez l’onglet **Usage**.
6. Copiez l’extrait de code affiché dans la section **Usage API**.
7. Collez l’extrait de code dans votre script Python, votre notebook ou votre terminal.


## Related topics

- [Aperçu de l’API publique](/fr/products/wandb/ref/python/public-api.md)