🐍 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

• Local Development Enviroment: Real developers use their local machines to build and tests software. This is exactly how we are going to start. Locally, on your own machine.

• Interactive Lessons: We use Skulp engine to render interactive python code blocks. If your code block has interactive tag, our engine will render it as runnable python code - directly in the browser.

• 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.

• Documentation as Lessons: This project is inspired by The Odin Project which pushes students to read documentation to find out more about things they are learning. This course aims to do the same. Lessons should be relatively short, provide basic concept about the topic and point the students to find out more by reading documentation or well written articles.

🏗️ 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

Please see ROADMAP.md for our current roadmap and work in progress (WIP) status.

Roadmap is subject to change. If you feel we should reorganize our structure, feel free to raise an issue and / or contact us on Discord.

🤝 Contributing

We are always looking for "Ledger Keepers".

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