[Task] Add README

[Description] Added readme file and performed some minor fixes.
[Author]

@alifalhasan

Makefile

@@ -1,13 +0,0 @@
-PROJECT = "Deep Learning Project 1"
-AUTHOR = "Alif Al Hasan"
-RELEASE = "0.0.1"
-
-.SILENT:
-.ONESHELL:
-
-docs:
-	echo "Generating docs..." && \
-	cd docs && \
-	sphinx-quickstart -q -p ${PROJECT} -a ${AUTHOR} -r ${RELEASE} --ext-viewcode --ext-todo --ext-autodoc
-
-.PHONY: docs

README.md

@@ -10,4 +10,126 @@ pinned: false
 license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Top 5 EPL Teams' Emblem Identifier
+A simple and well designed web app to identify the emblem of the top 5 teams of **EPL(English Premier League)** namely **Arsenal, Chelsea, Liverpool, Manchester City** and **Manchester United**.
+
+
+### Requirements
+- [Python 3.11](https://python.org/)
+- [NumPy](https://numpy.org/)
+- [SciPy](https://scipy.org/)
+- [Gradio](https://www.gradio.app/)
+- [Tensorflow](https://tensorflow.org/)
+
+
+### Table Of Contents
+-  [Introduction](#introduction)
+-  [Model Architecture](#model-architecture)
+-  [Project Architecture](#project-architecture)
+-  [How To Run](#how-to-run)
+-  [License](#license)
+-  [Contributor](#contributor)
+
+
+### Introduction
+A simple and well designed web app to identify the emblem of the top 5 teams of **EPL**. This model has been trained with a balanced dataset which contains almost **5k** images of the emblems of the teams.
+
+
+### Model Architecture
+The model utilizes a straightforward convolutional neural network (CNN) architecture, comprising the following layers:
+
+1. **Convolutional Layer:**
+   - 32 filters, each of size 3x3
+   - ReLU activation function
+   - Input shape: 224x224x3 (RGB images)
+   - Extracts spatial features from input images.
+
+2. **Max Pooling Layer:**
+   - Pool size: 2x2
+   - Reduces spatial dimensions for capturing more global features.
+
+3. **Flattening Layer:**
+   - Flattens the 2D feature maps into a 1D vector for input to dense layers.
+
+4. **Dense Layer 1:**
+   - 64 neurons
+   - ReLU activation function
+
+5. **Output Layer (Dense Layer 2):**
+   - 5 neurons (matching the number of classes)
+   - Softmax activation to produce probability scores for each class.
+
+**Key Points:**
+- Input image size: 224x224 pixels
+- Optimizer: Adam with a learning rate of 0.001
+- Loss function: Categorical crossentropy
+- Performance metric: Accuracy
+
+**Visual Representation:**
+[Input image (224x224x3)] --> [Conv2D] --> [MaxPooling2D] --> [Flatten] --> [Dense 1] --> [Output Layer (Dense 2)] --> [Predicted class]
+
+
+### Prject Architecture
+```
+├──  data
+│    └── arsenal  - images of arsenal's emblem.
+│    └── chelsea  - images of chelsea's emblem.
+│    └── liverpool  - images of liverpool's emblem.
+│    └── manchester-city  - images of manchester-city's emblem.
+│    └── manchester-united  - images of united's emblem.
+│
+│
+├──  model  
+│    └── football_logo_model.h5  - generated model.
+│ 
+│
+├──  src
+│    └── classify
+│        └── classify.py  - this module classifies the emblem from input image.
+│    └── train
+│        └── trainer.py  - this module trains the model.
+│
+│
+├──  app.py - this module starts the app interface.
+│
+│
+├──  LICENSE - license file of this project.
+│
+│
+├──  README.md - readme file of this project.
+│
+│
+├──  requirements.txt - list of required packages.
+```
+
+### How To Run
+First, install dependencies   
+```bash
+# clone project   
+git clone https://huggingface.co/spaces/alifalhasan/deep-learning-1
+
+# install project   
+cd deep-learning-1 
+pip install -r requirements.txt
+```
+
+Next, download the dataset from [here](https://drive.google.com/file/d/1O5Mm-86AlUf5fUYf1NS8J_t22h7h_UbQ/view?usp=sharing). First unzip the folder. **dataset** folder contains **five** more folders. Copy them and paste into the **data** directory of this project folder.
+
+Now train the model using this command:  
+```bash
+python src/train/trainer.py    
+```
+
+Finally, deploy the model using this command:  
+```bash
+python app.py    
+```
+
+### License
+Distributed under the MIT License. See `LICENSE` for more information.
+
+
+### Contributor
+Alif Al Hasan - [@alifalhasan](https://huggingface.co/alifalhasan) - alif.stu2017@juniv.edu
+
+Project Link: [https://huggingface.co/spaces/alifalhasan/deep-learning-1](https://huggingface.co/spaces/alifalhasan/deep-learning-1)