> 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="https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-296b711dc71c98f15db570f16d7378e415a0b382%2Fimage%20(473).png?alt=media" alt="" width="165"><figcaption></figcaption></figure>

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

<figure><img src="https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-67a7e608c82e2db023fac82cffdfa3fcf19c84e2%2Fimage%20(474).png?alt=media" alt="" width="344"><figcaption></figcaption></figure>

데이터를 다운로드할 형식을 선택할 수 있는 모달이 나타납니다. Roboflow는 [50개 이상의 다양한 주석 형식](https://roboflow.com/formats).

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

<figure><img src="https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-636e02dd0aefc5c3da02f4c20c8441f357b426dd%2Fimage%20(475).png?alt=media" alt=""><figcaption></figcaption></figure>

코드 옵션을 선택하면 코드가 "Jupyter"(Python) 및 "Terminal"(CLI) 탭에 바로 표시됩니다. 이를 실행하여 현재 검색과 일치하는 이미지를 선택한 형식으로 내보내고 다운로드하세요.

<figure><img src="https://3735512388-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-a86cf54b729c808095b7edfd3f6112e15b6227bf%2Fimage%20(477).png?alt=media" 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`) - 대상 디렉터리가 이미 존재하더라도 다시 다운로드합니다.

반환된 `데이터셋` 객체에는 `.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>
```

다음과 같습니다:

* `<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"
}
```

## 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>분할 정보와 학습 정보를 포함한 버전 정보를 가져옵니다.</code></td><td>분할 정보와 해당 학습 정보를 포함한 버전 정보를 가져옵니다.</td></tr></tbody></table>