---
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/).