Projects

모델 버전을 비교하고, 임시 워크스페이스에서 결과를 탐색한 다음, 리포트로 내보내 노트와 시각화를 저장합니다

프로젝트는 결과를 시각화하고, 실험을 비교하고, 아티팩트를 확인하고 다운로드하고, 자동화를 생성하는 등 다양한 작업을 수행하는 중심 위치입니다.

각 프로젝트에는 누가 액세스할 수 있는지를 결정하는 공개 범위 설정이 있습니다. 프로젝트에 누가 액세스할 수 있는지에 대한 자세한 내용은 Project visibility를 참조하세요.

각 프로젝트에는 다음 탭이 있습니다.

• Overview: 프로젝트의 스냅샷
• Workspace: 개인용 시각화 샌드박스
• Runs: 프로젝트의 모든 run을 나열한 테이블
• Automations: 프로젝트에 구성된 Automations
• Sweeps: 자동 탐색 및 최적화
• Reports: notes, run, 그래프의 저장된 스냅샷
• Artifacts: 모든 run과 해당 run에 연결된 아티팩트를 포함합니다

​

Overview tab

W&B는 프로젝트 필드에 지정한 이름으로 run을 초기화하면 프로젝트를 생성합니다.

Overview 탭에서 프로젝트 이름을 확인하고 프로젝트를 관리할 수 있습니다.

• 프로젝트 이름, 설명 또는 팀을 변경하려면 오른쪽 상단의 Edit를 클릭합니다.
• 최근 삭제한 Runs를 복원하려면 오른쪽 상단의 액션 () 메뉴를 클릭한 다음 Undelete recently deleted runs를 클릭합니다.
• 프로젝트를 삭제하려면 오른쪽 상단의 액션 () 메뉴를 클릭한 다음 Delete project를 클릭합니다. 확인 대화 상자의 내용을 읽고 안내에 따르세요. 프로젝트 삭제는 되돌릴 수 없습니다.

Overview 페이지의 나머지 부분은 Details 탭과 Project Roles 탭으로 나뉩니다.

​

세부 정보

프로젝트 세부 정보에는 다음이 포함됩니다.

• Project visibility: 프로젝트의 공개 범위입니다. 누가 이 프로젝트에 액세스할 수 있는지를 결정하는 설정입니다. 자세한 내용은 Project visibility를 참조하세요.
• Last active: 이 프로젝트에 마지막으로 데이터가 로깅된 Timestamp
• Contributors: 이 프로젝트에 기여한 사용자 수
• Total runs: 이 프로젝트의 총 run 수
• Total compute: 이 값은 프로젝트의 모든 run 시간을 합산해 계산합니다.

Details 탭에는 프로젝트의 데이터와 메트릭에 액세스하고 내보내는 방법, sweep에서 최적 모델을 다운로드하는 방법 등이 포함되어 있습니다.

라이브 예제 프로젝트 보기

Overview 탭에서 프로젝트의 공개 범위를 변경하려면 다음을 참조하세요.

1. W&B App에서 프로젝트의 아무 페이지에서나 왼쪽 내비게이션에서 Overview를 클릭합니다.

2. 오른쪽 상단에서 Edit를 클릭합니다.

3. Project visibility의 새 값을 선택합니다.

   • Team(기본값): 팀원만 프로젝트를 보고 편집할 수 있습니다.

   • Restricted: 초대된 멤버만 프로젝트에 액세스할 수 있으며, 공개 액세스는 비활성화됩니다.

   • Open: 누구나 run을 제출하거나 Reports를 만들 수 있지만, 편집은 팀원만 할 수 있습니다. 강의실 환경, 공개 벤치마크 대회 또는 그 밖의 일시적인 컨텍스트에서만 사용하는 것이 적합합니다.

   • Public: 누구나 프로젝트를 볼 수 있지만, 편집은 팀원만 할 수 있습니다.

     W&B 관리자에 의해 Public 공개 범위가 비활성화된 경우 이 옵션을 선택할 수 없습니다. 대신 보기 전용 W&B Report를 공유하거나, 도움이 필요하면 W&B 조직 관리자에게 문의하세요.

4. Save를 클릭합니다.

프로젝트를 더 엄격한 개인정보 보호 설정으로 변경하면, 프로젝트 액세스 권한을 복원하기 위해 개별 사용자를 다시 초대해야 할 수 있습니다.

​

Project Roles

Project Roles 탭은 프로젝트 소유자와 Admin 역할이 있는 사용자에게만 표시됩니다. 프로젝트에 액세스할 수 있는 사용자를 목록에서 확인하고 검색하거나, 멤버의 역할을 변경할 수 있습니다.

​

Workspace tab

프로젝트의 워크스페이스는 실험을 비교할 수 있는 개인용 샌드박스입니다. Projects를 사용하면 서로 비교할 수 있는 모델을 정리할 수 있습니다. 예를 들어 같은 문제를 다루지만 아키텍처, 하이퍼파라미터, 데이터셋, 전처리 등이 서로 다른 모델을 정리할 수 있습니다.

Runs Sidebar: 프로젝트의 모든 run 목록입니다.

• 액션 () 메뉴: 사이드바에서 행 위에 마우스를 올리면 왼쪽에 메뉴가 나타납니다. 이 메뉴를 사용해 run 이름을 바꾸거나, run을 삭제하거나, 활성 상태인 run을 중지할 수 있습니다.
• Visibility icon: 눈 아이콘을 클릭해 그래프에서 run 표시를 켜거나 끕니다
• Color: run 색상을 미리 설정된 다른 색상이나 맞춤형 색상으로 변경합니다
• Search: 이름으로 run을 검색합니다. 그러면 플롯에 표시되는 run도 함께 필터링됩니다.
• Filter: 사이드바 필터를 사용해 표시되는 run 범위를 좁힙니다
• Group: 설정 열을 선택해 run을 동적으로 그룹화합니다. 예를 들어 아키텍처별로 그룹화할 수 있습니다. 그룹화하면 플롯에 평균값을 따라가는 선과 그래프 점들의 분산을 나타내는 음영 영역이 표시됩니다.
• Sort: 값을 선택해 run을 정렬합니다. 예를 들어 loss가 가장 낮거나 accuracy가 가장 높은 run을 기준으로 정렬할 수 있습니다. 정렬은 그래프에 어떤 run이 표시되는지에 영향을 줍니다.
• Expand button: 사이드바를 전체 table로 확장합니다
• Minimize: Cmd+. (macOS) 또는 Ctrl+. (Windows/Linux)를 눌러 Runs selector를 접거나 다시 펼칩니다. 자세한 내용은 Keyboard shortcuts를 참조하세요.
• Run count: 상단 괄호 안의 숫자는 프로젝트의 전체 run 수입니다. (N visualized) 숫자는 눈 아이콘이 켜져 있어 각 플롯에서 시각화할 수 있는 run 수를 뜻합니다. 아래 예시에서는 그래프가 183개 run 중 처음 10개만 표시합니다. 그래프를 편집해 표시되는 최대 run 수를 늘리세요.

Runs tab에서 열을 고정하거나 숨기거나 순서를 바꾸면 Runs sidebar에도 이러한 맞춤 설정이 반영됩니다.

Panels layout: 이 작업 공간에서 결과를 탐색하고, chart를 추가하거나 제거하고, 서로 다른 메트릭을 기준으로 모델 버전을 비교할 수 있습니다

실제 예시 보기

​

패널 섹션 추가

섹션 드롭다운 메뉴에서 “섹션 추가”를 클릭해 패널용 새 섹션을 만드세요. 섹션 이름을 바꾸고, 드래그해 순서를 재정렬하고, 섹션을 펼치거나 접을 수 있습니다.

각 섹션의 오른쪽 상단에는 다음 옵션이 있습니다:

• 섹션 추가: 드롭다운 메뉴에서 위 또는 아래에 섹션을 추가하거나, 페이지 하단의 버튼을 클릭해 새 섹션을 추가합니다.
• 섹션 이름 바꾸기: 섹션 제목을 변경합니다.
• 섹션을 리포트로 내보내기: 이 패널 섹션을 새 리포트로 저장합니다.
• 섹션 삭제: 전체 섹션과 모든 차트를 삭제합니다. 이 작업은 Workspace 바의 페이지 하단에 있는 실행 취소 버튼으로 되돌릴 수 있습니다.
• 패널 추가: 더하기 버튼을 클릭해 섹션에 패널을 추가합니다.

​

섹션 간 패널 이동

패널을 끌어다 놓아 순서를 바꾸고 섹션별로 정리할 수 있습니다. 패널 오른쪽 상단의 “Move” 버튼을 클릭한 다음, 패널을 이동할 섹션을 선택할 수도 있습니다.

​

패널 크기 조정

모든 패널은 동일한 크기로 유지되며, 패널은 여러 페이지로 나뉘어 표시됩니다. 마우스를 올리면 모서리 아이콘이 표시되며, 섹션의 오른쪽 아래 모서리를 클릭한 채 드래그하여 크기를 조정할 수 있습니다.

​

메트릭 검색

워크스페이스의 검색 상자를 사용해 패널을 필터링합니다. 이 검색은 패널 제목을 기준으로 일치하며, 패널 제목은 기본적으로 시각화된 메트릭 이름입니다.

​

Runs 탭

Runs 탭을 사용해 run을 필터링, 그룹화, 정렬할 수 있습니다.

다음 탭에서는 Runs 탭에서 수행할 수 있는 몇 가지 일반적인 작업을 보여줍니다.

열 사용자 지정

Runs 탭에는 프로젝트의 run 세부 정보가 표시됩니다. 기본적으로 많은 수의 열이 표시됩니다.

Runs 탭을 사용자 지정하면 해당 설정이 Workspace 탭의 Runs 선택기에도 반영됩니다.

• 표시된 모든 열을 보려면 페이지를 가로로 스크롤하세요.
• 열 순서를 변경하려면 열을 왼쪽이나 오른쪽으로 드래그하세요.
• 열을 고정하려면 열 이름 위에 마우스를 올리고, 표시되는 액션 () 메뉴를 클릭한 다음 Pin column을 클릭하세요. 고정된 열은 페이지 왼쪽의 Name 열 다음에 표시됩니다. 고정된 열의 고정을 해제하려면 Unpin column을 선택하세요.
• 열을 숨기려면 열 이름 위에 마우스를 올리고, 표시되는 액션 () 메뉴를 클릭한 다음 Hide column을 클릭하세요. 현재 숨겨진 모든 열을 보려면 Columns를 클릭하세요.
• 여러 열을 한 번에 표시, 숨기기, 고정, 고정 해제하려면 Columns를 클릭하세요.
  • 숨겨진 열 이름을 클릭하면 다시 표시됩니다.
  • 표시된 열 이름을 클릭하면 숨겨집니다.
  • 표시된 열 옆의 고정 아이콘을 클릭하면 해당 열이 고정됩니다.

정렬

다음 옵션 중 하나를 사용해 지정된 열의 값을 기준으로 Table의 모든 행을 정렬하세요.

1. 열 헤더 위에 마우스를 올리면 표시되는 액션 () 메뉴를 클릭하면 해당 열의 값을 기준으로 테이블을 빠르게 정렬할 수 있습니다.
2. Sort 버튼을 클릭하고 드롭다운에서 원하는 열을 선택하세요. 이 패널을 사용하면 우선순위에 따라 여러 열을 기준으로 정렬할 수 있습니다.

앞의 이미지는 val_acc라는 Table 열의 정렬 옵션을 보는 방법을 보여줍니다.

필터

대시보드 왼쪽 상단의 Filter 버튼을 사용해 식으로 모든 행을 필터링하세요.

New filter를 클릭해 행에 하나 이상의 필터를 추가하세요. 필터를 설정할 수 있는 드롭다운 메뉴 3개가 나타납니다. 왼쪽부터 차례대로 열 이름, Operator, 필터 값입니다.

그룹화

테이블 위의 Group 버튼을 클릭해 특정 열의 값을 기준으로 모든 행을 그룹화하세요. run 그룹화에 대한 자세한 내용은 Organize runs into groups를 참조하세요.

​

Automations 탭

아티팩트 버전 관리를 위한 후속 작업을 자동화합니다. 자동화를 만들려면 트리거 이벤트와 그에 따른 작업을 정의하세요. 작업에는 웹훅 실행 또는 W&B 작업 시작이 포함됩니다. 자세한 내용은 Automations을 참조하세요.

​

Sweeps 탭

프로젝트에서 새 sweep을 시작하세요.

​

Reports 탭

한곳에서 모든 결과 스냅샷을 확인하고 팀과 결과를 공유하세요.

리포트를 보려면 프로젝트 사이드바에서 Reports 탭을 선택한 다음, 목록에서 리포트를 선택하세요.

​

Artifacts 탭

트레이닝 데이터셋과 파인튜닝된 모델부터 메트릭 및 미디어 테이블까지, 프로젝트와 관련된 모든 아티팩트를 확인하세요.

​

메타데이터 패널

메타데이터 패널에서는 아티팩트의 메타데이터에 액세스할 수 있습니다. 이 메타데이터에는 아티팩트를 재구성하는 데 필요한 설정 인수, 추가 정보를 확인할 수 있는 URL, 또는 아티팩트를 로깅한 run에서 생성된 메트릭이 포함될 수 있습니다. 아티팩트를 생성한 run의 설정과 메트릭 이력도 확인할 수 있습니다.

아티팩트의 메타데이터를 보려면 다음과 같이 하세요.

1. 프로젝트 사이드바에서 Artifacts 탭을 선택합니다.
2. 목록에서 아티팩트를 선택하여 해당 아티팩트 최신 버전의 세부정보 페이지를 확인합니다.
3. Metadata 탭을 선택하여 해당 아티팩트와 연결된 메타데이터를 확인합니다.

​

사용 패널

사용 패널은 웹 앱 외부(예: 로컬 머신)에서 사용할 수 있도록 아티팩트를 다운로드하는 code snippet을 제공합니다. 또한 이 섹션에는 해당 아티팩트를 출력한 run과, 이 아티팩트를 입력으로 사용하는 모든 run이 표시되며 연결됩니다.

아티팩트 사용을 보려면 다음과 같이 하세요:

1. 프로젝트 사이드바에서 Artifacts 탭을 선택합니다.
2. 목록에서 아티팩트를 선택해 해당 아티팩트 최신 버전의 세부정보 페이지를 봅니다.
3. 사용 탭을 선택해 code snippet과 관련 run을 봅니다.

​

파일 패널

파일 패널에는 아티팩트와 연관된 파일 및 폴더가 나열됩니다. W&B는 run에 대해 일부 파일을 자동으로 업로드합니다. 예를 들어 requirements.txt에는 run이 사용한 각 라이브러리의 버전이 표시되며, wandb-metadata.json 및 wandb-summary.json에는 run에 대한 정보가 포함됩니다. 그 밖의 파일도 run의 설정에 따라 아티팩트나 미디어처럼 업로드될 수 있습니다.

아티팩트에 로깅된 파일을 보려면 다음과 같이 하세요:

1. 프로젝트 사이드바에서 Artifacts 탭을 선택합니다.
2. 목록에서 아티팩트를 선택해 해당 아티팩트의 최신 버전에 대한 세부 정보 페이지를 확인합니다.
3. Files 탭을 선택해 해당 아티팩트와 연관된 모든 파일을 확인합니다.

​

리니지 패널

리니지 패널은 프로젝트와 연결된 모든 아티팩트와, 이들을 서로 연결하는 run을 보여줍니다. run 유형은 블록으로, 아티팩트는 원으로 표시되며, 화살표는 특정 유형의 run이 특정 유형의 아티팩트를 소비하거나 생성하는 관계를 나타냅니다. 왼쪽 열에서 선택한 특정 아티팩트의 유형은 강조 표시됩니다.

Explode 표시/숨기기를 클릭하면 개별 아티팩트 버전 전체와 이를 연결하는 특정 run을 볼 수 있습니다.

​

Versions 탭

Versions 탭에는 아티팩트의 모든 버전이 표시됩니다. 특정 버전의 세부 정보를 보려면 아티팩트를 선택합니다.

1. 프로젝트 사이드바에서 Artifacts 탭을 선택합니다.
2. 목록에서 아티팩트를 선택하여 해당 아티팩트 최신 버전의 세부 정보 페이지를 확인합니다.
3. 해당 아티팩트의 모든 버전을 보려면 Versions 탭을 선택합니다.
4. 드롭다운(아티팩트 이름 옆)에서 All Versions를 선택합니다.

예를 들어, 앞의 이미지는 "zoo-wyhak4p0"라는 이름의 모델 아티팩트에 있는 여러 버전을 보여줍니다.

​

프로젝트 만들기

W&B App에서 프로젝트를 만들거나, wandb.init() 호출 시 프로젝트를 지정해 프로그래밍 방식으로 만들 수 있습니다.

W&B App

W&B App에서는 Projects 페이지 또는 팀 랜딩 페이지에서 프로젝트를 만들 수 있습니다.

Projects 페이지에서:

1. 왼쪽 상단의 전역 내비게이션 아이콘을 클릭합니다. 프로젝트 사이드바가 열립니다.
2. 내비게이션의 Projects 섹션에서 View all을 클릭해 프로젝트 Overview 페이지를 엽니다.
3. Create new project를 클릭합니다.
4. Team을 프로젝트를 소유할 팀 이름으로 설정합니다.
5. Name 필드에 프로젝트 이름을 지정합니다.
6. Project visibility를 설정합니다. 기본값은 Team입니다.
7. 필요에 따라 설명을 입력합니다.
8. Create project를 클릭합니다.

팀 랜딩 페이지에서:

1. 왼쪽 상단의 전역 내비게이션 아이콘을 클릭합니다. 프로젝트 사이드바가 열립니다.
2. 내비게이션의 Teams 섹션에서 팀 이름을 클릭해 해당 랜딩 페이지를 엽니다.
3. 랜딩 페이지에서 Create new project를 클릭합니다.
4. Team은 현재 보고 있는 랜딩 페이지를 소유한 팀으로 자동 설정됩니다. 필요한 경우 팀을 변경합니다.
5. Name 필드에 프로젝트 이름을 지정합니다.
6. Project visibility를 설정합니다. 기본값은 Team입니다.
7. 필요에 따라 설명을 입력합니다.
8. Create project를 클릭합니다.

Python SDK

프로그래밍 방식으로 프로젝트를 만들려면 wandb.init()를 호출할 때 project를 지정합니다. 프로젝트가 아직 없으면 자동으로 생성되며, 지정한 entity가 소유하게 됩니다. 예를 들면 다음과 같습니다.

import wandb with wandb.init(entity="<entity>", project="<project_name>") as run: run.log({"accuracy": .95})

wandb.init() API 레퍼런스를 참고하세요.

​

조직 홈 및 Recent Activity

W&B App에서 조직 홈 페이지는 최근 작업을 요약해서 보여줍니다.

Recent Activity 뷰어에는 최근 Runs가 표시됩니다. 내 Runs를 보려면 Your projects를 선택하고, 동료의 최근 Runs를 보려면 Organization을 선택하세요.

• Search를 사용해 활동 목록을 필터링하세요.
• 정렬 가능한 열을 사용하면 원하는 column을 기준으로 행을 다시 정렬할 수 있습니다.
• run에 이러한 세부 정보가 포함되어 있으면 Notes 및 tags column이 자동으로 표시됩니다.

Recent Activity 뷰어 아래에서 최근에 생성한 Reports에 빠르게 액세스할 수 있습니다.

​

프로젝트에 별표 표시

프로젝트에 별표를 추가해 중요 프로젝트로 표시할 수 있습니다.

별표 표시된 프로젝트는 Projects 페이지 상단에 그룹화되어 표시됩니다. 왼쪽 상단의 Global navigation menu에 있는 Projects 목록에서 최근 프로젝트를 최대 10개까지 빠르게 액세스할 수 있으며, 별표 표시된 프로젝트가 먼저 나열됩니다.

프로젝트를 중요하다고 표시하는 방법은 두 가지입니다. 프로젝트의 Overview 탭에서 하거나 팀 프로필 페이지에서 할 수 있습니다.

프로젝트 Overview

1. W&B App에서 https://wandb.ai/<team>/<project-name>로 이동해 W&B 프로젝트를 엽니다.
2. 프로젝트 사이드바에서 Overview 탭을 선택합니다.
3. 오른쪽 상단의 Edit 버튼 옆에 있는 별표 아이콘을 클릭합니다.

팀 프로필

1. https://wandb.ai/<team>/projects의 팀 프로필 페이지로 이동합니다.
2. Projects 탭을 선택합니다.
3. 별표를 표시하려는 프로젝트 옆에 마우스를 올린 뒤, 나타나는 별표 아이콘을 클릭합니다.

예를 들어, 다음 이미지는 “Compare_Zoo_Models” 프로젝트 옆의 별표 아이콘을 보여줍니다.

프로젝트가 표시되는지 확인합니다. 왼쪽 내비게이션의 Project 섹션에서 View all을 클릭해 Project 페이지를 엽니다. 검색하거나 필터링하여 이름, 팀 또는 기타 메타데이터로 프로젝트를 찾습니다. 별표 표시된 프로젝트는 Projects 페이지 상단과 왼쪽 내비게이션의 Projects 섹션 상단에 표시됩니다.

​

프로젝트 삭제

Overview 탭 오른쪽에 있는 액션 () 메뉴를 사용하면 프로젝트를 삭제할 수 있습니다.

1. W&B 프로젝트로 이동합니다.
2. 프로젝트 사이드바에서 Overview 탭을 선택합니다.
3. 오른쪽 상단의 액션 () 메뉴를 클릭합니다.
4. 드롭다운 메뉴에서 Delete project를 선택합니다.

프로젝트를 삭제해도 W&B는 활성 sweeps 또는 agent를 종료하지 않습니다.

​

프로젝트에 노트 추가

프로젝트에 노트를 설명 Overview로 추가하거나 워크스페이스 내의 마크다운 패널로 추가할 수 있습니다.

​

프로젝트에 Overview 설명 추가하기

페이지에 추가한 설명은 프로필의 Overview 탭에 표시됩니다.

1. W&B 프로젝트로 이동합니다
2. 프로젝트 사이드바에서 Overview 탭을 선택합니다
3. 오른쪽 상단에서 Edit를 클릭합니다
4. 설명 필드에 메모를 추가합니다
5. Save 버튼을 선택합니다

run 비교용 설명 메모를 만들려면 Reports를 생성하세요

W&B 리포트를 만들어 plot과 markdown을 나란히 추가할 수도 있습니다. 서로 다른 섹션을 사용해 서로 다른 run을 보여주고, 작업한 내용에 대한 스토리를 전달하세요.

​

run 워크스페이스에 노트 추가

1. W&B 프로젝트로 이동합니다
2. 프로젝트 사이드바에서 워크스페이스 탭을 선택합니다
3. 오른쪽 상단에서 Add panels 버튼을 클릭합니다
4. 표시되는 모달에서 TEXT AND CODE 드롭다운을 선택합니다
5. Markdown을 선택합니다
6. 워크스페이스에 표시되는 Markdown 패널에 노트를 추가합니다