Welcome to LuminaPy

Master Python Data Structures & Algorithms Through Guided Experimentation.

What is LuminaPy?

LuminaPy is a comprehensive learning laboratory designed to take you from Python basics to algorithm mastery through structured, hands-on practice.

Why Choose LuminaPy?

Feature	Benefit
8-Phase Learning Path	Structured progression from beginner to expert
Pattern-Based Learning	Master patterns that solve 80% of problems
Progress Tracking	Gamified XP system with achievements
Visual Animations	Watch algorithms in action
One-Click Setup	GitHub Codespaces ready

Quick Start

git clone https://github.com/Harery/LuminaPy.git
cd LuminaPy
uv sync --all-extras
python build/foundations/01-python-basics/hello.py

Learning Path

1. Phase 1: Foundations - Python basics, control flow, functions
2. Phase 2: Data Structures - Arrays, strings, hash tables
3. Phase 3: Algorithms - Searching, sorting, recursion
4. Phase 4: Advanced DS - Trees, graphs, heaps
5. Phase 5: Patterns - 12 coding patterns
6. Phase 6: Challenges - LeetCode problems
7. Phase 7: Mastery - Mock interviews, optimization
8. Phase 8: Projects - Real-world applications

Next Steps

• Prerequisites
• Installation Guide
• Roadmap