Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document hf_transfer more prominently #1714

Merged
merged 4 commits into from
Oct 6, 2023

Conversation

Wauplin
Copy link
Contributor

@Wauplin Wauplin commented Oct 5, 2023

Discussed in #1652 and slack (private) cc @Narsil @osanseviero

This PR adds more info about hf_transfer in the docs and promote its usage in the CLI upload/download commands. Still, it is not set by default -and is not planned to be- because of its inherent limitations (progress bars, error handling, resumable download,...). The goal is to make this feature more known while being optional. About the CLI commands if users don't want any log message (including this one), they can set --quiet so it should "pollute" too much the output.

I also created an alias so that https://huggingface.co/docs/huggingface_hub/hf_transfer redirects to the corresponding section in the docs.

@HuggingFaceDocBuilderDev
Copy link

HuggingFaceDocBuilderDev commented Oct 5, 2023

The documentation is not available anymore as the PR was closed or merged.

@Wauplin Wauplin changed the title draft doc Document hf_transfer more prominently Oct 5, 2023
@Wauplin Wauplin added the documentation Improvements or additions to documentation label Oct 5, 2023
@Wauplin Wauplin marked this pull request as ready for review October 5, 2023 15:20
Copy link
Member

@stevhliu stevhliu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super cool and good job being transparent about the lack of user-friendly features 😄

docs/source/en/guides/download.md Outdated Show resolved Hide resolved
docs/source/en/package_reference/environment_variables.md Outdated Show resolved Hide resolved
docs/source/en/package_reference/environment_variables.md Outdated Show resolved Hide resolved
@Wauplin
Copy link
Contributor Author

Wauplin commented Oct 6, 2023

Thanks again for the great feedback @stevhliu! And yes always good to lower users expectations 😄

@Narsil
Copy link
Contributor

Narsil commented Oct 6, 2023

Just for clarity, lack of features is part of the reason of the speed (progressbars are slowing things down very often).

Copy link
Member

@LysandreJik LysandreJik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, looks good to me!

Thanks @Wauplin

@Wauplin
Copy link
Contributor Author

Wauplin commented Oct 6, 2023

Thanks for the review, I'll merge :)

@Wauplin Wauplin merged commit 6ccc1f6 into main Oct 6, 2023
@Wauplin Wauplin deleted the 1652-document-hf-transfer-more-prominently branch October 6, 2023 09:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants