Advent of Code challenge ⭐️

Quick Start

Windows

Setup instructions coming soon.

Mac

Prerequisites

• Homebrew must be installed: Install Homebrew
• UV must be installed:
  Run brew install uv to install uv

UV

1. Run uv venv to create a venv called .venv
2. Run source .venv/bin/activate to activate the new .venv
3. Run uv pip install -e . to install all dependencies via uv
4. Run uv run pre-commit install to install pre-commits locally

And now you are ready to use this repo

Usage

1. Activate your virtual environment:

source .venv/bin/activate

You can run your code in several ways:

• From the project root:

  uv run python advent_of_code/src/2024/Day1/main.py

• From a specific day directory:

  cd advent_of_code/src/2024/Day1
  uv run python main.py

• Debug directly in VS Code or your IDE: Open main.py and use the debugger.

Custom Badges

To display your own Advent of Code badges:

1. Open .github/workflows/badges.yml in this repository.
2. Find and use your own user ID for badge generation.
3. For more details, see the aoc-badges-action documentation.