# huggingface\_hub v1.0: Five Years of Building the Foundation of Open Machine Learning

[Hugging Face](https://yomu.fyi/company/hugging-face) · Lucain Pouget, Célina Hanouti, Lysandre, Julien Chaumond · Oct 27, 2025

**Type:** Announcement

## Summary

The Hugging Face Hub team released huggingface\_hub v1.0, marking the library's transition into a mature foundation for open machine learning after five years of development. The major update migrates the underlying network backend to httpx and replaces the legacy hf\_transfer tool with the hf\_xet binary package to enable chunk-level file deduplication across repositories. In addition, the release introduces a redesigned Typer-based CLI using the streamlined hf command alongside explicit authentication functions and expanded inference primitives. Legacy components, including the Git-based Repository class and the older InferenceApi interface, have been removed to establish a cleaner and more maintainable architecture. Most dependent machine learning libraries remain compatible across versions, though transformers requires v0.x for version 4 and v1.x for its upcoming version 5 release.

## Context

The Hugging Face Hub initially relied on Git wrappers embedded inside the transformers library to share model checkpoints. As machine learning models, datasets, and spaces expanded across thousands of external tools, the ecosystem required dedicated infrastructure that eliminated heavy Git LFS dependencies, simplified authentication, and supported scalable transfers for large model artifacts.

## Approach / What changed

Hugging Face upgraded huggingface\_hub to v1.0 by switching the HTTP backend to httpx, replacing hf\_transfer with the chunk-level hf\_xet transfer package, and introducing a redesigned Typer-based hf CLI. The release removed deprecated interfaces like the Git-based Repository class and InferenceApi in favor of direct HTTP methods, explicit auth utilities, and InferenceClient.

## Takeaways

- Version 1.0 switches the HTTP client backend to httpx while making HfHubHttpError inherit from both requests and httpx base error classes to preserve error-handling compatibility.
- File transfers now standardize on hf\_xet, replacing hf\_transfer and leveraging 64KB chunk-level deduplication instead of file-level Git LFS deduplication.
- Legacy interfaces such as the Git-based Repository class, HfFolder, and InferenceApi have been removed in favor of direct HTTP methods, explicit authentication helpers, and InferenceClient.

**Tags:** [Developer Experience](https://yomu.fyi/topic/developer-experience), [Machine Learning](https://yomu.fyi/topic/machine-learning), [Migrations](https://yomu.fyi/topic/migration), [Open Source](https://yomu.fyi/topic/open-source), [Python](https://yomu.fyi/topic/python)

[Read original post](https://huggingface.co/blog/huggingface-hub-v1)