openfga-sdk
A high performance and flexible authorization/permission engine built for developers and inspired by Google Zanzibar.
Decision gist · record as of 2026-08-14
Yes. The SDK is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. It is the canonical Python client for OpenFGA and suitable for production use if you are already running or planning to run an OpenFGA authorization service. Install it only if you have an OpenFGA instance to connect to.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; async/await syntax required; OpenFGA API endpoint and store ID must be configured.
- Low friction install with a pure-Python wheel and four lightweight runtime dependencies.
- The package is actively maintained with a recent release 46 days ago and supports current Python versions (3.10–3.14).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
last release 2026-06-29 (46 days) · last repo commit 2026-08-04 · 86 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,020,393 downloads/mo, #4,494 on PyPI
Alternatives
Verify before relying
pip install openfga_sdk
from openfga_sdk import ClientConfiguration, OpenFgaClient
async def main():
config = ClientConfiguration(api_url="https://api.fga.example", store_id="store_id")
async with OpenFgaClient(config) as client:
models = await client.read_authorization_models()
return models- Exact scope of OpenTelemetry integration and what observability signals are exported.
- Performance characteristics and latency impact of the default retry strategy (up to 3 retries on 429/5xx).
- Whether connection pooling behavior is configurable or automatic via aiohttp.
What it is and what it does
The openfga-sdk is an autogenerated Python wrapper around the OpenFGA API, a fine-grained authorization engine inspired by Google's Zanzibar. It provides an async client for managing authorization stores, models, and relationship tuples, and for performing authorization checks (including batch checks), expansions, and queries. The SDK handles credential flows (API token, client credentials, OAuth2), retries failed requests automatically, and integrates with OpenTelemetry for observability.
You initialize a single OpenFgaClient with your API endpoint and credentials, then use it to read/write authorization models, manage relationship tuples (the core permission data), and run authorization queries like checking whether a user has a specific permission. The client is designed for reuse across your application to avoid initialization overhead and maximize connection pooling.
Use it for
- Implement role-based or relationship-based access control (RBAC/ReBAC) in a web application by checking permissions before granting access to resources.
- Manage complex permission hierarchies where permissions depend on relationships between users, roles, and resources.
- Batch-check permissions for multiple user-resource pairs in a single operation to reduce API call overhead.
- Query authorization models to expand what permissions a user has or list all objects they can access.
- Integrate fine-grained authorization into microservices by centralizing permission logic in OpenFGA and querying it from multiple services.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The SDK is actively maintained, has no known vulnerabilities, installs with low friction, and is licensed permissively. It is the canonical Python client for OpenFGA and suitable for production use if you are already running or planning to run an OpenFGA authorization service. Install it only if you have an OpenFGA instance to connect to.
Install
openfga-sdk on PyPI
Before you install
Low friction install with a pure-Python wheel and four lightweight runtime dependencies. The package is actively maintained with a recent release 46 days ago and supports current Python versions (3.10–3.14).
Requires Python 3.10 or later; async/await syntax required; OpenFGA API endpoint and store ID must be configured.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install openfga_sdk
from openfga_sdk import ClientConfiguration, OpenFgaClient
async def main():
config = ClientConfiguration(api_url="https://api.fga.example", store_id="store_id")
async with OpenFgaClient(config) as client:
models = await client.read_authorization_models()
return modelsVerify before relying
- Exact scope of OpenTelemetry integration and what observability signals are exported.
- Performance characteristics and latency impact of the default retry strategy (up to 3 retries on 429/5xx).
- Whether connection pooling behavior is configurable or automatic via aiohttp.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesaiohttpopentelemetry-apipython-dateutilurllib3 |
| Maintenance | Actively maintained 46 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,020,393 / month, #4,494 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: openfga_sdk-0.10.4-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 › “fine-grained authorization python”
- openfga-sdkPython SDK for OpenFGA that wraps the OpenFGA API, enabling…
- workosA Python client library for the WorkOS API that provides typed access…
- django-guardiandjango-guardian adds per-object permission checks to Django, letting…
Give your agent the search over MCP, or paste the wish link into any chat.
More Security packages
Provides Python bindings to the FreeDesktop.org Secret Service API for securely storing and retrieving passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.
MSAL for Python handles OAuth2 and OpenID Connect authentication with Microsoft identity services, managing token acquisition, caching, and refresh for applications integrating with Microsoft Entra ID, Microsoft Accounts, and Azure AD B2C.
joserfc implements JOSE standards (JWS, JWE, JWK, JWT, and related RFCs) for signing, encrypting, and managing JSON-based cryptographic tokens in Python.
Authlib provides a complete implementation of OAuth 1.0, OAuth 2.0, and OpenID Connect 1.0 for building both authentication clients and servers, with built-in support for JWS, JWK, JWA, and JWT standards.
Provides low-level CFFI bindings to the official Argon2 password hashing algorithm for use by libraries and applications that need direct access to Argon2 without higher-level abstractions.
ADAL for Python authenticates applications with Azure Active Directory to obtain tokens for accessing Azure AD-protected resources.
Install only if maintaining existing code that already depends on it, and plan a migration.
See also oauth2-client · django-oauth-toolkit · aws-s3-access-grants-boto3-plugin · onelogin · django-oidc-provider · pydata-google-auth · coze-workload-identity · pyop · google-oauth · ovh