PyTorch's tutorial factory turns .py files into Colab notebooks

What it does

This repository is the build pipeline behind the official PyTorch tutorials. It uses Sphinx-Gallery to turn plain Python script files into HTML documentation, auto-generating Jupyter notebooks for Google Colab along the way. Contributors drop your_tutorial.py files into beginner_source, intermediate_source, advanced_source, recipes_source, or prototype_source directories, and the build system handles the rest.

The interesting bit

The project treats notebooks as an output format rather than a source format. By version-controlling plain Python instead of messy JSON notebook blobs, it keeps diffs readable while still handing users a one-click Colab experience.

Key highlights

• Sphinx-Gallery workflow: write a Python script, get both an HTML page and an auto-generated Colab-ready Jupyter notebook
• Five content tiers from beginner recipes to unstable prototype features
• Single-tutorial builds supported via regex with GALLERY_PATTERN
• A lightweight html-noplot build target skips code execution for quick local previews

Caveats

• Full documentation builds require a GPU and can take about 60–120 minutes.
• Spell checking for .rst files is currently limited to the beginner/ directory.

Verdict

Tutorial contributors and docs-infrastructure nerds will find the machinery here; if you just want to learn PyTorch, read the rendered site instead.