This project powers the EuroPython 2025 website, Discord bot, and internal bot ðĶ by downloading, transforming, and serving clean, structured JSON files for sessions, speakers, and the schedule, all pulled from Pretalx.
Built for transparency. Designed for reuse. Optimized for EuroPython.
ð What This Project Does
- Downloads submission and speaker data from Pretalx.
- Transforms raw data:
- Removes private/irrelevant fields
- Normalizes formats
- Adds computed fields (e.g. URLs, delivery mode)
- Serves the transformed JSON files via a static API.
âïļ Installation
-
Clone the repo
git clone https://github.com/EuroPython/programapi.git cd programapi -
Install uv (fast Python package manager)
-
Create a Python 3.13 virtual environment
-
Install dev dependencies
-
Enable pre-commit hooks
ð ïļ Configuration
You can update the event year or shortname in src/config.py.
Also, create a .env file in the project root and set:
PRETALX_TOKEN=your_api_token_here
(Yes, Pretalx has rate limits. Please be nice. ðĪŠ)
ðĶ Usage
-
Run the entire pipeline:
-
Run only the download step:
-
Run only the transformation step:
-
(Optional) Exclude components:
make all EXCLUDE="schedule youtube"
ð API Endpoints
Hosted at:
https://static.europython.eu/programme/ep2025/releases/current
| Endpoint | Description |
|---|---|
/speakers.json |
List of confirmed speakers |
/sessions.json |
List of confirmed sessions |
/schedule.json |
Latest conference schedule |
ð Schema Documentation
Looking for field definitions and examples?
Check out the ð data/examples/README.md for a full schema reference with example payloads and explanations.
ðŽ Questions? Feedback?
Feel free to open an issue or reach us at infra@europython.eu. We love contributors ð
ð Last updated for: EuroPython 2025