Skip to main content

Client library to download and publish models, datasets and other repos on the huggingface.co hub

Project description

huggingface_hub

Code style: black Code coverage GitHub release Documentation Documentation

Welcome to the huggingface_hub library

The huggingface_hub is a client library to interact with the Hugging Face Hub. The Hugging Face Hub is a platform with over 90K models, 14K datasets, and 12K demos in which people can easily collaborate in their ML workflows. The Hub works as a central place where anyone can share, explore, discover, and experiment with open-source Machine Learning.

With huggingface_hub, you can easily download and upload models, datasets, and Spaces. You can extract useful information from the Hub, and do much more. Some example use cases:

  • Downloading and caching files from a Hub repository.
  • Creating repositories and uploading an updated model every few epochs.
  • Extract metadata from all models that match certain criteria (e.g. models for text-classification).
  • List all files from a specific repository.

Read all about it in the library documentation.


Integrating to the Hub.

We're partnering with cool open source ML libraries to provide free model hosting and versioning. You can find the existing integrations here.

The advantages are:

  • Free model or dataset hosting for libraries and their users.
  • Built-in file versioning, even with very large files, thanks to a git-based approach.
  • Hosted inference API for all models publicly available.
  • In-browser widgets to play with the uploaded models.
  • Anyone can upload a new model for your library, they just need to add the corresponding tag for the model to be discoverable.
  • Fast downloads! We use Cloudfront (a CDN) to geo-replicate downloads so they're blazing fast from anywhere on the globe.
  • Usage stats and more features to come.

If you would like to integrate your library, feel free to open an issue to begin the discussion. We wrote a step-by-step guide with ❤️ showing how to do this integration.


Feedback (feature requests, bugs, etc.) is super welcome 💙💚💛💜♥️🧡

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

huggingface_hub-0.12.1.tar.gz (160.1 kB view details)

Uploaded Source

Built Distribution

huggingface_hub-0.12.1-py3-none-any.whl (190.3 kB view details)

Uploaded Python 3

File details

Details for the file huggingface_hub-0.12.1.tar.gz.

File metadata

  • Download URL: huggingface_hub-0.12.1.tar.gz
  • Upload date:
  • Size: 160.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for huggingface_hub-0.12.1.tar.gz
Algorithm Hash digest
SHA256 6f960f6246ef9c3446d0d6275e853485515682c350917fdaf2a59705f8b9ebb3
MD5 77c31916bb2d9f11e17764debdd9e4b3
BLAKE2b-256 90d74629218f05e188e21b4d68decda8566ff6898013f5e96f4d8caf9211d701

See more details on using hashes here.

File details

Details for the file huggingface_hub-0.12.1-py3-none-any.whl.

File metadata

File hashes

Hashes for huggingface_hub-0.12.1-py3-none-any.whl
Algorithm Hash digest
SHA256 867586cc8543fe1bd43a219fedbea7d71690021ad80f0c46f35c4751069278d7
MD5 1fc7fbb713920d28d52b9f10838ad039
BLAKE2b-256 573f63dd1710b00aa5e7c186ac761a2078f595abf7bb58ea802138d83cb30cca

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page