---
id: gcsfs
version: "2026.8.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# gcsfs — Convenient Filesystem interface over GCS

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install gcsfs
uv add gcsfs
poetry add gcsfs

## Description

# gcsfs

[|Build Status|](https://github.com/fsspec/gcsfs/actions)
[|Docs|](https://gcsfs.readthedocs.io/en/latest/?badge=latest)

**GCSFS** is a Python library that provides a familiar, file-system-like interface to [Google Cloud Storage (GCS)](https://docs.cloud.google.com/storage/docs/introduction). Built on top of [fsspec](https://github.com/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:

```bash
# Using pip
pip install gcsfs

# OR using conda
conda install -c conda-forge gcsfs
```

### Basic Usage

```python
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...

## AI interpretation — verify before relying

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.

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.

[View on SkillFed](https://skillfed.io/packages/gcsfs) · [View on PyPI](https://pypi.org/project/gcsfs/)