---
title: Clinical Decision Support Agent
emoji: 📈
colorFrom: green
colorTo: blue
sdk: gradio
app_file: app.py
pinned: false
license: mit
pipeline_tag: text-generation
base_model: mistralai/Mistral-7B-v0.1
tags:
- medical-ai
- llm
- clinical-decision-support
- langgraph
- pubmed
- groq
- llama
- agent
- medical
- rag
- nlp
- healthcare
- gradio
- langchain
---

# 🏥 Clinical Decision Support Agent

![Python](https://img.shields.io/badge/Python-3.10-blue)
![LLaMA](https://img.shields.io/badge/LLaMA-3.3%2070B-green)
![LangGraph](https://img.shields.io/badge/LangGraph-Agent-purple)
![HuggingFace](https://img.shields.io/badge/HuggingFace-Spaces-yellow)

## 🎯 Live Demo
👉 [Try it on Hugging Face Spaces](https://huggingface.co/spaces/mou11/clinical-decision-support-agent)

## 🔍 Overview
A production-grade Medical AI Agent that takes patient symptoms as 
natural language input, searches real PubMed medical literature 
automatically, and generates structured clinical recommendations 
with citations. Built with LangGraph for agent orchestration and 
Groq (LLaMA 3.3 70B) for clinical reasoning.

## 📊 Results

| Metric | Score |
|--------|-------|
| BERTScore Precision | 0.8449 |
| BERTScore Recall | 0.8887 |
| BERTScore F1 | 0.8663 |

## 🧪 Test Cases

| Case | Symptoms | Urgency Level |
|------|----------|--------------|
| Case 1 | Fever, cough, chest pain | High ✅ |
| Case 2 | Stiff neck, fever, confusion | Emergency ✅ |
| Case 3 | Chest pain radiating to left arm, diabetes | Emergency ✅ |

## ✨ Features

- ✅ Real-time PubMed literature search via NCBI API
- ✅ LLM-powered clinical reasoning (LLaMA 3.3 70B via Groq)
- ✅ Structured output: conditions, tests, treatments, urgency
- ✅ Multi-turn conversation memory
- ✅ BERTScore quality evaluation
- ✅ Interactive Gradio web interface

## 🏗️ Architecture

Patient Symptoms → Extract Search Query (LLM) → Search PubMed 
(NCBI API) → Generate Recommendation (LLaMA 3.3 70B) → 
Format Report → Gradio UI

## 🛠️ Tech Stack

| Component | Tool |
|-----------|------|
| Agent Orchestration | LangGraph |
| LLM | Groq — LLaMA 3.3 70B |
| Medical Literature | PubMed NCBI API |
| Evaluation | BERTScore |
| UI | Gradio |
| Platform | Kaggle T4 GPU |

## 🚀 How to Run

1. Get a free Groq API key at [console.groq.com](https://console.groq.com)
2. Clone the Space and install requirements
3. Set your Groq API key as environment variable
4. Run `python app.py`

## ⚠️ Medical Disclaimer

This system is for educational and research purposes only. 
It does not provide medical advice. Always consult a qualified 
healthcare professional for medical decisions.

## 📌 Part of Medical AI Portfolio

1. ✅ Pneumonia Detection (ViT + Grad-CAM)
2. ✅ Clinical Decision Support Agent (LangGraph + RAG) — this project
3. ✅ Medical LLM Fine-tuning (QLoRA)
4. ✅ Medical Report Generator (Hallucination Detection + FHIR)