Update README.md

README.md

@@ -1,12 +1,38 @@
 ---
-title: Cardioqa Ai System
-emoji: 📚
-colorFrom: gray
+title: CardioQA AI System
+emoji: 🫀
+colorFrom: blue
 colorTo: red
 sdk: docker
 pinned: false
 license: mit
-short_description: 'AI-Powered Cardiac Diagnostic Assistant with RAG '
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# CardioQA - AI-Powered Cardiac Diagnostic Assistant 🫀
+
+Professional cardiac health assistant powered by **RAG** (Retrieval-Augmented Generation), **ChromaDB**, and **Google Gemini 2.0**.
+
+## 🌟 Features
+- 🫀 **364+ cardiac medical Q&As** - Comprehensive knowledge base
+- 🤖 **AI-powered responses** with Google Gemini 2.0 Flash
+- 🛡️ **Medical safety validation** - Emergency detection & warnings  
+- 📊 **Confidence scoring** - Dynamic response quality metrics
+- ⚡ **Real-time semantic search** - ChromaDB + Sentence Transformers
+- 🎯 **Professional safety features** - Medical disclaimers & consultation recommendations
+
+## 🚀 API Endpoints
+- **`/`** - API information & status
+- **`/health`** - System health check & database status
+- **`/query`** - Ask cardiac health questions (POST)
+- **`/docs`** - Interactive FastAPI documentation
+- **`/stats`** - System statistics & model information
+
+## 🛠️ Built With
+- **Backend:** FastAPI + Uvicorn
+- **AI Model:** Google Gemini 2.0 Flash
+- **Vector Database:** ChromaDB with persistent storage
+- **Embeddings:** Sentence Transformers (all-MiniLM-L6-v2)
+- **Safety:** Custom medical validation system
+- **Deployment:** Docker + HuggingFace Spaces
+
+## 📊 System Architecture