Skip to main content
You’re here because you want to change Miles, not just use it. This section is the short tour for new contributors.

Contributing

Repo layout, what enforces code style, what lives in .claude, and how to drive CI from a PR.

Architecture Overview

The 30-minute tour of how Miles is organized internally.

Versions and Images

How the miles, SGLang and Megatron-LM trees fit together, and how to bump one.

Debugging

Isolating rollout from training, the debug and CI assertion flags, aligning precision.

Training Backends

Megatron-LM and FSDP: what each backend owns and where its code lives.

​
TL;DR for first-time contributors

  1. Pick something small from good first issue on GitHub.
  2. Run the Reproducibility recipe so you can be sure “I changed X and it broke” actually means that.
  3. Use --debug-train-only or --debug-rollout-only to scope your changes, and --list-only to confirm your test is actually registered in CI.
  4. Open a PR. We’ll review within ~48h.