# Chalk CLI Reference: Datasets
source: https://docs.chalk.ai/cli#datasets

Create, browse, and download [datasets](https://docs.chalk.ai/docs/datasets). Datasets store the results of offline queries for training and analysis.

## `chalk dataset list`
source: https://docs.chalk.ai/cli?command=dataset_list

```bash
chalk dataset list [flags]
```

Use the `chalk dataset list` command to view information about datasets that have been created in this environment.

**Flags**

- `--limit <limit>` (int, default `50`)
  Limit the number of datasets to retrieve.
- `--search <search>` (string)
  Search for datasets by name.

## `chalk dataset get`
source: https://docs.chalk.ai/cli?command=dataset_get

```bash
chalk dataset get <dataset-id> [flags]
```

Use the 'chalk dataset get' command to view detailed information about a specific dataset.

## `chalk dataset rename`
source: https://docs.chalk.ai/cli?command=dataset_rename

```bash
chalk dataset rename <dataset-id> <new-name> [flags]
```

Use the 'chalk dataset rename' command to change the name of an existing dataset.

## `chalk dataset download`
source: https://docs.chalk.ai/cli?command=dataset_download

```bash
chalk dataset download <revision-id> [flags]
```

Use the 'chalk dataset download' command to download files for a specific dataset revision.

**Flags**

- `--output-dir <output-dir>` (string, default `.`)
  Directory to save downloaded files.
- `--include-givens <include-givens>` (bool, default `false`)
  Include givens files in download.
- `--include-traces <include-traces>` (bool, default `false`)
  Include trace files in download.

## `chalk dataset stream_links`
source: https://docs.chalk.ai/cli?command=dataset_stream_links

```bash
chalk dataset stream-links <revision-id> [flags]
```

Use the 'chalk dataset stream-links' command to stream signed download URLs for a dataset revision as they are produced by the server. URLs are printed as they arrive; with --json, all URLs are aggregated into a single response.

## `chalk dataset upload`
source: https://docs.chalk.ai/cli?command=dataset_upload

```bash
chalk dataset upload <file>... [flags]
```

Use the 'chalk dataset upload' command to upload one or more local files into Chalk's object storage and register them as a new dataset revision.

CSV files are converted to Parquet locally. All files must have the same schema. For each prepared Parquet file the CLI calls GetDatasetUploadUris to mint a signed upload URI in the appropriate object-storage backend (S3 multipart, GCS resumable, or Azure block), uploads the file directly to object storage, and finally calls FinalizeDatasetUpload with the Arrow schema to register the dataset revision.

**Flags**

- `--name <name>` (string)
  Dataset name to register the uploaded files under.
- `--part-size <part-size>` (int, default `16777216`)
  Desired multipart part size in bytes (server may adjust).

## `chalk dataset archive`
source: https://docs.chalk.ai/cli?command=dataset_archive

```bash
chalk dataset archive <revision-id> [flags]
```

Use the 'chalk dataset archive' command to archive a specific dataset revision.

## `chalk dataset delete`
source: https://docs.chalk.ai/cli?command=dataset_delete

```bash
chalk dataset delete <dataset-id>
```

Delete the dataset in the current environment. Soft-deletes the dataset; does not physically erase stored data. Use a dataset ID, not a revision ID. Missing or already-deleted IDs succeed without changes.

**Arguments**

- `dataset-id` (string)
  The ID of the dataset to delete.
