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
| |--------|----------|---------| | ||
| | **hf-mount** | Mount as local filesystem — any tool works | [See below](#mount-as-a-local-filesystem) | | ||
| | **hf:// paths** (fsspec) | Python data tools (pandas, DuckDB) | [See below](#python-data-tools) | | ||
| | **Volume mounts** | HF Jobs & Spaces | [See below](#volume-mounts-in-jobs-and-spaces) | |
Member
There was a problem hiding this comment.
i would move those one level closer to hf-mount given they're really the same thing
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
3 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
Low risk documentation-only change that adds a new page and sidebar entry plus a cross-link; no runtime or API behavior is affected.
Overview
Adds a new Storage Buckets → Access Patterns doc page describing common ways to use bucket data from existing workflows (mount via
hf-mount, Pythonhf://buckets/access withHfFileSystem/fsspec, Jobs/Spaces volume mounts, and CLIsync).Updates the Hub docs sidebar (
_toctree.yml) to include the new page and adds a tip callout onstorage-buckets.mdlinking readers to it.Reviewed by Cursor Bugbot for commit f63cfcf. Bugbot is set up for automated code reviews on this repo. Configure here.