README.md

Covid19-Pneumonia-Detector

"Covid19-Pneumonia-Detector" is a Django-ReactJS Web App with an Artificial Intelligence. It can detect COVID-19 and Pneumonia from X-ray Images using CNN based on DenseNet121 architecture.

😷 Covid19 & Pneumonia Detector

.	.

In this project, I have a Django-React Web App which can detect COVID-19 & Pneumonia from cheast X-ray Images.

🎥 Live Demo

---

Table of contents

• Dataset
• Deep Learning Model
• Web App Backend
• Web App Frontend
• SUPPOERT
• LICENSE

📦 Dataset

.	Covid	Pneumonia	Normal
Dataset	576 images	4273 images	1583 images
samples

Train Set (80%)	Validation Set (20%)
5144 images	1288 images

🦾🤖 Deep Learning Model

this is the architecture of DenseNet121

🧐 Model Evaluation

Confusion Matrix	Accuracy Curve	Loss Curve

	Accuracy	Sensitivity	Specificity
	$$\frac{TP~+~TN}{TP~+~TN~+~FP~+~FN}$$	$$\frac{TP}{TP~+~FN}$$	$$\frac{TN}{TN~+~FP}$$
Covid19	99.76%	97.39%	100%
Pneumonia	95.04%	95.91%	93.33%
Normal	94.96%	91.25%	96.19%

👩‍💻 Web App Backend

First of all clone the project :

git clone https://github.com/BitterOcean/Covid19-Pneumonia-Detector-Backend.git

then, create a virtual enviroment and install python required packages :

mkvirtualenv -p /usr/bin/python3.10 venv
source ~/.virtualenvs/venv/bin/activate
pip3 install -r requirements.txt

finally, go to the project directory and run the bachend django server :

cd Covid19-Pneumonia-Detector-Backend
python3 manage.py migrate --run-syncdb
python3 manage.py runserver

Now the server will run on http://127.0.0.1:8000/

👩‍💻 Web App Frontend

step 0 : having Node js 16.x and npm installed

For Debian and Ubuntu based Linux distributions :

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - \ &&
sudo apt-get install -y nodejs

for other platforms, take a look at Nodejs Official Website.

then, install npm :

For Debian and Ubuntu based Linux distributions :

sudo apt install npm
sudo npm -g install create-react-app

for other platforms, use Google to find the instructions. 🙂.

Main Steps:

First of all clone the project :

git clone https://github.com/BitterOcean/Covid19-Pneumonia-Detector.git

then, go to the project directory and install required node modules :

npm i

after that, to use it locally, you have to change only one line in src/constants/routes.jsx, so :

cd Covid19-Detector/src/constants

and then change the first line, like below :

- export const API_ROOT = 'https://covid-19-pneumonia-detector-model.herokuapp.com';
+ export const API_ROOT = 'http://127.0.0.1:8000/';

and finally :

npm start

Now the frontend will run on http://127.0.0.1:3000/.
Eventually, here is the point that everything is ready and you can start using the the "Covid19-Pneumonia-Detector". 🙂.

📧 SUPPOERT

Reach out to me at one of the following places!

• Telegram at @BitterOcean
• Gmail at [email protected]

©️ LICENSE