Hub documentation

Páginas de Modelos Pré-Lançamento

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Páginas de Modelos Pré-Lançamento

Este recurso está disponível para organizações com plano Enterprise ou superior — ou entre em contato conosco.

As páginas de modelos em pré-lançamento permitem que sua organização anuncie um modelo futuro enquanto ele ainda está privado. Em vez de uma página 404, os visitantes veem uma página de anúncio dedicada com uma contagem regressiva ao vivo até a data de lançamento e um botão Curtir e Notificar no lançamento, para que possam ser notificados por e-mail no momento em que seu modelo for lançado. Quando você torna o modelo público, ele é considerado lançado e a página de anúncio é substituída pelo cartão do modelo.

Eligibilidade

  • Sua organização deve estar assinante de um plano Enterprise ou superior.
  • O repositório do modelo deve estar localizado no namespace da organização (por exemplo, my-org/my-upcoming-model). Repositórios pertencentes a usuários não são elegíveis.
  • O repositório do modelo deve ser privado. Tornar o modelo público o libera (veja abaixo).

Anuncie seu modelo

Para transformar a página de um modelo privado em uma página de pré-lançamento, adicione um campo release_date aos metadados do cartão do modelo (a seção YAML no topo do README.md do repositório):

---
release_date: 2026-07-27
description: "A short tagline shown on the pre-release page"
---

O campo release_date aceita uma data em YAML ou um timestamp ISO 8601 entre aspas, se você quiser especificar um horário exato:

release_date: "2026-07-27T15:00:00Z"

Valores inválidos são rejeitados pelo validador de metadados e ignorados. A data não precisa estar no futuro: com uma data no passado, a página exibe “Muito em breve” em vez de uma contagem regressiva. As datas são exibidas em UTC.

Alguns campos de metadados opcionais permitem personalizar a página de pré-lançamento:

CampoEfeito
descriptionSlogan principal da página de pré-lançamento, também usado como a meta descrição da página.
pretty_nameNome legível por humanos exibido no lugar do nome do repositório no título principal.
approximate_etaDefina como true se release_date for apenas uma estimativa: a data será então marcada com um selo Current ETA.
thumbnailURL de uma imagem personalizada para compartilhamento em redes sociais, substituindo a gerada automaticamente.
---
release_date: 2026-07-27
approximate_eta: true
pretty_name: "My Upcoming Model"
description: "A short tagline shown on the pre-release page"
---

Algumas coisas mais para saber:

  • O corpo em markdown do seu model card (tudo abaixo dos metadados YAML) é o que os visitantes leem na página de pré-lançamento — use-o para descrever o que está por vir, mostrar teasers, linkar para um paper, etc.
  • Você não precisa enviar nenhum peso ainda: o repositório só precisa do README.md durante todo o período de anúncio. Envie os arquivos do modelo quando estiver pronto.
  • Após editar os metadados do cartão do modelo, a página de pré-lançamento pode levar alguns momentos para ser ativada ou desativada.

O que os visitantes veem

Enquanto o modelo for privado e release_date estiver definido (e sua organização for elegível), os visitantes verão a página de pré-lançamento em vez de uma página 404:

  • Um hero com o rótulo Upcoming release, o nome do modelo, sua tagline e uma contagem regressiva ao vivo até a data de lançamento. As cores do hero são derivadas do avatar da sua organização.
  • Um botão Curtir e notificar na liberação: ao clicar nele, o usuário curte o repositório e se inscreve para receber uma notificação por e-mail sobre a liberação. Os usuários precisam estar conectados, e remover a curtida do modelo cancela a inscrição.
  • O conteúdo do cartão do modelo.
  • Uma barra lateral mostrando o número de curtidas (como usuários aguardando o lançamento) com os mais recentes que curtiram, a data de lançamento prevista e os modelos mais recentes da sua organização.
  • Uma miniatura de compartilhamento social dedicada, usando as mesmas cores do hero.
Pre-release page of a model, with a countdown to the release date and a Like and Notify on release button

A página de pré-lançamento exibe o conteúdo do seu model card — tudo o que você escreve no corpo do README.md fica visível publicamente enquanto o anúncio estiver ativo, incluindo as imagens e vídeos referenciados. O restante do repositório permanece privado: arquivos, discussões e acesso à API continuam restritos aos membros, e o modelo não é listado publicamente.

Quando a contagem regressiva chega a zero, a página exibe “Chegando muito em breve” — a página de pré-lançamento permanece no ar até que você torne o modelo público.

O que os membros veem

Todos os que têm acesso de leitura ao repositório continuam vendo a página regular do modelo, para que sua equipe possa continuar gerenciando arquivos e configurações enquanto o anúncio estiver ativo:

  • Um banner na página do modelo indica que o modelo está em pré-lançamento. Clique em Visualizar a página — ou adicione ?preview à URL do modelo — para verificar o que os visitantes veem.
  • Nas listagens de modelos, o modelo é exibido com o selo Pre-release.
Banner on the model page indicating that the model is in pre-release, with a Preview the page button

Notifique seus assinantes no lançamento

Quando estiver pronto para lançar:

  1. Envie os arquivos do modelo para o repositório.
  2. Torne o modelo público. Isso libera o modelo: a página de pré-lançamento se torna uma página de modelo regular — não é necessário remover o campo release_date.
  3. Membros do repositório com acesso de escrita verão um banner com a mensagem “N usuários estão aguardando para serem notificados sobre este lançamento”, com um botão Enviar notificações de lançamento.
  4. Clique em Send release notifications para enviar um e-mail a cada assinante informando que seu modelo já está disponível no Hugging Face.
Banner on the model page showing the number of users waiting to be notified, with a Send release notifications button

Notificações não são enviadas automaticamente quando o modelo se torna público: você escolhe quando enviá-las. Algumas coisas a saber:

  • Os assinantes são os usuários que curtiram o modelo enquanto ele estava em pré-lançamento, portanto, o número no banner pode ser menor que o total de curtidas.
  • Cada assinante recebe no máximo um e-mail, e o banner desaparece assim que as notificações forem enviadas.
  • As notificações respeitam as preferências de notificação de cada usuário (“Uma versão à qual você se inscreveu está disponível”).

Pontos a serem considerados

  • A página permanece ativa após a data: atingir a data de lançamento não remove automaticamente a página de pré-lançamento; torne o modelo público para lançá-lo e volte para a página regular do modelo.
  • Tornar o modelo público é o lançamento: as notificações de lançamento só podem ser enviadas após o modelo se tornar público.
  • Remover release_date enquanto o modelo ainda é privado remove a página de pré-lançamento: os visitantes recebem novamente uma página 404, como para qualquer modelo privado.
  • Tornar o modelo privado novamente (enquanto release_date ainda estiver definido) reativa a página de pré-lançamento.
Update on GitHub