โ— Shell
clean mode source โ†—

GitHub - EuroPython/programapi: Program API

This project powers the EuroPython 2026 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

  1. Downloads submission and speaker data from Pretalx.
  2. Transforms raw data:
    • Removes private/irrelevant fields
    • Normalizes formats
    • Adds computed fields (e.g. URLs, delivery mode)
  3. Serves the transformed JSON files via a static API.

โš™๏ธ Installation

  1. Clone the repo

    git clone https://github.com/EuroPython/programapi.git
    cd programapi
  2. Install uv (fast Python package manager)

  3. Create a Python 3.13 virtual environment

  4. Install dev dependencies

  5. 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/ep2026/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 2026