Skip to content

user-guide: document Hugging Face Storage Buckets as a remote - #5595

Open
davanstrien wants to merge 2 commits into
treeverse:mainfrom
davanstrien:docs/s3-hf-storage-buckets
Open

davanstrien wants to merge 2 commits into
treeverse:mainfrom
davanstrien:docs/s3-hf-storage-buckets

Conversation

@davanstrien

Copy link
Copy Markdown

Hugging Face Storage Buckets have an S3-compatible API, so a bucket works as a DVC S3 remote. This adds a short section to the existing Hugging Face integration page. It covers the one non-obvious part: the namespace goes in endpointurl (https://s3.hf.co/<NAMESPACE>) and the bare bucket name in the s3:// URL. It also shows credentials set with --local.

Tested with DVC 3.67.1 (dvc-s3 3.3.0) against s3.hf.co:

  • dvc remote add + endpointurl + region, credentials via dvc remote modify --local
  • dvc add → dvc push → fresh git clone → dvc pull, then a v1 → v2 update cycle
  • a 1 GB file (multipart) and a 2,000-file directory both round-trip with matching checksums

The same recipe is in the Hugging Face docs: https://huggingface.co/docs/hub/storage-buckets-s3#version-data-with-dvc

@CLAassistant

CLAassistant commented Oct 28, 2026 •

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants