# authomatic/authomatic

Simple yet powerful authorization / authentication client library for Python web applications.

Repository: https://github.com/authomatic/authomatic
Canonical: https://ross.abutalabs.com/products/authomatic
Homepage: https://authomatic.github.io/authomatic
Language: Python
License: MIT
License Family: permissive
Topics: python, authentication, oauth2-client, oauth-client, openid-client, authorization
Last push: 2025-12-12T08:28:51+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 56, release rhythm 35, longevity 100
- inputs: {"age_days": 4955, "days_push": 264, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1053, forks 397 (observed 2026-08-28T04:03:23.919305+00:00)

## What it is
Authomatic is a framework-agnostic Python library that simplifies user authentication and authorization via third-party providers like Facebook, Google, and Twitter using OAuth 2.0 and OpenID. It provides adapters for Django, Flask, Pyramid, and Webapp2, plus helpers for making provider API calls.

## Use cases
- add social login with Facebook or Google to a Flask app
- implement OAuth2 client authentication in a Django project
- log users in via third-party providers in a Pyramid web app
- call provider APIs on behalf of authenticated users
- replace hand-rolled OAuth flows with a minimal library
- support multiple OAuth2 providers from one codebase

## When to choose
- you need OAuth2 social login in a Python web app with Django, Flask, or Pyramid
- you want a lightweight, framework-agnostic auth client with minimal dependencies
- you need to make authenticated API calls to many popular providers

## When to avoid
- you need OAuth1 or OpenID support, which was removed in the 2.0 release
- you need a full identity provider or SSO server rather than a client library
- your framework has no adapter and you don't want to write one
- you need Python versions older than 3.10

## Facets
- artifact type: library
- maturity: active
- function: auth, authorization, http-client
- domain: web-development, security, apis
- platform: python
- tags: oauth2-client, oauth, openid, framework-agnostic, social-login, django, flask, pyramid

## Member repositories
- authomatic/authomatic (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:23.919305+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:59:20.607689+00:00, confidence not recorded.
  - readme: https://github.com/authomatic/authomatic (fetched 2026-08-28T04:03:23.919305+00:00, sha 60c2dbe689ab)
  - homepage: https://authomatic.github.io/authomatic (fetched 2026-08-29T13:00:58.719233+00:00, sha f839f1d444fa)
  - registry_pypi: https://pypi.org/pypi/authomatic/json (fetched 2026-08-29T13:00:58.722487+00:00, sha 56d085584db8)
- Data as of 2026-08-30T08:39:29.467469+00:00.