Your medical reports. Explained. Doctor visit ready.
Live: abhimishra01.github.io/report-ready
Every year in India, millions of people walk out of diagnostic labs holding reports they don't understand. Blood tests, MRI reports, discharge summaries — full of medical jargon, reference ranges, abbreviations.
They either:
- Ignore it and hope the doctor explains (average Indian doctor visit = 4 minutes)
- Google symptoms and spiral into health anxiety
- Ask a relative who also doesn't understand
- Pay for another consultation just to understand the first one
Western AI tools like ChatGPT Health require Apple Health integration, US medical records, iOS devices. They're built for San Francisco, not Sitapur.
ReportReady is for the person in Lucknow holding an Apollo Diagnostics PDF who just wants to know —
"Bhai, kya hua mujhe? Aur doctor se kya poochna chahiye?"
Upload your report. Get a plain English breakdown. Walk into your next doctor visit prepared — not confused.
Free. No login. No jargon.
- Upload a medical report PDF or paste report text
- Choose your AI provider and enter your API key
- Get a plain English breakdown of every finding
- See personalised questions to ask your doctor
- Download your prep sheet for the appointment
| Provider | Model | Cost per Report | Notes |
|---|---|---|---|
| Anthropic Claude | claude-haiku-4-5-20251001 | Default — Best accuracy | |
| OpenAI ChatGPT | gpt-4o-mini | Fast & reliable | |
| Google Gemini | gemini-1.5-flash | Free tier | Great for getting started |
Your API key is stored only in your browser's localStorage — never sent to any server.
- Open abhimishra01.github.io/report-ready
- Upload your report PDF (Blood test, MRI, Discharge summary, etc.)
- Select your AI provider
- Enter your API key (one-time — stored in browser)
- Click "Analyse Report"
- Read the plain English breakdown
- Copy the doctor questions and take them to your appointment
git clone https://github.com/abhimishra01/report-ready.git
cd report-ready
npm install
cp .env.example .env
# Add your API key to .env for Dev Mode
npm run devOpen http://localhost:5173/report-ready/
npm run deployThis runs vite build then deploys the dist folder to the gh-pages branch.
GitHub Pages setup: Set source to gh-pages branch in repository Settings → Pages.
- React + Vite — Fast development and build
- Tailwind CSS — Utility-first styling
- Framer Motion — Smooth animations with springy bounce
- pdfjs-dist — Client-side PDF text extraction
- html2canvas — Download report as image
- gh-pages — GitHub Pages deployment
100% client-side. No backend. No database. No login.
- Your medical reports are sent directly from your browser to the AI provider (Anthropic/OpenAI/Google)
- ReportReady servers never see your report or API key
- Your API key is stored in
localStorage— only on your device - Clear site data in your browser to remove all stored data
ReportReady is for informational purposes only and does not constitute medical advice. Always consult a qualified doctor before making health decisions. This tool is not a medical device and has not been validated by medical professionals.
Abhishek Mishra — github.com/abhimishra01
Built with love for India 🇮🇳 — where doctor appointments last 4 minutes and reports last a lifetime.