Spaces:
Sleeping
Sleeping
File size: 6,760 Bytes
9699bea 9f32f16 9699bea 9f32f16 9699bea d495234 9699bea d495234 9699bea | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 | ---
title: Agentic RagBot
emoji: 🏥
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: true
license: mit
app_port: 7860
tags:
- medical
- biomarker
- rag
- healthcare
- langgraph
- agents
short_description: Multi-Agent RAG System for Medical Biomarker Analysis
---
# 🏥 MediGuard AI — Medical Biomarker Analysis
A production-ready **Multi-Agent RAG System** that analyzes blood test biomarkers using 6 specialized AI agents with medical knowledge retrieval.
## ✨ Features
- **6 Specialist AI Agents** — Biomarker validation, disease prediction, RAG-powered analysis, confidence assessment
- **Medical Knowledge Base** — 750+ pages of clinical guidelines (FAISS vector store)
- **Evidence-Based** — All recommendations backed by retrieved medical literature
- **Free Cloud LLMs** — Uses Groq (LLaMA 3.3-70B) or Google Gemini
## 🚀 Quick Start
1. **Enter your biomarkers** in any format:
- `Glucose: 140, HbA1c: 7.5`
- `My glucose is 140 and HbA1c is 7.5`
- `{"Glucose": 140, "HbA1c": 7.5}`
2. **Click Analyze** and get:
- Primary diagnosis with confidence score
- Critical alerts and safety flags
- Biomarker analysis with normal ranges
- Evidence-based recommendations
- Disease pathophysiology explanation
## 🔧 Configuration
This Space requires at least one LLM API key. Configure secrets in **Space Settings → Secrets**.
### Required Secrets (pick one)
| Secret | Provider | Description | Get Free Key |
|--------|----------|-------------|--------------|
| `GROQ_API_KEY` | Groq | **Recommended** - Fast, free LLaMA 3.3-70B | [console.groq.com/keys](https://console.groq.com/keys) |
| `GOOGLE_API_KEY` | Google Gemini | Free Gemini 2.0 Flash | [aistudio.google.com](https://aistudio.google.com/app/apikey) |
### Optional: LLM Configuration
| Secret | Default | Description |
|--------|---------|-------------|
| `GROQ_MODEL` | `llama-3.3-70b-versatile` | Groq model to use |
| `GEMINI_MODEL` | `gemini-2.0-flash` | Gemini model to use |
| `LLM_PROVIDER` | auto-detected | Force provider: `groq` or `gemini` |
### Optional: Embeddings
| Secret | Default | Description |
|--------|---------|-------------|
| `EMBEDDING_PROVIDER` | `huggingface` | Provider: `jina`, `google`, or `huggingface` |
| `JINA_API_KEY` | - | High-quality 1024d embeddings ([jina.ai](https://jina.ai/)) |
### Optional: Observability (Langfuse)
| Secret | Description |
|--------|-------------|
| `LANGFUSE_ENABLED` | Set to `true` to enable tracing |
| `LANGFUSE_PUBLIC_KEY` | Langfuse public key |
| `LANGFUSE_SECRET_KEY` | Langfuse secret key |
| `LANGFUSE_HOST` | Langfuse host URL (e.g., `https://cloud.langfuse.com`) |
## 🏗️ Architecture
```
┌─────────────────────────────────────────────────────────┐
│ Clinical Insight Guild │
├─────────────────────────────────────────────────────────┤
│ ┌───────────────────────────────────────────────────┐ │
│ │ 1. Biomarker Analyzer │ │
│ │ Validates values, flags abnormalities │ │
│ └───────────────────┬───────────────────────────────┘ │
│ │ │
│ ┌────────────┼────────────┐ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Disease │ │Biomarker │ │ Clinical │ │
│ │Explainer │ │ Linker │ │Guidelines│ │
│ │ (RAG) │ │ │ │ (RAG) │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │
│ └────────────┼────────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ 4. Confidence Assessor │ │
│ │ Evaluates reliability, assigns scores │ │
│ └───────────────────┬───────────────────────────────┘ │
│ ▼ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ 5. Response Synthesizer │ │
│ │ Compiles patient-friendly summary │ │
│ └───────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
```
## 📊 Supported Biomarkers
| Category | Biomarkers |
|----------|------------|
| **Diabetes** | Glucose, HbA1c, Fasting Glucose, Insulin |
| **Lipids** | Cholesterol, LDL, HDL, Triglycerides |
| **Kidney** | Creatinine, BUN, eGFR |
| **Liver** | ALT, AST, Bilirubin, Albumin |
| **Thyroid** | TSH, T3, T4, Free T4 |
| **Blood** | Hemoglobin, WBC, RBC, Platelets |
| **Cardiac** | Troponin, BNP, CRP |
## ⚠️ Medical Disclaimer
This tool is for **informational purposes only** and does not replace professional medical advice, diagnosis, or treatment. Always consult a qualified healthcare provider with questions regarding a medical condition.
## 📄 License
MIT License — See [GitHub Repository](https://github.com/yourusername/ragbot) for details.
## 🙏 Acknowledgments
Built with [LangGraph](https://langchain-ai.github.io/langgraph/), [FAISS](https://faiss.ai/), [Gradio](https://gradio.app/), and [Groq](https://groq.com/).
|