Ultralytics YOLO27:

프로젝트#

Ultralytics Platform 프로젝트는 모델을 구성하고 관리하는 효과적인 솔루션을 제공합니다. 관련 모델을 함께 그룹화하여 더 쉽게 관리, 비교 및 개발할 수 있습니다.

graph TB
    P[Project]:::start --> M1[Model 1]:::proc
    P --> M2[Model 2]:::proc
    P --> M3[Model 3]:::proc
    M1 --> S[Check in Sidebar]:::proc
    M2 --> S
    M3 --> S
    S --> C[Charts]:::out
    S --> T[Comparison Table]:::out

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

프로젝트 생성#

사이드바에서 Projects로 이동한 다음 New Project를 클릭합니다.

Ultralytics Platform 프로젝트 목록

빠른 생성

Home 페이지의 빠른 작업에서 프로젝트를 생성할 수도 있습니다.

프로젝트 세부 정보를 입력합니다:

  • Name: 프로젝트를 설명하는 이름입니다(임의의 이름이 자동으로 생성됨).
  • URL: 이름에서 생성되며 생성 전에 편집할 수 있는 프로젝트 slug입니다.
  • Description: 프로젝트 목적에 대한 선택적 메모입니다.
  • Visibility: Public(누구나 볼 수 있음) 또는 Private(사용자와 팀 구성원만 액세스할 수 있음)입니다. 새 프로젝트의 기본값은 Public이며, Enterprise 워크스페이스에서는 새 프로젝트의 기본값이 Ultralytics-Enterprise 라이선스가 적용된 Private입니다.
  • License: 프로젝트에 적용할 선택적 라이선스입니다(None, Apache-2.0, MIT, BSD-3-Clause, AGPL-3.0, GPL-3.0, LGPL-3.0, MPL-2.0, EUPL-1.1, Unlicense, CC0-1.0, Ultralytics-Enterprise 또는 Other). Ultralytics-Enterprise 라이선스는 AGPL 요구 사항 없이 상업적으로 사용할 수 있으며 Enterprise 플랜에서 제공됩니다. 자세한 내용은 Ultralytics 라이선스를 참조하십시오. Enterprise 워크스페이스에서는 새 프로젝트에 이 라이선스가 미리 선택됩니다.

Ultralytics Platform New Project Dialog Name Visibility License

Create Project를 클릭하여 완료합니다. 새 프로젝트가 프로젝트 목록과 사이드바에 나타납니다.

프로젝트 페이지#

프로젝트 페이지에는 두 가지 주요 영역이 있습니다:

영역설명
모델 사이드바프로젝트의 모든 모델을 나열하며, 차트 선택을 위한 체크박스를 포함하고 크기를 조정할 수 있습니다.
메인 패널차트 대시보드 또는 비교 테이블을 표시합니다(보기 간 전환 가능).

두 영역 위의 컨트롤 행에는 모델 검색 상자, Diff 토글(테이블 보기 전용이며 서로 다른 열 수가 배지로 표시됨), 보기 옵션 드롭다운 및 보기 모드 토글이 있습니다.

Ultralytics Platform 프로젝트 페이지 사이드바 및 차트

프로젝트 헤더#

헤더에는 다음이 표시됩니다:

  • 프로젝트 아이콘(색상, 문자 또는 업로드한 이미지를 사용자 지정 가능)
  • 편집 가능한 이름(클릭하여 이름 변경; slug가 자동으로 업데이트됨)
  • 라이선스 선택기(클릭하여 변경; clone에서 상속된 copyleft 라이선스는 잠김)
  • 모델 수, 완료/학습 중/실패 수, 총 크기
  • Clone 수마지막 업데이트 타임스탬프
  • Description(클릭하여 편집)

헤더의 작업 버튼:

버튼설명
New Model편집 가능한 프로젝트의 학습 대화 상자를 엽니다.
모델 업로드편집 가능한 프로젝트에 하나 이상의 .pt 체크포인트를 선택합니다.
프로젝트 Clone공개 프로젝트와 해당 프로젝트의 완료된 모델을 워크스페이스에 Clone합니다.
Star프로젝트에 Star를 추가하거나 제거합니다.
Share공개 프로젝트를 공유하거나 임베드합니다.
추가 작업소유자를 위한 Information(메타데이터), RefreshDelete Project입니다.

프로젝트의 공개 범위 배지는 페이지 상단의 breadcrumb에서 이름 옆에 표시됩니다. 이를 클릭하여 공개와 비공개 간에 전환합니다.

보기 모드#

보기 컨트롤을 사용하여 세 가지 보기 모드 간에 전환합니다. 선택한 모드는 프로젝트별로 저장됩니다.

  • Cards: 사이드바에 전체 크기의 모델 카드가 표시되고 오른쪽에 Charts 대시보드가 표시됩니다. 선택한 모델의 loss 곡선과 metric을 비교할 수 있습니다.
  • Compact: 압축된 모델 사이드바가 표시되고 오른쪽에 Charts 대시보드가 표시됩니다. 실험이 많은 프로젝트에서 모델을 표시할 수 있는 세로 공간이 더 넓습니다.
  • Table: 학습 인수와 최종 metric을 나란히 표시하는 비교 테이블입니다. Diff를 활성화하면 모델 간 값이 다른 열만 표시됩니다.

Ultralytics Platform 프로젝트 비교 테이블 보기

필터 및 정렬#

모델 목록 위의 컨트롤 행에서는 다음을 제공합니다:

  • 이름으로 모델을 필터링하는 Search
  • Status filter: All, Completed, Untrained, Running, Starting 또는 Failed
  • Group by: None 또는 Task — 그룹화는 Compact 및 Table 모드에 적용됩니다.
  • Sort by: Created, Name 또는 Size이며, 각각 오름차순 또는 내림차순으로 정렬할 수 있습니다.

모델 사이드바#

크기를 조정할 수 있는 사이드바에 프로젝트의 모든 모델이 나열됩니다:

  • 차트와 비교 테이블에 표시할 모델을 선택하는 체크박스
  • .pt 파일을 사이드바로 직접 드래그 앤 드롭하여 모델을 업로드합니다(모델 업로드 세부 정보).
  • 실행 중인 모델의 학습 진행률(epoch 수 및 진행률 표시줄)
  • 모든 차트에서 일관되게 사용되는 모델 색상 선택기

모델을 클릭하면 해당 모델 페이지가 열립니다.

프로젝트 아이콘#

프로젝트 아이콘을 사용자 지정합니다:

  1. 프로젝트 이름 옆의 아이콘을 클릭합니다.
  2. 색상문자를 선택하거나 사용자 지정 이미지를 업로드합니다.
  3. 변경 사항은 자동으로 저장됩니다.

공개 설정#

프로젝트를 볼 수 있는 사용자를 제어합니다:

설정설명
공개누구나 Explore 페이지에서 볼 수 있습니다.
비공개사용자와 팀 구성원만 볼 수 있습니다.

프로젝트 공유#

프로젝트별 공동 작업자 초대 기능은 없습니다. 다른 사용자와 프로젝트를 공유하려면 다음 방법 중 하나를 사용합니다:

  • Public 공개 범위를 사용하면 누구나 Explore에서 프로젝트를 볼 수 있습니다.
  • **Teams**는 모든 리소스(프로젝트, 데이터셋, 모델, 배포)에 역할 기반 권한으로 팀 구성원이 액세스할 수 있는 공유 워크스페이스를 생성합니다. 지속적인 협업에는 Teams를 사용합니다.

프로젝트 Clone#

공개 프로젝트를 자신의 계정으로 Clone합니다:

  1. 공개 프로젝트 페이지로 이동합니다.
  2. Clone Project를 클릭합니다.
  3. 프로젝트와 완료된 모델이 워크스페이스에 복사됩니다. Clone 대화 상자에서 Clone의 공개 범위를 선택합니다.
Clone 동작

Clone된 프로젝트는 기본적으로 원본 프로젝트의 공개 범위를 상속합니다(따라서 공개 프로젝트를 Clone하면 공개 Clone이 생성됨). 확인하기 전에 Clone 대화 상자에서 Public 또는 Private를 선택할 수 있습니다. Enterprise 워크스페이스에서는 새 Clone의 기본값이 Private입니다. 원본 프로젝트에 copyleft 라이선스(예: AGPL-3.0)가 있으면 Clone이 해당 라이선스를 상속하며 라이선스가 잠깁니다.

모델 비교#

Charts 대시보드#

Charts 대시보드를 사용하여 모델 성능을 비교합니다:

  1. 체크박스를 사용하여 사이드바에서 모델을 선택합니다.
  2. 유형별(metrics, loss, learning rate)로 그룹화된 중첩 metric 곡선을 확인합니다.
  3. 차트를 드래그하여 재배치하고 가장자리를 드래그하여 크기를 조정합니다.
  4. 마우스를 올려 정확한 값을 확인하고, 범례 항목을 클릭하여 모델을 숨기거나 표시하며, 모델 선을 클릭하여 해당 모델로 이동합니다.

사용 가능한 차트 그룹:

그룹차트
메트릭detection의 mAP50, mAP50-95, precision 및 recall과 같은 Task metric
Loss각 loss 구성 요소(box, cls, …)별 차트 하나가 표시되며, 학습은 실선이고 validation은 점선입니다.
학습률lr/pg0, lr/pg1, lr/pg2

서로 다른 작업으로 학습된 모델을 비교할 수 있지만, 각 모델은 실제로 보고한 지표에 해당하는 차트만 표시합니다.

대화형 차트
  • 마우스를 올려 정확한 값을 확인합니다
  • 범례 항목을 클릭하여 모델을 숨기거나 표시합니다
  • 드래그하여 특정 영역을 확대합니다
  • 모델 선을 클릭하여 해당 모델의 페이지로 이동합니다
  • 그룹을 접거나 메뉴를 사용하여 개별 차트와 학습 또는 검증 손실 시리즈를 숨깁니다
  • 차트를 재배치하고 크기를 조정할 수 있으며, 레이아웃은 세션 간에 유지됩니다

비교 표#

학습 인자와 최종 지표를 나란히 비교하려면 표 보기로 전환합니다:

  1. Table 보기 모드 전환을 클릭합니다
  2. 선택한 모든 모델을 행으로 표시하고, 학습 인자와 지표를 열로 표시합니다
  3. Diff 버튼을 사용하여 모델 간 값이 다른 열만 표시합니다

모델 업로드#

기존 .pt 모델 파일을 업로드합니다:

  1. 프로젝트 페이지 또는 모델 사이드바에 파일을 드래그 앤 드롭합니다
  2. 여러 파일을 동시에 업로드할 수 있습니다(동시 업로드 최대 3개).
  3. 모델 메타데이터(작업, 아키텍처, 클래스 이름, 학습 결과)는 .pt 파일에서 자동으로 파싱됩니다
  4. 백그라운드에서 업로드가 완료되는 동안 로컬에서 파싱된 데이터로 차트가 즉시 업데이트됩니다
지원 파일

Ultralytics YOLO 학습에서 생성된 PyTorch .pt 파일만 지원됩니다. Platform은 학습 결과, 인자, 작업 유형, 클래스 이름을 포함한 내장 메타데이터를 파싱합니다. 형식에 대한 자세한 내용은 Models를 참조하세요.

프로젝트 편집#

프로젝트 이름, 설명 또는 설정을 업데이트합니다:

  1. 프로젝트 이름을 클릭하여 인라인으로 편집합니다
  2. 설명을 클릭하여 인라인으로 편집합니다
  3. 아이콘을 클릭하여 사용자 지정합니다
  4. 라이선스 배지를 클릭하여 라이선스를 변경합니다

Ultralytics Platform 프로젝트 설정

사용자 지정 메타데이터#

추가 작업을 열고 정보를 선택하여 다음 두 섹션을 검토합니다.

  • Ultralytics Metadata: 프로젝트 ID, 소유자, 공개 범위, 라이선스, 태그, 타임스탬프와 같은 읽기 전용 Platform 세부 정보입니다
  • Custom Metadata: 부서, 프로그램, 비용 센터, 거버넌스 또는 기타 조직 정보를 위한 사용자의 JSON 객체입니다

워크스페이스 뷰어는 메타데이터를 확인할 수 있으며, 편집 액세스 권한이 있는 멤버는 사용자 지정 메타데이터 객체를 교체할 수 있습니다. 직렬화된 메타데이터 객체는 500,000자로 제한되며 각 최상위 키는 128자로 제한됩니다. 빈 객체({})를 저장하면 사용자 지정 메타데이터가 삭제됩니다.

프로젝트 삭제#

더 이상 필요하지 않은 프로젝트를 삭제합니다:

  1. 헤더에서 More actions 메뉴를 열고 Delete Project를 선택합니다
  2. 삭제를 확인합니다.
연쇄 삭제

프로젝트를 삭제하면 프로젝트 내부의 모든 모델도 삭제됩니다. 이 작업을 수행하면 항목이 휴지통으로 이동하며, 30일 이내에 복원할 수 있습니다.

FAQ#

  • 프로젝트별로 별도의 모델 제한은 없습니다. 워크스페이스 전체 요금제 제한이 모든 프로젝트에 적용됩니다. Free는 모델 100개, Pro는 500개를 지원하며 Enterprise는 제한이 없습니다. 더 명확하게 비교하려면:

    • 관련 실험(동일한 데이터셋/작업)을 그룹화합니다
    • 더 이상 필요하지 않은 오래된 실행은 휴지통으로 삭제합니다
    • 의미 있는 프로젝트 이름을 사용합니다
  • 예. 삭제한 프로젝트는 휴지통으로 이동하며 30일 이내에 복원할 수 있습니다:

    1. Settings > Trash로 이동합니다
    2. 프로젝트를 찾습니다
    3. Restore를 클릭합니다
  • 그렇습니다. 동일한 워크스페이스 내의 프로젝트 간에 모델을 잘라내어 붙여넣거나 드래그할 수 있습니다. 자세한 내용은 프로젝트 간 모델 이동을 참고하세요. 모델 복제는 소유하지 않은 완료된 모델을 사용자의 프로젝트로 복사합니다.

댓글