nehulagrawal
commited on
Commit
β’
36735cf
1
Parent(s):
be275e1
Update readme1.md
Browse files- readme1.md +147 -0
readme1.md
CHANGED
@@ -0,0 +1,147 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
---
|
2 |
+
tags:
|
3 |
+
- ultralyticsplus
|
4 |
+
- yolov8
|
5 |
+
- ultralytics
|
6 |
+
- yolo
|
7 |
+
- vision
|
8 |
+
- object-detection
|
9 |
+
- pytorch
|
10 |
+
- retail
|
11 |
+
- shelf-detection
|
12 |
+
- mart
|
13 |
+
- mall
|
14 |
+
- inventory-management
|
15 |
+
library_name: ultralytics
|
16 |
+
library_version: 8.0.43
|
17 |
+
inference: false
|
18 |
+
model-index:
|
19 |
+
- name: foduucom/shelf-object-detection-yolov8
|
20 |
+
results:
|
21 |
+
- task:
|
22 |
+
type: object-detection
|
23 |
+
metrics:
|
24 |
+
- type: precision
|
25 |
+
value: 0.91
|
26 |
+
name: [email protected](box)
|
27 |
+
language:
|
28 |
+
- en
|
29 |
+
pipeline_tag: object-detection
|
30 |
+
---
|
31 |
+
|
32 |
+
<div align="center">
|
33 |
+
<img width="500" alt="foduucom/shelf-object-detection-yolov8" src="https://huggingface.co/foduucom/shelf-object-detection-yolov8/resolve/main/thumbnail.jpg">
|
34 |
+
</div>
|
35 |
+
|
36 |
+
# Model Card for YOLOv8 Shelf Object Detection in Retail Environments
|
37 |
+
|
38 |
+
## Model Enthusiasm π
|
39 |
+
|
40 |
+
Hey there, retail rockstar! π If you're ready to make your mart or mall experience a whole lot cooler, give this YOLOv8 Shelf Object Detection model a virtual high-five! π Your shelves will never be the same again, and neither will your customers' smiles.
|
41 |
+
|
42 |
+
## Model Magic β¨
|
43 |
+
|
44 |
+
The YOLOv8 Shelf Object Detection model is your new retail sidekick! It doesn't just detect objects; it's got a sixth sense for finding what you need on those shelves. Whether it's a jar of pickles or the latest gadget, this model's got you covered. And hey, it's a pro at counting too! So, say goodbye to empty spaces and hello to perfectly organized retail enchantment.
|
45 |
+
|
46 |
+
## Supported Labels π¬
|
47 |
+
|
48 |
+
```
|
49 |
+
['Empty Shelves', 'Magical Products']
|
50 |
+
```
|
51 |
+
|
52 |
+
## Collaboration Love β€οΈ
|
53 |
+
|
54 |
+
We're all about that collaboration groove! If you're as excited about this model as we are (and trust us, it's hard not to be), show some love with a thumbs up π. Let's work together to make retail dreams come true!
|
55 |
+
|
56 |
+
## Uses
|
57 |
+
|
58 |
+
### Direct Use
|
59 |
+
|
60 |
+
Integrate this model into your retail kingdom for real-time inventory harmony, shelf perfection, and automated restocking magic.
|
61 |
+
|
62 |
+
### Downstream Wonder
|
63 |
+
|
64 |
+
Want to optimize shelf layouts, unravel product placement mysteries, and sprinkle some sparkle into your customers' lives? This model's got your back!
|
65 |
+
|
66 |
+
### Not-So-Magic Disclaimers β‘
|
67 |
+
|
68 |
+
Just like a trusty wizard, this model might have its quirky moments:
|
69 |
+
|
70 |
+
- It might not be in sync with tricky lighting and shelf chaos. Keep those shelves tidy!
|
71 |
+
- Rapid changes in product vibes and shelf dances could affect its accuracy and spellcasting.
|
72 |
+
|
73 |
+
### Human Touch & Wizard Wisdom π§
|
74 |
+
|
75 |
+
Remember, every spellcaster has their quirks. Test and twirl within your retail realm before letting it loose on the magical stage.
|
76 |
+
|
77 |
+
## How to Join the Magic
|
78 |
+
|
79 |
+
To dive into the retail wizardry with the YOLOv8 Shelf Object Detection model, follow these enchanted steps:
|
80 |
+
```bash
|
81 |
+
pip install ultralyticsplus==0.0.28 ultralytics==8.0.43
|
82 |
+
```
|
83 |
+
|
84 |
+
- Summon the model and unveil its secrets:
|
85 |
+
|
86 |
+
```python
|
87 |
+
# Wave your wand (or keyboard) to get started!
|
88 |
+
from ultralyticsplus import YOLO, render_result
|
89 |
+
import cv2
|
90 |
+
|
91 |
+
# Cast a spell to summon the model
|
92 |
+
model = YOLO('foduucom/shelf-object-detection-yolov8')
|
93 |
+
|
94 |
+
# Tweak the magical parameters
|
95 |
+
model.overrides['conf'] = 0.25 # NMS confidence threshold
|
96 |
+
model.overrides['iou'] = 0.45 # NMS IoU threshold
|
97 |
+
model.overrides['agnostic_nms'] = False # NMS class-agnostic
|
98 |
+
model.overrides['max_det'] = 1000 # maximum number of detections per image
|
99 |
+
|
100 |
+
# set image
|
101 |
+
image = "path/to/your/shelf/image"
|
102 |
+
|
103 |
+
#you can pass live camera streaming or video
|
104 |
+
# Begin the mystical journey through video frames
|
105 |
+
# (Remember to have your retail tapestry ready)
|
106 |
+
while cap.isOpened():
|
107 |
+
# Read a frame from the video
|
108 |
+
success, frame = cap.read()
|
109 |
+
|
110 |
+
if success:
|
111 |
+
# Unleash the magic of YOLOv8
|
112 |
+
results = model(frame)
|
113 |
+
|
114 |
+
# Showcase the magic on the frame
|
115 |
+
annotated_frame = results[0].plot()
|
116 |
+
|
117 |
+
# Present the enchanted frame
|
118 |
+
cv2.imshow("YOLOv8 Retail Wizardry", annotated_frame)
|
119 |
+
|
120 |
+
# Dispel the spell if 'q' is pressed
|
121 |
+
if cv2.waitKey(1) & 0xFF == ord("q"):
|
122 |
+
break
|
123 |
+
else:
|
124 |
+
# Return to reality when the video ends
|
125 |
+
break
|
126 |
+
|
127 |
+
# Release your captive video and close the portal
|
128 |
+
cap.release()
|
129 |
+
cv2.destroyAllWindows()
|
130 |
+
```
|
131 |
+
|
132 |
+
## Model Masters π§ββοΈ
|
133 |
+
|
134 |
+
The mystical YOLOv8 Shelf Object Detection model was crafted by wizards at FODUU AI.
|
135 |
+
|
136 |
+
```bibtex
|
137 |
+
@ModelCard{
|
138 |
+
author = {Nehul Agrawal and
|
139 |
+
Pranjal Singh Thakur},
|
140 |
+
title = {YOLOv8 Shelf Object Detection in Retail Environments},
|
141 |
+
year = {2023}
|
142 |
+
}
|
143 |
+
```
|
144 |
+
|
145 |
+
Join the retail magic and send your owl to [email protected] for any questions or enchanting contributions.
|
146 |
+
|
147 |
+
Feel free to adjust the humor and tone as needed to match the vibe you want for your model card. Enjoy your retail adventures! πβ¨
|