git404hub

what is roger-that fr?

tanisha-byte/roger-that — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

tl;dr

A grading tool that tests AI voice and chat agents using real air traffic control procedures, scoring them with a parser instead of another AI judge.

vibe map

mindmap
  root((Roger That))
    What it does
      Deterministic scoring
      ATC-based scenarios
      No LLM judge
    Tech stack
      Python
      FastAPI
      SQLite
    Use cases
      Voice agent grading
      Chat model campaigns
      Session replay dashboard
    Audience
      Developers
      Agent builders
    Setup
      Python venv
      Bolna API key
      OpenAI-compatible key

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

Grade a voice or chat AI agent's responses against strict, rule-based readback requirements.

VIBE 2

Run randomized aviation-style test scenarios so an agent cannot memorize the answers.

VIBE 3

Replay a graded session as a visual animation to see where an agent succeeded or failed.

what's the stack?

PythonFastAPISQLitepytest

how it stacks up fr

tanisha-byte/roger-that0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

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

how do i run it?

Difficulty · moderate time til it works · 1h+

Live phone testing requires a Bolna API key, grading a real language model requires an OpenAI-compatible API key.

in plain english

Roger That is a testing tool for AI voice and chat agents that uses real air traffic control radio procedures as its exam. In real aviation, every instruction a controller gives has a required, exact readback, so a pilot cannot just say something that sounds close, it has to match specific rules. This project takes that same strict structure and uses it to grade AI agents without needing another AI to act as the judge. Instead, a parser checks the agent's response against the rules directly, which makes scoring repeatable and fair. The project includes six scenario types, such as a descent instruction, a rapid sequence of commands, a callsign mix-up trap, a case where the agent mishears something, and an emergency situation, and each one is randomized with a seed so an agent cannot just memorize answers. A scorer module reads the transcript, converts spoken numbers and the phonetic alphabet into a standard form, checks whether the agent caught any traps or made any hearing errors, and produces a weighted score. The scorer agrees with human graders on a hand-labeled test set at least 99% of the time. You can run this two ways: place a real outbound phone call to a live Bolna voice agent and grade the actual conversation, or run a text-based campaign against any OpenAI-compatible language model. Results are stored in a database and viewable through a dashboard with two views, one that replays a session as a pixel-art radar animation showing successes and mistakes, and one that shows a leaderboard, learning curves over time, and full transcripts. Setup involves creating a Python virtual environment, installing dependencies, and running the test suite before starting the dashboard with uvicorn. Live phone testing needs a Bolna API key, and testing language models directly needs an OpenAI-compatible API key. The project also includes an experimental learning-loop feature for helping agents improve between sessions, though the README notes this part has not been tested against a live system yet.

prompts (copy fr)

prompt 1
Help me set up Roger That's test environment and run the pytest suite locally.
prompt 2
Explain how Roger That's scorer grades a readback without using an LLM judge.
prompt 3
Walk me through running a campaign against an OpenAI-compatible model using OpenAICompatPilot.
prompt 4
Show me how to add a new scenario YAML file to Roger That's scenario engine.

Frequently asked questions

what is roger-that fr?

A grading tool that tests AI voice and chat agents using real air traffic control procedures, scoring them with a parser instead of another AI judge.

What language is roger-that written in?

Mainly Python. The stack also includes Python, FastAPI, SQLite.

How hard is roger-that to set up?

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

Who is roger-that for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.