---
id: storage3
version: "2.31.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# storage3 — Supabase Storage client for Python.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install storage3
uv add storage3
poetry add storage3

## Description

# Storage-py

Python Client library to interact with Supabase Storage.

## How to use

As it takes some effort to get the headers. We suggest that you use the storage functionality through the main [Supabase Python Client](https://github.com/supabase-community/supabase-py)


```python3
from storage3 import AsyncStorageClient

url = "https://<your_supabase_id>.supabase.co/storage/v1"
key = "<your api key>"
headers = {"apiKey": key, "Authorization": f"Bearer {key}"}

storage_client = AsyncStorageClient(url, headers)

async def get_buckets():
  await storage_client.list_buckets()
```

### Uploading files
When uploading files, make sure to set the correct mimetype by using the `file_options` argument:
```py
async def file_upload():
  await storage_client.from_("bucket").upload("/folder/file.png", file_object, {"content-type": "image/png"})
```
If no mime type is given, the default `text/plain` will be used.

## AI interpretation — verify before relying

storage3 is an async Python client library for interacting with Supabase Storage, enabling you to upload, download, and manage files in Supabase buckets through a simple API.

Verdict: storage3 is a well-maintained, actively developed async client for Supabase Storage with no known vulnerabilities, permissive licensing, and low installation friction. It is suitable for production use if you are already using Supabase and need programmatic file management from Python.

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