supabase/supabase-py

这是什么？

核心功能

• 01通过 PostgREST API 在 Python 中查询 Postgres 表。
• 02借助 supabase_auth 处理用户认证与会话。
• 03使用 storage3 上传、下载和管理文件。
• 04借助 realtime-py 订阅数据实时变更。
• 05通过 supabase_functions 调用 Supabase 边缘函数。

适用场景

• 为 Flask、Django 或 FastAPI 应用接入 Supabase 数据库和登录功能。
• 编写数据导入脚本，将记录写入 Supabase 的 Postgres 数据库。
• 构建将用户文件存入 Supabase Storage 的 Python 服务。
• 在 Python 后端中接收数据库的实时变更。

快速上手

1. 1

   克隆仓库

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

   使用 uv 创建虚拟环境

   uv venv supabase-py
3. 3

   安装工作区依赖

   uv sync

使用前须知

• !README 仅介绍本地开发环境的搭建，并未说明如何在应用中安装使用这些库。
• !运行测试需要 Docker 和 Supabase CLI。

收录于专题

标签

常见问题

supabase-py 是什么？

Supabase 官方 Python 客户端库合集，涵盖 Postgres 查询、认证、存储、实时订阅和边缘函数。 supabase-py 是 Supabase 官方的 Python 客户端库单体仓库，把各项服务拆分为独立包发布。其中 postgrest 通过 PostgREST API 查询 Postgres，supabase_auth 负责用户认证，storage3 用于文件存储，realtime-py 提供实时数据流，supabase_functions 用于调用边缘函数，顶层的 supabase 包则将这些能力整合为统一客户端。

supabase-py 可以免费使用吗？用的什么许可证？

supabase-py 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

supabase-py 还在维护吗？

活跃维护中。supabase-py 最近一次提交是在 2026年11月6日。

supabase-py 适合用来做什么？

为 Flask、Django 或 FastAPI 应用接入 Supabase 数据库和登录功能。 编写数据导入脚本，将记录写入 Supabase 的 Postgres 数据库。 构建将用户文件存入 Supabase Storage 的 Python 服务。 在 Python 后端中接收数据库的实时变更。

supabase-py 怎么安装和运行？

克隆仓库: git clone https://github.com/supabase/supabase-py.git 使用 uv 创建虚拟环境: uv venv supabase-py 安装工作区依赖: uv sync

在哪里获取 supabase-py？

源代码和安装说明在 GitHub 上：https://github.com/supabase/supabase-py