Skip to main content

Client library to download and publish models on the huggingface.co hub

Project description

huggingface_hub

Welcome to the Hub repo! Here you can find all the open source things related to the Hugging Face Hub.

Build GitHub GitHub release

What can you find in this repo?

The huggingface_hub client library

This library allows anyone to work with the Hub repositories: you can clone them, create them and upload your models to them. On top of this, the library also offers methods to access information from the Hub. For example, listing all models that meet specific criteria or get all the files from a specific repo. You can find the library implementation here.


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 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.


Inference API integration into the Hugging Face Hub

In order to get a functional Inference API on the Hub for your models (and thus, cool working widgets!) check out this doc. There is a docker image for each library. Within the image, you can find the implementation for supported pipelines for the given library.


Widgets

All our widgets are open-sourced. Feel free to propose and implement widgets. You can try all of them out here.


Code Snippets

We'll implement a few tweaks to improve the UX for your models on the website – let's use Asteroid as an example.

Model authors add an asteroid tag to their model card and they get the advantages of model versioning built-in

asteroid-model

We add a custom "Use in Asteroid" button. When clicked, you get a library-specific code sample that you'll be able to specify. 🔥

asteroid-code-sample


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

Project details


Release history Release notifications | RSS feed

This version

0.1.1

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.1.1.tar.gz (51.8 kB view details)

Uploaded Source

Built Distribution

huggingface_hub-0.1.1-py3-none-any.whl (59.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: huggingface_hub-0.1.1.tar.gz
  • Upload date:
  • Size: 51.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for huggingface_hub-0.1.1.tar.gz
Algorithm Hash digest
SHA256 195853756830200534f5d1117f76b1df537985c587c1e1b3ab233095493f9d65
MD5 05be1af83e3349c7abc7d7e55473eedf
BLAKE2b-256 1380a73a40e9e183978381ddd4f868a4d9b2c8a0d85aec6d739fb889aef365e6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: huggingface_hub-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 59.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for huggingface_hub-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3f05677c9da49cb577a7f92a4fbbb5465136d0ead24394b1f17098ad444c1b7e
MD5 80351959b3d690b35353f83651e55f3b
BLAKE2b-256 1fc25cd306e9a1d0781fa53068d0e62bafcac84d6d9b0ff5ea00cd528eb813ab

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