Wyszukiwanie w witrynie

Jak połączyć GitHub z Hugging Face

Automatyzacja połączenia między GitHub a Hugging Face zmienia sposób, w jaki tworzysz, wersjonujesz i wdrażasz projekty AI. Zamiast ręcznie przesyłać pliki, pipeline CI/CD utrzymuje Twoje Hugging Face Spaces lub modele zawsze w synchronizacji z repozytorium GitHub. W tym artykule zobaczymy, jak połączyć GitHub z Hugging Face.

Jak połączyć GitHub z Hugging Face

Przed rozpoczęciem upewnij się, że masz następujące rzeczy.

  • Konto GitHub i konto Hugging Face.
  • Git jest zainstalowany na twoim lokalnym komputerze.
  • (Opcjonalnie) Repozytorium GitHub do przechowywania kodu Twojego projektu oraz Hugging Face Space do hostowania Twojej aplikacji. Nie martw się, jeśli jeszcze ich nie masz; poniższe kroki Cię poprowadzą.

Aby połączyć GitHub z HuggingFace, postępuj zgodnie z poniższymi krokami.

  1. Wygeneruj token dostępu Hugging Face
  2. Przechowaj token jako sekret GitHub
  3. Utwórz plik przepływu pracy GitHub Actions
  4. Skonfiguruj swoją przestrzeń Hugging Face
  5. Zacommituj, Wypchnij i Patrz jak działa

Porozmawiajmy o nich szczegółowo.

1. Wygeneruj token dostępu do Hugging Face

Przekształcimy Twój repozytorium GitHub w jedyne źródło prawdy i zautomatyzujemy wdrożenia. Do tego pierwszą rzeczą, której potrzebujemy, jest token dostępu z Hugging Face. Aby go pobrać, postępuj zgodnie z poniższymi krokami.

  1. Zaloguj się na swoje konto Hugging Face.
  2. Kliknij na swój profil, a następnie wybierz Ustawienia.
  3. Z lewego paska bocznego kliknij Tokeny dostępu i wybierz Utwórz nowy token.
  4. Wybierz nazwę i zaznacz write jako typ tokenu, aby udzielić GitHubowi uprawnienia do wprowadzania aktualizacji.
  5. Kliknij Utwórz token, skopiuj go i zapisz w jakimś miejscu.

Upewnij się, że zapiszesz to w bezpiecznym miejscu, ponieważ możesz nie być w stanie odzyskać tego ponownie.

2. Przechowaj token jako sekret w GitHub

Teraz, gdy mamy token wygenerowany przez Hugging Face, przechowajmy go w swoim repozytorium Git. Aby to zrobić, wykonaj poniższe kroki.

  • Przejdź do swojego repozytorium GitHub i przejdź do Ustawienia > Sekrety i zmienne > Akcje.
  • Kliknij Nowy sekret repozytorium.
  • Nazwij sekret HF_TOKEN (ta dokładna nazwa jest kluczowa) i wklej swój token Hugging Face w pole wartości.
  • Kliknij Dodaj sekret.

Z Repository secrets zobaczysz naszą nowo utworzoną tajemnicę.

3. Utwórz plik przepływu pracy GitHub Actions

Musimy utworzyć plik YAML, który definiuje Twój pipeline CI/CD.

W swoim repozytorium GitHub utwórz następującą ścieżkę katalogu: .github/workflows/. Wewnątrz folderu workflows utwórz plik o nazwie deploy.yml.

W tym celu musisz kliknąć tworzenie nowego pliku hiperłącze. Następnie w polu Nazwa twojego pliku wpisz .github/workflows/deploy.yml.

Wklej następujące linie kodu.

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:[email /spaces/HF_USERNAME/SPACE_NAME main

Nie zapomnij zastąpić HF_USERNAME swoją nazwą użytkownika Hugging Face oraz SPACE_NAME nazwą swojej Przestrzeni.

4. Skonfiguruj swoją przestrzeń Hugging Face

Jeśli zaczynasz od nowa, utwórz przestrzeń Hugging Face, w której będzie znajdować się twoja aplikacja. Musisz postępować zgodnie z poniższymi krokami.

  • Zaloguj się do Hugging Face i kliknij na swój awatar > Nowa przestrzeń.
  • Nadaj swojej Przestrzeni nazwę, wybierz SDK (takie jak Gradio lub Streamlit) i ustaw Przestrzeń jako Publiczną.
  • Kliknij Utwórz przestrzeń.

Możesz zostawić domyślne pliki tak, jak są; Twój GitHub Action je nadpisze.

5. Zatwierdź, Wypchnij i Obserwuj jak Działa

Teraz zatwierdź plik .github/workflows/deploy.yml do swojego repozytorium GitHub. Wypchnij zatwierdzenie do gałęzi main. Przejdź do zakładki Actions w swoim repozytorium GitHub. Zobaczysz działający workflow Sync to Hugging Face hub. Jeśli zakończy się powodzeniem, Twój kod jest teraz dostępny na Twoim Hugging Face Space!

Miejmy nadzieję, że z pomocą tego przewodnika będziesz w stanie zintegrować lub połączyć swoje repozytorium GitHub z Hugging Face.

Czy Hugging Face korzysta z GitHub?

Tak, Hugging Face ściśle integruje się z GitHub, choć jest to osobna platforma. Hugging Face udostępnia repozytoria oparte na Git dla modeli, zbiorów danych i przestrzeni (Spaces), co oznacza, że można klonować, wysyłać i pobierać przy użyciu standardowych poleceń Git, tak jak na GitHub. Pozwala to programistom kontrolować wersje swoich zasobów AI, automatyzować wdrożenia za pomocą GitHub Actions oraz płynnie synchronizować kod między obiema platformami. Wiele Spaces i repozytoriów modeli Hugging Face jest bezpośrednio powiązanych z repozytoriami GitHub w celu ciągłej integracji i łatwiejszej współpracy.

Jak wypchnąć kod do Hugging Face?

Możesz wysyłać kod do Hugging Face Space lub repozytorium modelu, używając standardowych poleceń Git po sklonowaniu URL repozytorium z Hugging Face (np. https://huggingface.co/spaces/your-username/your-space-name). Najpierw uwierzytelnij się za pomocą tokenu dostępu Hugging Face (używając git remote set-url z wbudowanym tokenem lub huggingface-cli login). Następnie dodaj, zatwierdź i wypchnij swoje zmiany: git add ., git commit -m “wiadomość” i git push origin main. W celu automatyzacji możesz także skonfigurować workflow GitHub Actions, który wypycha zmiany do Hugging Face przy każdym pushu na GitHub, używając sekretu HF_TOKEN przechowywanego w Twoim repozytorium GitHub.

Powiązane artykuły