gitwtfhub

wtf is loop-ttt?

alvinzh04/loop-ttt — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · researcherLicense

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

PythonPyTorchHugging Face

How it stacks up

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.