> 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/reference/ko/platform/python-sdk.md).

# Python SDK

Roboflow Python SDK는 Roboflow REST API를 감싸는 래퍼로, Python 코드에서 Roboflow와 상호작용할 수 있는 추상 메서드를 제공합니다.

Python SDK는 프로젝트와 워크스페이스를 관리하고, 데이터셋을 업로드 및 다운로드하며, 모델에 대해 추론을 실행하고, 모델 가중치를 업로드하는 등의 메서드를 제공합니다.

Python SDK의 메서드 사용 예제와 참조는 API Reference 문서에 문서화되어 있습니다.

## 리소스

* [설치](https://github.com/roboflow/roboflow-python#-installation) (GitHub)
* [빠른 시작](https://github.com/roboflow/roboflow-python#quickstart) (GitHub)
* [Roboflow Python GitHub 저장소](https://github.com/roboflow/roboflow-python)
* [Roboflow Python 레퍼런스](https://roboflow.github.io/roboflow-python/)

## 설치

Roboflow Python 패키지에는 `Python >=3.10`.

```bash
pip install roboflow
```

### 경량 패키지

다음만 필요하다면 [Vision Events SDK](https://docs.roboflow.com/deployment/monitoring-and-analytics/vision-events#python-sdk) 그리고 무거운 이미지 처리 의존성(OpenCV, NumPy, Pillow) 없이 CLI가 필요하다면, 대신 경량 변형을 설치하세요:

```bash
pip install roboflow-slim
```

해당 `roboflow-slim` 패키지는 전체 `roboflow` 패키지보다 훨씬 작습니다. 이는 NumPy, OpenCV, Matplotlib, Pillow를 포함하지 않기 때문입니다. 이 패키지는 vision-event 로깅이나 기본 CLI 작업만 필요한 엣지 장치, 서버리스 환경, CI/CD 파이프라인, 마이크로서비스에 적합합니다.

두 패키지는 동일한 코드베이스와 API를 공유합니다. 다음을 대상으로 작성된 코드는 `roboflow-slim` 전체 `roboflow` 패키지에서도 동일하게 작동합니다 - 이미지 시각화가 필요 없는 곳에서는 더 가벼운 종속성을 사용하세요.

## 첫 번째 스크립트

다음에서 API 키를 가져와 [설정 → API 키](https://app.roboflow.com/settings/api) 그런 다음 내보내세요:

```bash
export ROBOFLOW_API_KEY=rf_xxxxx
```

그런 다음 공개 Universe 데이터셋의 버전을 다운로드하세요:

```python
import roboflow

rf = roboflow.Roboflow()  # ROBOFLOW_API_KEY를 가져옴
project = rf.workspace("roboflow-100").project("poker-cards-cxcvz")
version = project.version(1)

version.download("yolov8")
```

다음을 참조하세요 [Python SDK로 인증하기](/reference/ko/platform/python-sdk/authenticate-with-the-python-sdk.md) 키를 전달하는 다른 두 가지 방법은 다음을 참조하세요. 추론을 실행하려면 [워크플로](https://docs.roboflow.com/workflows) 또는 [REST API](/reference/ko/platform/rest-api.md) - SDK 추론은 더 이상 사용되지 않습니다.

## 빠른 참조

SDK의 주요 객체:

| 클래스             | 무엇을 나타내는지       | 일반적인 메서드                                                                                                   |
| --------------- | --------------- | ---------------------------------------------------------------------------------------------------------- |
| `Roboflow`      | 최상위 클라이언트       | `workspace()`, `project()`                                                                                 |
| `워크스페이스`        | Roboflow 워크스페이스 | `list_projects()`, `create_project()`, `upload_dataset()`, `list_workflows()`, `list_folders()`, `trash()` |
| `프로젝트`          | 데이터셋/프로젝트       | `versions()`, `version(n)`, `upload()`, `train()`, `delete()`, `restore()`                                 |
| `버전`            | 고정된 데이터셋 버전     | `download()`, `train()`, `모델`, `delete()`, `restore()`                                                     |
| `*.Model` (작업별) | 호스팅된 학습된 모델     | `predict()`                                                                                                |

모든 공개 메서드에 대한 작업 중심 안내는 사이드바의 이 섹션 나머지 부분을 살펴보세요.

### Microsoft Visual C++ 설치 안내

Microsoft Visual C++ 재배포 패키지는 일부 Python 패키지에 필요합니다. 공식 Microsoft 웹사이트에서 다운로드할 수 있습니다:

x64 시스템용: <https://aka.ms/vs/16/release/vc_redist.x64.exe>

x86 시스템용: <https://aka.ms/vs/16/release/vc_redist.x86.exe>

적절한 파일을 다운로드한 후 설치 프로그램을 실행하고 안내에 따라 재배포 패키지를 설치하세요.