fs-s3fs
Amazon S3 filesystem for PyFilesystem2
Decision gist · record as of 2026-08-14
Yes, if you need PyFilesystem integration with S3 and can accept dormant maintenance. The package is stable and has no known vulnerabilities, but the last release was 2019-08-14—verify compatibility with your current boto3 and PyFilesystem2 versions before relying on it for new projects. Low install friction and permissive licensing make it reasonable for existing codebases already using PyFilesystem.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires AWS credentials configured (via environment variables, config file, or IAM role) for S3 access.
- Low install friction with no runtime dependencies.
- Maintenance is dormant—last release was 2019-08-14, though the repository remains active with a recent commit in 2024-07-16.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
last release 2019-08-14 (2557 days) · last repo commit 2024-07-16 · 157 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 259,607 downloads/mo, #8,410 on PyPI
Alternatives
Verify before relying
pip install fs-s3fs
from fs_s3fs import S3FS
s3fs = S3FS('mybucket')
# Or via FS URL:
from fs import open_fs
s3fs = open_fs('s3://mybucket')- Whether the package works reliably with modern versions of boto3 and PyFilesystem2, given the last release was in 2019.
- Current compatibility with Python versions beyond 3.7, as classifiers only list up to 3.7.
- Whether upload_args and download_args features remain fully functional with current S3 API.
What it is and what it does
S3FS wraps Amazon S3 storage in a PyFilesystem interface, so you can treat S3 buckets like local directories. You open an S3FS instance by bucket name or URL, then use standard file operations—open, read, write, copy—exactly as you would with a local filesystem. The package handles the translation to S3 API calls behind the scenes.
It supports both basic file operations and S3-specific features like cache-control headers, ACLs, and public URL generation. You can mirror local directories to S3, download files to disk, or upload files from your filesystem to S3 using the same PyFilesystem copy and mirror tools you'd use for any other filesystem.
Use it for
- Mirror a local directory tree to S3 with custom cache-control and ACL settings for all uploaded objects.
- Download files from an S3 bucket to local disk using standard filesystem read operations.
- Generate public URLs for files stored in S3 without manually constructing them.
- Treat S3 as a drop-in replacement for local storage in code that already uses PyFilesystem.
- Upload files to S3 with metadata like cache-control headers set per-operation or per-instance.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need PyFilesystem integration with S3 and can accept dormant maintenance.
The package is stable and has no known vulnerabilities, but the last release was 2019-08-14—verify compatibility with your current boto3 and PyFilesystem2 versions before relying on it for new projects. Low install friction and permissive licensing make it reasonable for existing codebases already using PyFilesystem.
Install
fs-s3fs on PyPI
Before you install
Low install friction with no runtime dependencies. Maintenance is dormant—last release was 2019-08-14, though the repository remains active with a recent commit in 2024-07-16.
Requires AWS credentials configured (via environment variables, config file, or IAM role) for S3 access.
License in practice
MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.
Quickstart
pip install fs-s3fs
from fs_s3fs import S3FS
s3fs = S3FS('mybucket')
# Or via FS URL:
from fs import open_fs
s3fs = open_fs('s3://mybucket')Verify before relying
- Whether the package works reliably with modern versions of boto3 and PyFilesystem2, given the last release was in 2019.
- Current compatibility with Python versions beyond 3.7, as classifiers only list up to 3.7.
- Whether upload_args and download_args features remain fully functional with current S3 API.
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 2,557 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 259,607 / month, #8,410 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 :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2.7Programming Language :: Python :: 3.3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Topic :: System :: Filesystems |
Evidence: fs_s3fs-1.1.1-py2.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 › “s3 filesystem interface”
- fs-s3fsS3FS provides a PyFilesystem interface to Amazon S3, letting you…
- s3fss3fs provides a Python filesystem interface to Amazon S3, allowing…
- fsspecfsspec provides a unified filesystem interface specification and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Filesystems packages
Watches file system changes and triggers callbacks or process restarts when files are modified, with both synchronous and asynchronous APIs.
Install it if you need file system monitoring for development or production workflows.
Watchdog monitors file system events across Linux, macOS, Windows, and BSD, providing a Python API and command-line utilities to detect file and directory changes in real time.
Install it if you need to monitor file system events; the medium install friction is a one-time cost for reliable, platform-native behavior.
Portalocker provides cross-platform file locking with support for exclusive and shared locks, plus Redis-based distributed locks and process-aware PID file locking.
Install it if you need file or process coordination; the optional extras (pywin32, redis) are only required for specific lock types.
Infers file type and MIME type by examining magic number signatures in files or byte buffers, with no external dependencies.
However, the last release was 2022-11-02 with no recent commits, so it may not support the newest file formats or receive bug fixes promptly.
Sanitize and validate filenames and file paths by removing or replacing invalid characters, reserved names, and unprintable characters across multiple platforms (Linux, Windows, macOS, POSIX, and universal).
Install it if you need reliable filename or path validation across platforms; the low friction and clear API make it a straightforward addition to any project…
Provides object-oriented filesystem path handling as a backport for Python versions before 3.4, when pathlib became part of the standard library.
See also s3fs · python-fsutil · fs · dvc-s3 · fs.sshfs · littlefs-python · s5cmd · synapse-s3-storage-provider · fsspec · s3urls