Att automatisera kopplingen mellan GitHub och Hugging Face förändrar hur du bygger, skapar versioner och distribuerar AI-projekt. Istället för att manuellt ladda upp filer, håller en CI/CD-pipeline dina Hugging Face Spaces eller modeller alltid synkroniserade med ditt GitHub-förråd. I den här artikeln kommer vi att guida dig för att ansluta GitHub till Hugging Face.
Hur man ansluter GitHub till Hugging Face
Innan du börjar, se till att du har följande saker:
- Ett GitHub-konto och ett Hugging Face-konto.
- Git är installerat på din lokala dator.
- (Valfritt) Ett GitHub-arkiv för att vara värd för ditt projekts kod och ett Hugging Face Space för att vara värd för din app. Oroa dig inte om du inte har dessa saker ännu; stegen nedan kommer att vägleda dig.
För att ansluta GitHub till HuggingFace, följ stegen nedan:
- Skapa en åtkomsttoken för kramas ansikte
- Lagra token som en GitHub-hemlighet
- Skapa GitHub Actions arbetsflödesfil
- Ställ in ditt Hugging Face Space
- Engagera, pusha och se hur det fungerar.
1. Skapa en åtkomsttoken för Hugging Face
Vi kommer att förvandla ditt GitHub-förråd till den enda källan till sanning och automatisera implementeringar. För att göra detta är det första vi behöver ett åtkomsttoken från Hugging Face. För att hämta den token, gör dessa steg:
- Logga in på ditt Hugging Face-konto.
- Klicka på din profil och välj sedan Inställningar.
- Från det vänstra sidofältet, klicka på Access Tokens och välj Skapa ny token.
- Välj ett namn och välj ”skriv” som tokentyp för att ge GitHub behörighet att skicka uppdateringar.
- Klicka på Skapa token, kopiera token och spara den någonstans.
Se till att spara token på ett säkert ställe, eftersom du kanske inte kan hämta den igen.
2. Lagra token som en GitHub-hemlighet
Nu när vi har en token genererad från Hugging Face, låt oss lagra den i ditt Git-förråd. För att göra detta, följ stegen nedan:
- Gå till ditt GitHub-förråd och gå till Inställningar > Hemligheter och variabler > Åtgärder.
- Klicka på Ny förvarshemlighet.
- Namnge den hemliga HF_TOKEN (det här exakta namnet är avgörande) och klistra in din Hugging Face-token i värdefältet.
- Klicka på Lägg till hemlighet.
Från Repository secrets kommer du att se den nyskapade hemligheten.
3. Skapa GitHub Actions Workflow File
Vi måste skapa YAML-filen som definierar din CI/CD-pipeline.
Skapa följande katalogsökväg i ditt GitHub-förråd: .github/workflows/. Skapa en fil med namnet deploy.yml i mappen för arbetsflöden.
För att göra detta måste du klicka på Skapa en ny fil hyperlänk. Skriv sedan: .github/workflows/deploy.yml i fältet Namnge din fil.
Klistra in följande kodrader:
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
Glöm inte att ersätta HF_USERNAME med ditt Hugging Face-användarnamn och ersätt SPACE_NAME med namnet på ditt Space.
4. Ställ in ditt Hugging Face Space
Om du börjar på nytt skapar du Hugging Face Space där din app kommer att visas. Du måste följa stegen nedan:
- Logga in på Hugging Face och klicka på din profilbild > Nytt utrymme.
- Ge ditt utrymme ett namn, välj ett SDK (som Gradio eller Streamlit) och ställ in utrymmet på Offentligt.
- Klicka på Skapa utrymme.
Du kan lämna standardfilerna som de är; din GitHub Action kommer att skriva över dem.
5. Begå, tryck och se hur det fungerar
Överför nu filen .github/workflows/deploy.yml till ditt GitHub-förråd. Skjut commit till huvudgrenen. Gå till fliken Åtgärder i ditt GitHub-förråd. Du kommer att se arbetsflödet för Sync to Hugging Face-hubben körs. Om det lyckas är din kod nu live på ditt Hugging Face Space!
Använder Hugging Face GitHub?
Ja, Hugging Face integreras nära med GitHub, även om det är en separat plattform. Hugging Face tillhandahåller Git-baserade arkiv för modeller, datauppsättningar och Spaces, vilket innebär att du kan klona, pusha och dra med hjälp av standard Git-kommandon precis som du skulle göra med GitHub. Denna förmåga tillåter utvecklare att versionskontrollera sina AI-tillgångar, automatisera distributioner via GitHub Actions och synkronisera kod mellan de två plattformarna sömlöst. Många Hugging Face Spaces och modellförråd är direkt länkade till GitHub-förråd för kontinuerlig integration och enklare samarbete.
Hur skickar jag kod till Hugging Face?
Du kan skjuta kod till ett Hugging Face Space eller modellförråd med hjälp av standard Git-kommandon efter att ha klonat arkivets URL från Hugging Face (t.ex. https://huggingface.co/spaces/your-username/your-space-name). Autentisera först med en Hugging Face-åtkomsttoken (med git remote set-url med token inbäddad eller huggingface-cli-inloggning). Lägg sedan till, commit och driv dina ändringar: git add ., git commit -m ”meddelande” och git push origin main. För automatisering kan du också ställa in ett GitHub Actions-arbetsflöde som skjuter till Hugging Face vid varje GitHub-push, med hjälp av en HF_TOKEN-hemlighet lagrad i ditt GitHub-förråd.
Förhoppningsvis kommer du med den här guiden att kunna integrera eller ansluta ditt GitHub-förråd till Hugging Face.