Comment ajouter un Space à ArXiv

Les démos sur Hugging Face Spaces permettent à un large public d’essayer des recherches en apprentissage automatique de pointe sans écrire la moindre ligne de code. Hugging Face et ArXiv ont collaboré pour intégrer ces démos directement à côté des articles sur ArXiv !

Grâce à cette intégration, les utilisateurs peuvent désormais trouver les démos les plus populaires pour un article sur sa page de résumé arXiv. Par exemple, si vous souhaitez essayer les démos du modèle de classification de documents LayoutLM, vous pouvez accéder à la page arXiv de l’article LayoutLM et naviguer vers l’onglet démo. Vous y verrez des démos open source créées par la communauté du machine learning pour ce modèle, que vous pouvez tester immédiatement dans votre navigateur :

Nous allons présenter deux méthodes différentes pour ajouter votre Space à ArXiv et le faire apparaître dans l’onglet Demos.

Prérequis

• Il existe un article sur ArXiv pour lequel vous souhaitez créer une démonstration
• Vous avez construit (ou pouvez construire) une démo du modèle sur Spaces

Méthode 1 (recommandée) : Lier depuis le README de l’espace

La manière la plus simple d’ajouter un Space à un article ArXiv est d’inclure le lien vers l’article dans le fichier README du Space (README.md). Il est bon de pratiquer en incluant également une citation complète. Vous pouvez voir un exemple de lien et de citation dans ce README du Space Echocardiogram Segmentation.

Et c’est tout ! Votre Space devrait apparaître dans l’onglet Demo à côté de l’article sur ArXiv dans quelques minutes 🤗

Méthode 2 : Lier un modèle associé

Une approche alternative peut être utilisée pour lier des Spaces à des articles en liant un modèle intermédiaire au Space. Cela exige que l’article soit associé à un modèle présent sur le Hugging Face Hub (ou pouvant y être téléversé).

1. Tout d'abord, téléchargez le modèle associé à l'article ArXiv sur le Hugging Face Hub s'il n'y est pas déjà. (Les instructions détaillées se trouvent ici)

2. Lors de la rédaction de la carte du modèle (README.md), incluez un lien vers l’article ArXiv. Il est bon de fournir également une citation complète. Vous pouvez consulter un exemple de lien et de citation sur la carte du modèle LayoutLM

   Note : vous pouvez vérifier que cette étape a été réalisée avec succès en constatant l’apparition d’un bouton ArXiv au-dessus de la carte du modèle. Dans le cas de LayoutLM, le bouton indique « arxiv:1912.13318 » et renvoie vers l’article LayoutLM sur ArXiv.

   

3. Ensuite, créez une démo sur Spaces qui charge ce modèle. Quelque part dans le code, le nom du modèle doit être inclus afin que Hugging Face détecte qu'un Space est associé à ce modèle.

   Par exemple, le Space docformer_for_document_classification charge LayoutLM de cette manière et inclut la chaîne "microsoft/layoutlm-base-uncased" :

   Copié

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

   Note : voici un aperçu de la création de démos sur Hugging Face Spaces et des instructions plus spécifiques pour Gradio et Streamlit.

4. Dès que votre Space est construit, Hugging Face détecte qu’il est associé au modèle. Un bouton « Modèles liés » doit apparaître dans le coin supérieur droit du Space, comme indiqué ici :

   

   Note : Vous pouvez également ajouter des modèles liés manuellement en les mettant à jour explicitement dans les métadonnées du README de l'Espace, comme décrit ici.

Votre Space devrait apparaître dans l’onglet Demo à côté de l’article sur ArXiv dans quelques minutes 🤗

Update on GitHub