pathy
pathlib.Path subclasses for local and cloud bucket storage
Decision gist · record as of 2026-08-14
Yes. Pathy is actively maintained, has no known vulnerabilities, and solves a real friction point—unifying cloud storage APIs under a familiar interface. Install it if you work across multiple cloud providers or want to defer cloud decisions during development. The Apache-2.0 license is unrestrictive. Only caveat: pre-v1.0 status means minor version bumps can break the API, so pin your version range if stability is critical.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Cloud operations require appropriate credentials (JSON file for GCS/S3, connection string for Azure) configured via set_client_params().
- Low friction installation with a pure-Python wheel.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing free use in commercial and private projects with minimal restrictions—just retain the license notice.
last release 2026-04-11 (125 days) · last repo commit 2026-07-24 · 176 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,018,352 downloads/mo, #3,359 on PyPI
Alternatives
Verify before relying
# Install for Google Cloud Storage
pip install pathy[gcs]
from pathy import Pathy, use_fs
# Use local filesystem during development
use_fs()
# Create and write to a cloud path
greeting = Pathy("gs://my_bucket/greeting.txt")
greeting.write_text("Hello World!")
assert greeting.exists()- Performance characteristics when working with large numbers of blobs or very large files
- Caching behavior details and cache invalidation strategy
- Exact feature parity with pathlib.Path across all methods
What it is and what it does
Pathy is a pathlib subclass that lets you treat cloud buckets (Google Cloud Storage, S3, Azure) as if they were local filesystems. Instead of learning separate APIs for each cloud provider, you write code using familiar Path operations like `.exists()`, `.write_text()`, `.glob()`, and `.mkdir()`, and Pathy translates them to the underlying bucket API.
The package is designed for developers who want to prototype locally using the filesystem, then deploy to cloud storage without rewriting code. It handles credential setup per provider, supports both local and cloud paths through a fluid interface, and includes a CLI tool. Since it's built on pathlib-abc and smart-open, it integrates cleanly with Python's standard path ecosystem.
Use it for
- Develop machine learning pipelines locally with filesystem paths, deploy to S3 or GCS without code changes
- Build data processing scripts that work uniformly across local, S3, GCS, and Azure blob storage
- Migrate legacy code from local file I/O to cloud storage by swapping path prefixes
- Write cloud-agnostic tools that users can point at any supported bucket provider
- Simplify blob enumeration and metadata queries with glob patterns and stat operations
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Pathy is actively maintained, has no known vulnerabilities, and solves a real friction point—unifying cloud storage APIs under a familiar interface. Install it if you work across multiple cloud providers or want to defer cloud decisions during development. The Apache-2.0 license is unrestrictive. Only caveat: pre-v1.0 status means minor version bumps can break the API, so pin your version range if stability is critical.
Install
pathy on PyPI
Before you install
Low friction installation with a pure-Python wheel. Maintenance is active with recent releases and no known vulnerabilities. Runtime dependencies are minimal (pathlib-abc and smart-open), both lightweight utilities.
Requires Python 3.10 or later. Cloud operations require appropriate credentials (JSON file for GCS/S3, connection string for Azure) configured via set_client_params().
License in practice
Licensed under Apache-2.0 (permissive), allowing free use in commercial and private projects with minimal restrictions—just retain the license notice.
Quickstart
# Install for Google Cloud Storage
pip install pathy[gcs]
from pathy import Pathy, use_fs
# Use local filesystem during development
use_fs()
# Create and write to a cloud path
greeting = Pathy("gs://my_bucket/greeting.txt")
greeting.write_text("Hello World!")
assert greeting.exists()Verify before relying
- Performance characteristics when working with large numbers of blobs or very large files
- Caching behavior details and cache invalidation strategy
- Exact feature parity with pathlib.Path across all methods
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespathlib-abcsmart-open |
| Maintenance | Actively maintained 125 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,018,352 / month, #3,359 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 :: DevelopersLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13 |
Evidence: pathy-0.14.2-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 › “cloud storage path interface”
- pathyPathy provides a pathlib-compatible interface for working with cloud…
- cloudpathlibProvides pathlib-style classes for reading, writing, and managing…
- universal-pathlibUniversal Pathlib provides a pathlib.Path-like interface for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also cloudpathlib · blobfile · pathlib-abc · provide-dir · s3fs · s3pathlib · minio · s3path · path.py · smart-open