whatisgithub

What is loop-ttt?

alvinzh04/loop-ttt — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · researcherLicense

In one sentence

Research code studying looped language models, showing accuracy peaks at a trained depth then declines, and testing a tiny per batch adjustment that partly restores it.

Mindmap

mindmap
  root((Loop-TTT))
    What it does
      Studies looped Ouro models
      Tests test time training
    Tech stack
      Python
      PyTorch
      Hugging Face
    Use cases
      Depth curve experiments
      TTT accuracy studies
    Audience
      Researchers
      ML engineers

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

Reproduce the depth curve experiments showing where a looped Ouro model's accuracy peaks and then declines.

USE CASE 2

Apply the test time training update to a looped language model and measure its effect on math accuracy.

USE CASE 3

Inspect the curated results and generation logs behind the blog post's figures without rerunning experiments.

What is it built with?

PythonPyTorchHugging Face

How does it compare?

alvinzh04/loop-ttt0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhard
Complexity4/54/5
Audienceresearcherdeveloperresearcher

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

So what is it?

Loop-TTT is the code and data behind a research blog post about a type of AI language model called a looped, or recurrent depth, model. Instead of running through a fixed set of layers once, a looped model like the one studied here, called Ouro, can apply the same core block of layers multiple times before producing an answer, so how many times it loops becomes an adjustable setting rather than something fixed by the model's design. The research finds that answer accuracy on math problems improves as you increase the number of loops, but only up to the depth the model was originally trained at. Beyond that point, accuracy starts to fall again, as if the model overthinks the problem. Right at that peak point, the researchers try a small adjustment: updating about 100 tiny scaling values inside the model, done fresh for each batch of examples and then reset afterward, using a single step of a common optimization method. This small tweak improves the model's accuracy on generated math answers. The study's more surprising finding is that exactly where in the model this adjustment is applied matters more than whether it happens at all, and that much of the improvement behaves less like the model actually learning something new from each example and more like a reusable adjustment that works across many prompts. The repository includes the core code library for loading the Ouro models, preparing datasets and prompts, and the test time training update itself, along with the exact scripts used to run each experiment and produce each figure in the blog post. Curated result files are included so the reported numbers can be checked without rerunning every experiment, though some raw experiment folders behind certain plots are not part of this release. Running the experiments requires downloading Ouro model checkpoints from Hugging Face and using a GPU. The code is released under the MIT license, while the underlying model checkpoints and benchmark datasets remain under their own separate licenses.

Copy-paste prompts

Prompt 1
Help me set up the Ouro checkpoints and loopsteer package to reproduce this project's experiments.
Prompt 2
Explain how the test time training update to RMSNorm scale vectors works in this codebase.
Prompt 3
Walk me through regenerating Figure 2, the depth by TTT sweep, from the provided scripts.
Prompt 4
Show me how the curated results.json and generations.jsonl files map to the paper's figures.

Frequently asked questions

What is loop-ttt?

Research code studying looped language models, showing accuracy peaks at a trained depth then declines, and testing a tiny per batch adjustment that partly restores it.

What language is loop-ttt written in?

Mainly Python. The stack also includes Python, PyTorch, Hugging Face.

Who is loop-ttt for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.