hf-mount

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [
    "pkgconf",
    "rust"
  ],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Mount Hugging Face Buckets and repos as local filesystems",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:38:38+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "hf-mount",
  "github_default_branch": "main",
  "github_last_commit_at": "2026-06-19T14:26:06Z",
  "github_readme_excerpt": "# hf-mount\n\n\u003cimg width=\"1400\" height=\"386\" alt=\"image\" src=\"https://github.com/user-attachments/assets/d68eac8c-4e28-4d2d-93b2-b049da846397\" /\u003e\n\nMount [Hugging Face Buckets](https://huggingface.co/docs/hub/storage-buckets) and repos as local filesystems. No download, no copy, no waiting.\n\n```bash\nhf-mount start bucket myuser/my-bucket /tmp/data\n```\n\nAlso works with any model or dataset repo (read-only):\n\n```bash\nhf-mount start repo openai/gpt-oss-20b /tmp/gpt-oss\n```\n\nCommands will pick up your `HF_TOKEN` from the environment, or you can pass it explicitly with `--hf-token`.\n\nThen use your local folders as usual:\n```python\nfrom transformers import AutoModelForCausalLM\nmodel = AutoModelForCausalLM.from_pretrained(\"/tmp/gpt-oss\")  # reads on demand, no download step\n```\n\nhf-mount exposes [Hugging Face Buckets](https://huggingface.co/docs/hub/storage-buckets) and [Hub repos](https://huggingface.co) as a local filesystem via FUSE or NFS. Files are fetched lazily on first read, so only the bytes your code actually touches ever hit the network.\n\nTwo backends are available:\n- **NFS** (recommended) -- works everywhere, no root, no kernel extension\n- **FUSE** -- tighter kernel integration, requires root or [macFUSE](https://osxfuse.github.io/) on macOS\n\nAgentic storage: Agents don\u0027t require complex APIs or SDKs, they thrive on the filesystem: ls, cat, find, grep, and the power of composable UNIX pipelines.\n\n![hf-mount demo gif](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hf-mount/demo.gif)\n\n## Install\n\n### Homebrew (macOS, Linux)\n\n```bash\nbrew install hf-mount\n```\n\nOn macOS, this installs the NFS backend only (`hf-mount`, `hf-mount-nfs`). For the FUSE backend on macOS, download the binary manually or build from source \u2014 macFUSE is closed-source and not distributable through homebrew-core.\n\n### Manual download\n\nBinaries are available on [GitHub Releases](https://github.com/huggingface/hf-mount/releases):\n\n| Platform | Daemon | NFS | FUSE |\n| ",
  "github_repo": "huggingface/hf-mount",
  "github_stars": 750,
  "github_topics": [],
  "homepage": "https://github.com/huggingface/hf-mount",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 163,
  "installs_365d": 389,
  "installs_90d": 389,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "Apache-2.0",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "hf-mount",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 2835,
  "rank_365d": 5667,
  "rank_90d": 3191,
  "raw_hash": "d342ab2772aa0957",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/h/hf-mount.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "0.7.1",
  "versioned_formulae": [],
  "why_use_this": null
}