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

# Dataset Commands

> Dataset commands available with the Command Line Interface (CLI).

### Creating a new dataset

To create a dataset, use:

```none theme={null}
sutro datasets create <dataset_id>
```

### Uploading files to dataset via CLI

To upload a file to a dataset, use:

```none theme={null}
sutro datasets upload <dataset_id> <file_path>
```

If a dataset\_id is not provided, a new dataset will be created. The file\_path parameter can be a single file path or a directory path. If a directory path is provided, all files in the directory will be uploaded to the dataset.

### Downloading files from dataset via CLI

To download a file from a dataset, use:

```none theme={null}
sutro datasets download <dataset_id> <file_name> <output_path>
```

If no file\_name is provided, all files in the dataset will be downloaded. If no output\_path is provided, the file will be saved to the current working directory.

### Listing files in a dataset by dataset\_id

To list files in a dataset by dataset\_id, use:

```none theme={null}
sutro datasets files <dataset_id>
```

### Listing user datasets

To list all datasets associated with your API key, use:

```none theme={null}
sutro datasets list
```

### Other commands

To open the Sutro documentation in your browser, use:

```none theme={null}
sutro docs
```

To view commands, simply run:

```none theme={null}
sutro 
```

or

```none theme={null}
sutro --help
```
