README.md

---
title: Transparent Touch
emoji: 👀
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 5.38.2
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