What problem does it solve?
experiment-queue solves the operational pain of running large multi-seed, multi-config ML experiment grids on remote GPUs by preventing common failures like stale hung sessions, GPU OOM stalls, and wave-transition race conditions.
Core Features & Use Cases
- SSH GPU batch orchestration: schedules 10+ jobs across available GPUs with continuous state tracking and resumability.
- Wave transitions + phase dependencies: runs jobs in ordered phases (e.g., teacher then student) and only starts the next wave when the previous one fully settles.
- OOM-aware retry and stale cleanup: detects CUDA OOM in per-job logs, retries up to a configured max, and cleans stale screen sessions that appear alive but have exited.
- Deterministic manifest-driven launches: accepts a YAML/JSON grid spec or manifest to generate explicit job commands and expected output checks.
Quick Start
Use the experiment-queue skill to run a teacher-to-student multi-seed experiment grid by asking it to orchestrate a batch of 10+ jobs with a manifest and remote SSH GPU server, so it can launch in waves, retry OOM safely, and monitor completion via expected output files.