---
id: tensorflow-io-gcs-filesystem
version: "0.37.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# tensorflow-io-gcs-filesystem — TensorFlow IO

License: permissive · Maintenance: active · Downloads: 6.5M/mo

## What it is and what it does

tensorflow-io-gcs-filesystem is a TensorFlow I/O extension that adds Google Cloud Storage filesystem support to TensorFlow. It allows you to read and write data directly from GCS buckets within TensorFlow data pipelines, eliminating the need to download datasets locally before processing. The package integrates with tf.data.Dataset and Keras workflows to stream data from cloud storage.

The package is distributed as platform-specific compiled wheels for Python 3.7–3.12 on macOS (x86_64 and ARM64) and Linux (x86_64 and aarch64). It has no runtime dependencies beyond TensorFlow itself and is actively maintained, with the latest release (0.37.1) compatible with TensorFlow 2.16.x. Installation requires matching your TensorFlow version to the compatibility table provided in the documentation.

Use it for:

- Load training datasets directly from GCS URLs in machine learning workflows without downloading to disk first.
- Stream large datasets from cloud storage in data pipelines for memory-efficient processing.
- Access public datasets hosted on GCS via HTTP/HTTPS URLs in TensorFlow code.
- Build data preprocessing workflows that read raw data from GCS and write processed results back to cloud storage.
- Integrate GCS file access into distributed TensorFlow training on Google Cloud Platform infrastructure.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Google Cloud Storage filesystem support for TensorFlow, enabling direct reading and writing of data from GCS buckets within TensorFlow pipelines without local downloads.

Yes, if you are building TensorFlow pipelines that consume data from Google Cloud Storage and want to avoid local downloads. Install only if your TensorFlow version matches the compatibility table (0.37.1 requires TensorFlow 2.16.x). No known vulnerabilities. Medium install friction due to compiled wheels, but straightforward once the correct TensorFlow version is in place.

## Install

pip install tensorflow-io-gcs-filesystem
uv add tensorflow-io-gcs-filesystem
poetry add tensorflow-io-gcs-filesystem

## Installing tensorflow-io-gcs-filesystem

Before you install: Medium install friction due to platform-specific compiled wheels (cp39–cp312 across macOS and Linux architectures). Actively maintained with recent commits; compatible with TensorFlow 2.16.x per version table.

License in practice: Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install tensorflow-io-gcs-filesystem

# Read dataset directly from GCS URLs
dataset_url = "https://storage.googleapis.com/cvdf-datasets/mnist/"
d_train = tfio.IODataset.from_mnist(
    dataset_url + "train-images-idx3-ubyte.gz",
    dataset_url + "train-labels-idx1-ubyte.gz"
)
d_train = d_train.batch(32)

Requires TensorFlow 2.16.x installed; Python 3.7–3.12 supported; GCS credentials must be configured in your environment.

Verify before relying:

- Whether this package is a standalone filesystem plugin or requires the full tensorflow-io package as a peer dependency.
- Exact GCS authentication method expected (Application Default Credentials, service account key, etc.).
- Performance characteristics when reading large datasets from GCS vs. local storage.
- Whether automatic decompression of gzipped files is supported by this filesystem component.

## Package facts

- License: not declared (permissive)
- Python support: capped_below_current
- Install friction: medium
- Maintenance: active
- Downloads: 6.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tensorflow gcs filesystem, google cloud storage tensorflow, tensorflow io gcs, read gcs files tensorflow, cloud storage integration tensorflow, tensorflow-extension, cloud-storage, data-pipeline

[View on SkillFed](https://skillfed.io/packages/tensorflow-io-gcs-filesystem) · [View on PyPI](https://pypi.org/project/tensorflow-io-gcs-filesystem/)