huggingface/README.md

metadata

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
GOOGLE_API_KEY	Google Gemini	Free Gemini 2.0 Flash	aistudio.google.com

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)

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 for details.

🙏 Acknowledgments

Built with LangGraph, FAISS, Gradio, and Groq.