README.md

metadata

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:

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