Download and use artifacts ↗

    import wandb

    with wandb.init(project="<example>", job_type="<job-type>") as run:
        # See next step
    ```

Indicate the artifact you want to use with the [`wandb.Run.use_artifact()`](/models/ref/python/experiments/run#use_artifact) method. This returns a run object. In the following code snippet specifies an artifact called `'bike-dataset'` with the alias `'latest'`:

```python
    # Indicate the artifact to use. Format is "name:alias"
    artifact = run.use_artifact("bike-dataset:latest")
    ```

Use the object returned to download all the contents of the artifact:

```python
    # Download the entire artifact
    datadir = artifact.download()
    ```

You can optionally pass a path to the root parameter to download the contents of the artifact to a specific directory.

Use the [`wandb.Artifact.get_entry()`](/models/ref/python/experiments/artifact#get_entry) method to download only a subset of files:

```python
    # Download a specific file
    entry = artifact.get_entry(name)
    ```

Putting this together, the complete code example looks like this:

```python
    import wandb    

    with wandb.init(project="<example>", job_type="<job-type>") as run:
        # Indicate the artifact to use. Format is "name:alias"
        artifact = run.use_artifact("bike-dataset:latest")

        # Download the entire artifact
        datadir = artifact.download()

        # Download a specific file
        entry = artifact.get_entry("bike.png")
    ```

This fetches only the file at the path `name`. It returns an `Entry` object with the following methods:

* `Entry.download`: Downloads file from the artifact at path `name`
* `Entry.ref`: If `add_reference` stored the entry as a reference, returns the URI
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="Outside of a run"></span>
First, import the W\&B SDK. Next, create an artifact object from the Public API Class. Provide the entity, project, artifact, and alias associated with that artifact:

```python
    import wandb

    api = wandb.Api()
    artifact = api.artifact("entity/project/artifact:alias")
    ```

Use the object returned to download the contents of the artifact:

```python
    artifact.download()
    ```

You can optionally pass a path the `root` parameter to download the contents of the artifact to a specific directory. For more information, see the [Python SDK Reference Guide](/models/ref/python/experiments/artifact#download).
  <span class="tab-end"></span>

  <span class="tab-start" data-tab-title="W&B CLI"></span>
Use the `wandb artifact get` command to download an artifact from the W\&B server.

with wandb.init(project="<example>", job_type="<job-type>") as run:
    # Indicate the artifact to use. Format is "name:alias"
    artifact = run.use_artifact("bike-dataset:latest")

    # Download a specific file or sub-folder
    artifact.download(path_prefix="bike.png") # downloads only bike.png

# downloads files in the images/bikes directory
artifact.download(path_prefix="images/bikes/") 

with wandb.init(project="<example>", job_type="<job-type>") as run:
    # Query W&B for an artifact from another project and mark it
    # as an input to this run.
    artifact = run.use_artifact("my-project/artifact:alias")

    # Use an artifact from another entity and mark it as an input
    # to this run.
    artifact = run.use_artifact("my-entity/my-project/artifact:alias")

import wandb

with wandb.init(project="<example>", job_type="<job-type>") as run:
    artifact = wandb.Artifact("reference model")
    artifact.add_file("model.h5")
    run.use_artifact(artifact)