---
id: advent-of-code
version: "2025.6.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# advent-of-code

License: unclear · Maintenance: active · Downloads: 85.3K/mo

## What it is and what it does

This package bundles pre-computed solutions to Advent of Code puzzles, implemented in Rust and exposed to Python via PyO3. It exports a single `solve(year, day, part, input)` function that takes a puzzle year, day, part number, and input string, then returns the answer as a string. It also provides a command-line interface (`advent-of-code-py`) for the same purpose.

The package is useful if you want to quickly retrieve answers without solving puzzles yourself, verify your own solutions, or integrate AoC answers into other tools. It has no runtime dependencies and is actively maintained. Installation uses pre-compiled wheels across major platforms with medium friction.

Use it for:

- Look up solutions to Advent of Code puzzles without solving them manually
- Verify your own puzzle solutions against pre-computed answers
- Build tools or scripts that need quick access to AoC answers for reference or testing
- Use as a CLI tool to fetch answers directly from the command line

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides pre-computed solutions to Advent of Code puzzles as a Python library and CLI tool, with Rust-backed implementations exposed via PyO3.

Yes, if you need quick access to pre-computed Advent of Code solutions for reference, verification, or integration into other tools. The package is actively maintained, has no runtime dependencies, and works across major platforms. Install friction is moderate due to compiled wheels, but that is a one-time cost. Not suitable if you want to solve puzzles yourself.

## Install

pip install advent-of-code
uv add advent-of-code
poetry add advent-of-code

## Installing advent-of-code

Before you install: Medium install friction due to compiled wheels (cp312-abi3 binaries for macOS, Linux, Windows). Active maintenance with recent commits; last release 160 days ago and repository not archived.

Quickstart:

pip install advent-of-code

from advent_of_code import solve
result = solve(2019, 1, 1, "14")
print(result)  # "2"

Compiled wheels (cp312-abi3) limit platform support to macOS, Linux, and Windows; exact Python version requirement unspecified in metadata.

Verify before relying:

- Which Advent of Code years are covered by the package
- Whether the solve() function requires exact input formatting or handles whitespace/line-ending variations
- Performance characteristics for large or complex puzzle inputs
- Minimum Python version requirement (wheels suggest 3.12+ but requires_python is unspecified)

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: medium
- Maintenance: active
- Downloads: 85.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

advent of code solver, advent of code solutions library, aoc puzzle solver python, advent of code cli tool, pre-computed aoc answers, puzzle-solving, advent-of-code

[View on SkillFed](https://skillfed.io/packages/advent-of-code) · [View on PyPI](https://pypi.org/project/advent-of-code/)