fsspec
File-system specification
Decision gist · record as of 2026-08-14
Yes. fsspec is a foundational library ranked in the top 100 PyPI packages with no security vulnerabilities, active maintenance, and zero runtime dependencies. It solves a real problem—abstracting filesystem operations across heterogeneous backends—and is widely used by downstream projects. Install it when you need to work with multiple storage systems or when a dependency requires it.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Additional backends require optional extras (e.g., fsspec[ssh], fsspec[full]).
- Low friction: pure Python wheel, no runtime dependencies, and actively maintained with a release 17 days ago.
License · maintenance · safety
(unclear)
last release 2026-07-28 (17 days) · last repo commit 2026-07-30 · 1,341 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 878,523,962 downloads/mo, #31 on PyPI
Alternatives
Verify before relying
pip install fsspec
import fsspec
fs = fsspec.filesystem('file')
files = fs.ls('/path/to/directory')- Which specific filesystem backends are included in the base installation versus requiring optional extras
- Performance characteristics or throughput limits for different backend implementations
- Whether FUSE mounting and key-value store functionality are available for all backends or only some
What it is and what it does
fsspec is a specification and implementation library that defines a common filesystem interface for Python applications. Rather than writing code specific to each storage backend (local disk, S3, GCS, SSH, etc.), developers use fsspec's unified API and let the library route operations to the appropriate backend. The package includes several filesystem implementations directly and is designed to work alongside sister projects like s3fs and gcsfs that provide additional backend support.
The library enables applications to work with different storage systems interchangeably without changing application logic. It also provides optional higher-level features like key-value stores and FUSE mounting that can work across all supported backends. Base installation requires only Python 3.10 or later; additional backends are available through optional extras.
Use it for
- Write data processing pipelines that read from and write to multiple cloud storage providers without backend-specific code
- Build tools that need to work with files across local, SSH, S3, and GCS storage transparently
- Create applications that let users choose their storage backend at runtime without code changes
- Implement FUSE filesystem mounts for cloud storage to integrate with existing command-line tools
- Develop data science workflows using dask, pandas, or zarr that abstract storage details
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
fsspec is a foundational library ranked in the top 100 PyPI packages with no security vulnerabilities, active maintenance, and zero runtime dependencies. It solves a real problem—abstracting filesystem operations across heterogeneous backends—and is widely used by downstream projects. Install it when you need to work with multiple storage systems or when a dependency requires it.
Install
fsspec on PyPI
Before you install
Low friction: pure Python wheel, no runtime dependencies, and actively maintained with a release 17 days ago. Supports Python 3.10 through 3.14.
Requires Python 3.10 or later. Additional backends require optional extras (e.g., fsspec[ssh], fsspec[full]).
Quickstart
pip install fsspec
import fsspec
fs = fsspec.filesystem('file')
files = fs.ls('/path/to/directory')Verify before relying
- Which specific filesystem backends are included in the base installation versus requiring optional extras
- Performance characteristics or throughput limits for different backend implementations
- Whether FUSE mounting and key-value store functionality are available for all backends or only some
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 17 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 878,523,962 / month, #31 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: fsspec-2026.7.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “unified filesystem interface”
- fsspecfsspec provides a unified filesystem interface specification and…
- fsProvides a unified filesystem abstraction layer that lets you work…
- iopathiopath provides a unified interface for reading and writing data…
Give your agent the search over MCP, or paste the wish link into any chat.
Similar packages
Adds XRootD storage support to fsspec, enabling file access to XRootD servers through fsspec's unified interface using the 'root' protocol.
Provides a fsspec-compatible filesystem interface to Oracle Cloud Infrastructure Object Storage, enabling file-like operations on OCI buckets through a standard API.
Universal Pathlib provides a pathlib.Path-like interface for accessing multiple backend filesystems—local, cloud storage, HTTP, SFTP, and others—through a unified API powered by fsspec.
Install it if you work with multiple storage backends or want to future-proof code that might move between local and cloud storage.
A WebDAV client library that provides a Python API, optional fsspec filesystem integration, and a CLI tool for interacting with WebDAV servers.
Provides a fsspec-compatible filesystem interface for Google Drive, allowing you to read, write, and browse files on Google Drive using standard filesystem operations.
Not recommended for production systems requiring guaranteed stability—wait for a stable release or use the official Google Drive API directly if production…
Provides an fsspec-compatible filesystem interface for SFTP/SSH connections, allowing you to read, write, and manage files on remote servers using standard filesystem operations.
See also gcsfs · scmrepo · azureml-fsspec · dvc-objects