A tour of Python

An open source repository for learning Python, with an interactive playground built on top of Pyodide that lets you run Python code directly in the browser, no installation required.

The goal of this project is to make learning Python more approachable and structured, with lessons organized so they're easier to follow for those getting started with Python.

Project stack

• Framework: Astro with React
• Styling: Tailwind CSS
• WebAssembly Pyodide
• Package manager: pnpm
• Translation tooling: Python 3 + PyYAML, driven through the makefile

Getting started

pnpm install
pnpm dev

The dev server runs at http://localhost:4321.

Other useful scripts:

pnpm build      
pnpm preview    

Translations

Lessons are translated per-language under src/i18n/locales/*.yml and src/i18n/chapters/<lang>/. Common tasks are wrapped in the makefile:

make list-languages              # show available languages
make new-language LANG=xx        # scaffold a new language
make check-missing LANG=xx       # find missing translation keys
make validate-translations       # validate all translation files
make stats                       # translation coverage stats

Run make help (or just make) to see the full list of commands.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before opening a pull request, and note that this project follows a Code of Conduct.

License

MIT