#
Installation

Bevor Sie beginnen, müssen Sie Ihre Umgebung vorbereiten, indem Sie die entsprechenden Pakete installieren.

`huggingface_hub` wurde für Python 3.8+ getestet.

##
Installation mit pip

Es wird dringend empfohlen, `huggingface_hub` in einer virtuellen Umgebung zu installieren. Wenn Sie mit virtuellen Umgebungen in Python nicht vertraut sind, werfen Sie einen Blick auf diesen Leitfaden. Eine virtuelle Umgebung erleichtert die Verwaltung verschiedener Projekte und verhindert Kompatibilitätsprobleme zwischen Abhängigkeiten.

Beginnen Sie damit, eine virtuelle Umgebung in Ihrem Projektverzeichnis zu erstellen:

    python -m venv .env

Aktivieren Sie die virtuelle Umgebung. Unter Linux und macOS:

    source .env/bin/activate

Aktivieren der virtuellen Umgebung unter Windows:

    .env/Scripts/activate

Jetzt können Sie `huggingface_hub` aus dem PyPi-Register installieren:

    pip install --upgrade huggingface_hub

Überprüfen Sie nach Abschluss, ob die Installation korrekt funktioniert.

###
Installieren optionaler Abhängigkeiten

Einige Abhängigkeiten von `huggingface_hub` sind optional, da sie nicht notwendig sind, um die Kernfunktionen von `huggingface_hub` auszuführen. Allerdings könnten einige Funktionen von `huggingface_hub` nicht verfügbar sein, wenn die optionalen Abhängigkeiten nicht installiert sind.

Sie können optionale Abhängigkeiten über `pip` installieren:

    # Abhängigkeiten für spezifische TensorFlow-Funktionen installieren
    # /!\ Achtung: dies entspricht nicht `pip install tensorflow`
    pip install 'huggingface_hub[tensorflow]'

    # Abhängigkeiten sowohl für torch-spezifische als auch für CLI-spezifische Funktionen installieren.
    pip install 'huggingface_hub[cli,torch]'

Hier ist die Liste der optionalen Abhängigkeiten in huggingface_hub:

- `cli`: bietet eine komfortablere CLI-Schnittstelle für huggingface_hub.
- `fastai`, `torch`, `tensorflow`: Abhängigkeiten, um framework-spezifische Funktionen auszuführen.
- `dev`: Abhängigkeiten, um zur Bibliothek beizutragen. Enthält `testing` (um Tests auszuführen), `typing` (um den Type Checker auszuführen) und `quality` (um Linters auszuführen).

###
Installieren von der Quelle

In einigen Fällen kann es sinnvoll sein, `huggingface_hub` direkt von der Quelle zu installieren. Dies ermöglicht es Ihnen, die aktuellste `main`-Version anstelle der neuesten stabilen Version zu verwenden. Die `main`-Version ist nützlich, um immer auf dem neuesten Stand der Entwicklungen zu bleiben, zum Beispiel wenn ein Fehler seit der letzten offiziellen Veröffentlichung behoben wurde, aber noch keine neue Version herausgegeben wurde.

Das bedeutet jedoch, dass die `main`-Version nicht immer stabil sein könnte. Wir bemühen uns, die Hauptversion funktionsfähig zu halten, und die meisten Probleme werden in der Regel innerhalb von einigen Stunden oder einem Tag gelöst. Wenn Sie auf ein Problem stoßen, eröffnen Sie bitte ein “Issue”, damit wir es noch schneller beheben können!

    pip install git+https://github.com/huggingface/huggingface_hub

Bei der Installation von der Quelle können Sie auch einen bestimmten Zweig angeben. Dies ist nützlich, wenn Sie ein neues Feature oder einen neuen Fehlerbehebung testen möchten, der noch nicht zusammengeführt wurde:

    pip install git+https://github.com/huggingface/huggingface_hub@my-feature-branch

Überprüfen Sie nach Abschluss, ob die Installation korrekt funktioniert.

###
Editierbare Installation

Die Installation von der Quelle ermöglicht Ihnen eine editierbare Installation. Dies ist eine fortgeschrittenere Installation, wenn Sie zur Entwicklung von `huggingface_hub` beitragen und Änderungen im Code testen möchten. Sie müssen eine lokale Kopie von `huggingface_hub` auf Ihrem Computer klonen.

    # Zuerst die Repository lokal klonen
    git clone https://github.com/huggingface/huggingface_hub.git

    # Dann mit dem -e Flag installieren
    cd huggingface_hub
    pip install -e .

Diese Befehle verknüpfen den Ordner, in den Sie das Repository geklont haben, mit Ihren Python-Bibliothekspfaden. Python wird nun zusätzlich zu den normalen Bibliothekspfaden im geklonten Ordner suchen. Wenn Ihre Python-Pakete normalerweise in `./.venv/lib/python3.13/site-packages/` installiert sind, wird Python auch den geklonten Ordner `./huggingface_hub/` durchsuchen.

##
Installieren mit conda

Wenn Sie damit vertrauter sind, können Sie `huggingface_hub` über den conda-forge-Kanal installieren:

    conda install -c conda-forge huggingface_hub

Überprüfen Sie nach Abschluss, ob die Installation korrekt funktioniert.

##
Installation überprüfen

Nach der Installation überprüfen Sie, ob `huggingface_hub` richtig funktioniert, indem Sie den folgenden Befehl ausführen:

    python -c "from huggingface_hub import model_info; print(model_info('gpt2'))"

Dieser Befehl ruft Informationen vom Hub über das gpt2-Modell ab. Die Ausgabe sollte so aussehen:

    Model Name: gpt2
    Tags: ['pytorch', 'tf', 'jax', 'tflite', 'rust', 'safetensors', 'gpt2', 'text-generation', 'en', 'doi:10.57967/hf/0039', 'transformers', 'exbert', 'license:mit', 'has_space']
    Task: text-generation

##
Windows-Einschränkungen

Mit unserem Ziel, gutes ML überall zu demokratisieren, haben wir `huggingface_hub` als plattformübergreifende Bibliothek entwickelt, insbesondere um sowohl auf Unix-basierten als auch auf Windows-Systemen korrekt zu funktionieren. Es gibt jedoch einige Fälle, in denen `huggingface_hub` unter Windows gewisse Einschränkungen hat. Hier ist eine ausführliche Liste der bekannten Probleme. Bitte informieren Sie uns, wenn Sie auf ein nicht dokumentiertes Problem stoßen, indem Sie ein Issue auf Github eröffnen.

- Das Cache-System von `huggingface_hub` verwendet Symlinks, um Dateien, die vom Hub heruntergeladen wurden, effizient zu cachen. Unter Windows müssen Sie den Entwicklermodus aktivieren oder Ihr Skript als Admin ausführen, um Symlinks zu aktivieren. Wenn sie nicht aktiviert sind, funktioniert das Cache-System immer noch, aber nicht optimiert. Bitte lesen Sie den Abschnitt über Cache-Einschränkungen für weitere Details.
- Dateipfade auf dem Hub können Sonderzeichen enthalten (z.B. `"pfad/zu?/meiner/datei"`). Windows ist bei Sonderzeichen restriktiver, wodurch es unmöglich ist, diese Dateien unter Windows herunterzuladen. Hoffentlich ist dies ein seltener Fall. Bitte wenden Sie sich an den Repo-Eigentümer, wenn Sie denken, dass dies ein Fehler ist, oder an uns, um eine Lösung zu finden.

##
Nächste Schritte

Sobald `huggingface_hub“ richtig auf Ihrem Computer installiert ist, möchten Sie vielleicht Umgebungsvariablen konfigurieren oder einen unserer Leitfäden durchgehen, um loszulegen.

< > Update on GitHub