run-experiment

Deploy and run machine learning experiments across local GPUs, SSH servers, Vast.ai, and Modal.

2|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/raja21068/AutoResearch --skill run-experiment-raja21068
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-experiment
Source: https://github.com/raja21068/AutoResearch/tree/main/skills/aris/run-experiment
Command: npx skills add https://github.com/raja21068/AutoResearch --skill run-experiment-raja21068

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the friction of launching ML experiments by automatically deploying, preparing, and running jobs across local GPUs, remote SSH servers, Vast.ai instances, and Modal serverless GPUs.

Core Features & Use Cases

  • Environment-aware deployment: Detects whether to run locally, via SSH, on Vast.ai, or on Modal by reading project CLAUDE.md, then follows the correct lifecycle.
  • GPU pre-flight validation: Checks GPU availability before starting experiments (e.g., via nvidia-smi and memory-usage heuristics) to avoid failed or wasted runs.
  • Code syncing and job launch: Syncs code efficiently (rsync or git), optionally injects Weights & Biases logging, and starts the experiment with captured logs.
  • Cost-conscious execution: Supports Vast.ai auto-destroy after completion and Modal’s scale-to-zero behavior to reduce idle charges.
  • Use Case: You want to train a new model variant and need reliable execution plus logged results on the best available GPU provider without manually rewriting deployment steps each time.

Quick Start

Ask to run the experiment by providing your experiment description and requesting deployment on the configured environment in your project CLAUDE.md.

Frequently Asked Questions about run-experiment

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

FAQPage Schema
How do I run ML training jobs across different GPU providers like Vast.ai and Modal?

The Skill detects the target environment from your project CLAUDE.md and automates deploying and running ML training jobs across local GPUs, remote SSH servers, Vast.ai instances, or Modal serverless GPUs.

Can I deploy machine learning experiments on Vast.ai with automatic teardown after completion?

Yes, the Skill supports Vast.ai auto-destroy after job completion, automatically tearing down rented instances to reduce idle GPU rental charges.

Does the experiment execution workflow support Weights & Biases logging?

Yes, the workflow supports Weights & Biases logging by optionally injecting wandb tracking into your code syncing and job launch process for captured experiment metrics.

How do I check GPU availability before launching a remote SSH training job?

The Skill performs GPU pre-flight validation using nvidia-smi and memory-usage heuristics before launching remote SSH training jobs to prevent failed or wasted runs.

What is the best way to sync code and start experiments on a remote GPU server?

The Skill automates code syncing via rsync or git to remote GPU servers, prepares the environment, and starts the experiment process with captured logs.

Do I need to configure CLAUDE.md to deploy experiments on Modal serverless GPUs?

Yes, the Skill reads your project CLAUDE.md for environment detection and delegates Modal serverless GPU execution to /serverless-modal with scale-to-zero behavior.