README.md

# Radiology Report Training System

A Gradio app for teaching radiology residents and medical students how to read and report chest X-rays. This app uses the MIMIC-CXR dataset and DeepSeek's LLM for report analysis and feedback.

## Features

- View chest X-ray images with zoom functionality
- Input findings through typing or dictation
- Compare against ground truth findings and impressions
- Get AI-powered feedback on your report quality
- Hide ground truth for self-testing
- Support for both dataset images and custom uploads

## How to Use

1. Enter your DeepSeek API key in the provided input box
2. Click "Load Random Case" to get a new chest X-ray
3. Study the image and write your findings in the input box
4. Click "Submit Report" to get feedback
5. Use the "Hide Ground Truth" checkbox to test yourself

## Dataset

This app uses the [MIMIC-CXR dataset](https://huggingface.co/datasets/itsanmolgupta/mimic-cxr-dataset) (limited to 10 cases for this MVP version).

## Technical Details

- Built with Gradio
- Uses DeepSeek's LLM for report analysis
- Supports image upload and clipboard paste
- Provides zoom functionality for detailed image examination

## Requirements

See requirements.txt for full dependencies.