So verbinden Sie GitHub mit Hugging Face

Die Automatisierung der Verbindung zwischen GitHub und Hugging Face verändert die Art und Weise, wie Sie KI-Projekte erstellen, Versionen erstellen und bereitstellen. Anstatt Dateien manuell hochzuladen, sorgt eine CI/CD-Pipeline dafür, dass Ihre Hugging Face Spaces oder Modelle immer mit Ihrem GitHub-Repository synchronisiert sind. In diesem Artikel zeigen wir Ihnen, wie Sie GitHub mit Hugging Face verbinden.

So verbinden Sie GitHub mit Hugging Face

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Ein GitHub-Konto und ein Hugging Face-Konto.
• Git ist auf Ihrem lokalen Computer installiert.
• (Optional) Ein GitHub-Repository zum Hosten des Codes Ihres Projekts und ein Hugging Face Space zum Hosten Ihrer App. Machen Sie sich keine Sorgen, wenn Sie diese Dinge noch nicht haben. Die folgenden Schritte werden Sie dabei unterstützen.

Um GitHub mit HuggingFace zu verbinden, führen Sie die folgenden Schritte aus:

1. Generieren Sie ein Hugging Face-Zugriffstoken
2. Speichern Sie das Token als GitHub-Geheimnis
3. Erstellen Sie die GitHub Actions-Workflow-Datei
4. Richten Sie Ihren Hugging Face Space ein
5. Commit, Push und zusehen, wie es funktioniert.

1. Generieren Sie ein Hugging Face-Zugriffstoken

Wir machen Ihr GitHub-Repository zur Single Source of Truth und automatisieren Bereitstellungen. Dazu benötigen wir zunächst einen Zugriffstoken von Hugging Face. Führen Sie die folgenden Schritte aus, um dieses Token abzurufen:

1. Melden Sie sich bei Ihrem Hugging Face-Konto an.
2. Klicken Sie auf Ihr Profil und wählen Sie dann Einstellungen.
3. Klicken Sie in der linken Seitenleiste auf Zugriffstoken und wählen Sie Neues Token erstellen.
4. Wählen Sie einen Namen und „Schreiben“ als Token-Typ, um GitHub die Berechtigung zum Pushen von Updates zu erteilen.
5. Klicken Sie auf Token erstellen, kopieren Sie das Token und speichern Sie es irgendwo.

Stellen Sie sicher, dass Sie das Token an einem sicheren Ort aufbewahren, da Sie es möglicherweise nicht erneut abrufen können.

2. Speichern Sie das Token als GitHub-Geheimnis

Nachdem wir nun ein Token von Hugging Face generiert haben, speichern wir es in Ihrem Git-Repository. Befolgen Sie dazu die folgenden Schritte:

• Gehen Sie zu Ihrem GitHub-Repository und gehen Sie zu Einstellungen > Geheimnisse und Variablen > Aktionen.
• Klicken Sie auf Neues Repository-Geheimnis.
• Benennen Sie das Geheimnis HF_TOKEN (dieser genaue Name ist entscheidend) und fügen Sie Ihren Hugging Face-Token in das Wertfeld ein.
• Klicken Sie auf Geheimnis hinzufügen.

Unter Repository-Geheimnisse sehen Sie das neu erstellte Geheimnis.

3. Erstellen Sie die GitHub Actions-Workflow-Datei

Wir müssen die YAML-Datei erstellen, die Ihre CI/CD-Pipeline definiert.

Erstellen Sie in Ihrem GitHub-Repository den folgenden Verzeichnispfad: .github/workflows/. Erstellen Sie im Ordner „Workflows“ eine Datei mit dem Namen „deploy.yml“.

Dazu müssen Sie auf den Hyperlink „Neue Datei erstellen“ klicken. Geben Sie dann im Feld „Name Ihrer Datei“ Folgendes ein: .github/workflows/deploy.yml.

Fügen Sie die folgenden Codezeilen ein:

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

Vergessen Sie nicht, HF_USERNAME durch Ihren Hugging Face-Benutzernamen und SPACE_NAME durch den Namen Ihres Space zu ersetzen.

4. Richten Sie Ihren Hugging Face Space ein

Wenn Sie neu anfangen, erstellen Sie den Hugging Face Space, in dem Ihre App live geschaltet wird. Sie müssen die folgenden Schritte ausführen:

• Melden Sie sich bei Hugging Face an und klicken Sie auf Ihr Profilbild > Neuer Raum.
• Geben Sie Ihrem Space einen Namen, wählen Sie ein SDK (wie Gradio oder Streamlit) aus und stellen Sie den Space auf „Öffentlich“ ein.
• Klicken Sie auf „Bereich erstellen“.

Sie können die Standarddateien unverändert lassen; Ihre GitHub-Aktion wird sie überschreiben.

5. Commit, Push und zusehen, wie es funktioniert

Übertragen Sie nun die Datei .github/workflows/deploy.yml in Ihr GitHub-Repository. Schieben Sie den Commit in den Hauptzweig. Gehen Sie in Ihrem GitHub-Repository zur Registerkarte „Aktionen“. Ihr Hub-Workflow „Mit Hugging Face synchronisieren“ wird ausgeführt. Wenn dies gelingt, ist Ihr Code jetzt auf Ihrem Hugging Face Space verfügbar!

Verwendet Hugging Face GitHub?

Ja, Hugging Face lässt sich eng in GitHub integrieren, obwohl es sich um eine separate Plattform handelt. Hugging Face bietet Git-basierte Repositorys für Modelle, Datensätze und Spaces, was bedeutet, dass Sie mit Standard-Git-Befehlen klonen, pushen und ziehen können, genau wie Sie es mit GitHub tun würden. Diese Funktion ermöglicht Entwicklern die Versionskontrolle ihrer KI-Assets, die Automatisierung von Bereitstellungen über GitHub-Aktionen und die nahtlose Synchronisierung von Code zwischen den beiden Plattformen. Viele Hugging Face Spaces und Modell-Repositories sind für eine kontinuierliche Integration und einfachere Zusammenarbeit direkt mit GitHub-Repositories verknüpft.

Wie übertrage ich Code an Hugging Face?

Sie können Code mit Standard-Git-Befehlen in einen Hugging Face Space oder ein Modell-Repository pushen, nachdem Sie die Repository-URL von Hugging Face geklont haben (z. B. https://huggingface.co/spaces/your-username/your-space-name). Authentifizieren Sie sich zunächst mit einem Hugging Face-Zugriffstoken (mithilfe von git remote set-url mit eingebettetem Token oder mit der Anmeldung mit Huggingface-cli). Fügen Sie dann Ihre Änderungen hinzu, übernehmen Sie sie und pushen Sie sie: git add ., git commit -m „message“ und git push origin main. Zur Automatisierung können Sie auch einen GitHub-Aktionsworkflow einrichten, der bei jedem GitHub-Push an Hugging Face pusht, indem Sie ein HF_TOKEN-Geheimnis verwenden, das in Ihrem GitHub-Repository gespeichert ist.

Hoffentlich gelingt es Ihnen mit dieser Anleitung, Ihr GitHub-Repository mit Hugging Face zu integrieren oder zu verbinden.