🐍 The Python Ledger

The open-source, community-driven roadmap to Python mastery.

The Python Ledger is a free, comprehensive curriculum designed to take students from their first "Hello World" to building professional-grade applications.

Inspired by the philosophy of The Odin Project, we believe the best way to learn is by doing, reading documentation, and contributing to the ecosystem.

💡 The Philosophy

• Zero-Friction Starts: The first steps of the journey happen entirely in the browser. No installers, no PATH errors, no friction.

• The "Training Wheels" Phase: We move from the browser to the local machine early. Real developers use terminals, Git, and IDEs; our students do too.

• Curriculum-as-Code: This entire resource lives on GitHub. If a lesson is unclear or a link is broken, the students are encouraged to fix it themselves.

• Bite-Sized Mastery: Lessons are broken down into small, digestible sections to maintain momentum and prevent burnout.

🏗️ How It Works

This project is split into two parts to ensure maximum stability and ease of contribution:

• The Ledger (This Repo): A collection of pure Markdown files. This is the heart of the curriculum. No code, no scripts—just high-quality education.

• The Engine: A separate Docusaurus-based platform that consumes these Markdown files and injects a live Python interpreter (Skulpt) into the interactive lessons.

🗺️ The Roadmap

• Phase 1: The Foundations (In-Browser) Variables, Data Types, and Logic. Loops and Functions. Project: The Text-Adventure Engine.

• Phase 2: The Developer’s Toolbelt (Local) Setting up VS Code and Python locally. Mastering the Command Line. Version Control with Git & GitHub.

• Phase 3: Intermediate Python Data Structures (Lists, Dicts, Tuples). File I/O and Error Handling. Working with APIs and JSON.

• Phase 4: Object-Oriented Programming Classes, Inheritance, and Design Patterns. Testing with pytest. Capstone: The Expense Tracker Dashboard.

🤝 Contributing

We are always looking for "Ledger Keepers".

Whether you are fixing a typo or designing a new project, your contributions are welcome. Please see CONTRIBUTING.md for our style guide and workflow.