| --- |
| license: mit |
| title: MediAgent |
| sdk: docker |
| emoji: 🏥 |
| colorFrom: red |
| colorTo: gray |
| pinned: true |
| thumbnail: >- |
| https://cdn-uploads.huggingface.co/production/uploads/69e8826eb1347b4a2120bea7/py_Af1BHRw-N755ZiM4GO.jpeg |
| short_description: runs a 5-agent AI pipeline that analyzes medical images |
| --- |
| |
| # 🏥 MediAgent |
| ### Autonomous Multi-Agent Medical Imaging Analysis — AMD Instinct MI300X |
|
|
| > **AMD Developer Hackathon 2026 · Vision & Multimodal AI Track** |
| > Built by Ramyar — Sulaymaniyah, Iraq |
|
|
| --- |
|
|
| ## What It Does |
|
|
| MediAgent runs a 5-agent AI pipeline that analyzes medical images (X-ray, MRI, CT, DICOM) and generates formal radiology reports with differential diagnoses, ICD-10 codes, and FHIR R4 export — entirely on AMD hardware. |
|
|
| **No cloud APIs. No OpenAI. No Nvidia. Pure AMD MI300X + ROCm + vLLM.** |
|
|
| --- |
|
|
| ## ⚠️ Demo Mode |
|
|
| This Space runs in **demo mode** — the full pipeline UI works and all 5 agents animate live, but no real inference is performed since the AMD Instinct MI300X backend is not available on HuggingFace's free hardware. |
|
|
| **See the video demo for live inference on real AMD hardware.** |
|
|
| Live inference requires: AMD Instinct MI300X · ROCm · vLLM · Qwen multimodal |
|
|
| --- |
|
|
| ## The 5-Agent Pipeline |
|
|
| | Agent | Role | |
| |---|---| |
| | **INTAKE** | Validates input, normalizes clinical language, safety triage | |
| | **VISION** | Multimodal image analysis via Qwen on AMD MI300X | |
| | **RESEARCH** | KB cross-reference, differential diagnoses, ICD-10 codes | |
| | **REPORT** | ACR/NICE format radiology report synthesis | |
| | **CRITIC** | QA peer-review, quality scoring, disclaimer enforcement | |
|
|
| INTAKE + VISION run in **parallel** to minimize latency. |
|
|
| --- |
|
|
| ## Key Features |
|
|
| - Real-time SSE streaming pipeline with per-agent timers |
| - DICOM (.dcm) file support with metadata extraction |
| - 15-condition medical knowledge base with ICD-10 mapping |
| - FHIR R4 DiagnosticReport export |
| - Client-side PDF export |
| - Post-report clinical Q&A (ClinicalAdvisorAgent) |
| - Live AMD GPU metrics (util, VRAM, temp, power) |
| - Hard-enforced clinical safety rules |
|
|
| --- |
|
|
| ## Tech Stack |
|
|
| - **GPU:** AMD Instinct MI300X |
| - **GPU Software:** ROCm |
| - **Inference:** vLLM (ROCm build) + Qwen multimodal |
| - **Backend:** FastAPI + Uvicorn |
| - **Frontend:** Vanilla JS + Tailwind CSS + Chart.js + SSE |
|
|
| --- |
|
|
| ## GitHub |
|
|
| Full source code, architecture docs, and README: |
| **https://github.com/Ramyar2007/mediagent** |
|
|
| --- |
|
|
| *This system is a decision support tool. All outputs must be reviewed by a licensed radiologist before any clinical decisions are made.* |