autoresearch

Iteratively modify train.py and run short GPU experiments to optimize val_bpb.

4|4|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Roentek/Claude_Code_Boilerplate_Framework --skill autoresearch-roentek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/Roentek/Claude_Code_Boilerplate_Framework/tree/main/.claude/skills/autoresearch
Command: npx skills add https://github.com/Roentek/Claude_Code_Boilerplate_Framework --skill autoresearch-roentek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of finding better model training settings without manually iterating on code for hours, by running repeated short experiments and automatically keeping improvements.

Core Features & Use Cases

  • Autonomous experiment loop: Iterates through modifying train.py, running a fixed-budget training run, extracting results, and deciding whether to keep or discard changes.
  • Objective-driven optimization: Optimizes against val_bpb (lower is better) while tracking peak VRAM usage to manage compute constraints.
  • Git-backed research traceability: Creates an autoresearch/<tag> branch, commits each experiment, and records outcomes in results.tsv.

Use Case: When you want to run autonomous overnight research on a baseline GPT-like training setup, you can let the agent explore architecture and optimizer/hyperparameter changes for roughly 100 experiments while you sleep.

Quick Start

Ask your agent to start AutoResearch and create a new run tag, then verify data availability and launch the overnight loop that runs train.py, logs val_bpb, and continues until you manually interrupt it.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I automate hyperparameter tuning for overnight GPU training?

Autonomous ML research automates hyperparameter tuning by iteratively modifying training code, executing short GPU experiments, and keeping or discarding changes based on the extracted validation metric. It runs autonomously overnight to optimize models.

How does git-based experiment logging work for machine learning research?

Git-based experiment logging works by creating a dedicated branch, committing each training code modification, and recording validation metrics and peak VRAM in a results file. This keeps successful improvements while discarding failed runs.

Can I run autonomous machine learning experiments with a fixed runtime budget?

Yes, you can run autonomous machine learning experiments with a fixed runtime budget by enforcing a strict time limit per training run. The system executes short GPU experiments and automatically evaluates whether to keep code changes based on the validation metric.

What is the best way to optimize val_bpb across multiple training runs?

The best way to optimize val_bpb across multiple training runs is to use an autonomous experiment loop that modifies training code, executes short GPU experiments, and extracts the metric from logs to decide whether to keep or discard changes.

Do I need to modify prepare.py to run autonomous GPU training loops?

No, you do not need to modify prepare.py to run autonomous GPU training loops. You only edit train.py while treating prepare.py and evaluate_bpb as strictly read-only files during the automated experiment execution process.

What are the limitations of using autonomous experiments for model optimization?

Limitations of using autonomous experiments for model optimization include a strict fixed runtime budget per experiment and reliance on a single validation metric. The system requires tolerance for short training runs rather than continuous long executions.