research.autonomous.tinker

Runs autonomous single-file LLM training experiments under fixed wall-clock budgets optimizing val_bpb.

Updated May 9, 2026
One-click install
npx skills add https://github.com/0h-n0/auto-research --skill research-autonomous-tinker-0h-n0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research.autonomous.tinker
Source: https://github.com/0h-n0/auto-research/tree/main/skills/research.autonomous.tinker
Command: npx skills add https://github.com/0h-n0/auto-research --skill research-autonomous-tinker-0h-n0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires torch, numpy, datasets, torchvision, gymnasium, scikit-learn, scipy, and includes references (resource) components.

What problem does it solve? Manually iterating on model architecture and hyperparameters for small-scale training experiments is slow and unstructured. This Skill lets an agent autonomously edit a single training file, run fixed-budget experiments, and keep or revert changes based on a single comparable metric, enabling overnight unattended optimization loops. ## Core Features & Use Cases - Single-file autonomous editing: The agent edits only tinker/train.py (model, optimizer, hyperparameters) while data prep and validation splits stay immutable, preventing data leakage. - Fixed wall-clock budget per iteration: Each experiment runs under a configurable budget (default 300 seconds) so results are directly comparable, tracked via RESULTS.md, BEST.json, and events.jsonl. - Domain-pluggable packs: Ships with lm-pretrain (val_bpb on TinyStories/FineWeb-edu), vision-classification (CIFAR-10), nlp-classification (20 newsgroups), rl-cartpole, and tabular-classification domains, each with its own metric and templates. - Use Case: Select mode: tinker in a Phase 4 experiment plan, let the agent run an 8-hour overnight loop on a single GPU, then hand RESULTS.md and the best train.py to the paper drafting phase as a tinker journal. ## Quick Start Ask the agent to scaffold tinker mode for your project slug and run a baseline iteration with the tinker_run.sh script, then start the autonomous loop following program.md.

Frequently Asked Questions about research.autonomous.tinker

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

FAQPage Schema
How do I run autonomous LLM training experiments on a single GPU?▼

Scaffold the tinker directory for your project slug, run prepare.py to build the dataset, then execute tinker_run.sh for a baseline iteration. The agent then loops: edit train.py, run the script, compare val_bpb against BEST.json, and keep or revert the change.

What is val_bpb and why use it as the training metric?▼

val_bpb is validation bits per byte, computed by scaling validation cross-entropy by 1.4427 divided by bytes per token. It is vocabulary-size independent, so results stay comparable even if tokenization changes across experiments.

Can I use tinker mode for domains other than LLM pretraining?▼

Yes, domain packs exist for vision-classification (CIFAR-10, val_acc), nlp-classification (20 newsgroups, val_acc), rl-cartpole (episode_return), and tabular-classification (breast_cancer, val_acc). Pass --domain to tinker_run.sh to select one.

What happens if the agent breaks train.py during an iteration?▼

The runner pre-checks syntax with ast.parse and records failures as syntax_error iterations in events.jsonl. After repeated failures it auto-reverts train.py to the best snapshot stored in history/iter_<N>.py and logs a tinker.recover event.

Does tinker mode work on a laptop or consumer GPU?▼

Yes, the small-compute guide provides reduced configs: DEPTH=2 and 60-second budgets for CPU/MPS smoke tests, or DEPTH=4 with 512 sequence length for RTX-3090-class cards. Defaults target H100-class hardware.

Why are pretrained models forbidden in tinker experiments?▼

Pretrained weights or tokenizers would short-circuit the autonomy contract and make iterations incomparable. The pyproject templates explicitly exclude transformers, timm, stable-baselines3, and AutoML libraries so every result reflects the agent's own design.