Version 1.0 release of Hugging Face's open-source library brings breaking changes, including migration to httpx and a redesigned command-line interface, aiming to support the next decade of machine learning innovation.
Hugging Face Hub Reaches Version 1.0: A Milestone for Open Machine Learning Infrastructure
After five years of development, Hugging Face's open-source library, huggingface_hub, has reached version 1.0, marking a significant milestone in its evolution as the foundational Python package powering over 200,000 dependent libraries and providing core functionality for accessing more than 2 million public models, 500,000 public datasets, and 1 million public Spaces.
This release introduces breaking changes aimed at supporting the next decade of innovation in machine learning. Key upgrades include migrating to httpx as the core HTTP backend, which brings native HTTP/2 support, true thread safety, and unified synchronous and asynchronous APIs. The legacy hf_transfer library has been fully replaced by hf_xet, now the default for file transfers.
The command-line interface has been completely redesigned using Typer, replacing the deprecated huggingface-cli. The new hf command features a modern resource-action syntax, sandboxed installers for easy setup across platforms, and built-in autocompletion. It now supports advanced workflows including Spaces deployment, inference endpoints, job management, and full integration with the Hub's social features like collections, likes, and follow systems.
Background and Context
The Hugging Face Hub emerged as a solution to the common frustration faced by researchers and practitioners in the early days of the platform. Training state-of-the-art models required significant compute resources and expertise, and once trained, these models often lived in isolation, stored on local machines and shared via broken Google Drive links. The AI community was duplicating work, wasting resources, and missing opportunities for collaboration.
In late 2020, Hugging Face shipped huggingface_hub v0.0.1 with a simple mission: extract the internal logic from transformers and create a dedicated library that would unify how to access and share machine learning models and datasets on the Hugging Face Hub. Initially, the library was as straightforward as a Git wrapper for downloading files and managing repositories.
Over time, huggingface_hub evolved far beyond its origins. The early releases established the basics, introducing APIs that wrapped Git commands to interact with repositories. Version 0.0.17 brought token-based authentication, enabling secure access to private repositories and uploads. These were humble beginnings, but they laid the groundwork for everything that followed.
Why It Matters to the Industry
The release of huggingface_hub v1.0 is significant not only for its own ecosystem but also for the broader industry. The library's migration to httpx as the core HTTP backend brings substantial benefits, including native HTTP/2 support and true thread safety. This upgrade positions huggingface_hub to scale with the explosive growth of AI while maintaining the reliability that millions of developers depend on.
The redesigned CLI and adoption of hf_xet for file transfers also have significant implications for the industry. The new CLI features a modern resource-action syntax, sandboxed installers, and built-in autocompletion, making it easier for developers to work with the Hub. The adoption of hf_xet enables efficient uploads and downloads by transferring only changed portions of large files.
What Comes Next
The release of huggingface_hub v1.0 marks a significant milestone in its evolution as the foundational Python package powering open machine learning infrastructure. With this release, Hugging Face is fully committing to the future, focusing exclusively on v1.0 and beyond. Previous v0.* versions will remain available on PyPI but will only receive vulnerability updates.
The journey ahead for huggingface_hub is promising, with a global community of almost 300 contributors and millions of users worldwide driving innovation in machine learning. The library's migration to httpx as the core HTTP backend positions it to scale with the explosive growth of AI while maintaining the reliability that millions of developers depend on.
Key Facts
- huggingface_hub has reached version 1.0, marking a significant milestone in its evolution as the foundational Python package powering open machine learning infrastructure.
- The library's migration to httpx as the core HTTP backend brings native HTTP/2 support and true thread safety.
- The legacy hf_transfer library has been fully replaced by hf_xet, now the default for file transfers.
- The redesigned CLI features a modern resource-action syntax, sandboxed installers, and built-in autocompletion.
- huggingface_hub powers over 200,000 dependent libraries and provides core functionality for accessing more than 2 million public models, 500,000 public datasets, and 1 million public Spaces.
The release of huggingface_hub v1.0 is a significant milestone in the evolution of open machine learning infrastructure. With its migration to httpx as the core HTTP backend and adoption of hf_xet for file transfers, the library positions itself to scale with the explosive growth of AI while maintaining the reliability that millions of developers depend on.
