What problem does it solve?
On-policy distillation (OPD/MOPD) runs in Relax often suffer from teacher engine OOMs, teacher timeouts, and idle student or teacher GPUs caused by misconfigured SGLang flags, logits memory peaks, and unbalanced GPU partitioning. This Skill analyzes an OPD launch script and produces a cited diagnosis report with concrete, ordered fixes.
Core Features & Use Cases
- Teacher knob auditing: Evaluates ten rules (R-T01 to R-T10) covering mem-fraction-static, logits chunking, chunked-prefill sizing, CUDA graph phases, TP vs replicas, timeouts, VLM cache, env propagation, and max-running-requests.
- Balance analysis: Measures student/teacher capacity imbalance via GPU sampling, engine log windows, and wait-time metrics, then computes feasible GPU repartition points under divisibility constraints.
- Baseline anchoring: Compares the script against snapshot configurations from working OPD examples to flag untuned settings.
- Use Case: A user reports teacher OOM at logits[input_logprob_indices] on a multimodal MOPD run; the Skill computes the logits peak from vocab size and chunk size, recommends enabling logits chunking before raising prefill budgets, and emits an ordered fix list.
Quick Start
Run the opd-tuning skill on my OPD launch script examples/on_policy_distillation/mopd/run-mopd-qwen35-9b-8xgpu-colocate.sh and diagnose why the teacher engine is OOMing.