---
id: gotrue
version: "2.12.4"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# gotrue — Python Client Library for Supabase Auth

License: permissive · Maintenance: abandoned · Downloads: 4.1M/mo

## What it is and what it does

Gotrue is a Python client library for Supabase Auth that provides authentication functionality including user sign-up, sign-in, token refresh, and JWT management. It wraps HTTP requests to Supabase's authentication endpoints using httpx, validates data with pydantic, and handles JWT tokens via pyjwt. The library supports modern Python versions (3.9 through 3.13) and has low installation friction with only three runtime dependencies.

However, this package is deprecated and abandoned. The maintainers replaced it with supabase_auth in December 2024 and ceased updates as of August 7, 2025. The repository is archived and will not receive bug fixes, security patches, or new features. Any new projects should use supabase_auth instead; existing projects using gotrue should plan a migration.

Use it for:

- Authenticate users against a Supabase backend in a Python application.
- Manage JWT tokens and session state for Supabase Auth-protected APIs.
- Integrate Supabase authentication into a Python web service or CLI tool.
- Refresh and validate authentication tokens for long-running processes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for Supabase Auth that handles authentication and JWT token management via HTTP requests.

No. The package is explicitly deprecated and abandoned as of August 2025 with no further updates planned. While it has low install friction and permissive licensing, installing a package known to be unmaintained introduces technical debt and security risk. Use supabase_auth instead, which is the actively maintained replacement.

## Install

pip install gotrue
uv add gotrue
poetry add gotrue

## Installing gotrue

Before you install: Low install friction with three lightweight runtime dependencies (httpx, pydantic, pyjwt). However, the package is abandoned as of August 2025 and will receive no further updates; the maintainers have explicitly directed users to migrate to supabase_auth instead.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license text.

Quickstart:

pip install gotrue

from gotrue import Client

client = Client(url="https://your-supabase-url/auth/v1")
user = client.sign_up(email="user@example.com", password="password")

Requires Python 3.9 or later. Package is deprecated and no longer maintained; use supabase_auth instead.

Verify before relying:

- Whether existing projects using gotrue will continue to work with future Python versions or dependency updates after August 2025.
- Whether dependencies (httpx, pydantic, pyjwt) will receive security updates that gotrue will not backport.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 4.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

supabase authentication client, python auth library, jwt token management, supabase gotrue client, authentication http client, python auth provider, jwt validation python, deprecated, authentication, supabase

[View on SkillFed](https://skillfed.io/packages/gotrue) · [View on PyPI](https://pypi.org/project/gotrue/)