Install & Compatibility
Where this runs
tested against v4.10.0.20260509 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 35.7MB
glibcpy 3.10–3.920 runs
installs and imports cleanly · install 2.5s · import 0.000s · 36MB
34MB installed
● package 34MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ManagementClient
✓ from auth0-stubs.management import ManagementClient
✗ from auth0.management import ManagementClient
This quickstart demonstrates how to initialize the `ManagementClient` from `auth0-python` (version 5.0.0+), which is fully typed by `types-auth0-python`. It fetches the domain, client ID, and client secret from environment variables and then lists all users using the `users` sub-client. The example shows how type hints from `types-auth0-python` would apply to client initialization and method calls, aiding static analysis.
import os
from auth0.management import ManagementClient
from auth0.management.users import Users
from typing import Dict, Any
# Ensure environment variables are set for actual use
AUTH0_DOMAIN: str = os.environ.get('AUTH0_DOMAIN', 'your-tenant.auth0.com')
AUTH0_CLIENT_ID: str = os.environ.get('AUTH0_CLIENT_ID', 'YOUR_CLIENT_ID')
AUTH0_CLIENT_SECRET: str = os.environ.get('AUTH0_CLIENT_SECRET', 'YOUR_CLIENT_SECRET')
# Initialize the ManagementClient with client credentials for automatic token management
# This client is fully type-hinted by types-auth0-python
management_client: ManagementClient = ManagementClient(
domain=AUTH0_DOMAIN,
client_id=AUTH0_CLIENT_ID,
client_secret=AUTH0_CLIENT_SECRET
)
# Access a sub-client, e.g., for users management
users_client: Users = management_client.users
# Example: List users (response types are Pydantic models in v5, but can be dicts too)
try:
# Use .all() for pagination convenience or .get_all() if you need more control
all_users: list[Dict[str, Any]] = users_client.get_all()
print(f"Found {len(all_users)} users.")
if all_users:
print(f"First user ID: {all_users[0].get('user_id')}")
except Exception as e:
print(f"An error occurred: {e}")
Debug
Known issues
breakingThe `auth0-python` library underwent a major rewrite in v5.0.0, introducing significant breaking changes. This includes changes to import paths (e.g., `from auth0.management import Auth0` is now `from auth0.management import ManagementClient`), client initialization, and response types (now Pydantic models instead of generic dictionaries).fixRefer to the `auth0-python` v5 migration guide and update import paths, client instantiation, and how response data is accessed (e.g., use `.model_dump()` to convert Pydantic models to dictionaries if needed).
affects: auth0-python < 5.0.0 to 5.0.0+
gotchaMismatching versions of `types-auth0-python` and `auth0-python` can lead to incorrect type checking or errors. The stub package aims to provide accurate annotations for specific `auth0-python` versions (e.g., `4.10.*`).fixAlways install `types-auth0-python` with a version compatible with your `auth0-python` installation. Check the `types-auth0-python` PyPI page for the supported `auth0-python` version range. Pin both packages if necessary (e.g., `auth0-python~=4.10.0` and `types-auth0-python==4.10.0.YYYYMMDD`).
affects: All versions
breaking`auth0-python` has increased its minimum Python version requirement. For example, v5 requires Python >=3.9, and v5.2.0 dropped support for Python 3.8. Using older Python versions with newer `auth0-python` (and thus `types-auth0-python`) can cause runtime errors or `SyntaxError` with type hints.fixEnsure your Python environment meets the minimum requirement for the `auth0-python` version you are using. Update Python if necessary.
affects: auth0-python < 3.9 / 3.10 / 3.11
Upgrade
Version history
4.10.0.20260509latest on PyPI · released May 9, 2026
Audit
Dependencies
auth0-pythonrequiredProvides type hints for this runtime library. Not a runtime dependency, but a type-checking dependency.