dhecaptain/MedGemma

0

stars

1

commits

Python

primary language

Jan 16, 2026

updated

README

MedGemma Impact Challenge Submission

πŸ₯ Project: AI-Powered Radiology Assistant

An AI-powered radiology assistant that uses MedGemma to help radiologists analyze medical images, generate preliminary reports, and provide clinical decision support.

πŸ“‹ Competition Overview

Prize Tracks

  • Main Track: $75,000 (1st: $30k, 2nd: $20k, 3rd: $15k, 4th: $10k)
  • Agentic Workflow Prize: $10,000 (Two $5k prizes)
  • Edge AI Prize: $5,000
  • Novel Task Prize: $10,000 (Two $5k prizes)

🎯 Submission Requirements

Mandatory Components

  1. βœ… High-quality writeup (3 pages or less) - see docs/writeup.md
  2. βœ… Reproducible code - this repository
  3. βœ… Video demo (3 minutes or less) - to be created

Evaluation Criteria

CriteriaWeightDescription
Effective use of HAI-DEF models20%Appropriate use of MedGemma/HAI-DEF models
Problem domain15%Importance of problem, clarity of definition
Impact potential15%Real-world impact if solution works
Product feasibility20%Technical feasibility, deployment considerations
Execution and communication30%Quality of demo, writeup, and code

πŸš€ Quick Start

Prerequisites

  • Python 3.10+
  • CUDA-compatible GPU (recommended: 16GB+ VRAM for MedGemma 4B)
  • Hugging Face account with HAI-DEF terms accepted

Installation

# Clone the repository
cd /home/david/Documents/medgemma

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Accept HAI-DEF terms on Hugging Face
# Visit: https://huggingface.co/google/medgemma-4b-it

# Login to Hugging Face
huggingface-cli login

Running the Application

# Run the Gradio demo
python app.py

# Or run with Streamlit
streamlit run streamlit_app.py

πŸ“ Project Structure

medgemma/
β”œβ”€β”€ README.md                 # This file
β”œβ”€β”€ requirements.txt          # Python dependencies
β”œβ”€β”€ app.py                    # Main Gradio application
β”œβ”€β”€ streamlit_app.py          # Alternative Streamlit app
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ __init__.py
β”‚   β”œβ”€β”€ model.py             # MedGemma model wrapper
β”‚   β”œβ”€β”€ agents.py            # Agentic workflow components
β”‚   β”œβ”€β”€ utils.py             # Utility functions
β”‚   └── prompts.py           # Prompt templates
β”œβ”€β”€ notebooks/
β”‚   β”œβ”€β”€ 01_quickstart.ipynb  # Quick start notebook
β”‚   β”œβ”€β”€ 02_fine_tuning.ipynb # Fine-tuning example
β”‚   └── 03_evaluation.ipynb  # Model evaluation
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ writeup.md           # Competition writeup
β”‚   └── technical_details.md # Technical documentation
β”œβ”€β”€ tests/
β”‚   └── test_model.py        # Unit tests
└── examples/
    └── sample_images/       # Sample medical images for demo

πŸ”§ HAI-DEF Models Used

Primary Model

  • MedGemma 4B IT (google/medgemma-4b-it): Multimodal model for medical image and text comprehension

Supporting Models (Optional)

  • MedSigLIP (google/medsiglip-448): For medical image embeddings and retrieval
  • MedASR (google/medasr): For voice-based radiology dictation
  • MedGemma 27B (google/medgemma-27b-text-it): For complex clinical reasoning

πŸ“Š Use Cases Demonstrated

  1. Chest X-Ray Analysis: Automated analysis of chest radiographs
  2. Report Generation: AI-assisted radiology report drafting
  3. Clinical Q&A: Interactive question-answering about medical images
  4. Differential Diagnosis: AI-powered diagnostic suggestions

πŸ”— Resources

Official HAI-DEF Resources

Notebooks & Examples

⚠️ Important Disclaimers

  • MedGemma is NOT intended for direct clinical use without proper validation
  • All outputs require independent verification by qualified healthcare professionals
  • This is a demonstration application for the hackathon competition
  • Use of HAI-DEF models is subject to HAI-DEF Terms of Use

πŸ“ License

This project is licensed under CC BY 4.0 as required by the competition rules.

πŸ“§ Contact

[Your team information here]


Built with MedGemma for the MedGemma Impact Challenge 2026

Contributors

dhecaptain

1 commits

dhecaptain/MedGemma

0

stars

1

commits

Python

primary language

Jan 16, 2026

updated

README

MedGemma Impact Challenge Submission

πŸ₯ Project: AI-Powered Radiology Assistant

An AI-powered radiology assistant that uses MedGemma to help radiologists analyze medical images, generate preliminary reports, and provide clinical decision support.

πŸ“‹ Competition Overview

Prize Tracks

  • Main Track: $75,000 (1st: $30k, 2nd: $20k, 3rd: $15k, 4th: $10k)
  • Agentic Workflow Prize: $10,000 (Two $5k prizes)
  • Edge AI Prize: $5,000
  • Novel Task Prize: $10,000 (Two $5k prizes)

🎯 Submission Requirements

Mandatory Components

  1. βœ… High-quality writeup (3 pages or less) - see docs/writeup.md
  2. βœ… Reproducible code - this repository
  3. βœ… Video demo (3 minutes or less) - to be created

Evaluation Criteria

CriteriaWeightDescription
Effective use of HAI-DEF models20%Appropriate use of MedGemma/HAI-DEF models
Problem domain15%Importance of problem, clarity of definition
Impact potential15%Real-world impact if solution works
Product feasibility20%Technical feasibility, deployment considerations
Execution and communication30%Quality of demo, writeup, and code

πŸš€ Quick Start

Prerequisites

  • Python 3.10+
  • CUDA-compatible GPU (recommended: 16GB+ VRAM for MedGemma 4B)
  • Hugging Face account with HAI-DEF terms accepted

Installation

# Clone the repository
cd /home/david/Documents/medgemma

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Accept HAI-DEF terms on Hugging Face
# Visit: https://huggingface.co/google/medgemma-4b-it

# Login to Hugging Face
huggingface-cli login

Running the Application

# Run the Gradio demo
python app.py

# Or run with Streamlit
streamlit run streamlit_app.py

πŸ“ Project Structure

medgemma/
β”œβ”€β”€ README.md                 # This file
β”œβ”€β”€ requirements.txt          # Python dependencies
β”œβ”€β”€ app.py                    # Main Gradio application
β”œβ”€β”€ streamlit_app.py          # Alternative Streamlit app
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ __init__.py
β”‚   β”œβ”€β”€ model.py             # MedGemma model wrapper
β”‚   β”œβ”€β”€ agents.py            # Agentic workflow components
β”‚   β”œβ”€β”€ utils.py             # Utility functions
β”‚   └── prompts.py           # Prompt templates
β”œβ”€β”€ notebooks/
β”‚   β”œβ”€β”€ 01_quickstart.ipynb  # Quick start notebook
β”‚   β”œβ”€β”€ 02_fine_tuning.ipynb # Fine-tuning example
β”‚   └── 03_evaluation.ipynb  # Model evaluation
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ writeup.md           # Competition writeup
β”‚   └── technical_details.md # Technical documentation
β”œβ”€β”€ tests/
β”‚   └── test_model.py        # Unit tests
└── examples/
    └── sample_images/       # Sample medical images for demo

πŸ”§ HAI-DEF Models Used

Primary Model

  • MedGemma 4B IT (google/medgemma-4b-it): Multimodal model for medical image and text comprehension

Supporting Models (Optional)

  • MedSigLIP (google/medsiglip-448): For medical image embeddings and retrieval
  • MedASR (google/medasr): For voice-based radiology dictation
  • MedGemma 27B (google/medgemma-27b-text-it): For complex clinical reasoning

πŸ“Š Use Cases Demonstrated

  1. Chest X-Ray Analysis: Automated analysis of chest radiographs
  2. Report Generation: AI-assisted radiology report drafting
  3. Clinical Q&A: Interactive question-answering about medical images
  4. Differential Diagnosis: AI-powered diagnostic suggestions

πŸ”— Resources

Official HAI-DEF Resources

Notebooks & Examples

⚠️ Important Disclaimers

  • MedGemma is NOT intended for direct clinical use without proper validation
  • All outputs require independent verification by qualified healthcare professionals
  • This is a demonstration application for the hackathon competition
  • Use of HAI-DEF models is subject to HAI-DEF Terms of Use

πŸ“ License

This project is licensed under CC BY 4.0 as required by the competition rules.

πŸ“§ Contact

[Your team information here]


Built with MedGemma for the MedGemma Impact Challenge 2026

Contributors

dhecaptain

1 commits

Languages

Python

79.6%

Jupyter Notebook

18.9%

Dockerfile

1.6%