# huggingface/huggingface_hub

The official CLI and Python client for the Hugging Face Hub.

Repository: https://github.com/huggingface/huggingface_hub
Canonical: https://ross.abutalabs.com/products/huggingface_hub
Homepage: https://huggingface.co/docs/huggingface_hub
Language: Python
License: Apache-2.0
License Family: permissive
Topics: model-hub, machine-learning, models, natural-language-processing, deep-learning, pytorch, pretrained-models, hacktoberfest
Last push: 2026-08-26T18:35:22+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 2080, "days_push": 7, "days_rel": 8, "gap_med": 5.0, "n_releases_24m": 105}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3845, forks 1174 (observed 2026-08-28T04:08:24.067106+00:00)

## What it is
The official Python client and CLI for the Hugging Face Hub, a platform for sharing machine learning models, datasets, and apps. It lets users download and cache files, create and manage repositories, upload models, search the Hub, and interact with its APIs programmatically or from the terminal.

## Use cases
- download pretrained models from huggingface hub
- upload my model to huggingface
- download a dataset from the hub in python
- create a repository on the hugging face hub
- search huggingface models programmatically
- manage huggingface repos from the command line
- cache model files locally for training
- authenticate with hugging face from a script

## When to choose
- you need to download, upload, or manage models and datasets on the Hugging Face Hub
- you are building a Python library that integrates with Hugging Face model hosting
- you want a CLI to script Hub interactions like repo creation and file transfer
- you need cached, resumable downloads of large model weights

## When to avoid
- you need to run inference on models rather than manage Hub artifacts (use transformers or inference clients)
- you want to host your own model registry independent of Hugging Face's platform
- you need a general-purpose file storage client unrelated to the Hub

## Facets
- artifact type: library
- maturity: stable
- function: http-client, cli, developer-tools, machine-learning, sdk
- domain: machine-learning, developer-tools, artificial-intelligence, large-language-models
- platform: python, cli, cross-platform, windows
- tags: hugging-face, model-hub, pretrained-models, model-download, dataset-download, pytorch, model-sharing, hf-cli, linux, macos

## Member repositories
- huggingface/huggingface_hub (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:24.067106+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:26:01.733576+00:00, confidence not recorded.
  - readme: https://github.com/huggingface/huggingface_hub (fetched 2026-08-28T04:08:24.067106+00:00, sha 33e3bd8f3ce6)
  - homepage: https://huggingface.co/docs/huggingface_hub (fetched 2026-08-29T09:20:54.003199+00:00, sha 4bba662fb619)
  - site_page: https://huggingface.co/docs (fetched 2026-08-29T09:20:54.012267+00:00, sha bdec26667b98)
  - site_page: https://huggingface.co/docs/huggingface_hub/quick-start (fetched 2026-08-29T09:20:54.016580+00:00, sha 27963761eafa)
  - site_page: https://huggingface.co/docs/huggingface_hub/installation (fetched 2026-08-29T09:20:54.018442+00:00, sha bf2fbe843a09)
  - site_page: https://huggingface.co/docs/huggingface_hub/guides/overview (fetched 2026-08-29T09:20:54.020115+00:00, sha 35332d7b5386)
  - site_page: https://huggingface.co/docs/huggingface_hub/guides/download (fetched 2026-08-29T09:20:54.021773+00:00, sha dbac62a3b441)
  - site_page: https://huggingface.co/docs/huggingface_hub/guides/upload (fetched 2026-08-29T09:20:54.023587+00:00, sha 31b00c544314)
  - site_page: https://huggingface.co/docs/huggingface_hub/guides/buckets (fetched 2026-08-29T09:20:54.026036+00:00, sha a29ae5543e5a)
  - site_page: https://huggingface.co/pricing (fetched 2026-08-29T09:20:54.014466+00:00, sha de6b7a178be5)
- Data as of 2026-08-30T08:39:29.467469+00:00.