Hub documentation
프리 릴리스 모델 페이지
프리 릴리스 모델 페이지
이 기능은 Enterprise 플랜 이상을 사용하는 조직에서 사용할 수 있습니다. 또는 문의해 주세요.
Pre-release model pages는 모델이 아직 비공개 상태일 때 조직이 예정된 모델을 공지할 수 있게 합니다. 404 페이지 대신 방문자는 출시일까지의 실시간 카운트다운과 Like and Notify on release 버튼이 포함된 전용 공지 페이지를 보며, 모델이 출시되는 즉시 이메일로 알림을 받을 수 있습니다. 모델을 공개하면 출시된 것으로 간주되며, 공지 페이지는 모델 카드로 대체됩니다.
자격 요건
- 조직은 Enterprise 플랜 또는 그 이상의 플랜에 구독되어 있어야 합니다.
- 모델 저장소는 조직 네임스페이스 아래에 있어야 합니다(예:
my-org/my-upcoming-model). 사용자 소유의 저장소는 대상이 아닙니다. - 모델 저장소는 private여야 합니다. 모델을 공개하면 릴리스됩니다(아래 참조).
모델 발표
private 모델의 페이지를 사전 출시 페이지로 전환하려면, 모델 카드 메타데이터(리포지토리의 README.md 상단 YAML 섹션)에 release_date 필드를 추가하세요:
---
release_date: 2026-07-27
description: "A short tagline shown on the pre-release page"
---release_date 필드는 YAML 날짜를 받거나, 특정 시간을 지정하려면 따옴표로 묶인 ISO 8601 타임스탬프를 받을 수 있습니다:
release_date: "2026-07-27T15:00:00Z"잘못된 값은 메타데이터 검증기에 의해 거부되고 무시됩니다. 날짜가 미래일 필요는 없습니다: 과거 날짜를 사용하면 페이지에 카운트다운 대신 “Coming very soon”이 표시됩니다. 날짜는 UTC로 표시됩니다.
몇 가지 선택적 메타데이터 필드를 통해 사전 릴리스 페이지를 사용자 지정할 수 있습니다:
| 필드 | 효과 |
|---|---|
description | 프리 릴리스 페이지의 히어로 태그라인이며, 페이지의 메타 설명으로도 사용됩니다. |
pretty_name | 히어로 제목에 저장소 이름 대신 표시되는 사람이 읽을 수 있는 이름. |
approximate_eta | release_date가 추정치인 경우 true로 설정합니다. 이 경우 해당 날짜에는 Current ETA 배지가 표시됩니다. |
thumbnail | 생성된 이미지를 대체하는 사용자 지정 소셜 공유 이미지의 URL |
---
release_date: 2026-07-27
approximate_eta: true
pretty_name: "My Upcoming Model"
description: "A short tagline shown on the pre-release page"
---알아두면 좋은 몇 가지 사항:
- 모델 카드의 마크다운 본문(YAML 메타데이터 아래에 있는 모든 내용)은 프리릴리스 페이지에서 방문자가 읽는 부분입니다. 이 부분을 활용하여 출시 예정인 내용을 설명하고, 티저를 보여주거나, 논문에 대한 링크를 추가하는 등의 용도로 사용하세요.
- 아직 가중치를 업로드할 필요가 없습니다: 발표 기간 동안 저장소에는
README.md만 있으면 됩니다. 준비가 되면 언제든 모델 파일을 업로드하세요. - 모델 카드 메타데이터를 편집한 후, 사전 릴리스 페이지가 켜지거나 꺼지는 데 몇 초가 걸릴 수 있습니다.
방문자가 보는 것
모델이 비공개이고 release_date가 설정되어 있으며(조직이 해당 자격을 갖춘 경우), 방문자는 404 페이지 대신 사전 출시 페이지를 확인합니다:
- Upcoming release 라벨, 모델 이름, 태그라인, 그리고 출시일까지의 실시간 countdown이 포함된 히어로 섹션입니다. 히어로의 색상은 조직의 아바타에서 파생됩니다.
- 좋아요 및 릴리스 알림 버튼: 클릭하면 저장소에 좋아요를 표시하고 릴리스에 대한 이메일 알림을 구독합니다. 사용자는 로그인 상태여야 하며, 모델의 좋아요를 취소하면 구독도 해제됩니다.
- 모델 카드 내용.
- 좋아요 수(발행을 기다리는 사용자)와 최근 좋아요를 누른 사용자, 예상 출시일, 그리고 조직의 최신 모델이 표시된 사이드바입니다.
- 히어로와 동일한 색상을 사용하는 전용 소셜 공유 썸네일입니다.

프리 릴리스 페이지는 모델 카드 내용을 렌더링합니다.
README.md본문에 작성한 모든 내용은 공지 기간 동안 공개적으로 표시되며, 여기에 포함된 이미지와 비디오도 포함됩니다. 저장소의 나머지 부분은 비공개로 유지됩니다: 파일, 토론, API 접근은 멤버에게만 제한되며, 모델은 공개 목록에 표시되지 않습니다.
카운트다운이 0에 도달하면 페이지에 “곧 출시됩니다”가 표시됩니다. 모델을 공개하기 전까지 사전 출시 페이지는 유지됩니다.
멤버가 보는 것
읽기 권한이 있는 모든 사용자는 저장소에서 일반 모델 페이지를 계속 볼 수 있으므로, 공지 기간 동안에도 팀은 파일과 설정을 계속 관리할 수 있습니다:
- 모델 페이지의 배너는 해당 모델이 사전 출시 상태임을 나타냅니다. 페이지 미리보기를 클릭하거나 모델 URL에
?preview를 추가하여 방문자가 보는 내용을 확인하세요. - 모델 목록에서 모델은 Pre-release 배지와 함께 표시됩니다.

릴리스 시 구독자에게 알림
릴리스할 준비가 되면:
- 모델 파일을 저장소에 푸시합니다.
- 모델을 공개 상태로 만듭니다. 이렇게 하면 모델이 릴리스되며, 프리릴리스 페이지가 일반 모델 페이지로 변경됩니다.
release_date필드를 제거할 필요가 없습니다. - 쓰기 권한이 있는 Repo 멤버는 “N명의 사용자가 이 릴리스에 대한 알림을 기다리고 있습니다”라는 배너와 Send release notifications 버튼을 확인합니다.
- Send release notifications를 클릭하면 Hugging Face에서 모델이 사용 가능하다는 이메일이 각 구독자에게 전송됩니다.

모델이 공개될 때 알림이 자동으로 전송되지 않습니다: 전송 시점은 사용자가 직접 선택합니다. 알아두어야 할 몇 가지 사항:
- Subscribers는 프리릴리스 기간 동안 해당 모델을 좋아한 사용자들을 의미하므로, 배너에 표시된 수는 총 좋아요 수보다 적을 수 있습니다.
- 각 구독자에게는 최대 1회 이메일이 전송되며, 알림이 전송되면 배너가 사라집니다.
- 알림은 각 사용자의 알림 설정을 따릅니다(“구독한 릴리스가 사용 가능합니다”).
Things to keep in mind
- 해당 날짜 이후에도 페이지가 유지됩니다: 릴리스 날짜에 도달한다고 해서 사전 릴리스 페이지가 자동으로 제거되지 않습니다. 모델을 공개하여 릴리스하고 일반 모델 페이지로 전환하세요.
- 모델을 공개하는 것이 릴리스입니다: 모델이 공개된 후에만 릴리스 알림을 보낼 수 있습니다.
- 모델이 여전히 비공개 상태일 때
release_date를 제거하면 사전 출시 페이지가 삭제됩니다. 방문자는 비공개 모델의 경우와 마찬가지로 404 페이지를 다시 확인하게 됩니다. release_date가 여전히 설정된 상태에서 모델을 다시 비공개로 전환하면 사전 출시 페이지가 다시 활성화됩니다.