# 使用 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.9.0 - **来源摘要:** Mount Hugging Face Buckets and repos as local filesystems - **主页:** - **仓库:** - **最后更新:** 2026-07-08T16:31:49Z - **已生成:** 2026-08-03T19:37:03+00:00 ## 可执行文件 - hf-mount (别名) - hf-mount-fuse (别名) - hf-mount-nfs (别名) ## 安装行为 - Bottle: 不可用 ## 版本和新鲜度 - 页面生成时间: 2026-08-03 - 管理器版本: 0.9.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。 ## Combined YAML source View the package source record on GitHub. [combined/hf-mount.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hf-mount.yml) ## 来源 - pkg.so package database - Geiger risk classifier - curated package history - pkgdb category and tag curation - cross-ecosystem install command graph