aoc

---

Table of Contents

• Installation
• License

Requirements

• Python 3.12 or higher
• uv Astral

Configuration

Update Aoc session cookie in ~/.aoc_session. The session cookie can be found in your browser cookies when logged into Advent of Code.

You can also pass it as an environment variable.

export AOC_SESSION="your_session_cookie_here"

Installation

uv sync
uv run aoc

Run a specific day:

uv run aoc --day 5 --year 2025 run [--part 1]

Run pre-commit checks:

uv run pre-commit

Run tests:

uv run pytest tests/y2025

License

aoc is distributed under the terms of the MIT license.