Installation¶
Requirements¶
Python 3.14+
httpx (installed automatically)
That’s it. No Django, no ORM, no heavy framework.
Install with uv¶
uv add pretalx-client
Install with pip¶
pip install pretalx-client
Verify the install¶
from pretalx_client import PretalxClient
client = PretalxClient("pycon-us-2026")
print(client.api_url)
# https://pretalx.com/api/events/pycon-us-2026/
If you’re using pretalx-client as part of django-program, it’s already included as a workspace dependency – no extra install needed.
Authentication¶
Most Pretalx data is publicly accessible, but some fields (speaker emails, draft submissions) require an API token. You can generate one from your Pretalx user profile under Settings > API tokens.
Pass it when constructing the client:
client = PretalxClient(
"pycon-us-2026",
api_token="your-pretalx-api-token",
)
Without a token, the client still works – you just won’t see restricted fields.