Ensemble Certs

Bulk PDF certificate generator for the Ensemble AI hackathon. Fills in participant names, team names, and placement text on a PDF template using PyMuPDF.

Setup

pip install -r requirements.txt

Usage

python generate_certs.py \
    --template template.pdf \
    --csv "Certyfikaty mapping - attendance.csv" \
    --output-dir output \
    --only-attended

Options

Flag	Default	Description
--template	(required)	PDF template with [IMIE_NAZWISKO], [NAZWA_DRUZYNY], [ZA_CO] placeholders
--csv	(required)	CSV with first_last_name, team_name, Czy przyszedł columns
--output-dir	output	Directory for generated PDFs
--only-attended	off	Skip rows where attendance ≠ TRUE
--font-regular	fonts/Montserrat-Regular.ttf	Regular weight TTF font
--font-bold	fonts/Montserrat-Bold.ttf	Bold weight TTF font
--limit	0 (all)	Generate only the first N certificates

Top-5 teams automatically get placement text ("zajęcie N. miejsca") instead of the default "udział".

Project structure

├── generate_certs.py          # Main script
├── template.pdf               # PDF template with placeholders (see Canva link above)
├── fonts/                     # Montserrat TTF fonts
└── output/                    # Generated certificates (git-ignored)