Update README.md

README.md

@@ -11,9 +11,51 @@ pinned: false
 short_description: Streamlit template space
 ---
 
-# Welcome to Streamlit!
+# 🧠 Facial Keypoints Detection
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+A Streamlit application that predicts facial keypoints using a trained ResNet model.
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+---
+
+## 📌 What this app does
+
+- Upload a face image
+- Converts image to grayscale
+- Resizes to 96x96
+- Predicts facial keypoints (eyes, nose, mouth, etc.)
+- Visualizes the keypoints directly on the image
+
+---
+
+## 🖼 Example Workflow
+
+1. Upload a front-facing face image
+2. Model predicts keypoints
+3. Red dots appear on facial landmarks
+
+---
+
+## 🏗 Model
+
+- Architecture: ResNet-based CNN
+- Input shape: 96x96 grayscale
+- Output: (x, y) coordinates for facial landmarks
+- Loss used during training: MSE
+
+---
+
+## 🛠 Tech Stack
+
+- Streamlit
+- TensorFlow / Keras
+- NumPy
+- Matplotlib
+- Pillow
+
+---
+
+## 🚀 Run locally
+
+```bash
+pip install -r requirements.txt
+streamlit run src/streamlit_app.py