A comprehensive solution runner for Advent of Code challenges with performance tracking, automated submission, and statistics generation.
- 🎄 Solution Runner: Execute AOC solutions with timing and error handling
- 📊 Performance Tracking: Track execution times and compare with previous runs
- 🚀 Auto Submission: Submit answers directly to AOC with smart timeout handling
- 📈 Statistics: Generate comprehensive stats tables from tracked data
- 🎯 Sample Input Support: Test with sample data or custom input strings
- 🎬 Algorithm Animations: Interactive 3D visualizations with matplotlib and GIF export capabilities
- 📝 Template Generation: Auto-create solution templates for new problems
- 🎨 Colorized Output: Beautiful terminal output with progress indicators
-
Install Dependencies
pip install -r requirements.txt
-
Set up Session Cookie
- Get your session cookie from AOC website
- Save it in
session_cookie.txt
-
Run a Solution
python main.py 2025 1
Need more details? Check the Installation & Setup Guide for comprehensive instructions.
- 📋 Installation & Setup - Detailed setup instructions
- ⌨️ CLI Reference - Complete command-line documentation
- ✍️ Solution Writing Guide - How to write effective solutions
- 📊 Performance Tracking - Understanding the tracking system
- 🏃 Benchmarking - Performance analysis tools
- 🎬 Algorithm Animations - Create and export animated visualizations
- 📈 Statistics - Statistics generation and analysis
- 📝 Markdown Generation - Auto-generate documentation from benchmarks
- 🏗️ Project Structure - Understanding the codebase
# Run both parts for day 1 of 2025
python main.py 2025 1
# Test with sample input
python main.py 2025 1 --sample
# Submit answer to AOC
python main.py 2025 1 --submit
# Show run history
python main.py 2025 1 --history
# Interactive 3D animation (if available)
python main.py 2025 8 --animation --sample
# Export 3D animation as GIF
python main.py animation 2025 8 --sample --export-gif my_3d_animation.gif
# Benchmark and auto-update documentation
python main.py 2025 1 --benchmark --benchmark-publish
# Update all documentation files
python main.py --update-markdown --markdown-allSee more examples in the CLI Reference
| Year | Stars ⭐ | Problems 🧩 | Runs 🏃 | Success Rate | Avg Time ⚡ | Fastest 🚀 | Slowest 🐌 |
|---|---|---|---|---|---|---|---|
| 2025 | 24 | 24 | 565 | 98.1% | 264.9ms | 0.2μs | 7.88s |
| 2024 | 50 | 2 | 61 | 100.0% | 6.7μs | 0.2μs | 0.3ms |
| 2023 | 50 | 15 | 603 | 77.9% | 27.1ms | 0.4μs | 712.2ms |
| 2022 | 50 | 2 | 61 | 100.0% | 6.9μs | 0.3μs | 0.3ms |
| 2021 | 6 | 6 | 210 | 85.7% | 0.7ms | 0.2ms | 3.3ms |
| 2017 | 49 | 50 | 1217 | 89.0% | 663.3ms | 0.6μs | 8.36s |
| 2016 | 50 | 50 | 2102 | 98.9% | 1.45s | 0.1μs | 28.77s |
| 2015 | 50 | 50 | 2104 | 95.7% | 345.9ms | 0.2μs | 11.54s |
- ⭐ Total Stars: 331
- 🧩 Total Problems Solved: 199
- 🏃 Total Runs: 6923 (93.9% success)
- ⚡ Average Time: 706.8ms
- 🚀 Fastest Time: 0.1μs
- 🐌 Slowest Time: 28.77s
Last updated: 2025-12-12 08:00:25
- Python 3.7+
requests(for AOC communication)matplotlib(for 3D animations)Pillow(for GIF export)colorama(optional, for colored output)
This project is for educational purposes. Please respect Advent of Code's terms of service.