Projects
프로젝트를 생성하고 팀원을 초대하여 Lab, Serving, Volume을 함께 사용하는 방법을 안내합니다.
프로젝트는 리소스 격리 단위입니다. 자신이 생성하거나 속한 프로젝트의 리소스만 조회할 수 있습니다.

| 번호 | 설명 |
|---|---|
| ① | 현재 작업 중인 프로젝트를 전환합니다. 선택한 프로젝트에 속한 Lab/Serving/Volume만 화면에 표시됩니다 |
| ② | 현재 프로젝트의 설정 페이지로 이동합니다. 프로젝트 단위 연동 credential을 관리할 때 사용합니다 |
| ③ | 새 프로젝트를 생성합니다. 이름은 3자 이상 소문자·숫자·하이픈만 가능하며 전체 시스템에서 고유해야 합니다 |
프로젝트 선택
- 상단 헤더의 ① 프로젝트 선택 드롭다운을 클릭합니다.
- 사용 가능한 프로젝트 목록에서 원하는 프로젝트를 선택합니다.
- 선택한 프로젝트의 리소스(Lab, Serving 등)가 화면에 표시됩니다.
프로젝트를 선택하면 이후 생성되는 Lab, Serving, Volume이 모두 현재 선택된 프로젝트에 속하게 됩니다. 리소스를 생성하기 전에 반드시 올바른 프로젝트가 선택되어 있는지 확인하세요.
프로젝트 설정
상단 헤더의 ② Project Settings 아이콘을 클릭하면 현재 선택된 프로젝트의 설정 페이지로 이동합니다.

| 번호 | 설명 |
|---|---|
| ① | 현재 프로젝트에서 사용하는 Hugging Face token 설정 카드입니다 |
| ② | 이 token을 사용할 수 있는 범위를 설명합니다. 해당 프로젝트에서 Hugging Face model 또는 dataset import를 실행할 수 있는 사용자는 이 token을 사용할 수 있습니다 |
| ③ | 필요한 repository 권한만 가진 read-only 또는 fine-grained token 사용을 권장합니다 |
| ④ | Hugging Face token 입력란입니다. token은 저장 후 다시 표시되지 않고 입력값은 마스킹됩니다 |
Hugging Face token 관리
프로젝트 Hugging Face token은 해당 프로젝트에서 Hugging Face model, dataset을 가져오는 작업, Compile 작에 사용하는 공유 credential입니다. 업
- Hugging Face token 입력란에
hf_...형식의 token을 입력합니다. - token 저장 버튼을 클릭합니다.
- token이 이미 설정된 프로젝트에서는 새 token을 입력한 뒤 token 교체로 갱신할 수 있습니다.
- 더 이상 프로젝트 token을 사용하지 않을 때는 token 삭제를 클릭합니다.
저장된 token 값은 다시 표시되지 않습니다. 설정 여부, 마지막 수정 시간, 수정한 사용자만 확인할 수 있습니다.
public-space는 모든 사용자가 자동으로 소속되는 공유 프로젝트입니다. 이 프로젝트에 Hugging Face token을 저장하면 Hugging Face model 또는 dataset import를 실행할 수 있는 모든 사용자가 해당 token을 사용할 수 있습니다.
프로젝트 생성
- 상단 헤더의 ② New Project 버튼을 클릭합니다.
- 프로젝트 이름을 입력합니다.
- 3자 이상의 소문자, 숫자, 하이픈(-)만 사용 가능 (예:
my-ml-project) - 프로젝트 이름은 고유해야 합니다.
- 3자 이상의 소문자, 숫자, 하이픈(-)만 사용 가능 (예:
- Create 버튼을 클릭하여 생성합니다.
팀원 초대
public-space가 아닌 프로젝트를 선택하면 상단 헤더에 Add Member 버튼이 표시됩니다.
- 상단 헤더의 Add Member 버튼을 클릭합니다.
- 초대할 사용자의 유저명(Username)을 입력합니다.
- Add Member 버튼을 클릭합니다.
- 추가된 사용자는 다음 로그인 시 프로젝트 선택 드롭다운에 해당 프로젝트가 자동으로 표시되며, 바로 접근할 수 있습니다.
프로젝트 나가기
- 프로젝트 선택 드롭다운에서 나가려는 프로젝트 옆의 나가기 아이콘을 클릭합니다.
- 확인 대화상자에서 Leave를 클릭합니다.
본인이 해당 프로젝트의 마지막 멤버인 경우, 나가기 시 프로젝트 및 모든 하위 리소스(Serving, Lab, Volume 등)가 삭제된다는 경고 확인 다이얼로그가 추가로 표시됩니다. 확인 후에만 나가기가 진행됩니다.
public-space는 모든 사용자가 자동으로 소속되는 기본 공용 프로젝트입니다. 로그인 시 자동으로 접근 권한이 부여되며, 이 프로젝트에서는 나가기가 불가능합니다.