Skip to main content
Importez un modèle préentraîné depuis Hugging Face Hub dans une collection du registre. Le registre exécute chaque importation dans une sandbox. La sandbox récupère la révision sélectionnée du modèle, puis W&B journalise les fichiers importés sous forme d’artifact. W&B journalise l’artifact dans l’équipe et le projet que vous sélectionnez, puis lie la version de l’artifact à la collection spécifiée. L’équipe et le projet définissent l’emplacement de l’artifact dans W&B. Le registre et la collection déterminent l’endroit où le modèle apparaît dans le registre W&B.
Les importations de modèles consomment des ressources de calcul de sandbox et sont décomptées du quota de sandboxes de votre organisation. Elles ne nécessitent pas de sandboxes équipées de GPU.Le registre crée et arrête automatiquement la sandbox d’importation. Vous n’avez donc pas besoin de la configurer ni de la gérer.
Vous pouvez importer une révision Hugging Face précise en indiquant un commit, une branche ou un tag. Si vous n’indiquez aucune révision, le registre importe la branche par défaut du dépôt. L’importation d’une autre révision du même modèle dans la même collection crée une nouvelle version du modèle.

​
Autorisations

Pour importer un modèle depuis Hugging Face Hub, vous devez disposer des éléments suivants :

​
Limites et échecs d’importation

Les importations de modèles sont soumises à une limite de 90 Go, basée sur la capacité disque de la sandbox d’importation. Une importation peut échouer à différentes étapes :
  • Si votre organisation ne dispose pas d’un quota de sandbox suffisant, le registre ne peut pas créer la sandbox d’importation et l’importation échoue avant même le début du transfert du modèle.
  • Si votre organisation ne dispose pas d’un espace de stockage d’artifacts suffisant, l’importation peut échouer une fois le transfert du modèle commencé.
Vous ne pouvez pas annuler une importation une fois qu’elle a commencé. Pour déterminer si une importation a abouti ou a échoué, vérifiez son statut d’importation.

​
Importer un modèle

  1. Accédez à Registry.
  2. Sélectionnez Import model.
  3. Dans le champ Repository link, saisissez l’URL du modèle sur Hugging Face Hub ou l’ID du dépôt. Par exemple, pour importer bert-base-uncased, saisissez https://huggingface.co/google-bert/bert-base-uncased ou google-bert/bert-base-uncased.
  4. Facultatif : dans Version, indiquez le commit, la branche ou le tag à importer.
  5. Sélectionnez Next.
  6. Saisissez le nom de l’équipe et du projet dans lesquels vous souhaitez journaliser le modèle importé.
  7. Dans Registry, sélectionnez le registre de destination.
  8. Dans Collection, sélectionnez la collection de destination.
  9. Sélectionnez Next.
  10. Facultatif : ajoutez des alias pour mieux organiser le modèle importé et le retrouver plus facilement.
  11. Vérifiez les paramètres d’importation, puis sélectionnez Import.
Les modèles importés depuis Hugging Face Hub se voient attribuer le type de collection model.

​
Vérifier le statut d’une importation

Pour vérifier le statut d’une importation :
  1. Accédez à Registry.
  2. Sélectionnez le menu d’actions (), puis sélectionnez View import activity.
L’activité d’importation affiche l’un des statuts suivants :

​
Afficher un modèle importé

Une fois l’importation terminée, la version du modèle importé apparaît dans la collection de destination. Le registre lui ajoute un alias au format hf-<commit-hash>, où <commit-hash> correspond au hash de commit résolu dans le dépôt source. Pour afficher un modèle importé :
  1. Accédez au registre.
  2. Sélectionnez le registre de destination.
  3. Sélectionnez la collection de destination.
  4. Sélectionnez la version du modèle importé.
  5. Sélectionnez l’onglet Metadata.

​
Métadonnées d’un modèle importé

Outre les métadonnées standard disponibles pour les versions d’artifact liées, les versions de modèle importées comportent les champs suivants : Par exemple, supposons que vous importiez le modèle YOLOS small depuis Hugging Face Hub. Une fois l’importation terminée, ses métadonnées peuvent se présenter ainsi :
Métadonnées du modèle YOLOS small importé
Dans cet exemple :
  • repo_id vaut hustvl/yolos-small.
  • resolved_revision vaut 3d8f7130d3ce4907, le commit auquel main était résolu au moment de l’importation.
  • size_bytes vaut 245 569 443 octets, soit environ 245,6 Mo ou 234,2 Mio.
  • source vaut huggingface.
Dernière modification le 30 septembre 2026