Update README.md

README.md

@@ -13,4 +13,83 @@ colorTo: indigo
 short_description: WellBe+ Agent, integrating Healthcare & Whoop MCP servers
 ---
 
-Try it on [HuggingFace Spaces](https://huggingface.co/spaces/natasha1704/WellBePlusAssistant)
+# 🫀 WellBe+ Assistant – Your Personalized Health Intelligence Agent
+
+<p align="center"><img width="60%" src="docs/images/logo.png" alt="WellBe+ logo"/></p>
+
+> AI-powered medical Q&A assistant that fuses **real-time health data** with **trusted clinical knowledge** to deliver personalized, evidence-based insights.
+
+---
+
+## What is WellBe+?
+
+**WellBe+ Assistant** is a multi-context agent built with OpenAI’s **Agents SDK**. It intelligently handles data from two secure **MCP (Model Context Protocol) servers** deployed on Hugging Fzces spaces:
+
+- **Healthcare MCP** – queries FDA drug info, PubMed literature, and clinical safety resources  
+- **Whoop MCP** – accesses real-time biometric and recovery metrics from Whoop 
+
+Whether you're wondering about medication side effects or investigating how your sleep has changed since starting a new prescription, WellBe+ can combine multiple sources to answer with **precision, personalization, and clinical grounding**.
+
+---
+
+## Features
+
+- **Drug Interactions & Adverse Effects**: FDA and literature-based answers
+- **Personal Health Trends**: Uses WHOOP metrics to track your sleep, strain, recovery, and performance
+- **Contextual Reasoning**: Combines multiple data sources when needed for holistic answers
+- **Scientific Transparency**: Queries PubMed and public APIs for clear traceability
+- **Built on Agents SDK**: Modular, expandable, and production-ready with tool-routing intelligence
+
+---
+
+## Example Queries
+
+- *"What are the adverse effects of Tamoxifen?"*  
+- *"I’ve been on Prozac for 3 months. Do you notice any sleep changes? What are its most common side effects?"*  
+- *"Is it safe to take ibuprofen with sertraline?"*  
+- *"Does my strain level impact my recovery score over the past two weeks?"*
+
+---
+
+## MCP Servers in Use
+
+| Server Type    | Description                                  | Link                                                                                  |
+|----------------|----------------------------------------------|---------------------------------------------------------------------------------------|
+| Healthcare MCP | FDA, PubMed, clinical data                   | [Explore](https://huggingface.co/spaces/Agents-MCP-Hackathon/healthcare-mcp-public)   |
+| Whoop MCP      | Recovery, strain, workouts, sleep from WHOOP | [Explore](https://huggingface.co/spaces/Agents-MCP-Hackathon/whoop-mcp-server)        |
+
+---
+
+## How to Run Locally (Optional with Custom Data)
+
+If you want to run WellBe+ assistant locally, please refer to Github [project](https://github.com/Alea4jacta6est/drug-interaction-checker-agent):
+
+## Demo
+
+Coming Soon
+
+## Why WellBe+?
+
+Healthcare is personal. Your assistant should be too.
+WellBe+ bridges generic medical knowledge and your real-world health data to give answers that are not just correct—but relevant to you.
+
+Whether you’re a curious patient, a health-conscious athlete, or a healthcare professional, WellBe+ provides:
+	•	Faster answers
+	•	Safer decisions
+	•	Smarter wellness tracking
+
+## Tech Stack
+	•	OpenAI Agents SDK
+	•	MCP Protocols (via Hugging Face spaces)
+	•	OpenFDA, PubMed APIs
+    •	Whoop Biometric Data Feed
+	•	Gradio Interface
+
+## License
+
+MIT
+
+## Support & Contributions
+	•	Open an issue or discussion
+	•	Contact us via Hugging Face Spaces discussions
+	•	Pull requests welcome!