Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
@@ -10,4 +10,66 @@ pinned: false
|
|
10 |
license: cc-by-4.0
|
11 |
---
|
12 |
|
13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10 |
license: cc-by-4.0
|
11 |
---
|
12 |
|
13 |
+
# Leprosy Detection App
|
14 |
+
|
15 |
+
Leprosy Gradio Detection web application. In this application, I have used a fine tuned YOLOv5s model to detect Leprosy samples based on images. The application uses gradio as the platform and can also be used in the [Huggingface online hosting application](https://huggingface.co/spaces/Arekku21/Leprosy-Detection).
|
16 |
+
|
17 |
+
## Overview
|
18 |
+
[Leprosy](https://en.wikipedia.org/wiki/Leprosy), also known as Hansen's disease, is a chronic infectious disease that primarily affects the skin and peripheral nerves. The model used is a YOLO model from [Ultralytics](https://github.com/ultralytics/yolov5) with their version YOLOv5.
|
19 |
+
|
20 |
+
### Features
|
21 |
+
|
22 |
+
- Upload an image to the app.
|
23 |
+
- Utilizes a fine-tuned YOLOv5s model for leprosy detection.
|
24 |
+
- Detect and label leprosy regions in the uploaded image.
|
25 |
+
|
26 |
+
## Prerequisites
|
27 |
+
|
28 |
+
Before running the application, make sure you have the following prerequisites installed on your system:
|
29 |
+
|
30 |
+
- Python 3.x
|
31 |
+
- Git
|
32 |
+
- Gradio
|
33 |
+
- Pip package manager
|
34 |
+
- Conda Virtual environment (optional but recommended)
|
35 |
+
|
36 |
+
### Installation Steps and Running the app
|
37 |
+
|
38 |
+
To install the required Python libraries, navigate to the project directory and run the following command:
|
39 |
+
|
40 |
+
#### Step 1 Clone the repository
|
41 |
+
```
|
42 |
+
# Make sure you have git-lfs installed (https://git-lfs.com)
|
43 |
+
git lfs install
|
44 |
+
git clone https://huggingface.co/spaces/Arekku21/Leprosy-Detection
|
45 |
+
|
46 |
+
# if you want to clone without large files – just their pointers
|
47 |
+
# prepend your git clone with the following env var:
|
48 |
+
GIT_LFS_SKIP_SMUDGE=1
|
49 |
+
```
|
50 |
+
|
51 |
+
#### Step 2 Install requirements
|
52 |
+
```
|
53 |
+
#navigate to your cloned repository and location of requirmenents.txt
|
54 |
+
pip install -r requirements.txt
|
55 |
+
```
|
56 |
+
|
57 |
+
#### Step 3 Run the app
|
58 |
+
```
|
59 |
+
#ensure that you are using the right environment or have all the requirements installed
|
60 |
+
#ensure that you are navigated to the cloned repository
|
61 |
+
python app.py
|
62 |
+
```
|
63 |
+
|
64 |
+
#### Step 4 Using the app
|
65 |
+
Your terminal should look like this and follow the local host URL link to use the application.
|
66 |
+
```
|
67 |
+
Downloading: "https://github.com/ultralytics/yolov5/zipball/master" to C:\Users\master.zip
|
68 |
+
|
69 |
+
YOLOv5 2023-9-28 Python-3.9.18 torch-2.0.1+cpu CPU
|
70 |
+
|
71 |
+
Fusing layers...
|
72 |
+
Model summary: 157 layers, 7015519 parameters, 0 gradients, 15.8 GFLOPs
|
73 |
+
Adding AutoShape...
|
74 |
+
Running on local URL: http://127.0.0.1:7860
|
75 |
+
```
|