miniopy-async

What it is and what it does

miniopy-async is an asynchronous Python SDK for MinIO, an S3-compatible object storage system. It wraps MinIO operations—uploads, downloads, bucket management, presigned URLs—in async/await patterns, allowing non-blocking I/O in event-driven applications. The client depends on aiohttp for HTTP transport, certifi for SSL certificates, aiohttp-retry for resilience, argon2-cffi for password hashing, and pycryptodome for cryptographic operations.

You instantiate a Minio client with endpoint, credentials, and SSL settings, then use async context managers and await calls to interact with buckets and objects. The package is marked Production/Stable, actively maintained, and supports current Python versions (3.10–3.13). It carries no known vulnerabilities and is licensed under Apache-2.0, making it suitable for commercial projects.

Use it for:

• Build async web services (e.g., Sanic, FastAPI) that upload or download files from MinIO without blocking request handlers.
• Generate presigned URLs for temporary object access in async workflows.
• Manage object metadata and bucket operations in event-driven applications.
• Integrate MinIO storage into async data pipelines or background job systems.
• Replace synchronous S3 clients in async codebases targeting MinIO or S3-compatible endpoints.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Asynchronous Python client for MinIO object storage, enabling non-blocking operations to upload, download, and manage objects in MinIO or S3-compatible buckets.

Yes. The package is actively maintained, carries no known vulnerabilities, has low install friction, and is the natural choice for async MinIO access in Python. Use it if you need non-blocking object storage in an async application; skip it only if you require synchronous I/O or have no MinIO/S3-compatible backend.

Install

miniopy-async on PyPI

pip install miniopy-async

uv add miniopy-async

poetry add miniopy-async

Installing miniopy-async

Before you install

Low friction: pure Python wheel with five runtime dependencies (aiohttp, certifi, aiohttp-retry, argon2-cffi, pycryptodome). Active maintenance—last commit 2026-03-31, status marked active, no reported vulnerabilities.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.

Quickstart

pip install miniopy-async

from miniopy_async import Minio
import asyncio

async def main():
    async with Minio("play.min.io", access_key="...", secret_key="...", secure=True) as client:
        url = await client.presigned_get_object("my-bucket", "my-object")
        print(url)

asyncio.run(main())

Requires Python 3.10 or later (supports 3.10, 3.11, 3.12, 3.13).

Verify before relying

• Whether the package handles concurrent requests efficiently under high load.
• Performance characteristics compared to synchronous MinIO clients.
• Completeness of MinIO API coverage in async form.

Package facts

Evidence: miniopy_async-1.23.5-py3-none-any.whl

Tags

More Python Modules packages