explaingit

ajay6601/clinicalbench

Analysis updated 2026-08-11 · repo last pushed 2026-04-02

PythonAudience · pm founderComplexity · 3/5MaintainedSetup · moderate

TLDR

ClinicalBench tests whether AI judges can reliably catch mistakes in medical AI outputs before they reach patients. It evaluates automated judges on factuality, safety, hallucination, and completeness against known-correct answers.

Mindmap

mindmap
  root((repo))
    What it does
      Tests AI judge reliability
      Scores medical AI outputs
      Validates against known answers
    Evaluation dimensions
      Factuality
      Safety
      Hallucination
      Completeness
    Use cases
      Automated quality gates
      Threshold configuration
      Catching unsafe outputs
    Tech stack
      Python
      AI model APIs
    Key findings
      Cheap models work well
      Hallucination judge weakest
      Costs 10 to 14 dollars

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 build with it?

USE CASE 1

Set up automated quality gates that block unsafe medical AI outputs or flag borderline ones for human review.

USE CASE 2

Run a second AI judge model as an independent reference to check agreement with your primary judge.

USE CASE 3

Inject fake medical claims into correct answers to test whether your AI judge catches hallucinations.

USE CASE 4

Configure stricter safety thresholds for high-risk contexts like emergency medicine versus general health Q&A.

What is it built with?

PythonOpenAI APILLM Judges

How does it compare?

ajay6601/clinicalbench0verflowme/learnings0verflowme/r2ai
LanguagePythonPythonPython
Last pushed2026-04-022022-06-182025-11-19
MaintenanceMaintainedDormantQuiet
Setup difficultymoderateeasymoderate
Complexity3/51/53/5
Audiencepm founderresearcherdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires API keys for AI model providers and approximately $10-14 in API costs to run the full evaluation pipeline.

No license information provided, so assume all rights are reserved by the author.

In plain English

ClinicalBench helps you figure out whether you can trust AI to automatically catch dangerous mistakes in medical AI outputs, without a human reviewer checking every response. If you're building a clinical AI product and want to use an AI "judge" to approve or block answers before they reach patients, this project tests how reliable that judge actually is. The framework runs medical questions through several AI models, then has automated judges score each answer on four dimensions: factuality, safety, hallucination, and completeness. It validates those judge scores against known-correct answers to see whether the judges give high marks to good answers and low marks to bad ones. You can also run a second judge model as an independent reference to check agreement, and inject fake medical claims into correct answers to see if the judge catches them. A healthcare startup founder or product manager building a clinical AI feature would use this to set up automated quality gates, rules that block unsafe outputs or flag borderline ones for human review. For example, you might configure stricter thresholds for emergency medicine responses than for general health Q&A. The project includes calibrated thresholds based on real testing, so you know what tradeoff you're making between catching errors and false alarms. The results are surprisingly encouraging: the factuality judge catches nearly all wrong answers while rarely flagging correct ones, and a cheap model works almost as well as an expensive one. The hallucination judge is the weakest link, the author recommends running two models and taking the stricter score to improve it. The whole evaluation pipeline costs about $10-14 in API calls. The author openly notes the limitations: the test data is clean multiple-choice questions rather than messy real-world clinical text, and there are no physician-reviewed annotations. The framework and thresholds transfer, but you'd want to retest with data that matches your actual deployment context before trusting it in production.

Copy-paste prompts

Prompt 1
I'm building a clinical AI feature and want to use an AI judge to approve or block medical answers before they reach patients. How do I use ClinicalBench to test whether my judge reliably catches wrong answers without too many false alarms?
Prompt 2
Help me set up ClinicalBench to evaluate my medical AI model's outputs on factuality, safety, hallucination, and completeness, and calibrate thresholds that decide what gets auto-approved versus flagged for human review.
Prompt 3
I want to run two AI judge models on my medical AI outputs and take the stricter score for hallucination detection. Show me how to configure ClinicalBench for this dual-judge approach.
Prompt 4
My clinical AI product handles both general health Q&A and emergency medicine. How do I use ClinicalBench to set different safety thresholds for each context based on real testing data?
Prompt 5
I need to estimate the API cost of running ClinicalBench's full evaluation pipeline on my medical question set. What should I expect to spend and how can I optimize it?

Frequently asked questions

What is clinicalbench?

ClinicalBench tests whether AI judges can reliably catch mistakes in medical AI outputs before they reach patients. It evaluates automated judges on factuality, safety, hallucination, and completeness against known-correct answers.

What language is clinicalbench written in?

Mainly Python. The stack also includes Python, OpenAI API, LLM Judges.

Is clinicalbench actively maintained?

Maintained — commit in last 6 months (last push 2026-04-02).

What license does clinicalbench use?

No license information provided, so assume all rights are reserved by the author.

How hard is clinicalbench to set up?

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

Who is clinicalbench for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.