> 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>

이에 대한 가능성은 두 가지입니다:

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

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

\\

</details>

<details>

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

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

원본 화질의 단일 이미지를 다운로드하려면 데이터세트의 이미지를 클릭한 다음 "이미지 다운로드"를 선택하면 됩니다.

원본 화질의 여러 이미지를 다운로드하려면 저희의 [CLI](#cli) 또는 저희의 [Image Search API](/datasets/ko/manage/manage-datasets/dataset-search.md#search-images-across-a-workspace).

</details>

## Python SDK

프로젝트에 생성된 버전이 있으면, 지원되는 내보내기 형식 중 아무 형식으로나 이미지와 주석을 다운로드할 수 있습니다. 다음을 사용하세요: `Version.download()` 동기식 "가져와서 압축 해제" 흐름에는 다음을 사용하고, `Version.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) - 내보내기 형식입니다. 일반적인 값: `yolov8`, `yolov11`, `voc`, `coco`, `darknet`, `tfrecord`, `createml`, `multiclass`. 전체 목록은 프로젝트 유형에 따라 다릅니다. 잘못된 값을 전달하면 오류와 함께 전체 목록이 반환됩니다.
* `location` (str, 선택 사항) - 대상 디렉터리입니다. 기본값: `./<project-slug>-<version>`.
* `overwrite` (bool, 기본값 `False`) - 대상 디렉터리가 이미 존재해도 다시 다운로드합니다.

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

### 다운로드 없이 새 내보내기 실행

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

이렇게 하면 서버 측에서 내보내기 재생성이 시작됩니다. 생성이 완료되면 호출이 반환되며(실패하면 `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>
```

다음에서:

* `<형식>` 지원되는 데이터세트 형식 중 하나입니다(예: `voc`, `yolov8`, `coco`, `darknet`등). 다음을 실행하세요: `roboflow version download --help` 전체 목록은 다음을 참고하세요.
* `<위치>` 다운로드할 로컬 경로입니다(선택 사항이며 기본값은 현재 디렉터리입니다)
* 데이터세트 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
```

다음에서 공개적으로 이용 가능한 데이터세트를 다운로드: [로보플로우 유니버스](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"
}
```

## MCP 서버

AI 에이전트를 [MCP 서버](https://docs.roboflow.com/agents/mcp-server) 그리고 다음 도구를 사용해 데이터세트 다운로드를 가져올 수 있습니다:

<table data-search="false"><thead><tr><th width="290">도구</th><th>설명</th></tr></thead><tbody><tr><td><code>versions_export</code></td><td>버전에 대한 데이터셋 내보내기를 확인하거나 트리거합니다.</td></tr><tr><td><code>versions_get</code></td><td>분할과 학습 내역을 포함한 버전 정보를 가져옵니다.</td></tr></tbody></table>