Supabase Storage client for Python.
Project Links
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.
2.28.3
Mar 20, 2026
2.28.2
Mar 13, 2026
2.28.1
Mar 13, 2026
2.28.0
Feb 10, 2026
2.27.3
Feb 03, 2026
2.27.2
Jan 14, 2026
2.27.1
Jan 06, 2026
2.27.0
Dec 16, 2025
2.26.0
Dec 15, 2025
2.25.1
Dec 10, 2025
2.25.0
Dec 03, 2025
2.24.0
Nov 07, 2025
2.23.3
Nov 06, 2025
2.23.2
Nov 03, 2025
2.23.1
Nov 03, 2025
2.23.0
Oct 31, 2025
2.22.4
Oct 30, 2025
2.22.3
Oct 28, 2025
2.22.2
Oct 24, 2025
2.22.1
Oct 21, 2025
2.22.0
Oct 08, 2025
2.21.1
Oct 03, 2025
2.21.0
Oct 03, 2025
2.20.0
Sep 22, 2025
2.19.0
Sep 17, 2025
0.12.2
Aug 15, 2025
0.12.1
Aug 05, 2025
0.12.0
Jun 19, 2025
0.11.3
Jan 29, 2025
0.11.2
Jan 29, 2025
0.11.1
Jan 23, 2025
0.11.0
Dec 30, 2024
0.10.0
Nov 22, 2024
0.9.0
Oct 31, 2024
0.8.2
Oct 18, 2024
0.8.1
Oct 03, 2024
0.8.0
Sep 28, 2024
0.7.7
Jul 14, 2024
0.7.6
Jun 05, 2024
0.7.5
Jun 04, 2024
0.7.4
Mar 23, 2024
0.7.3
Mar 11, 2024
0.7.2
Mar 10, 2024
0.7.1
Mar 10, 2024
0.7.0
Nov 22, 2023
0.6.1
Oct 02, 2023
0.6.0
Sep 28, 2023
0.5.4
Aug 04, 2023
0.5.3
Jul 24, 2023
0.5.2
Mar 05, 2023
0.5.1
Feb 22, 2023
0.5.0
Feb 05, 2023
0.4.0
Jan 10, 2023
0.3.6
Jan 05, 2023
0.3.5
Oct 10, 2022
0.3.4
Jun 07, 2022
0.3.3
Jun 06, 2022
0.3.2
May 16, 2022
0.3.1
May 01, 2022
0.3.0
Apr 30, 2022
0.2.0
Apr 11, 2022
0.1.1
Dec 25, 2021
0.1.0
Dec 25, 2021
Wheel compatibility matrix
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)