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). Репозитории, принадлежащие пользователям, не подходят.
  • Репозиторий модели должен быть закрытым. Если сделать модель публичной, она будет опубликована (см. ниже).

Анонс вашей модели

Чтобы превратить страницу приватной модели в страницу предварительного релиза, добавьте поле release_date в метаданные карточки модели (YAML-раздел в начале файла README.md репозитория):

---
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Человекочитаемое имя, отображаемое вместо имени репозитория в заголовке hero.
approximate_etaУстановите значение true, если release_date является лишь оценкой: в этом случае дата будет отмечена значком Current ETA.
thumbnailURL пользовательского изображения для социальных сетей, заменяющего сгенерированное.
---
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, названием модели, вашим слоганом и живым обратным отсчётом до даты релиза. Цвета героя выводятся из аватара вашей организации.
  • A Like and Notify on release button: clicking it likes the repo and subscribes the user to an email notification for the release. Users need to be logged in, and unliking the model unsubscribes.
  • Содержание карточки модели.
  • Боковая панель, отображающая количество лайков (от пользователей, ожидающих релиз) с указанием последних пользователей, поставивших лайк, ожидаемой даты релиза и последних моделей вашей организации.
  • Отдельное изображение для социальных сетей, использующее те же цвета, что и главный баннер.
Pre-release page of a model, with a countdown to the release date and a Like and Notify on release button

Страница предварительного релиза отображает содержимое карточки вашей модели — всё, что вы пишете в теле README.md, публично доступно, пока анонс активен, включая изображения и видео, на которые там есть ссылки. Остальная часть репозитория остаётся приватной: файлы, обсуждения и доступ к API по-прежнему доступны только участникам, а модель не отображается в публичном списке.

Когда обратный отсчёт дойдёт до нуля, на странице появится «Скоро» — предзагрузочная страница остаётся доступной, пока вы не сделаете модель публичной.

Что видят участники

Все, у кого есть доступ на чтение к репозиторию, продолжают видеть обычную страницу модели, поэтому ваша команда может продолжать управлять файлами и настройками, пока объявление активно:

  • Баннер на странице модели указывает на то, что модель находится в предварительном выпуске. Нажмите Просмотреть страницу — или добавьте ?preview к URL модели — чтобы проверить, что видят посетители.
  • В списках моделей модель отображается с бейджем 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 пользователей ожидают уведомления об этом релизе» и кнопку Send release notifications.
  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

Уведомления не отправляются автоматически, когда модель становится общедоступной: вы сами решаете, когда их отправить. Несколько важных моментов:

  • Подписчики — это пользователи, которые поставили «нравится» модели, пока она находилась в предвыпуске, поэтому число в баннере может быть меньше общего количества отметок «нравится».
  • Каждому подписчику отправляется не более одного электронного письма, а баннер исчезает после отправки уведомлений.
  • Уведомления учитывают настройки уведомлений каждого пользователя («Доступен релиз, на который вы подписаны»).

На что следует обратить внимание

  • Страница остаётся доступной после указанной даты: наступление даты релиза не приводит к автоматическому снятию страницы предварительного релиза; чтобы опубликовать модель, сделайте её общедоступной и вернитесь к обычной странице модели.
  • Публикация модели — это релиз: уведомления о релизе могут быть отправлены только после того, как модель станет публичной.
  • Удаление release_date, пока модель остаётся приватной, убирает страницу предварительного релиза: посетители снова получают страницу 404, как и для любой приватной модели.
  • Снова сделать модель приватной (пока release_date всё ещё задан) снова включает страницу предварительного релиза.
Update on GitHub