experiment-queue

Orchestrate SSH-based ML experiment batches with wave and dependency enforcement.

Updated May 20, 2026
One-click install
npx skills add https://github.com/lightrain-a/medtrace-aris --skill experiment-queue-lightrain-a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-queue
Source: https://github.com/lightrain-a/medtrace-aris/tree/main/.vendor/aris/skills/experiment-queue
Command: npx skills add https://github.com/lightrain-a/medtrace-aris --skill experiment-queue-lightrain-a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Multi-seed, multi-config ML experiment batches often stall due to stale SSH screen sessions, GPU memory not fully releasing after OOM, and wave-phase race conditions, forcing you to manually babysit dozens of jobs.

Core Features & Use Cases

  • OOM-aware retry: Detect CUDA OOM from logs, kill the failing run, wait, and retry up to a configured maximum.
  • Stale screen cleanup: Detect “python exited but screen still exists” situations, verify expected outputs, and cleanly transition the job state.
  • Wave & dependency orchestration: Run jobs in waves based on GPU availability and preconditions, and enforce teacher→student or phase dependencies so downstream jobs don’t start too early.

Quick Start

Ask your AI to run a batch sweep on SSH GPUs with experiment-queue for 10+ jobs with an orchestrated manifest or grid spec, so it can manage waves, OOM retries, and stale-screen cleanup end-to-end.

Frequently Asked Questions about experiment-queue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate multi-seed ML experiment sweeps over SSH without manual babysitting?

You can automate multi-seed ML experiment sweeps by providing a YAML manifest or grid-derived job specs to a queue system that orchestrates SSH batches, manages GPU availability thresholds, and enforces wave dependencies. This eliminates manual troubleshooting and automatically handles stale screen sessions across remote runs.

How do I automatically retry ML experiments that fail with CUDA OOM errors?

To automatically retry ML experiments failing with CUDA OOM errors, the system detects the error from per-job logs, kills the failing run, waits for GPU memory to release, and retries up to a configured maximum. This OOM-aware retry mechanism prevents batches from stalling after memory crashes.

What is the best way to orchestrate teacher student distillation chains across multiple GPUs?

The best way to orchestrate teacher student distillation chains is using a job state machine that enforces phase dependencies. This ensures downstream student jobs wait until upstream teacher phases complete, preventing wave-phase race conditions in multi-phase experiment workflows.

How do I clean up stale SSH screen sessions when a python process exits but the screen persists?

To clean up stale SSH screen sessions when a python process exits but the screen persists, the system detects the mismatch, verifies expected outputs, and cleanly transitions the job state. This persistent queue state management keeps the experiment grid running smoothly without manual intervention.

Do I need a YAML manifest to run experiment grids with automatic OOM retry?

Yes, you need a YAML manifest or grid-derived job specs to run experiment grids with automatic OOM retry. The queue requires these specs to bootstrap remote helpers, gate jobs by GPU-free thresholds, and execute wave-based orchestration end-to-end.