Skip to content

Art0citus/AI-Image-classification

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🖼️ Image Classification Web App

Deep Learning • TensorFlow • Streamlit

Python TensorFlow Streamlit OpenCV License

A portfolio-grade image classification web application built using a pre-trained MobileNetV2 model.
The app allows users to upload an image and receive the top-3 predictions with confidence scores in real time.


🔍 Overview

This project demonstrates an end-to-end machine learning workflow — from image preprocessing to model inference and UI deployment.

It focuses on practical ML engineering, not just model training, by showcasing:

  • Model integration
  • Image preprocessing pipelines
  • Performance optimization
  • Clean UI–ML separation
  • Deployment-ready architecture

🎯 Why This Project Matters

  • Demonstrates applied deep learning
  • Uses industry-standard tools
  • Shows understanding of ML deployment
  • Highlights clean engineering practices
  • Suitable for junior ML / AI / backend roles

🚀 Features

  • Upload images (jpg, jpeg, png)
  • Image classification using MobileNetV2
  • Displays Top-3 predictions with confidence
  • Cached model loading for faster inference
  • Interactive and responsive Streamlit UI

🧠 Model Details

Attribute Value
Model MobileNetV2
Dataset ImageNet
Input Size 224 × 224 × 3
Framework TensorFlow / Keras
Inference CPU

MobileNetV2 is optimized for speed and efficiency, making it suitable for real-time applications.


🏗️ High-Level Architecture

Image Upload ↓ PIL Image Loader (RGB) ↓ OpenCV Resize + Normalization ↓ MobileNetV2 Inference ↓ Decoded Predictions ↓ Streamlit UI


🧩 Tech Stack

  • Python
  • TensorFlow / Keras
  • Streamlit
  • OpenCV
  • NumPy
  • Pillow (PIL)

📁 Project Structure

├── main.py # Streamlit app & ML pipeline ├── requirements.txt # Project dependencies ├── README.md # Documentation └── .venv/ # Virtual environment (optional)


▶️ Run Locally

1️ Clone the repository

git clone https://github.com/your-username/image-classifier-streamlit.git
cd image-classifier-streamlit

2️ Create & activate virtual environment
python -m venv .venv


Windows

.venv\Scripts\activate


Mac / Linux

source .venv/bin/activate

3️⃣ Install dependencies
pip install -r requirements.txt

4️⃣ Run the app
uv run streamlit run main.py

About

AI Learning

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages