Arekku21 commited on
Commit
29f47d6
·
1 Parent(s): 13b6ff6

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +63 -1
README.md CHANGED
@@ -10,4 +10,66 @@ pinned: false
10
  license: cc-by-4.0
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
+ ```