gcsfs
Convenient Filesystem interface over GCS
Install
gcsfs on PyPI
pip
pip install gcsfsuv
uv add gcsfspoetry
poetry add gcsfsPackage facts
| License | BSD-3-Clause (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 8 — aiohttp, decorator, fsspec, google-auth-oauthlib, google-auth, google-cloud-storage-control, google-cloud-storage, requests |
| Maintenance | actively maintained — 0 days since the last release |
| Last repo commit | |
| First released | |
| Popularity | one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-13) |
Evidence: gcsfs-2026.8.0-py3-none-any.whl
Keywords: file-system, gcloud, google-cloud-storage
About gcsfs
from the package's own PyPI description — quoted content, verbatim
gcsfs
GCSFS is a Python library that provides a familiar, file-system-like interface to Google Cloud Storage (GCS). Built on top of fsspec, it allows you to interact with cloud buckets as if they were local directories, making it a favorite for data scientists and engineers.
Getting Started
Installation
Install via pip or conda:
# Using pip
pip install gcsfs
# OR using conda
conda install -c conda-forge gcsfs
Basic Usage
import gcsfs
# Initialize the filesystem
fs = gcsfs.GCSFileSystem(project='my-google-project')
# List files in a bucket
files = fs.ls('my-bucket')
# Read a file directly into a string/bytes
with fs.open('my-bucket/data.txt', 'rb') as f:
content = f.read()
Specialized Bucket Support
GCSFS now automatically supports advanced Google Cloud Storage features through its ExtendedFileSystem implementation.
1. Hierarchical Namespace (HNS)
Hierarchical Namespace (HNS) replaces the...
Read as markdown · JSON record · Source repository · Homepage · Docs
AI interpretation — verify before relying
AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page
gcsfs provides a file-system-like interface to Google Cloud Storage, allowing you to read, write, and manage cloud buckets using familiar Python file operations built on fsspec.
Installation is straightforward with low friction; the package is actively maintained with a recent release and depends on well-established libraries like fsspec, google-auth, and google-cloud-storage.
gcsfs is licensed under BSD-3-Clause (permissive), meaning you can use, modify, and distribute it freely in both open-source and commercial projects with minimal restrictions.
Usage
pip install gcsfs
import gcsfs
fs = gcsfs.GCSFileSystem(project='my-google-project')
files = fs.ls('my-bucket')
with fs.open('my-bucket/data.txt', 'rb') as f:
content = f.read()
Requires Python >=3.10 and valid Google Cloud credentials (local gcloud setup, service account key, or environment-based authentication).
Verdict: gcsfs is a stable, actively maintained library (latest release 2026-08-13, 395 GitHub stars) with no known vulnerabilities, permissive licensing, and low install friction. It is well-suited for data scientists and engineers needing seamless cloud storage integration, though you must have Google Cloud credentials configured.
Needs verification
- Whether the async API (asynchronous=True) is production-ready or still experimental
- Performance characteristics and latency overhead compared to direct google-cloud-storage calls
- Support status for Hierarchical Namespace and Rapid Buckets features mentioned in the description
Similar packages
permissive · top 100 on PyPI
fsspecunclear · top 100 on PyPI
requests-filepermissive · top 1,000 on PyPI
universal-pathlibpermissive · top 1,000 on PyPI
storage3permissive · top 1,000 on PyPI
gcloud-aio-storagepermissive · top 1,000 on PyPI
google-cloud-storage-transferpermissive · top 1,000 on PyPI
smart-openpermissive · top 1,000 on PyPI
huggingface-hubpermissive · top 100 on PyPI
pathablepermissive · top 1,000 on PyPI