nehulagrawal commited on
Commit
36735cf
β€’
1 Parent(s): be275e1

Update readme1.md

Browse files
Files changed (1) hide show
  1. 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: mAP@0.5(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 info@foduu.com 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! πŸ›’βœ¨