---
id: miniopy-async
version: "1.23.5"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# miniopy-async — Asynchronous MinIO Client SDK for Python

License: permissive · Maintenance: active · Downloads: 265.4K/mo

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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 265.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

async minio client, s3 object storage async, minio sdk python async, asynchronous file upload download, object storage client, minio presigned urls, async s3 compatible, async-io, object-storage, s3-compatible

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