| --- |
| 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 |
|
|
|  |
|  |
|  |
|  |
|
|
| ## 🎯 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) |
