git404hub

what is minirouter fr?

mini-router/minirouter — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · researcherComplexity · 5/5Setup · hard

tl;dr

A competition workspace that trains a tiny router deciding which of several language models should answer each question, instead of using one big model.

vibe map

mindmap
  root((MiniRouter))
    What it does
      Routes questions to models
      Tiny trained router head
      Evolution based training
    Tech stack
      Python
      PyTorch
      PostgreSQL
      GitHub Actions
    Use cases
      Train routing head
      Benchmark model pool
      Run validator backend
    Results
      Beats single models on average
      Math headroom found
      MMLU near ceiling
    Audience
      ML researchers
      Competition miners

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 make with this?

VIBE 1

Train a small routing head that learns which language model to call for a given question.

VIBE 2

Benchmark a pool of language models against a single trained router on math and knowledge tasks.

VIBE 3

Run the validator backend to evaluate and score competition submissions from other participants.

VIBE 4

Use the oracle-ceiling diagnostic to check how much headroom a better router could still capture.

what's the stack?

PythonPyTorchPostgreSQLGitHub Actions

how it stacks up fr

mini-router/minirouter920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity5/53/52/5
Audienceresearcherresearchergeneral

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

how do i run it?

Difficulty · hard time til it works · 1day+

Needs GPU hardware (project trains on an NVIDIA H200) plus API access to the pooled models.

in plain english

MiniRouter is a workspace built for a competition called Gittensor, where participants try to build a small, cheap system that decides which of several language models should answer a given question. Instead of training one giant model to answer everything, the project trains a tiny router that picks the right specialist model and role for each question. The router itself is small on purpose. A frozen 0.6 billion parameter encoder reads a question and turns it into a single vector, and a much smaller head, about 10,000 parameters, uses that vector to decide which model should answer and in what role. This small head is trained using an evolution style method called separable CMA-ES, which breeds many candidate routing heads and keeps the ones that perform best, based only on whether the final answer was right or wrong. The repository wires together three open source models, an automatic grader for math, general knowledge, and coding questions, and tooling for miners (competition participants) to submit and evaluate their own trained routers. It includes training and evaluation code, benchmark configurations, a validator backend that stores submissions in a database, and a public competition website with a leaderboard. A GitHub Actions workflow automatically labels and tracks submission pull requests as they move through review and evaluation. The project reports real benchmark results. Across two tasks, math and general knowledge questions, the trained router scored higher on average than any single model in its pool, because different models are strong at different subjects. The authors also built a diagnostic tool to check how much room a perfect router could still improve on, which showed genuine unused potential on the math task that their current router does not fully capture yet. This is a research and competition codebase written mostly in Python, aimed at people comfortable with machine learning training pipelines, evaluation benchmarks, and running jobs on GPU hardware. It documents its own workflow for contributors, including branch naming rules and where finished model submissions should be placed.

prompts (copy fr)

prompt 1
Explain how the 0.6B encoder and 10K parameter routing head work together to pick a model.
prompt 2
Walk me through setting up the validator backend and the DATABASE_URL for submission evaluation.
prompt 3
Show me how separable CMA-ES trains the routing head using only right or wrong rewards.
prompt 4
Summarize the oracle-ceiling diagnostic and what it found about headroom on the math benchmark.

Frequently asked questions

what is minirouter fr?

A competition workspace that trains a tiny router deciding which of several language models should answer each question, instead of using one big model.

What language is minirouter written in?

Mainly Python. The stack also includes Python, PyTorch, PostgreSQL.

How hard is minirouter to set up?

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

Who is minirouter for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.