---
id: minio
version: "7.2.20"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# minio — MinIO Python SDK for Amazon S3 Compatible Cloud Storage

License: permissive · Maintenance: active · Downloads: 12.9M/mo

## 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 above — 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

pip install minio
uv add minio
poetry add minio

## Installing 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_current
- Install friction: low
- Maintenance: active
- Downloads: 12.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

s3 compatible object storage client, minio python sdk, amazon s3 api wrapper, cloud storage file upload, bucket management python, object storage sdk, s3-like storage client, s3-compatible, object-storage, cloud-storage

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