skillfed

gcsfs

Convenient Filesystem interface over GCS

gcsfs Permissive license BSD-3-Clause Active 395 v2026.8.0 released

Install

gcsfs on PyPI

pip

pip install gcsfs

uv

uv add gcsfs

poetry

poetry add gcsfs

Package 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

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14

About gcsfs

from the package's own PyPI description — quoted content, verbatim

gcsfs

|Build Status| |Docs|

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
google cloud storage python interfacegcs filesystem apicloud bucket file operationsfsspec gcs adaptergoogle cloud storage client librarycloud storage file system abstractiongcs python sdk

Similar packages