storage3
Supabase Storage client for Python.
Decision gist · record as of 2026-08-14
Yes, if you are using Supabase and need async file storage operations in Python. The library is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. The async-only design and requirement for Supabase credentials are not drawbacks but intentional constraints. Consider it essential if Supabase Storage is your backend; otherwise, it has no value.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later; all operations are async and must be called within an async context.
- Low friction install with a pure-Python wheel.
- Actively maintained with recent commits and a stable release cycle; last release was 71 days ago and the repository shows 2557 stars.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions; suitable for most projects.
last release 2026-06-04 (71 days) · last repo commit 2026-08-12 · 2,557 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 37,103,634 downloads/mo, #729 on PyPI
Alternatives
Verify before relying
pip install storage3
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)
await storage_client.list_buckets()- Whether the package works with Supabase Storage exclusively or supports other S3-compatible backends.
- Performance characteristics and rate limits when handling large files or high-volume uploads.
- Whether error handling and retry logic are built in or require manual implementation.
What it is and what it does
storage3 is an async Python client for Supabase Storage, the file management service built into Supabase. It wraps the Supabase Storage HTTP API, allowing you to list buckets, upload files with custom MIME types, download files, and manage storage operations programmatically. The library uses httpx for async HTTP requests and integrates with pydantic for data validation and yarl for URL handling.
The package is designed to be used either directly (by constructing an AsyncStorageClient with your Supabase credentials) or through the higher-level Supabase Python Client. All operations are async-first, so you'll need to run them in an async context. The library handles authentication via headers and supports bucket-level operations and file uploads with configurable content types.
Use it for
- Upload user-generated content (images, documents) to Supabase Storage from a Python backend.
- Build a file management system that lists, downloads, and deletes files from Supabase buckets.
- Integrate file storage into async web frameworks like FastAPI or Starlette.
- Automate bulk file operations or migrations to Supabase Storage from other systems.
- Manage file metadata and organize uploads by bucket and folder structure.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are using Supabase and need async file storage operations in Python.
The library is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. The async-only design and requirement for Supabase credentials are not drawbacks but intentional constraints. Consider it essential if Supabase Storage is your backend; otherwise, it has no value.
Install
storage3 on PyPI
Before you install
Low friction install with a pure-Python wheel. Actively maintained with recent commits and a stable release cycle; last release was 71 days ago and the repository shows 2557 stars.
Requires Python 3.9 or later; all operations are async and must be called within an async context.
License in practice
MIT license permits commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install storage3
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)
await storage_client.list_buckets()Verify before relying
- Whether the package works with Supabase Storage exclusively or supports other S3-compatible backends.
- Performance characteristics and rate limits when handling large files or high-volume uploads.
- Whether error handling and retry logic are built in or require manual implementation.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packageshttpxdeprecationpydanticyarl |
| Maintenance | Actively maintained 71 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 37,103,634 / month, #729 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: storage3-2.31.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “supabase storage python client”
- storage3Async Python client library for uploading, downloading, and managing…
- supabasePython client library for Supabase that provides unified access to…
- supafuncSupafunc provides a Python client library for invoking Supabase…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also supabase · supabase-auth · supabase-functions · realtime · supafunc · gotrue · filestack-python · minio · gsutil · kbcstorage