> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ko/create-and-upload/download-a-dataset.md).

# 데이터세트 다운로드

## 웹 앱

{% hint style="info" %}
를 참조하세요 [Roboflow Universe 데이터셋 다운로드](/datasets/ko/universe/universe/download-a-universe-dataset.md) Roboflow Universe에서 데이터셋을 다운로드하려면 문서를 참조하세요.
{% endhint %}

Roboflow에서 데이터셋을 다운로드하거나 내보내려면 먼저 프로젝트의 Dataset 페이지로 이동하세요.

<figure><img src="/files/ff7ff4ce9dfbee6e08349bad7052190b83c205b5" alt="" width="165"><figcaption></figcaption></figure>

이미지 검색창 오른쪽에서 Export를 클릭하세요.

<figure><img src="/files/50dd71a37e926c78b32a7462e4f62d4a5e780fc9" alt="" width="344"><figcaption></figcaption></figure>

모달이 나타나며 데이터를 다운로드할 형식 옵션이 표시됩니다. Roboflow는 [50개 이상의 다양한 주석 형식을 지원합니다](https://roboflow.com/formats).

데이터셋을 직접 zip 파일로 다운로드하거나, 로컬에서 데이터를 다운로드할 수 있는 코드 스니펫을 제공받도록 선택할 수도 있습니다.

<figure><img src="/files/3052e78ba95480f010f4f8da12a4dacc498cf00a" alt=""><figcaption></figcaption></figure>

코드 옵션을 선택하면 Python 코드 스니펫, curl 명령어 또는 데이터셋의 직접 다운로드 링크 중에서 선택할 수 있습니다.

<figure><img src="/files/6064d4a727ee978db9361f1bd390a5ce596855b5" alt=""><figcaption></figcaption></figure>

### 자주 묻는 질문

<details>

<summary>압축된 이미지 수가 UI와 일치하지 않는 이유는 무엇인가요?</summary>

이에 대한 두 가지 가능성이 있습니다:

* 해당 클라우드 서비스에서 이미지 다운로드에 무작위로 실패했습니다.
* 이미지가 손상되었거나 너무 커서 일부 오류가 발생했습니다.

우리 애플리케이션은 export zip을 한 번만 생성한 다음, 동일한 형식(예: COCO)을 선택하면 같은 export를 다시 다운로드합니다. 다운로드한 이미지 수가 맞지 않는 것을 발견하면 언제든지 새 버전을 생성해 다시 다운로드할 수 있습니다.

\\

</details>

<details>

<summary>다운로드한 이미지는 원본 품질인가요?</summary>

아니요. 학습 속도 저하를 방지하기 위해, 충분한 모델 성능에 필요한 해상도와 학습 속도 사이의 균형을 유지하는 수준으로 이미지를 압축합니다.

원본 품질의 단일 이미지를 다운로드하려면 데이터셋의 이미지를 클릭하고 "Download Image"를 선택하면 됩니다.

원본 품질의 여러 이미지를 다운로드하려면 다음을 사용하는 것을 권장합니다: [CLI](#cli) 또는 다음을 사용하세요 [이미지 검색 API](/datasets/ko/manage/manage-datasets/dataset-search.md#search-images-across-a-workspace).

</details>

## Python SDK

프로젝트에 생성된 버전이 있으면 지원되는 어떤 export 형식으로든 이미지와 주석을 다운로드할 수 있습니다. 다음을 사용하세요 `Version.download()` 동기식 "fetch and unzip" 흐름에는, 또는 `Version.export()` 다운로드 없이 비동기적으로 export를 (재)생성하도록 Roboflow에 요청합니다.

### 버전 다운로드

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace().project("my-detector")
version = project.version(3)

dataset = version.download(
    model_format="yolov8",      # 또는 "voc", "coco", "darknet" 등
    location="./my-detector-v3", # 선택 사항, 기본값은 ./<project>-<version>
    overwrite=False,             # 선택 사항, 기존 디렉터리를 다시 다운로드하려면 True로 설정
)

print(dataset.location)  # 디스크상의 경로
```

#### 매개변수

* `model_format` (str) - export 형식. 일반적인 값: `yolov8`, `yolov11`, `voc`, `coco`, `darknet`, `tfrecord`, `createml`, `multiclass`. 전체 목록은 프로젝트 유형에 따라 다릅니다. 잘못된 값을 전달하면 오류와 함께 전체 목록이 반환됩니다.
* `location` (str, 선택 사항) - 대상 디렉터리. 기본값은 `./<project-slug>-<version>`.
* `overwrite` (bool, 기본값 `False`) - 대상 디렉터리가 이미 존재하더라도 다시 다운로드합니다.

반환되는 `데이터셋` 객체에는 `.location` 압축 해제된 디렉터리를 가리키는 속성이 있습니다.

### 다운로드 없이 새 export를 시작하기

```python
ok = version.export(model_format="coco")
```

이렇게 하면 서버 측에서 export 재생성이 시작됩니다. 생성이 완료되면 호출이 반환되며, 실패하면 `RuntimeError` 가 발생합니다). 그 후 다음 `download()` 가 새로 생성된 아티팩트를 가져옵니다.

### 공개 Universe 데이터셋

공개 Universe 프로젝트를 다운로드하려고 워크스페이스 멤버일 필요는 없습니다. API 키에 Universe 접근 권한만 있으면 됩니다:

```python
project = rf.workspace("roboflow-100").project("poker-cards-cxcvz")
project.version(1).download("yolov8", location="./poker-cards")
```

## CLI

프로젝트에 저장된 버전이 있으면 명령줄을 사용해 해당 버전의 이미지와 주석을 다운로드할 수 있습니다.

### 명령

```bash
roboflow version download <workspace/project/version> -f <format> -l <location>
```

또는 축약형 별칭을 사용하세요:

```bash
roboflow download <workspace/project/version> -f <format> -l <location>
```

다음에서:

* `<format>` 는 지원되는 데이터셋 형식 중 하나입니다(예: `voc`, `yolov8`, `coco`, `darknet`, 등). 다음을 실행하세요 `roboflow version download --help` 전체 목록을 보려면.
* `<location>` 는 다운로드할 로컬 경로입니다(선택 사항 - 기본값은 현재 디렉터리)
* 데이터셋 URL은 [리소스 축약 표기](https://docs.roboflow.com/reference/platform/cli#resource-shorthand): `workspace/project/version`, `project/version`, 또는 다음만 지정하세요 `-p project` 와 버전 번호.

### 예시

VOC 형식의 데이터셋 버전을 다운로드하세요:

```bash
roboflow download -f voc -l ./my-dataset my-workspace/hand-gestures/1
```

프로젝트 축약 표기를 사용해 다운로드하세요(기본 워크스페이스 사용):

```bash
roboflow download -f yolov8 hand-gestures/1
```

다음에서 공개적으로 उपलब्ध한 데이터셋을 다운로드하세요 [Roboflow Universe](https://universe.roboflow.com):

```bash
roboflow download -f coco joseph-nelson/chess-pieces-new/25
```

### JSON 출력

스크립팅 및 자동화에는 다음을 사용하세요 `--json` 구조화된 출력을 얻으려면:

```bash
roboflow download hand-gestures/1 -f yolov8 --json
```

```json
{
  "workspace": "my-workspace",
  "project": "hand-gestures",
  "version": 1,
  "format": "yolov8",
  "location": "./hand-gestures-1"
}
```