# 使用 Homebrew 安装 hf-mount 查看 hf-mount 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。 ## 安装 ```sh sudo av install brew:hf-mount ``` 其他安装命令: ### macOS - Homebrew (100%): ```sh brew install hf-mount ``` 证据: local Homebrew formula metadata ## 软件包事实 - **软件包键:** brew:hf-mount - **软件包管理器:** Homebrew - **软件包管理器页面:** - **版本:** 0.8.0 - **来源摘要:** Mount Hugging Face Buckets and repos as local filesystems - **主页:** - **仓库:** - **上游文档:** - **许可证:** Apache-2.0 - **源码归档:** - **最后更新:** 2026-06-29T13:05:34Z - **已生成:** 2026-07-08T07:18:31+00:00 ## 可执行文件 - hf-mount (cli) - hf-mount-fuse (cli) - hf-mount-nfs (cli) - hf-mount (别名) - hf-mount-fuse (别名) - hf-mount-nfs (别名) ## 构建依赖 - pkgconf - rust ## 安装行为 - post-install 钩子: 未定义 - Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## 版本和新鲜度 - 页面生成时间: 2026-07-08 - 管理器版本: 0.8.0 - 管理器更新时间: 2026-06-29 - 本地数据: OK - 上游仓库: https://github.com/huggingface/hf-mount - 检测到的最新版本: v0.8.0 (当前) ## 项目历史与用法 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. ### 项目历史 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. ### 采用历史 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. ### 使用方式 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. ### 为什么软件包爱好者会关心 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. ### 时间线 - 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. ### 来源 - - - - - - ## 安全说明 没有找到 hf-mount 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。 ## 源数据库详情 - **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 ## 相关链接 - [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/zh-hans/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [pkgconf](https://www.automicvault.com/zh-hans/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/zh-hans/pkg/brew/rust/) - Build dependency declared by Homebrew. - [bindfs](https://www.automicvault.com/zh-hans/pkg/brew/bindfs/) - Shares av.db curated category or tags: cli, filesystem, fuse, mount, system. - [ifuse](https://www.automicvault.com/zh-hans/pkg/brew/ifuse/) - Shares av.db curated category or tags: cli, filesystem, fuse, mount, system. - [afuse](https://www.automicvault.com/zh-hans/pkg/brew/afuse/) - Shares av.db curated category or tags: cli, filesystem, fuse, system. - [avfs](https://www.automicvault.com/zh-hans/pkg/brew/avfs/) - Shares av.db curated category or tags: cli, filesystem, fuse, system. - [acl](https://www.automicvault.com/zh-hans/pkg/brew/acl/) - Shares av.db curated category or tags: cli, filesystem, system. - [attr](https://www.automicvault.com/zh-hans/pkg/brew/attr/) - Shares av.db curated category or tags: cli, filesystem, system. - [convmv](https://www.automicvault.com/zh-hans/pkg/brew/convmv/) - Shares av.db curated category or tags: cli, filesystem, system. - [cpmtools](https://www.automicvault.com/zh-hans/pkg/brew/cpmtools/) - Shares av.db curated category or tags: cli, filesystem, system. - [libfuse](https://www.automicvault.com/zh-hans/pkg/brew/libfuse/) - Local package facts share a topical domain. Shared terms: cli, filesystem, filesystems, fuse, mount. - [ratarmount](https://www.automicvault.com/zh-hans/pkg/brew/ratarmount/) - Local package facts share a topical domain. Shared terms: as, cli, filesystem, filesystems, fuse. - [squashfuse](https://www.automicvault.com/zh-hans/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) ## 来源 - 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