Skip to content

README.md

Latest commit

 

History

History
99 lines (67 loc) · 2.52 KB

README.md

File metadata and controls

99 lines (67 loc) · 2.52 KB
Raw

🖼️ Python Personalised Image Generator (GUI)

A Python-based GUI application that allows users to generate personalised images by combining their own photo with their favourite animal or plant.
The project focuses on GUI design, API integration, image processing, and clean application flow.

This is my first complete Python GUI project, built with a strong emphasis on real-world development practices.

✨ Features

  • Multi-screen interactive GUI built using Tkinter
  • User name input with personalised greeting
  • Choice between Animal or Plant
  • Intelligent validation of animal/plant names using Wikipedia API
  • Image upload from local system
  • Automatic fetching of animal/plant images
  • Image processing using Pillow (PIL)
  • Final generated image preview inside the app
  • Clean error handling and user-friendly warnings
  • Back button navigation for smooth user experience

🎥 Project Demo

Watch the full execution demo of the application here:
👉 https://youtu.be/LpQyKQnc_Q4

🧠 How the Application Works

  1. User enters their name
  2. Chooses between Animal or Plant
  3. Enters a valid animal/plant name (validated via Wikipedia API)
  4. Uploads their own image
  5. The application processes and generates a combined image
  6. The final image is displayed and saved locally

🛠️ Tech Stack

  • Python 3
  • Tkinter – GUI development
  • Pillow (PIL) – Image processing
  • Requests – API calls
  • Wikipedia REST API – Data validation

📂 Project Structure

Python-Personalised-Image-generator-GUI/ │ ├── first_file.py # Main application file ├── README.md # Project documentation ├── .gitignore # Git ignore rules

🎯 Learning Outcomes

Through this project, I learned:

  • Building structured GUI applications in Python
  • Managing multi-frame navigation in Tkinter
  • Making safe and validated API calls
  • Handling user input and edge cases
  • Image manipulation and rendering
  • Using Git & GitHub professionally

🔮 Future Improvements

  • AI-based image generation for true personalisation
  • Background removal and better image blending
  • Loading indicators and UI animations
  • Export gallery for generated images
  • Improved layout and styling

🚀 How to Run the Project

  1. Clone the repository

    git clone https://github.com/bhoomi72/Python-Personalised-Image-generator-GUI.git

  2. Install dependencies

    pip install pillow requests

  3. Run the application

    python first_file.py