For the complete documentation index, see llms.txt. This page is also available as Markdown.

Python SDK

Roboflow Python SDK를 설치하고, 데이터셋을 다운로드하며 프로젝트, 버전, 모델을 다루는 첫 스크립트를 작성합니다.

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

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

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

리소스

설치

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

pip install roboflow

경량 패키지

다음만 필요하다면 Vision Events SDK 그리고 무거운 이미지 처리 의존성(OpenCV, NumPy, Pillow) 없이 CLI가 필요하다면, 대신 경량 변형을 설치하세요:

pip install roboflow-slim

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

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

첫 번째 스크립트

다음에서 API 키를 가져와 설정 → API 키 그런 다음 내보내세요:

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

다음을 참조하세요 Python SDK로 인증하기 키를 전달하는 다른 두 가지 방법은 다음을 참조하세요. 추론을 실행하려면 워크플로 또는 REST API - 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

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

마지막 업데이트

도움이 되었나요?