What is Advent of Code?

Advent of Code (AoC) is an advent calendar style coding challenge held in December. Each day contains a problem that can be solved by writing code. Each problem contains two parts; part 2 is unlocked after part 1 is complete. Solving each part nets one star. The problems typically get harder each day.

From 2015 to 2024, problems ran from the 1^st to the 25^th; in 2025 problems are running from the 1^st to the 12^th. There are currently 524 total stars to collect.

About this repo

This repo contains my solutions for the AoC problems. My aim is for the code to follow good design principles, and to use relatively efficient algorithms where possible (i.e., not just brute force). My solutions are written in Python.

Progress Tracker

This tracker records the number of solutions (for parts or stars) uploaded to this repo.

• 2015: 32/50 ⭐
• 2016: 10/50 ⭐
• 2017: 8/50 ⭐
• 2018: 2/50 ⭐
• 2019: 4/50 ⭐
• 2020: 6/50 ⭐
• 2021: 2/50 ⭐
• 2022: 6/50 ⭐
• 2023: 0/50 ⭐
• 2024: 40/50 ⭐
• 2025: 20/24 ⭐
• Total: 140/524 ⭐

Usage

For year 20YY and day DD, from the repo root run:

python3 20YY/solution_day_DD.py <your-input-file>

replacing <your-input-file> with your actual input file path.

Acknowledgements

Advent of Code was created by Eric Wastl and is available at adventofcode.com.