gitwtfhub

wtf is one-layer-deeper?

tilde-research/one-layer-deeper — explained in plain English

Analysis updated 2026-05-18

46PythonAudience · researcherComplexity · 5/5Setup · hard

TL;DR

A machine learning competition where participants submit a Python model and optimizer that trains within a strict time and memory budget on an H100 GPU.

Mindmap

mindmap
  root((One Layer Deeper))
    What it does
      Model design competition
      Fixed time budget
      Fixed parameter limit
    Tech stack
      Python
      PyTorch
      H100 GPU
    Use cases
      Architecture research
      Optimizer research
      Leaderboard competition
    Audience
      ML researchers
      Competitive coders
    Setup
      uv tool install
      GitHub login
      Submission CLI

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

Compete in a research challenge to design the most parameter-efficient trainable model.

REASON 2

Practice model architecture and optimizer design against fixed time and memory budgets.

REASON 3

Submit and validate a model entry through the provided command line tool.

REASON 4

Study a working example submission that uses a standard Transformer and AdamW optimizer.

What's in the stack?

PythonPyTorchH100 GPUuv

How it stacks up

tilde-research/one-layer-deeperagricidaniel/goghbetta-tech/harness-sdd
Stars464646
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity5/53/52/5
Audienceresearcherdeveloperdeveloper

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

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires access to an Nvidia H100 GPU and a GitHub account to authenticate with the submission service.

No license information was found in the explanation provided.

Wtf does this do

One Layer Deeper is a machine learning competition run by Core Automation and Tilde Research, along with the code needed to take part in it. The challenge asks participants to design the best possible neural network model and training setup for a fixed problem, while staying within a strict limit on how much memory the model can use and how long it can train on a single Nvidia H100 graphics card, which is a type of chip commonly used to train AI models. Entrants control the model's architecture, how deep it is, which optimizer trains it, how the learning rate changes over time, and the training loss function used to measure mistakes during training. The competition organizers, referred to as the evaluator, control everything else: the training data, the outer training loop, and how the final result is scored. A submission is a single Python file that defines a model builder function and an optimizer builder function, following a fixed contract so the evaluator can plug it into its own training pipeline automatically. There are three difficulty tiers. Easy gives 60 seconds of training time and allows many attempts per day, Medium gives 600 seconds with fewer attempts allowed, and Hard gives a full hour of training time but only one accepted attempt per day, using a private dataset that participants cannot inspect directly. The Easy and Medium tiers are meant for practice, while the public leaderboard only ranks each participant's best successful attempt on the Hard tier. The rules are detailed and strict. A model can hold at most 500 million parameters, roughly the individual numbers that make up what the model has learned, submissions cannot depend on files outside the one submitted file, and attempts to game the scoring system on the Hard tier result in an immediate ban. The project provides a command line tool, installed with a package manager called uv, that handles logging in through GitHub, validating a submission file, submitting it for evaluation, checking its status, and viewing the public leaderboard. A basic example submission using a standard Transformer model and the AdamW optimizer is included as a starting point.

Yoink these prompts

Prompt 1
Walk me through installing the one-layer CLI and submitting the baseline AdamW example.
Prompt 2
Explain the difference between the Easy, Medium, and Hard tiers in this competition.
Prompt 3
Help me write a build_model and build_optimizer function that follows this repo's submission contract.
Prompt 4
Explain the 500 million parameter limit and how persistent buffers count toward it.
Prompt 5
Summarize the competition rules I need to follow to avoid disqualification.

Frequently asked questions

wtf is one-layer-deeper?

A machine learning competition where participants submit a Python model and optimizer that trains within a strict time and memory budget on an H100 GPU.

What language is one-layer-deeper written in?

Mainly Python. The stack also includes Python, PyTorch, H100 GPU.

What license does one-layer-deeper use?

No license information was found in the explanation provided.

How hard is one-layer-deeper to set up?

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

Who is one-layer-deeper for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

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