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

# Downloading Dataset

> Download the file associated with a specific dataset.

> [!WARNING]
>
> You are reading the docs of Galtea 5.13. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/dataset/download.md).

## Returns

Returns the local file path to the downloaded dataset file.

## Example

```python theme={"system"}
downloaded_path = galtea.datasets.download(dataset=dataset, output_directory="./.temp")
```

## Parameters

**dataset** `Dataset object` *required*

The Dataset object (retrieved via `get` or `get_by_name`) for which you want to download the associated file. The dataset must have a `uri` attribute.

> [!NOTE]
>
> Deprecated alias: `test`.

**output\_directory** `string` (default: the current directory)

The local directory path where the dataset file will be saved.

## Errors

| Error | Cause |
| - | - |
| `ValueError` | No dataset was given, or it has no associated file. |
| `Exception` | The download link expired, or the transfer from storage failed. |

> [!NOTE]
>
> A failed download raises instead of returning `None`, and the message never contains the
> presigned link.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.