Comment connecter GitHub à Hugging Face

Automatisez la synchronisation entre GitHub et Hugging Face pour déployer vos projets d'IA facilement. Découvrez comment établir cette connexion étape par étape dans cet article.

Automatiser la connexion entre GitHub et Hugging Face transforme la façon dont vous construisez, versionnez et déployez des projets d'IA. Au lieu de télécharger manuellement des fichiers, un pipeline CI/CD maintient vos Hugging Face Spaces ou modèles toujours synchronisés avec votre dépôt GitHub. Dans cet article, nous allons voir comment connecter GitHub à Hugging Face.

Comment connecter GitHub à Hugging Face

Avant de commencer, assurez-vous d'avoir ce qui suit.

• Un compte GitHub et un compte Hugging Face.
• Git installé sur votre machine locale.
• (Optionnel) Un dépôt GitHub pour héberger le code de votre projet et un Hugging Face Space pour héberger votre application. Ne vous inquiétez pas si vous ne les avez pas encore ; les étapes ci-dessous vous guideront.

Pour connecter GitHub à Hugging Face, suivez les étapes ci-dessous.

1. Générez un jeton d'accès Hugging Face
2. Stockez le jeton en tant que secret GitHub
3. Créez le fichier de flux de travail GitHub Actions
4. Configurez votre Hugging Face Space
5. Faites un commit, poussez et regardez-le fonctionner

Discutons de ces points en détail.

Générer un jeton d'accès Hugging Face

Nous allons transformer votre dépôt GitHub en source unique de vérité et automatiser les déploiements. Pour cela, la première chose dont nous avons besoin est un jeton d'accès de Hugging Face. Pour l'obtenir, suivez les étapes ci-dessous.

1. Connectez-vous à votre compte Hugging Face.
2. Cliquez sur votre profil, puis sélectionnez Paramètres.
3. Dans la barre latérale gauche, cliquez sur Jetons d'accès et sélectionnez Créer un nouveau jeton.
4. Choisissez un nom et sélectionnez écrire comme type de jeton pour accorder à GitHub la permission de pousser des mises à jour.
5. Cliquez sur Créer un jeton, copiez-le et sauvegardez-le quelque part.

Assurez-vous de le sauvegarder dans un endroit sûr, car vous risquez de ne pas pouvoir le récupérer à nouveau.

Stocker le jeton en tant que secret GitHub

Maintenant que nous avons un jeton généré depuis Hugging Face, stockons-le dans votre dépôt Git. Pour ce faire, suivez les étapes ci-dessous.

• Allez dans votre dépôt GitHub et naviguez vers Paramètres > Secrets et variables > Actions.
• Cliquez sur Nouveau secret de dépôt.
• Nommez le secret HF_TOKEN (ce nom exact est crucial) et collez votre jeton Hugging Face dans le champ valeur.
• Cliquez sur Ajouter un secret.

Dans les secrets de dépôt, vous verrez notre nouveau secret créé.

Créer le fichier de flux de travail GitHub Actions

Nous devons créer le fichier YAML qui définit votre pipeline CI/CD.

Dans votre dépôt GitHub, créez le chemin de répertoire suivant : .github/workflows/. À l'intérieur du dossier workflows, créez un fichier nommé deploy.yml.

Pour ce faire, vous devez cliquer sur le lien pour créer un nouveau fichier. Ensuite, dans le champ Nom de votre fichier, tapez .github/workflows/deploy.yml.

Collez les lignes de code suivantes.

name: Sync to Hugging Face hub on: push: branches: [main] # Déclenche le flux de travail lors des poussées vers la branche principale. workflow_dispatch: # Vous permet de déclencher manuellement le flux de travail depuis l'onglet Actions. jobs: sync-to-hub: runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v3 with: fetch-depth: 0 # Récupère tout l'historique pour toutes les branches et tags. lfs: true # Vérifie les fichiers Git LFS. - name: Push to Hugging Face Hub env: HF_TOKEN: ${{ secrets.HF_TOKEN }} run: git push https://HF_USERNAME:[email protected]/spaces/HF_USERNAME/SPACE_NAME main

N'oubliez pas de remplacer HF_USERNAME par votre nom d'utilisateur Hugging Face et SPACE_NAME par le nom de votre Space.

Configurer votre Hugging Face Space

Si vous partez de zéro, créez le Hugging Face Space où votre application résidera. Vous devez suivre les étapes ci-dessous.

• Connectez-vous à Hugging Face et cliquez sur votre photo de profil > Nouveau Space.
• Donnez un nom à votre Space, choisissez un SDK (comme Gradio ou Streamlit), et définissez le Space comme Public.
• Cliquez sur Créer Space.

Vous pouvez laisser les fichiers par défaut tels quels ; votre action GitHub les écrasera.

Faire un commit, pousser et regarder fonctionner

Maintenant, faites un commit du fichier .github/workflows/deploy.yml dans votre dépôt GitHub. Poussez le commit vers la branche principale. Allez dans l'onglet Actions de votre dépôt GitHub. Vous verrez votre flux de travail Sync to Hugging Face hub en cours d'exécution. S'il réussit, votre code est maintenant en ligne sur votre Hugging Face Space !

Espérons que, grâce à ce guide, vous serez en mesure d'intégrer ou de connecter votre référentiel GitHub à Hugging Face.

Est-ce que Hugging Face utilise GitHub ?

Oui, Hugging Face s'intègre étroitement avec GitHub, bien qu'il s'agisse d'une plateforme distincte. Hugging Face fournit des référentiels basés sur Git pour les modèles, les ensembles de données et les Espaces, ce qui signifie que vous pouvez cloner, pousser et tirer en utilisant des commandes Git standards, tout comme vous le feriez avec GitHub. Cela permet aux développeurs de contrôler la version de leurs actifs d'IA, d'automatiser les déploiements via les actions GitHub et de synchroniser le code entre les deux plateformes sans interruption. De nombreux Espaces et référentiels de modèles de Hugging Face sont directement liés à des référentiels GitHub pour une intégration continue et une collaboration facilitée.

Comment puis-je pousser du code vers Hugging Face ?

Vous pouvez pousser du code vers un Espace Hugging Face ou un référentiel de modèle en utilisant des commandes Git standard après avoir cloné l'URL du référentiel depuis Hugging Face (par exemple, https://huggingface.co/spaces/votre-nom-utilisateur/votre-nom-espace). Tout d'abord, authentifiez-vous avec un jeton d'accès Hugging Face (en utilisant git remote set-url avec le jeton intégré ou huggingface-cli login). Ensuite, ajoutez, validez et poussez vos changements : git add ., git commit -m “message”, et git push origin main. Pour l'automatisation, vous pouvez également configurer un workflow d'actions GitHub qui pousse vers Hugging Face à chaque push sur GitHub, en utilisant un secret HF_TOKEN stocké dans votre référentiel GitHub.

Maintenant que tu as fini de lire Comment connecter GitHub à Hugging Face, nous t'invitons à explorer davantage la catégorie Tutoriels. Tu y trouveras d'autres articles intéressants qui élargiront tes connaissances et te tiendront informé. Ne cesse pas de lire et de découvrir plus!