Het automatiseren van de verbinding tussen GitHub en Hugging Face transformeert de manier waarop u AI-projecten bouwt, maakt en implementeert. In plaats van handmatig bestanden te uploaden, zorgt een CI/CD-pijplijn ervoor dat uw Hugging Face Spaces of modellen altijd gesynchroniseerd blijven met uw GitHub-repository. In dit artikel zullen we u begeleiden bij het verbinden van GitHub met Hugging Face.
Hoe GitHub te verbinden met Hugging Face
Zorg ervoor dat u over de volgende zaken beschikt voordat u begint:
- Een GitHub-account en een Hugging Face-account.
- Git wordt op uw lokale computer geïnstalleerd.
- (Optioneel) Een GitHub-opslagplaats om de code van uw project te hosten en een Hugging Face Space om uw app te hosten. Maak je geen zorgen als je deze dingen nog niet hebt; de onderstaande stappen zullen u begeleiden.
Volg de onderstaande stappen om GitHub met HuggingFace te verbinden:
- Genereer een knuffelgezichtstoegangstoken
- Bewaar het token als een GitHub-geheim
- Maak het GitHub Actions Workflow-bestand
- Stel uw knuffelgezichtsruimte in
- Commit, push en zie hoe het werkt.
1. Genereer een knuffelgezichtstoegangstoken
We zullen van uw GitHub-repository de enige bron van waarheid maken en implementaties automatiseren. Om dit te doen, hebben we eerst een toegangstoken van Hugging Face nodig. Voer deze stappen uit om dat token op te halen:
- Log in op uw Hugging Face-account.
- Klik op uw profiel en selecteer vervolgens Instellingen.
- Klik in de linkerzijbalk op Toegangstokens en selecteer Nieuw token maken.
- Kies een naam en selecteer ‘schrijven’ als het tokentype om GitHub toestemming te geven om updates te pushen.
- Klik op Token maken, kopieer het token en sla het ergens op.
Zorg ervoor dat u het token op een veilige plek bewaart, omdat u het mogelijk niet meer kunt ophalen.
2. Bewaar het token als een GitHub-geheim
Nu we een token hebben gegenereerd vanuit Hugging Face, kunnen we deze in uw Git-repository opslaan. Om dit te doen, volgt u de onderstaande stappen:
- Ga naar je GitHub-repository en ga naar Instellingen > Geheimen en variabelen > Acties.
- Klik op Nieuw repositorygeheim.
- Noem het geheime HF_TOKEN (deze exacte naam is cruciaal) en plak uw Knuffelgezicht-token in het waardeveld.
- Klik op Geheim toevoegen.
Vanuit Repository-geheimen ziet u het nieuw gemaakte geheim.
3. Maak het GitHub Actions Workflow-bestand
We moeten het YAML-bestand maken dat uw CI/CD-pijplijn definieert.
Maak in uw GitHub-repository het volgende mappad: .github/workflows/. Maak in de map Workflows een bestand met de naam Deploy.yml.
Om dit te doen, klikt u op de hyperlink Een nieuw bestand aanmaken. Typ vervolgens in het veld Geef uw bestand een naam: .github/workflows/deploy.yml.
Plak de volgende regels code:
name: Sync to Hugging Face hub
on:
push:
branches: [main] # Triggers the workflow on pushes to the main branch.
workflow_dispatch: # Allows you to manually trigger the workflow from the Actions tab.
jobs:
sync-to-hub:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v3
with:
fetch-depth: 0 # Fetches all history for all branches and tags.
lfs: true # Checks out any Git LFS files.
- name: Push to Hugging Face Hub
env:
HF_TOKEN: ${{ secrets.HF_TOKEN }}
run: git push https://HF_USERNAME:$HF_TOKEN@huggingface.co/spaces/HF_USERNAME/SPACE_NAME main
Vergeet niet HF_USERNAME te vervangen door uw Knuffelgezicht-gebruikersnaam en SPACE_NAME te vervangen door de naam van uw ruimte.
4. Stel uw knuffelgezichtsruimte in
Als u nieuw begint, maakt u de Hugging Face Space waar uw app live gaat. U moet de onderstaande stappen volgen:
- Log in op Hugging Face en klik op je profielfoto > Nieuwe ruimte.
- Geef uw Space een naam, selecteer een SDK (zoals Gradio of Streamlit) en stel de Space in op Openbaar.
- Klik op Ruimte creëren.
U kunt de standaardbestanden laten zoals ze zijn; je GitHub-actie zal ze overschrijven.
5. Commit, push en kijk hoe het werkt
Leg nu het bestand .github/workflows/deploy.yml vast in uw GitHub-repository. Push de commit naar de hoofdvertakking. Ga naar het tabblad Acties in uw GitHub-repository. U zult zien dat uw Sync to Hugging Face-hubworkflow wordt uitgevoerd. Als het lukt, staat je code nu live op je Hugging Face Space!
Gebruikt Hugging Face GitHub?
Ja, Hugging Face integreert nauw met GitHub, ook al is het een apart platform. Hugging Face biedt op Git gebaseerde repository’s voor modellen, datasets en Spaces, wat betekent dat je kunt klonen, pushen en pullen met behulp van standaard Git-commando’s, net zoals je zou doen met GitHub. Met deze mogelijkheid kunnen ontwikkelaars hun AI-middelen versiebeheer geven, implementaties automatiseren via GitHub Actions en code naadloos tussen de twee platforms synchroniseren. Veel Hugging Face Spaces en modelrepository’s zijn rechtstreeks gekoppeld aan GitHub-repository’s voor continue integratie en eenvoudigere samenwerking.
Hoe push ik code naar Hugging Face?
Je kunt code naar een Hugging Face Space of modelrepository pushen met behulp van standaard Git-opdrachten na het klonen van de repository-URL van Hugging Face (bijvoorbeeld https://huggingface.co/spaces/uw-gebruikersnaam/uw-ruimte-naam). Authenticeer eerst met een Hugging Face-toegangstoken (met behulp van git remote set-url met het token ingebed of Huggingface-cli login). Voeg vervolgens je wijzigingen toe, commit ze en push ze: git add ., git commit -m “message”, en git push origin main. Voor automatisering kun je ook een GitHub Actions-workflow instellen die bij elke GitHub-push naar Hugging Face pusht, met behulp van een HF_TOKEN-geheim dat is opgeslagen in je GitHub-repository.
Hopelijk kun je met deze handleiding je GitHub-repository integreren of verbinden met Hugging Face.