Update README.md

README.md

@@ -11,3 +11,63 @@ license: mit
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# 🧠 Brain Tumor Detection using YOLOv8 🎯  
+
+## 🚀 Overview  
+This **Hugging Face Space** allows users to **upload MRI scan images** and detect the presence of a **brain tumor** using the **YOLOv8** object detection model. The model processes the uploaded image and provides an annotated output indicating whether a tumor is detected.
+
+🔹 **Built with:** `YOLOv8` | `Gradio` | `PyTorch` | `OpenCV`  
+🔹 **Live on Hugging Face Spaces!** ✅  
+
+## ✨ Features  
+✔️ **Upload MRI scan images** 🏥  
+✔️ **YOLOv8-powered brain tumor detection** 🧠  
+✔️ **Annotated image output with tumor detection** 📸  
+✔️ **Real-time diagnosis message** ⏳  
+✔️ **Simple & intuitive UI powered by Gradio** 🎨  
+
+---
+
+## 🛠 How to Use  
+1️⃣ **Upload an MRI image** by clicking the "Upload MRI Image" button.  
+2️⃣ **Click "Submit"** to analyze the image.  
+3️⃣ **View the results**:
+   - The uploaded MRI image with **bounding boxes** (if a tumor is detected).
+   - A **diagnosis message** ("Tumor Detected" or "No Tumor Detected").  
+
+✅ **No installation required!** Just visit the Hugging Face Space and start detecting brain tumors instantly.
+
+---
+
+## 📁 Model Details  
+This app uses **YOLOv8**, an advanced object detection model fine-tuned for **brain tumor detection**.  
+- **Default model:** `yolov8n.pt` (Replace with `best.pt` for custom-trained model).  
+- **Bounding box output** with confidence score.  
+- **Fast & accurate inference** using PyTorch.  
+
+---
+
+## 🏗 Deployment on Hugging Face Spaces  
+### **1️⃣ Create a New Hugging Face Space**  
+Go to **[Hugging Face Spaces](https://huggingface.co/spaces)** and create a new **Gradio** Space.
+
+### **2️⃣ Upload the following files:**  
+- **`app.py`** (Main Gradio app)  
+- **`requirements.txt`** (Dependencies)  
+- **`model/best.pt`** (Your trained YOLOv8 model)  
+
+### **3️⃣ Run the Space!**  
+Hugging Face will **automatically install dependencies** and deploy the app.  
+
+---
+
+## 📜 Dependencies (Auto-installed in Hugging Face)  
+```text
+gradio
+torch
+torchvision
+ultralytics
+opencv-python
+numpy
+