gitwtfhub

wtf is read?

ibm/read — explained in plain English

Analysis updated 2026-05-18

21PythonAudience · researcherComplexity · 4/5Setup · moderate

TL;DR

A research toolkit that tests whether an AI judge model actually reasons from the policy text it is given, rather than answering from memorized patterns.

Mindmap

mindmap
  root((READ))
    What it does
      Tests policy grounding
      Perturbs policy text
      Classifies failure modes
    Tech stack
      Python
      OpenAI API
      Anthropic API
    Use cases
      AI safety research
      Judge model evaluation
      Paper reproduction
    Audience
      AI safety researchers
      LLM evaluators

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

Test whether an LLM-as-judge system is genuinely grounded in the policy text it is shown.

REASON 2

Diagnose failure modes like prior-based guessing or confusion in an AI judge's verdicts.

REASON 3

Reproduce the benchmark results from the associated academic paper on policy grounding.

What's in the stack?

PythonOpenAI APIAnthropic APIHugging Face

How it stacks up

ibm/read0whitedev/detranspiler2951461586/mulerun-pool
Stars212121
LanguagePythonPythonPython
Setup difficultymoderatehardmoderate
Complexity4/54/53/5
Audienceresearcherdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an OpenAI or Anthropic API key and downloads a roughly 125 MB dataset from Hugging Face on first run.

No license is stated in the visible portion of the README.

Wtf does this do

READ is a research toolkit from IBM for testing whether an AI system used as a judge, one that decides if content violates a written policy, is actually reading and reasoning about that policy or just guessing from what it learned during training. It is the companion code for an academic paper under review at a 2026 AI ethics and society conference. The tool works by asking the same question to a judge model multiple times with small variations: once with the full policy, once with no policy at all, once with the specific rule that was supposedly broken removed, and once with other unrelated rules removed one at a time. By comparing how the judge's verdict changes across these variations, the framework can tell whether the judge is genuinely anchored to the correct rule, ignoring the policy entirely, or getting confused by unrelated details. Results get sorted into labeled categories such as Faithful, Confused, Prior Based, or Policy Degraded. It ships as a Python package with a command line interface, and works with judge models from OpenAI or Anthropic, requiring you to supply your own API key for whichever provider you use. It downloads its test dataset automatically from Hugging Face on first run, drawing on a published benchmark covering domains like HR policy, education, and social media moderation. The output is a spreadsheet style CSV of verdicts that can then be summarized into statistics with confidence intervals. This project fits AI safety researchers and practitioners who build or evaluate LLM based judges and want a rigorous way to check whether those judges are trustworthy, rather than developers building general purpose applications.

Yoink these prompts

Prompt 1
Explain what it means for an AI judge to be 'policy grounded' versus answering from prior training.
Prompt 2
Walk me through running this benchmark against gpt-4o with my own OpenAI API key.
Prompt 3
What do the failure mode labels Faithful, Confused, and Policy-Degraded mean in this tool's output?
Prompt 4
How does removing a policy clause help detect whether a judge model is actually reading it?

Frequently asked questions

wtf is read?

A research toolkit that tests whether an AI judge model actually reasons from the policy text it is given, rather than answering from memorized patterns.

What language is read written in?

Mainly Python. The stack also includes Python, OpenAI API, Anthropic API.

What license does read use?

No license is stated in the visible portion of the README.

How hard is read to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is read for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

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