iamhelitha commited on
Commit
7814cfb
·
verified ·
1 Parent(s): 15ff5d0

Deploy from GitHub Actions (branch: main, sha: d3f7e1a6)

Browse files
Files changed (2) hide show
  1. README.md +15 -24
  2. examples/sample_aerial_1.jpg +2 -2
README.md CHANGED
@@ -27,12 +27,11 @@ pinned: false
27
  [![HuggingFace Model](https://img.shields.io/badge/%F0%9F%A4%97%20HuggingFace-Model-yellow)](https://huggingface.co/iamhelitha/EleFind-yolo11-elephant)
28
  [![GitHub](https://img.shields.io/badge/GitHub-EleFind--gradio--ui-181717?logo=github)](https://github.com/iamhelitha/EleFind-gradio-ui)
29
 
30
- A web application for detecting elephants in aerial and drone imagery using [YOLOv11](https://docs.ultralytics.com/) with [SAHI](https://github.com/obss/sahi) (Slicing Aided Hyper Inference) and explainable AI heatmap visualizations.
31
 
32
  ## Features
33
 
34
  - Real-time elephant detection with bounding boxes and confidence scores
35
- - XAI Gaussian density heatmaps highlighting detection hotspots
36
  - Adjustable SAHI parameters (confidence, slice size, overlap, IoU)
37
  - Confidence bar charts and per-detection data tables
38
  - Automatic model download from HuggingFace Hub
@@ -50,6 +49,20 @@ python app.py
50
 
51
  Open [http://127.0.0.1:7860](http://127.0.0.1:7860) in your browser. The model downloads automatically on first run.
52
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
53
  ## Model
54
 
55
  | Property | Value |
@@ -93,28 +106,6 @@ Open [http://127.0.0.1:7860](http://127.0.0.1:7860) in your browser. The model d
93
  <img src="assets/val_batch0_pred.jpg" alt="Validation predictions" width="80%"/>
94
  </p>
95
 
96
- ## Getting Started
97
-
98
- ```bash
99
- git clone https://github.com/iamhelitha/EleFind-gradio-ui.git
100
- cd EleFind-gradio-ui
101
- pip install -r requirements.txt
102
-
103
- # Run the app (model auto-downloads from HuggingFace)
104
- python app.py
105
-
106
- # Run tests
107
- pytest test_detection.py -v
108
- pytest test_detection.py -v -m "not slow" # skip inference tests
109
- ```
110
-
111
- ### Environment Variables
112
-
113
- | Variable | Description | Default |
114
- |---|---|---|
115
- | `HF_MODEL_REPO` | HuggingFace model repository | `iamhelitha/EleFind-yolo11-elephant` |
116
- | `HF_MODEL_FILE` | Model filename in the repository | `best.pt` |
117
-
118
  ## Project Structure
119
 
120
  ```
 
27
  [![HuggingFace Model](https://img.shields.io/badge/%F0%9F%A4%97%20HuggingFace-Model-yellow)](https://huggingface.co/iamhelitha/EleFind-yolo11-elephant)
28
  [![GitHub](https://img.shields.io/badge/GitHub-EleFind--gradio--ui-181717?logo=github)](https://github.com/iamhelitha/EleFind-gradio-ui)
29
 
30
+ A web application for detecting elephants in aerial and drone imagery using [YOLOv11](https://docs.ultralytics.com/) with [SAHI](https://github.com/obss/sahi) (Slicing Aided Hyper Inference).
31
 
32
  ## Features
33
 
34
  - Real-time elephant detection with bounding boxes and confidence scores
 
35
  - Adjustable SAHI parameters (confidence, slice size, overlap, IoU)
36
  - Confidence bar charts and per-detection data tables
37
  - Automatic model download from HuggingFace Hub
 
49
 
50
  Open [http://127.0.0.1:7860](http://127.0.0.1:7860) in your browser. The model downloads automatically on first run.
51
 
52
+ ### Testing
53
+
54
+ ```bash
55
+ pytest test_detection.py -v
56
+ pytest test_detection.py -v -m "not slow" # skip inference tests
57
+ ```
58
+
59
+ ### Environment Variables
60
+
61
+ | Variable | Description | Default |
62
+ |---|---|---|
63
+ | `HF_MODEL_REPO` | HuggingFace model repository | `iamhelitha/EleFind-yolo11-elephant` |
64
+ | `HF_MODEL_FILE` | Model filename in the repository | `best.pt` |
65
+
66
  ## Model
67
 
68
  | Property | Value |
 
106
  <img src="assets/val_batch0_pred.jpg" alt="Validation predictions" width="80%"/>
107
  </p>
108
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
109
  ## Project Structure
110
 
111
  ```
examples/sample_aerial_1.jpg CHANGED

Git LFS Details

  • SHA256: 11239769f2f9fc33bae85099c415bd534f436a3951168c16b87c594f8c0cf0d7
  • Pointer size: 132 Bytes
  • Size of remote file: 3.33 MB

Git LFS Details

  • SHA256: f0b71bf6066db205cd0f248cddac3a216171865153dcbb58901c2864fc9ec3d0
  • Pointer size: 132 Bytes
  • Size of remote file: 9.03 MB