Hub documentation

プレリリースモデルページ

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

プレリリースモデルページ

この機能は、Enterpriseプラン以上の組織でご利用いただけます。または、お問い合わせください。

プレリリースモデルページでは、モデルがまだ非公開の間に、組織として今後のモデルリリースを告知できます。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"

無効な値はメタデータバリデータによって拒否され、無視されます。日付は未来である必要はありません。過去の日付を指定すると、カウントダウンの代わりに「まもなく公開」と表示されます。日付はUTCで表示されます。

いくつかの任意のメタデータフィールドにより、プレリリースページをカスタマイズできます。

フィールド効果
descriptionプレリリースページのヒーローキャッチコピーであり、ページのメタディスクリプションとしても使用されます。
pretty_nameヒーロータイトルでリポジトリ名に代わって表示される人間が読みやすい名前。
approximate_etarelease_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"
---

さらに知っておくべきこと:

  • モデルカードのMarkdown本文(YAMLメタデータ以下の部分)は、プレリリースページで訪問者が読む内容です。これから提供される内容の説明、ティザーの提示、論文へのリンクの追加などに活用してください。
  • まだ重みのアップロードは不要です: 発表期間中は、リポジトリにREADME.mdがあるだけで十分です。準備ができた時点で、モデルファイルをアップロードしてください。
  • モデルカードのメタデータを編集した後、プレリリースページのオン/オフ切り替えに数秒かかる場合があります。

訪問者が表示される内容

モデルがプライベートであり、release_dateが設定されている場合(かつ、あなたの組織が対象である場合)、訪問者は404ページではなくプレリリースページが表示されます:

  • Upcoming release ラベル、モデル名、キャッチフレーズ、リリース日までのライブcountdown を備えたヒーローセクション。ヒーローのカラーは、あなたの組織のアバターから派生されます。
  • Like and Notify on releaseボタン: クリックするとリポジトリに「いいね」が付けられ、リリースのメール通知にユーザーが購読されます。ユーザーはログインしている必要があります。モデルの「いいね」を解除すると、購読も解除されます。
  • モデルカードの内容。
  • リリースを待っているユーザーの「いいね」数、最新の「いいね」をしたユーザー、予定リリース日、およびあなたの組織の最新モデルを表示するサイドバー。
  • ヒーローと同じ色を使用した、ソーシャルシェア用の専用サムネイル。
Pre-release page of a model, with a countdown to the release date and a Like and Notify on release button

プレリリースページでは、モデルカードの内容が表示されます。README.mdの本文に記述した内容は、アナウンスが公開されている間、参照されている画像や動画を含むすべてが公開されます。リポジトリの残りの部分は非公開のままです。ファイル、ディスカッション、APIアクセスはメンバーにのみ制限され、モデルは公開リストに表示されません。

カウントダウンがゼロになると、ページには「まもなく公開」と表示されます。モデルを公開するまで、プレリリースのページは表示され続けます。

メンバーが見るもの

リポジトリへの読み取りアクセスを持つすべてのユーザーは、通常どおりのモデルページを閲覧し続けるため、アナウンスが公開されている間も、チームはファイルや設定の管理を継続できます:

  • モデルページ上のバナーにより、そのモデルがプレリリースであることが示されます。プレビューページをクリックするか、モデルのURLに?previewを追加することで、訪問者が確認する内容を確認できます。
  • モデル一覧では、モデルにPre-releaseバッジが表示されます。
Banner on the model page indicating that the model is in pre-release, with a Preview the page button

リリース時に購読者に通知

リリースの準備が整ったら:

  1. モデルファイルをリポジトリにプッシュします。
  2. モデルを公開します。これによりモデルがリリースされ、プレリリースページは通常のモデルページになります。release_dateフィールドを削除する必要はありません。
  3. 書き込みアクセスを持つリポジトリメンバーには、「N人のユーザーがこのリリースの通知を待っています」というバナーが表示され、リリース通知を送信ボタンが配置されます。
  4. Send release notifications をクリックすると、Hugging Face でモデルが利用可能になったことを各購読者にメールで通知します。
Banner on the model page showing the number of users waiting to be notified, with a Send release notifications button

モデルが公開になった時点で通知が自動的に送信されるわけではありません。送信するタイミングはご自身で選択します。以下の点にご注意ください:

  • Subscribersとは、モデルがプレリリース中に「いいね」を押したユーザーを指します。そのため、バナーに表示される数値は、いいねの総数よりも少なくなることがあります。
  • 各購読者には最大1回のみメールが送信され、通知が送信されるとバナーは非表示になります。
  • 通知は、各ユーザーの通知設定(「購読中のリリースが利用可能になりました」)を尊重します。

留意すべき点

  • ページは日付を過ぎても表示され続けます:リリース日を迎えても、プレリリースページは自動的に削除されません。モデルを公開してリリースし、通常のモデルページに戻してください。
  • モデルを公開にすることがリリースです。リリース通知は、モデルが公開された後にのみ送信できます。
  • モデルがまだプライベートな状態でrelease_dateを削除すると、プレリリースページが削除され、他のプライベートモデルと同様に、訪問者は404ページが表示されるようになります。
  • release_dateが設定されている間に、モデルを再度プライベートにすると、プレリリースページが再度有効になります。
Update on GitHub