Neuerungen in der huggingface_hub Version 1.13.0

Sehr geehrte Leserin, sehr geehrter Leser,

Die jüngste Veröffentlichung der Version 1.13.0 der huggingface_hub-Bibliothek markiert einen signifikanten Schritt in der Weiterentwicklung der Interaktion mit dem Hugging Face Hub. Diese Aktualisierung konzentriert sich auf die Verbesserung der Benutzerfreundlichkeit und die Optimierung der Schnittstelle für automatisierte Systeme, insbesondere im Kontext von Künstlicher Intelligenz.

Globale Formatierungsoptionen für die CLI

Eine der zentralen Neuerungen in huggingface_hub v1.13.0 ist die Einführung globaler Formatierungsoptionen für alle `hf`-Befehle in der Kommandozeilenschnittstelle (CLI). Bisher mussten solche Optionen oft pro Befehl definiert werden, was zu Inkonsistenzen und zusätzlichem Implementierungsaufwand führte. Mit dieser Version können nun die Parameter `--format`, `--json` und `-q` (kurz für `--quiet`) universell angewendet werden.

Besondere Beachtung verdient die Option `--format auto`. Diese intelligente Funktion erkennt automatisch, ob die CLI in einem interaktiven Terminal von einem Menschen oder in einer automatisierten Umgebung von einem KI-Agenten verwendet wird. Entsprechend passt sie die Ausgabe an: für menschliche Nutzer wird eine gut lesbare, formatierte Ausgabe generiert, während für KI-Tools eine strukturierte, maschinenlesbare Ausgabe bereitgestellt wird. Dies eliminiert die Notwendigkeit manueller Anpassungen und fördert eine nahtlose Integration in bestehende Workflows und KI-Agenten.

Erweiterte CLI-Befehle für Hub-Inhalte

Die aktuelle Version erweitert die Funktionalitäten der CLI um mehrere neue Befehle, die den Zugriff auf und die Verwaltung von Hub-Inhalten erleichtern:

• `hf models card --metadata`: Dieser Befehl ermöglicht das Abrufen von Modellkarten im JSON-Format. Dies ist nützlich für die programmatische Analyse von Modellmetadaten, die in der YAML-Frontmatter der README-Dateien hinterlegt sind.
• `hf models ls `: Anstatt nur Repositories aufzulisten, kann dieser Befehl nun die Dateien innerhalb eines spezifischen Repositories anzeigen. Optionen wie `--tree`, `-R` (rekursiv), `-h` (lesbare Größen) und `--revision` ermöglichen eine detaillierte Dateilistenansicht.
• `hf datasets leaderboard`: Dieser neue Befehl bietet die Möglichkeit, Benchmark-Ergebnisse von Modellen direkt im Terminal zu vergleichen, die auf einem bestimmten Datensatz eingereicht wurden. Dies unterstützt die schnelle Bewertung und Auswahl von Modellen basierend auf Leistungsmetriken.

Verbesserte Verwaltung von Hugging Face Spaces

Die Verwaltung von Hugging Face Spaces über die CLI wurde ebenfalls signifikant erweitert. Mit den neuen `hf spaces`-Unterbefehlen erhalten Benutzer eine umfassendere Kontrolle über den Lebenszyklus ihrer Spaces:

• `hf spaces pause` und `hf spaces restart`: Diese Befehle ermöglichen das Anhalten oder Neustarten eines Space, wobei `--factory-reboot` einen sauberen Neuaufbau erzwingt. Diese Funktionen sind entscheidend für das Kostenmanagement und die schnelle Wiederherstellung von Diensten.
• `hf spaces settings`: Konfigurieren Sie die Schlafzeit und Hardware-Spezifikationen eines Space in einem einzigen Aufruf, beispielsweise mit `--hardware t4-medium --sleep-time 3600`.
• `hf spaces hardware`: Dieser Befehl listet alle verfügbaren Hardware-Optionen zusammen mit deren Preisen auf, was die Entscheidungsfindung bei der Hardware-Auswahl unterstützt.

Vereinfachtes CLI-Update

Ein häufiges Problem bei Kommandozeilenwerkzeugen ist der Update-Prozess. Die neue Version behebt dies durch die Einführung des Befehls `hf update`. Dieser Befehl erkennt automatisch die Installationsmethode der CLI (z.B. Homebrew, Standalone-Installer oder pip) und führt den entsprechenden Upgrade-Befehl aus. Dies ersetzt die bisherige, oft störende, interaktive Update-Aufforderung beim Start der CLI und sorgt für eine reibungslosere Aktualisierung.

Zentrale URI-Analyse und effizienter Job-Skript-Upload

Die Einführung einer zentralen `parse_hf_uri`-Funktion und der `HfUri`-Datenklasse standardisiert die Analyse von `hf://`-Strings in der gesamten Bibliothek. Dies gewährleistet eine konsistente Handhabung von Verweisen auf Modelle, Datensätze, Spaces, Buckets oder Dateien innerhalb eines Repositories und verbessert die Robustheit der Fehlerbehandlung.

Des Weiteren wurde der Transportmechanismus für Job-Skripte, die über `hf jobs uv run` hochgeladen werden, auf den Bucket-Transport umgestellt. Anstatt Skripte als Base64-kodierte Umgebungsvariablen zu übergeben, werden sie nun in einem `{namespace}/jobs-artifacts`-Bucket gespeichert und in den Job-Container gemountet. Diese Methode ist weniger fehleranfällig, einfacher zu debuggen und ermöglicht das Zurückschreiben von Output-Artefakten, da die Mounts nun schreibbar sind.

Ausblick

Die Version 1.13.0 von huggingface_hub bietet eine Reihe von Verbesserungen, die sowohl die manuelle Nutzung der CLI als auch die Integration in automatisierte KI-Workflows optimieren. Die globalen Formatierungsoptionen und die agentenfreundliche Ausgabe sind besonders relevant für Unternehmen, die KI-Tools in ihre Entwicklungsprozesse integrieren möchten. Die erweiterten Verwaltungsfunktionen für Spaces und die vereinfachten Update-Prozesse tragen zusätzlich zur Effizienz und Skalierbarkeit bei.

Bibliographie

• Hugging Face. (2026). [v1.13.0] new CLI commands and formatting, and HF URI parsing. GitHub Release. Verfügbar unter: https://github.com/huggingface/huggingface_hub/releases/tag/v1.13.0
• Hugging Face. (2026). [v1.12.0] Unified CLI output, bucket search, and more. GitHub Release. Verfügbar unter: https://github.com/huggingface/huggingface_hub/releases/tag/v1.12.0
• Hugging Face. (2026). Add `out` output singleton with agent/humain mode rendering (#4005) · 03e00fc · huggingface/huggingface_hub. GitHub Commit. Verfügbar unter: https://github.com/huggingface/huggingface_hub/commit/03e00fcfe79c546e7df757d97153ef3640e4914a
• Hugging Face. (2026). [v1.9.0] Agent-Aware CLI, Spaces Volumes, and more. GitHub Release. Verfügbar unter: https://github.com/huggingface/huggingface_hub/releases/tag/v1.9.0
• Hugging Face. (2026). [v1.5.0]: Buckets API, Agent-first CLI, Spaces Hot-Reload and more. GitHub Release. Verfügbar unter: https://github.com/huggingface/huggingface_hub/releases/tag/v1.5.0
• Hugging Face. (2026). [CLI] Migrate `download`, `upload`, `upload-large-folder` to `out` singleton · Pull Request #4100 · huggingface/huggingface_hub. GitHub Pull Request. Verfügbar unter: https://github.com/huggingface/huggingface_hub/pull/4100
• Hugging Face. (2026). [CLI] Add `FormatWithAutoOpt` with callback to auto set output mode (#4028) · 56482ed · huggingface/huggingface_hub. GitHub Commit. Verfügbar unter: https://github.com/huggingface/huggingface_hub/commit/56482ede64c31e9f3e3f1614d430eaf0c122b2c0
• Hugging Face. (2026). [CLI] output format option for `ls` CLIs · Pull Request #3735 · huggingface/huggingface_hub. GitHub Pull Request. Verfügbar unter: https://github.com/huggingface/huggingface_hub/pull/3735
• Hugging Face. (2026). [CLI] Add --format and --quiet options to `hf papers ls` (#3903) · 2f9153e · huggingface/huggingface_hub. GitHub Commit. Verfügbar unter: https://github.com/huggingface/huggingface_hub/commit/2f9153e7e9b0433e0d0b483328fff5f34eada7aa
• Hugging Face. (2026). [v1.7.0] pip-installable CLI extensions and multiple QoL improvements. GitHub Release. Verfügbar unter: https://github.com/huggingface/huggingface_hub/releases/tag/v1.7.0