Como adicionar um Space ao ArXiv

Demos no Hugging Face Spaces permitem que um público amplo experimente pesquisas de aprendizado de máquina de ponta sem escrever nenhum código. Hugging Face e ArXiv colaboraram para incorporar esses demos diretamente ao lado dos artigos no ArXiv!

Graças a essa integração, os usuários agora podem encontrar as demonstrações mais populares de um artigo na página de resumo do arXiv. Por exemplo, se você quiser testar as demonstrações do modelo de classificação de documentos LayoutLM, pode acessar a página do artigo do LayoutLM no arXiv e navegar para a aba de demonstração. Você verá demonstrações de código aberto criadas pela comunidade de machine learning para este modelo, que podem ser testadas imediatamente no seu navegador:

Vamos abordar duas maneiras diferentes de adicionar seu Space ao ArXiv e fazê-lo aparecer na aba Demos.

Pré-requisitos

• Existe um paper existente no ArXiv para o qual você gostaria de criar uma demonstração
• Você construiu (ou pode construir) uma demonstração para o modelo em Spaces

Método 1 (Recomendado): Vinculando a partir do README do Space

A maneira mais simples de adicionar um Space a um artigo do ArXiv é incluir o link para o artigo no arquivo README do Space (README.md). É uma boa prática incluir também uma citação completa. Você pode ver um exemplo de um link e uma citação neste README do Space de Segmentação de Ecocardiograma.

E é isso! Seu Space deve aparecer na aba Demo ao lado do paper no ArXiv em alguns minutos 🤗

Método 2: Vinculando um modelo relacionado

Uma abordagem alternativa pode ser usada para vincular Spaces a papers, vinculando um modelo intermediário ao Space. Isso exige que o paper esteja associado a um modelo que esteja no Hugging Face Hub (ou que possa ser enviado para lá).

1. Primeiro, faça o upload do modelo associado ao artigo do ArXiv no Hugging Face Hub, caso ele ainda não esteja lá. (As instruções detalhadas estão aqui)

2. Ao escrever o model card (README.md) do modelo, inclua um link para o paper no ArXiv. É uma boa prática incluir também uma citação completa. Você pode ver um exemplo de link e citação no model card do LayoutLM

   Nota: você pode verificar se essa etapa foi realizada com sucesso observando se um botão do ArXiv aparece acima do cartão do modelo. No caso do LayoutLM, o botão diz: “arxiv:1912.13318” e faz link para o paper do LayoutLM no ArXiv.

   

3. Em seguida, crie uma demonstração no Spaces que carregue este modelo. Em algum lugar do código, o nome do modelo deve estar incluído para que o Hugging Face detecte que um Space está associado a ele.

   Por exemplo, o Space docformer_for_document_classification carrega o LayoutLM desta forma e inclui a string "microsoft/layoutlm-base-uncased":

   Copiado

   from transformers import LayoutLMForTokenClassification
   
   layoutlm_dummy = LayoutLMForTokenClassification.from_pretrained("microsoft/layoutlm-base-uncased", num_labels=1)

   Nota: Aqui está uma visão geral sobre a criação de demonstrações no Hugging Face Spaces e aqui estão instruções mais específicas para Gradio e Streamlit.

4. Assim que seu Space for construído, o Hugging Face detectará que ele está associado ao modelo. Um botão “Linked Models” deve aparecer no canto superior direito do Space, conforme mostrado aqui:

   

   Nota: Você também pode adicionar modelos vinculados manualmente, atualizando-os explicitamente no metadados do README do Space, conforme descrito aqui.

Seu Space deve aparecer na aba Demo ao lado do paper no ArXiv em alguns minutos 🤗

Update on GitHub