Skip to content

docs: make server-side repo→bucket copy easier to find#2519

Merged
davanstrien merged 4 commits into
mainfrom
bucket-copy-discoverability
Jun 8, 2026
Merged

docs: make server-side repo→bucket copy easier to find#2519
davanstrien merged 4 commits into
mainfrom
bucket-copy-discoverability

Conversation

@davanstrien

@davanstrien davanstrien commented Jun 2, 2026

Copy link
Copy Markdown
Member

hf buckets cp copies a dataset/model/Space repo into a bucket server-side
(only Xet hashes migrated, no re-upload), but it was documented only at the
bottom of storage-buckets.md and never linked from the datasets docs.

  • datasets-ingesting.md: add the copy cross-link + example
  • storage-buckets.md: mention it in the Managing Files intro; link "instantly"
    to chunk-level deduplication
  • xet/deduplication.md: note dedup is what makes server-side copies instant

No new feature — discoverability only.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only discoverability and cross-links; no product or API behavior changes.

Overview
Improves discoverability of server-side hf buckets cp (and related CLI) for copying Xet-tracked data from datasets/models/Spaces into storage buckets without re-uploading bytes.

datasets-ingesting.md now calls out repo→bucket copy in Ingest raw data, with a short example and a link to the storage-buckets copy section.

storage-buckets.md surfaces the same workflow earlier under Managing Files, ties “instant” copies to chunk-level deduplication, and expands the NOTE with the same storage region requirement for server-side copy (plus minor NOTE formatting cleanup).

xet/deduplication.md adds a TIP explaining that deduplication is why hash-only server-side copies are fast, with a link back to the buckets copy docs.

Reviewed by Cursor Bugbot for commit a760b69. Bugbot is set up for automated code reviews on this repo. Configure here.

Cross-link the instant copy from datasets-ingesting.md and the Managing Files
intro, and tie it to the Xet dedup explanation. Feature already existed but was
buried at the bottom of storage-buckets.md.
@HuggingFaceDocBuilderDev

Copy link
Copy Markdown

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@Wauplin

Wauplin commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

@davanstrien can you also add a disclaimer that server-side copy only works within the same storage region (i.e. cannot copy from US to EU)? I haven't properly documented this yet as mentioned by @Pierrci in slack

Will open a separate PR for huggingface_hub docs

Per review (Wauplin), folded into the existing copy note.
@davanstrien

Copy link
Copy Markdown
Member Author

just updated that disclaimer

Comment thread docs/hub/storage-buckets.md Outdated
Co-authored-by: Pedro Cuenca <pedro@huggingface.co>
Comment thread docs/hub/datasets-ingesting.md Outdated
Co-authored-by: Julien Chaumond <julien@huggingface.co>
@davanstrien
davanstrien merged commit c83b9ad into main Jun 8, 2026
3 checks passed
@davanstrien
davanstrien deleted the bucket-copy-discoverability branch June 8, 2026 07:21
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.

5 participants