Repolode
Submit
supabase

supabase/supabase-py

Official Python monorepo of client libraries for Supabase, covering Postgres queries, auth, storage, realtime and edge functions.

View on GitHubWebsite
Stars
2,632
Forks
614
Open issues
72
Last commit
23 hours ago

What is it?

supabase-py is the official Python monorepo for Supabase client libraries. It bundles separate packages for the main Supabase services: postgrest for querying Postgres through the PostgREST API, supabase_auth for user authentication, storage3 for file storage, realtime-py for realtime data streams, and supabase_functions for invoking edge functions. The top-level supabase package combines these into a single client.

The library is aimed at Python developers building backends or scripts on top of a Supabase project, including apps written with Flask, Django or FastAPI. Developers can read and write database tables, manage user sign-ups and sessions, upload and download files, and subscribe to live changes from Python code.

The repository uses uv for workspace management, with make targets for running tests per package. Tests rely on Docker and the Supabase CLI for local test containers.

Key features

  • 01Query Postgres tables through the PostgREST API from Python.
  • 02Handle user authentication and sessions via supabase_auth.
  • 03Upload, download and manage files with storage3.
  • 04Subscribe to realtime data changes with realtime-py.
  • 05Invoke Supabase edge functions with supabase_functions.

Use cases

  • Adding a Supabase-backed database and login to a Flask, Django or FastAPI app.
  • Writing data-loading scripts that push records into a Supabase Postgres database.
  • Building Python services that store user files in Supabase Storage.
  • Consuming live database changes from a Python backend.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/supabase/supabase-py.git
  2. 2

    Create a virtual environment with uv

    uv venv supabase-py
  3. 3

    Install the workspace dependencies

    uv sync

Things to know

  • The README covers only local development setup, not installing the libraries for application use.
  • Running the tests requires Docker and the Supabase CLI.

In collections

Data science courses & toolsLogin, SSO & identity servers

Topics

#postgres#authentication#file-storage#realtime#python-sdk#backend-as-a-service#auth#authorization#community#data-science

FAQ

What is supabase-py?
Official Python monorepo of client libraries for Supabase, covering Postgres queries, auth, storage, realtime and edge functions. supabase-py is the official Python monorepo for Supabase client libraries. It bundles separate packages for the main Supabase services: postgrest for querying Postgres through the PostgREST API, supabase_auth for user authentication, storage3 for file storage, realtime-py for realtime data streams, and supabase_functions for invoking edge functions. The top-level supabase package combines these into a single client.
Is supabase-py free to use? What license does it have?
supabase-py is open source under the MIT license. Check the license terms before using it in commercial products.
Is supabase-py still maintained?
Actively maintained. The last commit to supabase-py was on Nov 6, 2026.
What can I use supabase-py for?
Adding a Supabase-backed database and login to a Flask, Django or FastAPI app. Writing data-loading scripts that push records into a Supabase Postgres database. Building Python services that store user files in Supabase Storage. Consuming live database changes from a Python backend.
How do I install supabase-py?
Clone the repository: git clone https://github.com/supabase/supabase-py.git Create a virtual environment with uv: uv venv supabase-py Install the workspace dependencies: uv sync
Where can I get supabase-py?
The source code and installation instructions are on GitHub: https://github.com/supabase/supabase-py

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects