Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Filesystem API

The HfFileSystem class provides a pythonic file interface to the Hugging Face Hub based on fssepc.


HfFileSystem is based on fsspec, so it is compatible with most of the APIs that it offers. For more details, check out our guide and the fsspec’s API Reference.

class huggingface_hub.HfFileSystem

< >

( *args **kwargs )


  • endpoint (str, optional) — The endpoint to use. If not provided, the default one ( is used.
  • token (str, optional) — Authentication token, obtained with HfApi.login method. Will default to the stored token.

Access a remote Hugging Face Hub repository as if were a local file system.


>>> from huggingface_hub import HfFileSystem

>>> fs = HfFileSystem()

>>> # List files
>>> fs.glob("my-username/my-model/*.bin")
>>>"datasets/my-username/my-dataset", detail=False)
['datasets/my-username/my-dataset/.gitattributes', 'datasets/my-username/my-dataset/', 'datasets/my-username/my-dataset/data.json']

>>> # Read/write files
>>> with"my-username/my-model/pytorch_model.bin") as f:
...     data =
>>> with"my-username/my-model/pytorch_model.bin", "wb") as f:
...     f.write(data)


< >

( *args endpoint: typing.Optional[str] = None token: typing.Optional[str] = None **storage_options )


< >

( path: str revision: typing.Optional[str] = None )


< >

( path: str detail: bool = True refresh: bool = False revision: typing.Optional[str] = None **kwargs )

List the contents of a directory.