---
id: s3path
version: "0.6.5"
license: Apache 2.0
license_treatment: permissive
maintenance: aging
---

# s3path

License: permissive · Maintenance: aging · Downloads: 2.9M/mo

## What it is and what it does

S3Path wraps boto3's S3 resource with a pathlib-compatible API, so you can treat S3 buckets and keys like a local filesystem. Instead of learning boto3's object-oriented methods (put_object, list_objects, etc.), you use familiar pathlib patterns: iterdir() to list contents, glob() to find matching keys, the / operator to navigate paths, and open() to read or write objects. It also supports versioned S3 objects through a VersionedS3Path subclass.

The package depends on boto3 for AWS communication and smart-open for file-like access to S3 objects. It supports modern Python versions (3.9–3.13) and is classified as Beta. The maintainer has kept it active, though releases are infrequent; no known security vulnerabilities are recorded.

Use it for:

- List and navigate S3 bucket contents using pathlib-style iteration and path operations instead of boto3 API calls.
- Batch process files in S3 using glob patterns to find matching keys across nested prefixes.
- Read or write S3 objects via context managers (with open()) as if they were local files.
- Work with versioned S3 buckets by tracking and accessing specific object versions.
- Migrate local filesystem code to S3 with minimal refactoring by swapping pathlib.Path for S3Path.

## Worth the install?

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

S3Path provides a pathlib-like interface for working with AWS S3 buckets and objects, letting you navigate, query, and manipulate S3 storage using familiar filesystem operations.

Yes, if you work regularly with S3 and prefer pathlib's ergonomics over boto3's API. Install friction is low, dependencies are stable, and the license is permissive. The aging maintenance status and infrequent releases are a minor concern but not a blocker—the package is stable and actively maintained. No security vulnerabilities are known.

## Install

pip install s3path
uv add s3path
poetry add s3path

## Installing s3path

Before you install: Low friction: pure Python wheel with only two runtime dependencies (boto3 and smart-open). Maintenance is aging—last release was 202 days ago—but the repo is active and not archived, with a recent commit on 2026-01-24.

License in practice: Apache 2.0 is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

from s3path import S3Path
bucket_path = S3Path('/my-bucket/')
for item in bucket_path.iterdir():
    print(item)

Requires AWS credentials configured (via environment variables, IAM role, or AWS config file) so boto3 can authenticate to S3.

Verify before relying:

- Performance characteristics when working with very large S3 buckets or deeply nested key hierarchies.
- Whether all pathlib methods are fully implemented or if some operations have S3-specific limitations.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 2.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

s3 pathlib interface, aws s3 file operations, s3 path navigation, boto3 s3 wrapper, cloud storage path api, s3 object listing and access, aws-s3, pathlib-wrapper

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