minio
MinIO Python SDK for Amazon S3 Compatible Cloud Storage
What it is and what it does
The MinIO Python SDK is a client library for interacting with MinIO object storage or any Amazon S3-compatible service. It abstracts the underlying S3 API into high-level Python methods for common operations like bucket creation, file upload and download, object listing, and metadata management. The library handles authentication, HTTP communication via urllib3, and cryptographic operations through its dependencies.
Typical usage involves instantiating a Minio client with an endpoint URL and credentials, then calling methods to manage buckets and objects. The SDK is production-stable, actively maintained, and supports modern Python versions (3.9 through 3.13). It carries no known security vulnerabilities and uses permissive licensing, making it suitable for both open-source and commercial projects.
Use it for:
- Upload and download files to a MinIO cluster or S3-compatible storage from a Python application.
- Programmatically create and manage buckets and set access policies on object storage.
- Integrate cloud object storage into data processing pipelines or web applications.
- Migrate files between local storage and MinIO or S3-compatible services.
- Build backup or archival workflows that store objects in S3-compatible storage.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides high-level Python APIs to connect to MinIO or Amazon S3-compatible object storage services for uploading, downloading, and managing files and buckets.
Yes. The package is production-stable, actively maintained, has zero known vulnerabilities, low install friction, and permissive licensing. It is the standard way to interact with MinIO and S3-compatible storage from Python. Install it if you need to work with object storage in your application.
Install
minio on PyPI
pip
pip install miniouv
uv add miniopoetry
poetry add minioInstalling minio
Before you install
Low install friction with a pure-Python wheel distribution. Actively maintained with recent releases and no known vulnerabilities. Runtime dependencies are well-established cryptography and HTTP libraries.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects including proprietary applications.
Quickstart
pip install minio
from minio import Minio
client = Minio("play.min.io",
access_key="Q3AM3UQ867SPQQA43P2F",
secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
)
client.make_bucket("my-bucket")
client.fput_object("my-bucket", "object-name", "/path/to/file")
Requires Python 3.9 or later; credentials (access key and secret key) for the target MinIO or S3-compatible service.
Verify before relying
- Whether the SDK supports concurrent uploads or download operations and any performance characteristics.
- Details on retry behavior, timeout handling, and connection pooling for production workloads.
- Whether multipart upload is handled automatically or requires explicit configuration.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.9) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 5 — argon2-cffi, certifi, pycryptodome, typing-extensions, urllib3 |
| Maintenance | actively maintained — 260 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 12,925,957/month — #1,302 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: minio-7.2.20-py3-none-any.whl
Tags
More Python Modules packages
Converts domain names between Unicode and…
permissive · top 100 on PyPI
setuptoolsSetuptools is a Python build backend and…
permissive · top 100 on PyPI
PyYAMLPyYAML parses and emits YAML 1.1 data format,…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
annotated-typesProvides reusable metadata objects for use with…
permissive · top 100 on PyPI
typing-inspectionProvides runtime tools to inspect and…
permissive · top 100 on PyPI
miniopy-asyncAsynchronous Python client for MinIO object…
permissive · top 15,000 on PyPI
git-remote-s3Enables Git to use Amazon S3 as a remote…
permissive · top 15,000 on PyPI
snakemake-storage-plugin-s3Enables Snakemake workflows to read from and…
permissive · top 15,000 on PyPI
synapse-s3-storage-providerA Synapse media storage provider that…
permissive · top 15,000 on PyPI
deadline-job-attachmentsTransfers files between workstations and AWS…
permissive · top 15,000 on PyPI
s3fss3fs provides a Python filesystem interface to…
permissive · top 100 on PyPI
tosA Python SDK for interacting with Volcengine's…
unclear · top 15,000 on PyPI
pathyPathy provides a pathlib-compatible interface…
permissive · top 5,000 on PyPI
fs-s3fsS3FS provides a PyFilesystem interface to…
permissive · top 15,000 on PyPI
storage3Async Python client library for uploading,…
permissive · top 1,000 on PyPI