README.md

---
title: 'MediAgent AI: Your Conversational Health Navigator'
emoji: 🧬
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
secrets:
- MODAL_BACKEND_URL
---

# 🧬 MediAgent AI: Your Conversational Health Navigator

**MediAgent AI** is a sophisticated, conversational health assistant designed to provide reliable, sourced, and easy-to-understand answers to a wide range of medical questions.

This application is built with a decoupled architecture: a modern Gradio UI hosted on Hugging Face Spaces and a powerful, serverless GPU backend running on [Modal](https://modal.com).

## 🚀 Key Features

- 🌐 **Multilingual Support**: Automatically detects and responds in English, French, Spanish, and Hindi.
- 💬 **Conversational & Stateful**: Remembers the chat history to understand follow-up questions.
- 👤 **Role-Based Adaptation**: Tailors its language and the tools it uses based on whether you select **Patient** or **Doctor**.
- 🛠️ **Multi-Tool Capability**: Uses a powerful toolkit to search the web, PubMed, clinical trials, and drug databases to find the best answer.
- 🛡️ **Safety First**: Includes a critical safety layer to detect potential emergencies and provide appropriate disclaimers.

---

## 🧪 Try It In Your Language!

Copy and paste one of the examples below to test the AI's multilingual capabilities.

### English

What are the most common side effects of metformin?

### Spanish

Cuáles son los síntomas de la diabetes tipo 2?

### French

Comment savoir si j'ai la grippe ou un simple rhume ?

### Hindi

उच्च रक्तचाप के लिए घरेलू उपचार क्या हैं?

---

## 🧑‍⚕️ See The Role-Based Difference

Select a role in the UI and use a matching prompt below to see how the AI adapts its response.

### For the Patient Role

Select **patient** and ask a general health question. The AI will use web search to provide an easy-to-understand overview.

What are the most common side effects I should watch out for with lisinopril?

### For the Doctor Role

Select **doctor** and ask a technical, multi-part question. The AI will use specialized tools like PubMed and ClinicalTrials.gov to provide a detailed, sourced answer.

My patient with Crohn's is on methotrexate and we are considering adding infliximab. I need the latest PubMed literature on efficacy, a check for interactions between the two drugs, and a list of ongoing clinical trials for novel biologics in IBD.