storage3 2.28.3


pip install storage3

  Latest version

Released: Mar 20, 2026


Meta
Author: Joel Lee, Leon Fedden, Daniel Reinón García, Leynier Gutiérrez González, Anand Krishna
Maintainer: Leonardo Santiago
Requires Python: >=3.9

Classifiers

Programming Language
  • Python :: 3

License
  • OSI Approved :: MIT License

Operating System
  • OS Independent

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

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:

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.

Wheel compatibility matrix

Platform Python 3
any

Files in release

Extras: None
Dependencies:
httpx[http2] (<0.29,>=0.26)
deprecation (>=2.1.0)
pydantic (>=2.11.7)
yarl (>=1.20.1)
pyiceberg (>=0.10.0)