supervisely/supervisely

Supervisely – 컴퓨터 비전 프로젝트를 위한 웹 기반 플랫폼

개요 – Supervisely는 컴퓨터 비전 작업을 위한 클라우드 호스팅 "운영 체제"입니다. 데이터 라벨링(이미지, 비디오, 3D 포인트 클라우드, 의료 DICOM), 데이터 시각화, 모델 학습, 추론, 품질 관리, 합성 데이터 생성 및 협업 도구를 단일 웹 UI에 통합했습니다. 이 플랫폼은 공개된 Python SDK와 풍부한 REST API를 통해 확장할 수 있어, Supervisely 생태계 내에서 실행되는 스크립트나 완전한 앱을 작성할 수 있습니다.

주요 구성 요소

• Supervisely Platform – 프로젝트, 데이터 세트, 어노테이션 및 모델을 저장하는 핵심 웹 서비스(https://app.supervisely.com에서 이용 가능).
• Supervisely Ecosystem – 한 번의 클릭으로 실행할 수 있는 수백 개의 즉시 사용 가능한 앱(헤드리스 스크립트, 대화형 UI 도구, 라벨링 도구 확장 기능) 마켓플레이스.
• Python SDK (supervisely package) – 인증, 페이지네이션, 오류 처리 등을 처리하는 REST API의 얇은 래퍼. 워크플로우 예시:

  import supervisely as sly
  api = sly.Api.from_env()
  project = api.project.create(workspace_id=123, name="demo project")
  dataset = api.dataset.create(project.id, "dataset-01")
  img = api.image.upload_path(dataset.id, "img.png", "/local/path/img.png")
  ann = api.annotation.upload_path(img.id, "/local/path/ann.json")
  

• App framework – FastAPI, Flask 등 모든 웹 서버를 Supervisely 앱으로 변환할 수 있습니다. 프레임워크가 UI 위젯, 인증, 버전 관리 및 배포 훅을 제공하므로 개발자는 컴퓨터 비전 로직에 집중할 수 있습니다.

확장 방법

레벨	구축 내용	일반적인 유스케이스
1️⃣	직접 HTTP 호출	모든 언어에서 빠른 자동화
2️⃣	SDK를 사용한 Python 스크립트	데이터 가져오기/내보내기, 배치 모델 추론
3️⃣	헤드리스 Python 앱 (UI 없음)	커스텀 포맷 변환기, 대량 사용자 관리
4️⃣	대화형 UI가 있는 앱	커스텀 라벨링 인터페이스, 학습 대시보드
5️⃣	UI 통합형 라벨링 도구	라벨링 UI 내에서 AI 지원 어노테이션

주요 판매 포인트

• 1분 만에 시작 – pip install supervisely로 SDK를 설치하면 웹 UI를 즉시 사용할 수 있습니다.
• 마법처럼 간단한 API – SDK가 REST 엔드포인트를 추상화하여 재시도, 유효성 검사 및 페이지네이션을 처리합니다.
• 어디서나 커스터마이징 가능 – UI 위젯을 교체하거나, 자체 모델을 연결하거나, 개인용 앱을 작성할 수 있습니다.
• 원클릭 배포 – 앱은 Docker 이미지(예: supervisely/agent)로 패키징되어 플랫폼 UI에서 바로 실행할 수 있습니다.
• 버전 관리된 릴리스 – 에코시스템은 GitHub와 GitLab 모두에서 브랜치와 릴리스를 지원합니다.
• 커뮤니티 및 엔터프라이즈 – Fortune 500 기업을 포함한 65,000명 이상의 사용자가 사용 중이며, 앱은 공개 또는 비공개로 설정할 수 있습니다.

주요 사용자

• CV 모델의 라벨링, 학습 및 평가를 위한 관리된 환경이 필요한 데이터 과학자.
• 협업 어노테이션(이미지, 비디오, 3D, 의료)이 필요한 팀.
• 기존 Supervisely 프로젝트와 통합되어야 하는 커스텀 파이프라인(예: 합성 데이터 생성, Model-as-a-Service)을 구축하는 엔지니어.
• 폐쇄형 제품이 아닌 확장 가능한 플랫폼을 찾는 기업.

설치 / 빠른 시작

pip install supervisely   # Python SDK 설치
# 환경 변수 SUPERVISELY_API_TOKEN에 토큰 설정
python -c "import supervisely as sly; api = sly.Api.from_env(); print(api.team.get_my_team())"

전체 앱의 경우, 일반적으로 FastAPI 서비스를 작성하고 SDK를 통해 UI 위젯을 추가한 다음 Docker 이미지를 플랫폼에 푸시합니다.

리소스

• 웹사이트: https://supervisely.com
• SDK 문서: https://developer.supervisely.com
• API 참조: https://api.docs.supervisely.com
• 앱 에코시스템: https://ecosystem.supervisely.com
• YouTube 강의: What is Supervisely?

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부의 가정이 추가되지 않았습니다.