rajahshan commited on
Commit
14e0b6c
·
verified ·
1 Parent(s): f88dcdf

Initial FactoryVision AI model package (private review)

Browse files
Files changed (5) hide show
  1. README.md +66 -0
  2. SOURCE.md +8 -0
  3. labels.json +12 -0
  4. metrics.json +7 -0
  5. model.pt +3 -0
README.md ADDED
@@ -0,0 +1,66 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ pipeline_tag: object-detection
5
+ library_name: ultralytics
6
+ tags:
7
+ - industrial-vision
8
+ - factoryvision-ai
9
+ - ppe-detection
10
+ - education
11
+ - yolo11
12
+ ---
13
+ # FactoryVision AI — PPE YOLO11n (fine-tuned)
14
+
15
+ **FactoryVision AI — Credits and Attribution**
16
+
17
+ **Original Developer & Model Author:** Thevanth Rajamohan
18
+ **Technical Review, Code Contributions & Model Publication Support:** Swapin Vidya
19
+ **Publishing Organisation:** TechSphere Consultancy Services Private Limited
20
+ **Hugging Face:** https://huggingface.co/TechsphereAI
21
+ **Official Website:** https://techsphereconsultancy.com/
22
+
23
+ **Project Provenance:** FactoryVision AI was originally developed by Thevanth Rajamohan. Swapin Vidya contributed technical review, detection-metrics improvements, testing, model publication preparation and documentation. The models are being prepared for publication under TechSphere Consultancy Services Private Limited's Hugging Face namespace, with the original developer's permission.
24
+
25
+ **Original GitHub Repository:** https://github.com/Theivanth/Factory-Vision-AI
26
+ **Merged contribution by Swapin Vidya:** https://github.com/Theivanth/Factory-Vision-AI/pull/1
27
+
28
+ ## Purpose and limitations
29
+ Educational object detection for people and PPE-related objects in factory/construction images. **Not a certified industrial safety system.** Detected PPE status is only a suggested alert requiring human review; it cannot establish a worker's actual PPE compliance or substitute for a trained safety inspector. In particular, missed detections mean unsafe situations may go unflagged.
30
+
31
+ ## Architecture and files
32
+ - Fine-tuned Ultralytics YOLO11n; original starting checkpoint `yolo11n.pt`
33
+ - Weights: `model.pt` (archive `checkpoints/ppe_yolo.pt`)
34
+ - 10 classes: see `labels.json`
35
+ - Training: 30 configured epochs, 640px image size, batch size 16; the training script uses a held-out PPE test split
36
+
37
+ ## Training data
38
+ Construction Site Safety Image Dataset, attributed to Snehil Sanyal / Roboflow Universe, referenced by the source project: https://www.kaggle.com/datasets/snehilsanyal/construction-site-safety-image-dataset-roboflow . Source project lists CC BY 4.0 for this dataset; verify provenance and attribution requirements before public release. Dataset images are not included in this model package.
39
+
40
+ ## Held-out test performance (from the supplied Kaggle output)
41
+ - Precision (bounding boxes): **0.8400**
42
+ - Recall (bounding boxes): **0.6398**
43
+ - mAP@50: **0.7053**
44
+ - mAP@50:95: **0.3927**
45
+
46
+ The numbers above are reported by the training artefact `ppe_test_metrics.json`, not independently reproduced. The reported test split has 82 images; class-specific breakdown is not included in this package. Do not confuse the separate pretrained YOLO COCO person baseline with this PPE result.
47
+
48
+ ## Example inference
49
+ ```python
50
+ from ultralytics import YOLO
51
+ model = YOLO('model.pt')
52
+ results = model.predict('your_image.jpg', conf=0.25)
53
+ for result in results:
54
+ print(result.boxes)
55
+ ```
56
+
57
+ Note: object detections alone do not perform the project's person-to-helmet association. The original application implements an additional alert logic layer; consult its source and use human review.
58
+
59
+ ## Licensing and redistribution
60
+ - Ultralytics YOLO11 and its fine-tuned checkpoints have AGPL-3.0 obligations by default, or require a suitable enterprise licence for uses incompatible with AGPL-3.0. See https://www.ultralytics.com/license
61
+ - The source repository's MIT licence does **not** automatically license this trained checkpoint, pretrained weights, or source datasets.
62
+ - The original developer has reportedly authorised publication; the publisher must still confirm the specific publication terms and applicable third-party rights.
63
+ - **Do not assign an MIT/Apache model licence or switch to public visibility until licensing has been checked and recorded.**
64
+
65
+ ## Known limitations
66
+ Domain shift, lighting, small objects, occlusion, crowded scenes, cameras and inference thresholds may reduce performance. False negatives are especially concerning for PPE alerting.
SOURCE.md ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
 
1
+ Source: https://github.com/Theivanth/Factory-Vision-AI
2
+ Original Project Developer and Model Author: Thevanth Rajamohan
3
+ Technical Reviewer, Code Contributor and Hugging Face Publication Support: Swapin Vidya
4
+ Publishing Organisation: TechSphere Consultancy Services Private Limited
5
+ Hugging Face: https://huggingface.co/TechsphereAI
6
+ Official Website: https://techsphereconsultancy.com/
7
+ Swapin Vidya's merged contribution: https://github.com/Theivanth/Factory-Vision-AI/pull/1
8
+ Model checkpoint SHA-256: f5e40e04ea7819a0b6cb9579b28c4e4f4227c7b6941d924c8b2beeee39f127c8
labels.json ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ [
2
+ "Hardhat",
3
+ "Mask",
4
+ "NO-Hardhat",
5
+ "NO-Mask",
6
+ "NO-Safety Vest",
7
+ "Person",
8
+ "Safety Cone",
9
+ "Safety Vest",
10
+ "machinery",
11
+ "vehicle"
12
+ ]
metrics.json ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ {
2
+ "metrics/precision(B)": 0.8400341147197301,
3
+ "metrics/recall(B)": 0.6397617577867072,
4
+ "metrics/mAP50(B)": 0.7053377987370262,
5
+ "metrics/mAP50-95(B)": 0.3926973285767887,
6
+ "fitness": 0.3926973285767887
7
+ }
model.pt ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:f5e40e04ea7819a0b6cb9579b28c4e4f4227c7b6941d924c8b2beeee39f127c8
3
+ size 5507546