menelsystems/files-sdk-py

files-sdk is a Python library that gives you one consistent API for working with files across multiple cloud storage providers. Instead of learning the unique client library for each storage service you want to use, you write the same upload/download/stream calls and just swap out the adapter (the provider-specific connector) to change where files actually go. The library ships adapters for Amazon S3, Cloudflare R2, UploadThing, MinIO, DigitalOcean Spaces, Hetzner Object Storage, Linode Object Storage, Storj DCS, and a local filesystem adapter useful for development and testing. A further ten adapters are in progress, including one for Akamai NetStorage. Each adapter comes in both a synchronous and an asynchronous flavor with identical method names and return types, so switching between them requires minimal changes to your code. The core pattern shown in the README is straightforward: create a Files (or AsyncFiles) object, pass in your chosen adapter, then call upload, download, or stream. The local adapter requires no cloud credentials, making it easy to build and test without touching any external service. You can also look up an adapter by name string using Files.from_name() if you want to select the provider dynamically. The project is a Python port of the files-sdk.dev SDK. It targets Python 3.11 and above, uses pytest for testing, pyright for type checking, and ruff for linting. Packages are installed via the uv package manager, though standard pip also works.