# Install hf-mount with Homebrew Mount Hugging Face Buckets and repos as local filesystems. Version 0.8.0 via Homebrew; verified 2026-06-29. ## Install ```sh sudo av install brew:hf-mount ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hf-mount ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:hf-mount - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.8.0 - **Source summary:** Mount Hugging Face Buckets and repos as local filesystems - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-29T13:05:34Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - hf-mount (cli) - hf-mount-fuse (cli) - hf-mount-nfs (cli) - hf-mount (alias) - hf-mount-fuse (alias) - hf-mount-nfs (alias) ## Build dependencies - pkgconf - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.8.0 - Package-manager updated: 2026-06-29 - Local data: ok - Upstream repository: https://github.com/huggingface/hf-mount - Upstream latest detected: v0.8.0 (current) ## Project history and usage hf-mount is a Hugging Face filesystem tool that mounts Hugging Face Buckets and Hub repositories as local directories. It targets ML workflows where code expects paths but the underlying artifacts are large remote model, dataset, or bucket objects. ### Project history Hugging Face introduced hf-mount alongside Storage Buckets as a way to attach buckets, models, and datasets from the Hub as local filesystems. The project's README describes a FUSE or NFS filesystem that fetches file bytes lazily on first read, so model and dataset consumers can browse or load remote content without cloning or downloading a full repository first. The project sits on top of Hugging Face's newer storage direction: Buckets are S3-like mutable object storage powered by the Xet storage backend, while traditional model and dataset repositories remain Git-based and read-only when mounted. hf-mount turns both forms into a local path abstraction for training, inference, evaluation, browsing, and agent scratch-storage workflows. ### Adoption history Hugging Face's changelog announcement framed hf-mount as a way to attach remote storage much larger than local disk and explicitly called out agentic storage. The Hub access-patterns documentation then made hf-mount one of the named access methods next to volume mounts, `hf://` fsspec paths, CLI sync, and the S3 API. Homebrew packaging gives macOS and Linux users a direct `brew install hf-mount` path. The README notes that the Homebrew package installs the NFS backend on macOS, while FUSE builds require platform support such as macFUSE or fuse3. ### How it is used The common flow is `hf-mount start bucket owner/name /mount/path` for a read-write bucket or `hf-mount start repo datasets/name /mount/path` for a read-only Hub repository. Commands can take credentials from `HF_TOKEN`, use NFS by default, or use FUSE where available. After mounting, ordinary tools such as shells, Python libraries, model loaders, `find`, `cat`, pandas, DuckDB, training scripts, and inference servers can read paths under the mount. The README also documents cache controls, read-only mode, token-file rotation, overlay mode, and operational limits such as stale metadata windows and no cross-node locking. ### Why package nerds care hf-mount is interesting packaging-wise because it turns cloud ML storage into a traditional Unix mount workflow. The package bundles daemon and backend executables, bridges Rust filesystem code with Hugging Face storage APIs, and exposes a very package-manager-friendly surface: install a binary, run a command, get a path. It also shows the Hugging Face CLI ecosystem expanding beyond API wrappers into host-level tools. The package matters when model artifacts are too large for laptop disks or ephemeral CI runners but the consuming program still insists on POSIX-looking files. ### Timeline - 2026-03-24: Hugging Face announced hf-mount in the Hub changelog. - 2026: Hugging Face documented hf-mount under Storage Buckets access patterns. - 2026: Homebrew packaged `hf-mount` for macOS and Linux installation. - Storage Buckets era: hf-mount became one of several Hub access paths alongside `hf://` fsspec, volume mounts, CLI sync, and S3-compatible APIs. ### Related projects - hf-mount is related to Hugging Face Storage Buckets, the Hugging Face Hub, `huggingface_hub` filesystem and URI support, Xet-backed storage, FUSE, NFS, macFUSE, and ML tooling that accepts local filesystem paths for models and datasets. ### Sources - - - - - - ## Security Notes No matching local secret-handling manifest was found for hf-mount. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hf-mount - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [bindfs](https://www.automicvault.com/pkg/brew/bindfs/) - Shares av.db curated category or tags: cli, filesystem, fuse, mount, system. - [ifuse](https://www.automicvault.com/pkg/brew/ifuse/) - Shares av.db curated category or tags: cli, filesystem, fuse, mount, system. - [afuse](https://www.automicvault.com/pkg/brew/afuse/) - Shares av.db curated category or tags: cli, filesystem, fuse, system. - [avfs](https://www.automicvault.com/pkg/brew/avfs/) - Shares av.db curated category or tags: cli, filesystem, fuse, system. - [acl](https://www.automicvault.com/pkg/brew/acl/) - Shares av.db curated category or tags: cli, filesystem, system. - [attr](https://www.automicvault.com/pkg/brew/attr/) - Shares av.db curated category or tags: cli, filesystem, system. - [convmv](https://www.automicvault.com/pkg/brew/convmv/) - Shares av.db curated category or tags: cli, filesystem, system. - [cpmtools](https://www.automicvault.com/pkg/brew/cpmtools/) - Shares av.db curated category or tags: cli, filesystem, system. - [libfuse](https://www.automicvault.com/pkg/brew/libfuse/) - Local package facts share a topical domain. Shared terms: cli, filesystem, filesystems, fuse, mount. - [ratarmount](https://www.automicvault.com/pkg/brew/ratarmount/) - Local package facts share a topical domain. Shared terms: as, cli, filesystem, filesystems, fuse. - [squashfuse](https://www.automicvault.com/pkg/brew/squashfuse/) - Local package facts share a topical domain. Shared terms: cli, filesystem, filesystems, fuse, mount. ## Combined YAML source View the package source record on GitHub. [combined/hf-mount.yml](https://github.com/automic-vault/db/blob/main/combined/hf-mount.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph