Automatiser la connexion entre GitHub et Hugging Face transforme la manière 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 toujours vos espaces ou modèles Hugging Face synchronisés avec votre dépôt GitHub. Dans cet article, nous vous guiderons pour connecter GitHub à Hugging Face.
Comment connecter GitHub à Hugging Face
Avant de commencer, assurez-vous d’avoir les éléments suivants :
- Un compte GitHub et un compte Hugging Face.
- Git est installé sur votre machine locale.
- (Optionnel) Un dépôt GitHub pour héberger le code de votre projet et un espace Hugging Face pour héberger votre application. Ne vous inquiétez pas si vous n’avez pas encore ces éléments ; les étapes ci-dessous vous guideront.
Pour connecter GitHub à Hugging Face, suivez les étapes ci-dessous :
- Générez un token d’accès Hugging Face.
- Stockez le token en tant que secret GitHub.
- Créez le fichier de workflow GitHub Actions.
- Configurez votre espace Hugging Face.
- Commitez, poussez et regardez-le fonctionner.
1. Générez un token d’accès Hugging Face
Nous allons transformer votre dépôt GitHub en la source unique de vérité et automatiser les déploiements. Pour cela, la première chose dont nous avons besoin est un token d’accès de Hugging Face. Pour obtenir ce token, suivez ces étapes :
- Connectez-vous à votre compte Hugging Face.
- Cliquez sur votre profil et sélectionnez ensuite Paramètres.
- Dans la barre latérale gauche, cliquez sur Tokens d’accès et sélectionnez Créer un nouveau token.
- Choisissez un nom et sélectionnez “write” comme type de token pour accorder à GitHub l’autorisation de pousser des mises à jour.
- Cliquez sur Créer le token, copiez le token et enregistrez-le quelque part.
Assurez-vous de sauvegarder le token dans un endroit sûr, car vous pourriez ne pas être en mesure de le récupérer à nouveau.
2. Stockez le token en tant que secret GitHub
Maintenant que nous avons un token généré par Hugging Face, stockons-le dans votre dépôt Git. Pour cela, suivez les étapes ci-dessous :
- Allez dans votre dépôt GitHub et accédez à 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 token Hugging Face dans le champ de valeur.
- Cliquez sur Ajouter le secret.
Dans Secrets de dépôt, vous verrez le nouveau secret créé.
3. Créez le fichier de workflow 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, cliquez sur le lien hypertexte Créer un nouveau fichier. Ensuite, dans le champ Nommez votre fichier, tapez : .github/workflows/deploy.yml.
Collez les lignes de code suivantes :
name: Synchroniser avec le hub Hugging Face
on:
push:
branches: [main] # Déclenche le workflow lors des poussées vers la branche principale.
workflow_dispatch: # Permet de déclencher manuellement le workflow depuis l'onglet Actions.
jobs:
sync-to-hub:
runs-on: ubuntu-latest
steps:
- name: Vérifier le dépôt
uses: actions/checkout@v3
with:
fetch-depth: 0 # Récupère tout l'historique pour toutes les branches et tags.
lfs: true # Vérifie tous les fichiers Git LFS.
- name: Pousser vers le hub Hugging Face
env:
HF_TOKEN: ${{ secrets.HF_TOKEN }}
run: git push https://HF_USERNAME:$HF_TOKEN@huggingface.co/spaces/HF_USERNAME/SPACE_NAME main
N’oubliez pas de remplacer HF_USERNAME par votre nom d’utilisateur Hugging Face et de remplacer SPACE_NAME par le nom de votre espace.
4. Configurez votre espace Hugging Face
Si vous partez de zéro, créez l’espace Hugging Face où votre application sera mise en ligne. Vous devez suivre les étapes ci-dessous :
- Connectez-vous à Hugging Face et cliquez sur votre photo de profil > Nouvel espace.
- Donnez un nom à votre espace, choisissez un SDK (comme Gradio ou Streamlit) et définissez l’espace comme Public.
- Cliquez sur Créer un espace.
Vous pouvez laisser les fichiers par défaut tels quels ; votre action GitHub les écrasera.
5. Commitez, poussez et regardez-le fonctionner
Maintenant, commitez le 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 workflow Synchroniser avec le hub Hugging Face s’exécuter. S’il réussit, votre code est maintenant en ligne sur votre espace Hugging Face !
Hugging Face utilise-t-il GitHub ?
Oui, Hugging Face s’intègre étroitement avec GitHub, bien qu’il s’agisse d’une plateforme distincte. Hugging Face fournit des dépôts 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 à l’aide de commandes Git standard, tout comme vous le feriez sur GitHub. Cette capacité permet aux développeurs de contrôler les versions de leurs actifs d’IA, d’automatiser les déploiements via GitHub Actions et de synchroniser le code entre les deux plateformes sans soudure. De nombreux espaces Hugging Face et dépôts de modèles sont directement liés à des dépôts GitHub pour une intégration continue et une collaboration plus facile.
Comment puis-je pousser du code sur Hugging Face ?
Vous pouvez pousser du code vers un espace Hugging Face ou un dépôt de modèle en utilisant des commandes Git standard après avoir cloné l’URL du dépôt depuis Hugging Face (par exemple, https://huggingface.co/spaces/votre-nom-utilisateur/votre-nom-d-espace). Tout d’abord, authentifiez-vous avec un token d’accès Hugging Face (en utilisant git remote set-url avec le token intégré ou huggingface-cli login). Ensuite, ajoutez, commitez et poussez vos modifications : git add ., git commit -m “message”, et git push origin main. Pour l’automatisation, vous pouvez également configurer un workflow GitHub Actions qui pousse vers Hugging Face à chaque poussée sur GitHub, en utilisant un secret HF_TOKEN stocké dans votre dépôt GitHub.
Espérons qu’avec ce guide, vous pourrez intégrer ou connecter votre dépôt GitHub à Hugging Face.
