whatisgithub

What is autotrainess?

simple-agent-lab/autotrainess — explained in plain English

Analysis updated 2026-05-18

15PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A research framework that gives an AI agent structured tools to plan, train, evaluate, and improve language models on its own.

Mindmap

mindmap
  root((AutoTrainess))
    What it does
      Agent trains language models
      Structured training interfaces
      Closed plan train eval loop
    Tech stack
      Python
      LlamaFactory training
      Codex and OpenCode agents
    Use cases
      Autonomous post-training
      PostTrainBench evaluation
      Reusable agent skills
    Audience
      ML researchers
      LLM training engineers
      Agent framework builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give an autonomous coding agent structured tools to run a full LLM training and evaluation cycle.

USE CASE 2

Compare an agent's performance with and without the AutoTrainess structured interfaces.

USE CASE 3

Reuse the AutoTrainHub planning, data, training, and evaluation skills in a Codex or OpenCode setup.

USE CASE 4

Study the accompanying paper and PostTrainBench results on autonomous post-training.

What is it built with?

PythonLlamaFactoryCodexOpenCode

How does it compare?

simple-agent-lab/autotrainess0pen-sourcer/hearth13127905/deep-learning-based-air-gesture-text-recognition-
Stars151515
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/53/53/5
Audienceresearchervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Full pipeline requires GPU training infrastructure and the separate full-code branch, this branch is instructions and skills only.

The README does not state a license.

So what is it?

AutoTrainess is a research framework that lets an AI agent improve other language models on its own, instead of a human engineer running the training process step by step. Rather than giving the agent a bare command line and letting it figure out what to do, the project provides a structured set of tools, called AutoTrainHub, that mirror the steps an experienced training engineer would follow: plan the next iteration, prepare the data, run the training, evaluate the results, and log what happened, then repeat. The paper behind this project tested the approach on a benchmark called PostTrainBench, comparing agents that only had command line access against agents using AutoTrainess's structured tools, under the same ten hour GPU budget. Four base models were tested, Qwen3-1.7B, Qwen3-4B, SmolLM3-3B, and Gemma-3-4B, across seven benchmark areas including math, code, function calling, knowledge, health, and general instruction following. The results table in the README shows AutoTrainess outperforming the command line only setup across the agent combinations tested, with gains ranging from about 3.6 to 7.5 points depending on the pairing. Each part of the toolkit handles one stage of the loop. The planning tool produces a specific hypothesis and success criterion for the next training attempt. The data tool selects and validates training examples while checking for leakage and formatting errors. The training tool uses LlamaFactory, an existing training library, to run a stable process that exports a ready to evaluate model. The evaluation tool runs real benchmarks and captures raw output and failure details, and the logging tool keeps a persistent record of experiments across long running sessions. Together these are meant to reduce common problems in unsupervised training runs, like broken data formats, wrong chat templates, and lost experiment history. This branch of the repository contains only the instruction files and reusable skills, meant to be copied into a Codex or OpenCode agent setup. The complete benchmark runner, agent wrappers, and full pipeline live on a separate branch called full-code, which users are told to check out if they want to run the entire evaluation process rather than just reuse the planning and training instructions.

Copy-paste prompts

Prompt 1
Explain what each of AutoTrainess's five interfaces, iteration_plan, data, train, eval, and log, actually does in the training loop.
Prompt 2
Help me copy AutoTrainess's AGENTS.md and skills into a Codex or OpenCode workspace to try it out.
Prompt 3
Summarize the PostTrainBench results comparing CLI-only agents to AutoTrainess across the four base models.
Prompt 4
What is the difference between this branch of AutoTrainess and the full-code branch, and when would I need the full-code branch?

Frequently asked questions

What is autotrainess?

A research framework that gives an AI agent structured tools to plan, train, evaluate, and improve language models on its own.

What language is autotrainess written in?

Mainly Python. The stack also includes Python, LlamaFactory, Codex.

What license does autotrainess use?

The README does not state a license.

How hard is autotrainess to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is autotrainess for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.