프로젝트
Ultralytics Platform 프로젝트는 모델을 구성하고 관리하기 위한 효과적인 솔루션을 제공합니다. 관련 모델들을 그룹화하여 관리, 비교 및 개발을 더 쉽게 수행할 수 있습니다.
graph TB
P[Project] --> M1[Model 1]
P --> M2[Model 2]
P --> M3[Model 3]
M1 --> C[Charts Dashboard]
M2 --> C
M3 --> C
M1 --> T[Comparison Table]
M2 --> T
M3 --> T
style P fill:#4CAF50,color:#fff
style C fill:#2196F3,color:#fff
style T fill:#FF9800,color:#fff프로젝트 생성
사이드바에서 **프로젝트(Projects)**로 이동한 다음 **프로젝트 생성(Create Project)**을 클릭합니다.
빠른 생성
홈 페이지의 빠른 작업(quick actions)을 통해서도 프로젝트를 생성할 수 있습니다.
프로젝트 세부 정보를 입력합니다:
- 이름(Name): 프로젝트에 대한 설명적인 이름 (랜덤 이름이 자동으로 생성됩니다)
- 설명(Description): 프로젝트 목적에 대한 선택적 메모
- 공개 범위(Visibility): 공개(누구나 볼 수 있음) 또는 비공개(본인만 액세스 가능)
- 라이선스(License): 프로젝트를 위한 선택적 라이선스(AGPL-3.0, Apache-2.0, MIT, GPL-3.0, BSD-3-Clause, LGPL-3.0, MPL-2.0, EUPL-1.1, Unlicense, Ultralytics-Enterprise 등). Ultralytics-Enterprise 라이선스는 AGPL 요구 사항 없이 상업적 용도로 사용하기 위한 것이며 Enterprise 플랜에서 제공됩니다. Ultralytics 라이선싱을 참조하십시오.
**생성(Create)**을 클릭하여 완료합니다. 새 프로젝트가 프로젝트 목록과 사이드바에 나타납니다.
프로젝트 페이지
프로젝트 페이지에는 두 개의 주요 영역이 있습니다:
| 영역 | 설명 |
|---|---|
| 모델 사이드바(Models Sidebar) | 검색, 상태 필터, 정렬 옵션 및 선택을 위한 체크박스가 포함된 프로젝트 내 모든 모델의 크기 조절 가능한 목록 |
| 메인 패널(Main Panel) | 차트 대시보드 또는 비교 테이블(뷰 간 전환 가능) |
프로젝트 헤더
헤더는 다음을 표시합니다:
- 프로젝트 아이콘(색상, 글자 또는 업로드된 이미지를 사용자 지정할 수 있음)
- 편집 가능한 이름(클릭하여 이름 변경; 슬러그가 자동 업데이트됨)
- 라이선스 배지
- 모델 수, 완료/실행 중/실패 카운트, 총 크기
- 복제 수(Clone count) 및 마지막 업데이트 타임스탬프
- 설명(클릭하여 편집)
헤더의 작업 버튼:
| 버튼 | 설명 |
|---|---|
| 새 모델(New Model) | 학습 대화 상자를 엽니다 |
| 복제(Clone) | 프로젝트 및 모든 모델 복제(공개 프로젝트) |
| 즐겨찾기(Star) | 프로젝트 즐겨찾기 설정/해제 |
| 공유(Share) | 공개 프로젝트를 위한 소셜 공유 |
| 새로고침(Refresh) | 프로젝트 데이터 새로고침 |
| 삭제 | 프로젝트를 휴지통으로 이동 |
보기 모드
보기 컨트롤을 사용하여 세 가지 보기 모드 간에 전환합니다:
- 카드(Cards): 오른쪽에 차트 대시보드가 있는 전체 너비 모델 사이드바 — 체크된 모델에 대한 손실 곡선 및 메트릭 비교.
- 컴팩트(Compact): 오른쪽에 차트 대시보드가 있는 압축된 모델 사이드바 — 실험이 많은 프로젝트에서 모델을 위한 더 많은 수직 공간 확보.
- 테이블(Table): 학습 인수와 최종 메트릭을 나란히 보여주는 비교 테이블. **차이(Diff)**를 활성화하여 모델 간 값이 다른 열만 강조 표시합니다.
모델 사이드바
크기 조절 가능한 사이드바에는 프로젝트 내 모든 모델이 나열됩니다:
- 체크박스: 차트/테이블에 표시할 모델 선택
- 검색: 이름별로 모델 필터링
- 보기 옵션: 상태 필터(전체, 완료, 실행 중, 시작 중, 대기 중, 실패, 취소됨), 작업별 그룹화 및 정렬 순서
- 드래그 앤 드롭:
.pt파일을 사이드바로 직접 드래그하여 모델 업로드(모델 업로드 세부 정보) - 학습 진행률: 실행 중인 모델에 대해 표시됨(에포크 수 및 진행률 표시줄)
모델을 클릭하여 모델 페이지를 엽니다.
프로젝트 아이콘
프로젝트 아이콘을 사용자 지정합니다:
- 프로젝트 이름 옆의 아이콘 클릭
- 색상과 글자를 선택하거나 사용자 지정 이미지 업로드
- 변경 사항은 자동으로 저장됩니다
가시성 설정
프로젝트를 볼 수 있는 사람 제어:
| 설정 | 설명 |
|---|---|
| 공개(Public) | 탐색(Explore) 페이지에서 누구나 볼 수 있음 |
| 비공개(Private) | 본인과 공동 작업자만 가능 |
공동 작업자와 공유
전체 팀 워크스페이스를 만들지 않고 특정 사용자와 비공개 프로젝트를 공유합니다:
- 프로젝트 페이지에서 공유(Share) 버튼 클릭
- 공동 작업자의 사용자 이름 또는 이메일 입력
- 역할 설정
- 초대(Invite) 클릭
편집자 권한이 있는 공동 작업자는 프로젝트 내에서 모델을 업로드하고 학습을 시작할 수 있습니다.
**공유(Sharing)**는 개별 사용자에게 프로젝트별 액세스 권한을 부여하며, 일회성 협업에 이상적입니다. **팀(Teams)**은 모든 리소스(프로젝트, 데이터셋, 모델, 배포)를 역할 기반 권한으로 팀원들이 액세스할 수 있는 공유 워크스페이스를 생성합니다. 다수와의 지속적인 협업에는 팀 기능을 사용하십시오.
프로젝트 복제
공개 프로젝트를 본인의 계정으로 복제합니다:
- 공개 프로젝트 페이지 방문
- 프로젝트 복제(Clone Project) 클릭
- 프로젝트와 모든 모델이 비공개 프로젝트로 본인의 계정에 복사됩니다
복제된 프로젝트는 항상 본인의 계정에서 비공개로 생성됩니다. 복제 수는 원본 프로젝트에 표시됩니다. 원본이 카피레프트 라이선스(예: AGPL-3.0)인 경우, 복제본은 해당 라이선스를 상속하고 잠급니다.
모델 비교
차트 대시보드
차트 대시보드를 사용하여 모델 성능을 비교합니다:
- 체크박스를 사용하여 사이드바에서 모델 선택
- 유형별로 그룹화된 오버레이 메트릭 곡선 보기(메트릭, 학습 손실, 검증 손실, 학습률)
- 차트를 드래그하여 재정렬하거나, 가장자리를 드래그하여 크기 조절
- 마우스를 올려 정확한 값을 확인하고, 범례 항목을 클릭하여 모델 숨기기/표시, 모델 라인을 클릭하여 해당 모델로 이동
사용 가능한 차트 그룹:
| 그룹 | 차트 |
|---|---|
| 메트릭 (Metrics) | mAP50, mAP50-95, 정밀도(precision), 재현율(recall) |
| 학습 손실(Train Loss) | train/box_loss, train/cls_loss, train/dfl_loss |
| 검증 손실(Val Loss) | val/box_loss, val/cls_loss, val/dfl_loss |
| 학습률(Learning Rate) | lr/pg0, lr/pg1, lr/pg2 |
- 마우스를 올려 정확한 값을 확인합니다
- 범례 항목을 클릭하여 모델을 숨기거나 표시합니다.
- 드래그하여 특정 영역을 확대합니다.
- 모델 라인을 클릭하여 해당 모델 페이지로 이동합니다.
- 차트를 재정렬하고 크기를 조정합니다. 레이아웃은 세션 간에 유지됩니다.
비교 테이블
학습 인수와 최종 지표를 나란히 비교하려면 테이블 보기로 전환하십시오:
- 테이블 보기 모드 토글을 클릭합니다.
- 선택한 모든 모델을 행으로, 학습 인수와 지표를 열로 확인합니다.
- Diff 버튼을 사용하여 모델 간 값이 다른 열만 강조 표시합니다.
모델 업로드
기존 .pt 모델 파일을 업로드합니다:
- 프로젝트 페이지 또는 모델 사이드바에 파일을 드래그 앤 드롭합니다.
- 여러 파일을 동시에 업로드할 수 있습니다 (최대 3개 동시 업로드).
- 모델 메타데이터(태스크, 아키텍처, 클래스 이름, 학습 결과)는
.pt파일에서 자동으로 파싱됩니다. - 업로드가 백그라운드에서 완료되는 동안 로컬에서 파싱된 데이터를 사용하여 차트가 즉시 업데이트됩니다.
Ultralytics YOLO 학습에서 생성된 PyTorch .pt 파일만 지원됩니다. 플랫폼은 학습 결과, 인수, 태스크 유형 및 클래스 이름을 포함한 임베디드 메타데이터를 파싱합니다. 형식에 대한 자세한 내용은 Models를 참조하십시오.
프로젝트 편집
프로젝트 이름, 설명 또는 설정을 업데이트합니다:
- 프로젝트 이름을 클릭하여 인라인으로 편집합니다.
- 설명을 클릭하여 인라인으로 편집합니다.
- 아이콘을 클릭하여 사용자 정의합니다.
- 라이선스 배지를 클릭하여 라이선스를 변경합니다.
프로젝트 삭제
더 이상 필요하지 않은 프로젝트를 제거합니다:
- 헤더의 삭제 버튼(휴지통 아이콘)을 클릭합니다.
- 삭제를 확인하십시오
프로젝트를 삭제하면 해당 프로젝트 내의 모든 모델도 삭제됩니다. 이 작업은 항목을 휴지통으로 이동하며, 여기서 30일 이내에 복원할 수 있습니다.
FAQ
한 프로젝트에 몇 개의 모델을 포함할 수 있습니까?
프로젝트당 모델 수에는 하드 제한이 없습니다. 하지만 더 나은 관리를 위해 다음을 권장합니다:
- 관련 실험 그룹화 (동일한 데이터셋/태스크)
- 오래된 실험 보관
- 의미 있는 프로젝트 이름 사용
삭제된 프로젝트를 복원할 수 있습니까?
네, 삭제된 프로젝트는 휴지통으로 이동하며 30일 이내에 복원할 수 있습니다:
- 설정 > 휴지통으로 이동합니다.
- 해당 프로젝트를 찾습니다.
- 복원을 클릭합니다.
프로젝트 간에 모델을 전송할 수 있습니까?
네, 모델 페이지의 모델 복제 대화 상자를 사용하여 모델을 다른 프로젝트로 복제할 수 있습니다.