Update README.md

README.md

@@ -9,5 +9,92 @@ app_file: app.py
 pinned: false
 short_description: Transparent Touch Overlay Image
 ---
+# 🖼️ Overlay Image Composer
 
+A Gradio app for overlaying one image over another with adjustable **position**, **scale**, **transparency**, and optional **flip** or **grayscale** effects.
+
+Ideal for creating creative image compositions, watermarked visuals, and basic graphics design — all from the browser!
+
+---
+
+## 🚀 Features
+
+- 📤 Upload background and overlay images
+- ✨ Adjust overlay position (X/Y)
+- 🔍 Resize overlay using scale slider
+- 🕶️ Control overlay transparency
+- 🔄 Flip the overlay image horizontally
+- ⚫ Convert overlay to grayscale
+- 💾 Download the final composed image
+
+---
+
+## 📦 Requirements
+
+Install required libraries:
+
+```bash
+pip install -r requirements.txt
+
+requirements.txt
+
+gradio
+Pillow>=10.0.0
+
+▶️ Running the App
+
+Run the app locally:
+
+python app.py
+
+Once running, you will see something like:
+
+Running on local URL: http://127.0.0.1:7860
+
+Open the link in your browser.
+🌐 Hosting on Hugging Face Spaces
+
+    Create a new Space on Hugging Face Spaces
+
+    Select Gradio as the SDK
+
+    Upload:
+
+        app.py
+
+        requirements.txt
+
+    Click "Commit" and wait for the Space to build and deploy
+
+📸 How to Use
+
+    Upload a background image (base layer)
+
+    Upload an overlay image (top layer)
+
+    Adjust the X/Y position, scale, and transparency sliders
+
+    Optionally flip or grayscale the overlay
+
+    Click Generate Composite
+
+    Click Download to save the final image
+
+📝 Example Use Cases
+
+    Creating simple posters or memes
+
+    Adding semi-transparent logos/watermarks
+
+    Designing collages or layered illustrations
+
+    Quick visual experiments for digital artists
+
+📄 License
+
+MIT License
+❤️ Credits
+
+Built using Gradio and Pillow
+Developed by Your Jasvir Singh
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference