Open
Conversation
New subpage under Storage Buckets covering access patterns: hf-mount (filesystem), HfFileSystem/fsspec (pandas, DuckDB), volume mounts in Jobs/Spaces, and CLI sync. Keeps content high-level with cross-links to detailed docs.
|
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. |
julien-c
reviewed
Apr 7, 2026
julien-c
reviewed
Apr 7, 2026
| Install: | ||
|
|
||
| ```bash | ||
| curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh | sh |
Member
There was a problem hiding this comment.
really need to submit it to brew
julien-c
approved these changes
Apr 7, 2026
Member
julien-c
left a comment
julien-c
left a comment
There was a problem hiding this comment.
wait for other reviewers, but nice 👍
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New subpage under Storage Buckets covering the main access patterns for using bucket data from code:
hf://buckets/paths with pandas, DuckDB Python clientAlso adds a tip callout on the main
storage-buckets.mdpage linking to the new page.Notes
The page is intentionally high-level for now — buckets is evolving fast, so it links out
to detailed docs (hf-mount repo, huggingface_hub guides) rather than duplicating content.
Happy to flesh out with more detailed examples and additional tool integrations in future PRs.
Related: #2362 (adds bucket tip boxes to pandas/DuckDB pages)
Test plan
Note
Low Risk
Docs-only changes (new page, sidebar entry, and cross-links) with no runtime or API impact; main risk is broken or outdated links/examples.
Overview
Adds a new
Storage Buckets → Access Patternsdoc page describing how to use bucket data viahf-mount, Jobs/Spaces volume mounts,hf://buckets/fsspec (HfFileSystem) integrations (pandas/DuckDB examples), and existing CLIsyncworkflows.Updates the hub sidebar (
_toctree.yml) to include the new subpage and adds a tip callout instorage-buckets.mdpointing readers to it.Reviewed by Cursor Bugbot for commit 8e59e8d. Bugbot is set up for automated code reviews on this repo. Configure here.