Skip to main content

MinIO Python SDK for Amazon S3 Compatible Cloud Storage Slack

MinIO Python SDK is Simple Storage Service (aka S3) client to perform bucket and object operations to any Amazon S3 compatible object storage service.

For a complete list of APIs and examples, please take a look at the Python Client API Reference

Minimum Requirements

Python 3.7 or higher.

Download using pip

pip3 install minio

Download source

git clone https://github.com/minio/minio-py
cd minio-py
python setup.py install

Quick Start Example - File Uploader

This example program connects to an S3-compatible object storage server, make a bucket on that server, and upload a file to the bucket.

You need the following items to connect to an S3-compatible object storage server:

Parameters Description
Endpoint URL to S3 service.
Access Key Access key (aka user ID) of an account in the S3 service.
Secret Key Secret key (aka password) of an account in the S3 service.

This example uses MinIO server playground https://play.min.io. Feel free to use this service for test and development.

file_uploader.py

from minio import Minio
from minio.error import S3Error


def main():
    # Create a client with the MinIO server playground, its access key
    # and secret key.
    client = Minio(
        "play.min.io",
        access_key="Q3AM3UQ867SPQQA43P2F",
        secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
    )

    # Make 'asiatrip' bucket if not exist.
    found = client.bucket_exists("asiatrip")
    if not found:
        client.make_bucket("asiatrip")
    else:
        print("Bucket 'asiatrip' already exists")

    # Upload '/home/user/Photos/asiaphotos.zip' as object name
    # 'asiaphotos-2015.zip' to bucket 'asiatrip'.
    client.fput_object(
        "asiatrip", "asiaphotos-2015.zip", "/home/user/Photos/asiaphotos.zip",
    )
    print(
        "'/home/user/Photos/asiaphotos.zip' is successfully uploaded as "
        "object 'asiaphotos-2015.zip' to bucket 'asiatrip'."
    )


if __name__ == "__main__":
    try:
        main()
    except S3Error as exc:
        print("error occurred.", exc)

Run File Uploader

$ python file_uploader.py
'/home/user/Photos/asiaphotos.zip' is successfully uploaded as object 'asiaphotos-2015.zip' to bucket 'asiatrip'.

$ mc ls play/asiatrip/
[2016-06-02 18:10:29 PDT]  82KiB asiaphotos-2015.zip

More References

Explore Further

Contribute

Please refer Contributors Guide

PYPI

Release files for minio 7.1.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for minio 7.1.16
File Size Uploaded
minio-7.1.16.tar.gz 120.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for minio 7.1.16
File Interpreter ABI Platform
minio-7.1.16-py3-none-any.whl Python 3 none any Details

Total release size: 198.0 kB

Release files / minio-7.1.16.tar.gz

Download URL minio-7.1.16.tar.gz
Size 120.1 kB
Tags Source
SHA-256 checksum
How to use checksums
56ecb1e7e0103d2dc212fb460fdb70ab2abb7fa5685db378429325d96d95587a
BLAKE2b-256 checksum
How to use checksums
5d7ba867aab021c433abf68adf00a0fb627dc0935ee98a92685aee1cbc93ddc2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.12

Release files / minio-7.1.16-py3-none-any.whl

Download URL minio-7.1.16-py3-none-any.whl
Size 77.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8073bed2b4b1853f3d69ab2f01a0de86264071083032985921201cfbb0950b15
BLAKE2b-256 checksum
How to use checksums
9aaec20305102e32f078ec5e77a5010378318307a2de213f61be6c5facb56f0f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.12

Release history Release notifications | RSS feed

7.2.20

2 release files

7.2.19

2 release files

7.2.18

2 release files

7.2.17

2 release files

7.2.16

2 release files

7.2.15

2 release files

7.2.13

2 release files

7.2.12

2 release files

7.2.11

2 release files

7.2.10

2 release files

7.2.9

2 release files

7.2.8

2 release files

7.2.7

2 release files

7.2.6

2 release files

7.2.5

2 release files

7.2.4

2 release files

7.2.3

2 release files

7.2.2

2 release files

7.2.1

2 release files

7.2.0

2 release files

7.1.17

2 release files

This release

7.1.16 This release

2 release files

7.1.15

2 release files

7.1.14

2 release files

7.1.12

2 release files

7.1.11

2 release files

7.1.9

2 release files

7.1.8

2 release files

7.1.7

2 release files

7.1.6

2 release files

7.1.5

2 release files

7.1.4

2 release files

7.1.3

2 release files

7.1.2

2 release files

7.1.1

2 release files

7.1.0

2 release files

7.0.4

2 release files

7.0.3

2 release files

7.0.2

2 release files

7.0.1

2 release files

7.0.0

2 release files

6.0.2

3 release files

6.0.1

3 release files

6.0.0

3 release files

5.0.10

3 release files

5.0.9

3 release files

5.0.8

3 release files

5.0.7

3 release files

5.0.6

3 release files

5.0.5

3 release files

5.0.4

2 release files

5.0.3

3 release files

5.0.1

3 release files

5.0.0

3 release files

4.0.21

3 release files

4.0.20

3 release files

4.0.18

3 release files

4.0.17

3 release files

4.0.15

3 release files

4.0.14

3 release files

4.0.13

3 release files

4.0.12

3 release files

4.0.11

3 release files

4.0.10

3 release files

4.0.9

3 release files

4.0.8

3 release files

4.0.7

3 release files

4.0.6

3 release files

4.0.5

3 release files

4.0.4

3 release files

4.0.3

3 release files

4.0.2

3 release files

4.0.1

3 release files

4.0.0

3 release files

3.0.4

3 release files

3.0.3

3 release files

3.0.2

3 release files

3.0.1

3 release files

3.0.0

3 release files

2.2.6

4 release files

2.2.5

2 release files

2.2.4

2 release files

2.2.3

3 release files

2.2.2

3 release files

2.2.1

3 release files

2.2.0

3 release files

2.1.0

3 release files

2.0.8

3 release files

2.0.7

3 release files

2.0.6

3 release files

2.0.5

3 release files

2.0.4

3 release files

2.0.3

3 release files

2.0.2

3 release files

2.0.1

3 release files

2.0.0

3 release files

1.0.2

3 release files

1.0.1

3 release files

1.0.0

3 release files

0.2.9

3 release files

0.2.8

3 release files

0.2.6

3 release files

0.2.5

3 release files

0.2.4

3 release files

0.2.3

3 release files

0.2.2

3 release files

0.2.1

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page