autoresearch

Automate iterative ML experiments by modifying training code and extracting validation bits-per-byte.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/tDalile/dotfiles --skill autoresearch-tdalile
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: autoresearch
Source: https://github.com/tDalile/dotfiles/tree/main/agents/skills/autoresearch
Command: npx skills add https://github.com/tDalile/dotfiles --skill autoresearch-tdalile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the repetitive and time-constrained process of proposing, applying, running, and evaluating short ML experiments to improve a small GPT model's validation bits-per-byte metric.

Core Features & Use Cases

  • Autonomous Experiment Loop: Reads and modifies train.py, runs training for a fixed five-minute budget, extracts val_bpb and memory usage, and logs results to a structured TSV.
  • Crash and Resource Management: Detects crashes, tails logs for quick fixes, enforces a 10-minute hard timeout, and constrains VRAM usage for low-memory GPUs (e.g., RTX 4050).
  • Versioned Tracking: Commits experimental changes to git, keeps commits that improve the metric, and rolls back unsuccessful attempts.
  • Use Case: Nightly hyperparameter and architecture search on a local workstation to squeeze performance out of constrained GPU hardware.

Quick Start

Start an autoresearch experiment by creating a new branch in the repository and instructing the agent to run a 5-minute training loop, evaluate val_bpb, and log results.

Frequently Asked Questions about autoresearch

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

FAQPage Schema
How do I automate hyperparameter search for small GPT models on a local GPU?▼

You can automate hyperparameter optimization by running an autonomous experiment loop that modifies training code, executes five-minute runs, and logs validation bits-per-byte to a structured TSV file.

Can I run ML training experiments autonomously with under 6GB VRAM?▼

Yes, autonomous ML training experiments are designed for local GPUs with under 6GB VRAM, enforcing strict memory constraints and a ten-minute hard timeout to prevent resource exhaustion.

What is validation bits-per-byte optimization for GPT architectures?▼

Validation bits-per-byte optimization is an automated evaluation mechanism that extracts val_bpb metrics from short training runs to measure and improve small GPT model compression efficiency.

Does autoresearch require uv tooling and Python 3.10 to run experiments?▼

Yes, running automated ML experiments requires Python 3.10+, uv tooling, git access, and an NVIDIA GPU to properly execute the iterative training and code modification loops.

How does the agent handle crashes during automated ML training runs?▼

The system handles crashes during automated ML training by detecting failures, tailing logs for quick fixes, and rolling back unsuccessful git commits to maintain a stable experiment loop.