git404hub

what is read fr?

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.

vibe map

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

what do people make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

what's the stack?

PythonOpenAI APIAnthropic APIHugging Face

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 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.

in plain english

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.

prompts (copy fr)

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

what is read fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.