프로젝트#

Ultralytics Platform 프로젝트는 모델을 구성하고 관리하는 효과적인 방법을 제공합니다. 관련 모델을 함께 그룹화하면 관리, 비교, 개발이 더욱 쉬워집니다.

프로젝트 만들기#

사이드바에서 Train을 열고 +을 클릭하여 New Project 대화상자를 엽니다.

빠른 생성

홈 페이지의 빠른 작업에서도 프로젝트를 만들 수 있습니다.

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

• 이름: 프로젝트를 설명하는 이름입니다(무작위 이름이 자동 생성됩니다).
• URL: 이름에서 생성되며 프로젝트 생성 전에 수정할 수 있는 프로젝트 슬러그입니다.
• 설명: 프로젝트 목적에 대한 선택 사항인 메모입니다.
• 공개 범위: 공개(누구나 볼 수 있음) 또는 비공개(사용자와 팀원만 액세스 가능)입니다. 새 프로젝트는 기본적으로 공개로 설정되며, Enterprise 워크스페이스에서는 새 프로젝트가 Ultralytics-Enterprise 라이선스로 비공개 설정됩니다.
• 라이선스: 프로젝트에 적용할 선택 사항인 라이선스입니다(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 워크스페이스에서는 새 프로젝트에 이 라이선스가 미리 선택됩니다.

Create Project를 클릭하여 완료합니다. 새 프로젝트가 Projects 목록과 사이드바에 표시됩니다.

프로젝트 페이지#

프로젝트 페이지는 두 가지 주요 영역으로 구성됩니다:

두 영역 위의 컨트롤 행에는 모델 검색창, Diff 토글(테이블 뷰에서만 사용 가능하며 차이가 있는 열의 개수가 배지로 표시됨), 뷰 옵션 드롭다운, 뷰 모드 토글이 있습니다.

프로젝트 헤더#

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

• 프로젝트 아이콘(색상, 문자 또는 업로드한 이미지로 맞춤 설정 가능)
• 수정 가능한 이름(클릭하여 이름을 변경하면 슬러그가 자동으로 업데이트됨)
• 라이선스 선택기(클릭하여 변경 가능하며, 클론에서 상속된 카피레프트 라이선스는 잠김)
• 모델 수, 완료/학습 중/실패한 모델 수, 총 크기
• 클론 수 및 최종 업데이트 타임스탬프
• 설명(클릭하여 수정)

헤더의 작업 버튼:

프로젝트의 공개 범위 배지는 페이지 상단의 탐색 경로에서 이름 옆에 표시되며, 클릭하여 공개와 비공개 간에 전환할 수 있습니다.

뷰 모드#

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

• 카드: 사이드바에 전체 크기의 모델 카드가 표시되고 오른쪽에 차트 대시보드가 표시됩니다. 선택된 모델의 손실 곡선과 메트릭을 비교할 수 있습니다.
• 간략: 오른쪽에 차트 대시보드가 표시되는 축약된 모델 사이드바입니다. 실험이 많은 프로젝트에서 모델을 표시할 수 있도록 세로 공간을 더 확보합니다.
• 테이블: 학습 인수와 최종 메트릭을 나란히 보여 주는 비교 테이블입니다. Diff를 활성화하면 모델 간 값이 다른 열만 표시됩니다.

필터링 및 정렬#

모델 목록 위의 컨트롤 행에서 다음을 설정할 수 있습니다:

• 이름으로 모델을 필터링하는 검색
• 상태 필터: 전체, 완료, 학습 전, 실행 중, 시작 중 또는 실패
• 그룹화 기준: 없음 또는 작업 — 그룹화는 간략 및 테이블 모드에서 적용됩니다.
• 정렬 기준: 생성일, 이름 또는 크기. 각각 오름차순이나 내림차순으로 정렬할 수 있습니다.

모델 사이드바#

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

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

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

프로젝트 아이콘#

프로젝트 아이콘을 맞춤 설정합니다:

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

공개 범위 설정#

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

프로젝트 공유#

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

• 공개로 설정하면 누구나 탐색에서 프로젝트를 볼 수 있습니다.
• Teams는 프로젝트, 데이터셋, 모델, 배포 등 모든 리소스를 역할 기반 권한에 따라 팀원이 이용할 수 있는 공유 워크스페이스를 만듭니다. 지속적인 협업에는 Teams를 사용하세요.

프로젝트 복제#

공개 프로젝트를 본인 계정으로 복제합니다:

1. 공개 프로젝트 페이지를 방문합니다.
2. 프로젝트 복제를 클릭합니다.
3. 프로젝트와 완료된 모델이 워크스페이스에 복사됩니다. 복제 대화상자에서 클론의 공개 범위를 선택할 수 있습니다.

복제 동작

복제된 프로젝트는 기본적으로 원본 프로젝트의 공개 범위를 상속하므로, 공개 프로젝트를 복제하면 공개 클론이 생성됩니다. 확인하기 전에 복제 대화상자에서 공개 또는 비공개를 선택할 수 있습니다. Enterprise 워크스페이스에서는 새 클론이 기본적으로 비공개로 설정됩니다. 클론 수는 원본 프로젝트에 표시됩니다. 원본에 카피레프트 라이선스(예: AGPL-3.0)가 있으면 클론은 해당 라이선스를 상속하며 변경할 수 없도록 잠깁니다.

모델 비교#

차트 대시보드#

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

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

사용 가능한 차트 그룹:

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

대화형 차트

• 정확한 값을 보려면 마우스를 올립니다.
• 범례 항목을 클릭하여 모델을 숨기거나 표시합니다.
• 드래그하여 특정 영역을 확대합니다.
• 모델 선을 클릭하여 해당 모델의 페이지로 이동합니다.
• 그룹을 접거나 그룹 메뉴를 사용하여 개별 차트와 학습 또는 검증 손실 계열을 숨깁니다.
• 차트 재배치 및 크기 조정; 레이아웃은 세션 간에도 유지됩니다

비교 표#

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

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

모델 업로드#

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

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

지원 파일

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

프로젝트 편집#

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

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

사용자 지정 메타데이터#

More actions를 열고 Information을 선택하면 다음 두 섹션을 확인할 수 있습니다:

• Ultralytics 메타데이터: 프로젝트 ID, 소유자, 공개 여부, 라이선스, 태그, 타임스탬프 등 읽기 전용 Platform 세부 정보
• 사용자 지정 메타데이터: 부서, 프로그램, 비용 센터, 거버넌스 또는 기타 조직 관련 정보를 위한 자체 JSON 객체

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

프로젝트 삭제#

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

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

연쇄 삭제

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

자주 묻는 질문#