File size: 4,642 Bytes
36735cf
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8307172
36735cf
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
---
tags:
- ultralyticsplus
- yolov8
- ultralytics
- yolo
- vision
- object-detection
- pytorch
- retail
- shelf-detection
- mart
- mall
- inventory-management
library_name: ultralytics
library_version: 8.0.43
inference: false
model-index:
- name: foduucom/shelf-object-detection-yolov8
  results:
  - task:
      type: object-detection
    metrics:
    - type: precision
      value: 0.91
      name: mAP@0.5(box)
language:
- en
pipeline_tag: object-detection
---

<div align="center">
  <img width="640" alt="foduucom/product-detection-in-shelf-yolov8" src="https://huggingface.co/foduucom/product-detection-in-shelf-yolov8/resolve/main/thumbnail.jpg">
</div>

# Model Card for YOLOv8 Shelf Object Detection in Retail Environments

## Model Enthusiasm πŸŽ‰

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.

## Model Magic ✨

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.

## Supported Labels 🏬

```
['Empty Shelves', 'Magical Products']
```

## Collaboration Love ❀️

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!

## Uses

### Direct Use

Integrate this model into your retail kingdom for real-time inventory harmony, shelf perfection, and automated restocking magic.

### Downstream Wonder

Want to optimize shelf layouts, unravel product placement mysteries, and sprinkle some sparkle into your customers' lives? This model's got your back!

### Not-So-Magic Disclaimers ⚑

Just like a trusty wizard, this model might have its quirky moments:

- It might not be in sync with tricky lighting and shelf chaos. Keep those shelves tidy!
- Rapid changes in product vibes and shelf dances could affect its accuracy and spellcasting.

### Human Touch & Wizard Wisdom πŸ§™

Remember, every spellcaster has their quirks. Test and twirl within your retail realm before letting it loose on the magical stage.

## How to Join the Magic

To dive into the retail wizardry with the YOLOv8 Shelf Object Detection model, follow these enchanted steps:
```bash
pip install ultralyticsplus==0.0.28 ultralytics==8.0.43
```

- Summon the model and unveil its secrets:

```python
# Wave your wand (or keyboard) to get started!
from ultralyticsplus import YOLO, render_result
import cv2

# Cast a spell to summon the model
model = YOLO('foduucom/shelf-object-detection-yolov8')

# Tweak the magical parameters
model.overrides['conf'] = 0.25  # NMS confidence threshold
model.overrides['iou'] = 0.45  # NMS IoU threshold
model.overrides['agnostic_nms'] = False  # NMS class-agnostic
model.overrides['max_det'] = 1000  # maximum number of detections per image

# set image
image = "path/to/your/shelf/image"

#you can pass live camera streaming or video
# Begin the mystical journey through video frames
# (Remember to have your retail tapestry ready)
while cap.isOpened():
    # Read a frame from the video
    success, frame = cap.read()

    if success:
        # Unleash the magic of YOLOv8
        results = model(frame)

        # Showcase the magic on the frame
        annotated_frame = results[0].plot()

        # Present the enchanted frame
        cv2.imshow("YOLOv8 Retail Wizardry", annotated_frame)

        # Dispel the spell if 'q' is pressed
        if cv2.waitKey(1) & 0xFF == ord("q"):
            break
    else:
        # Return to reality when the video ends
        break

# Release your captive video and close the portal
cap.release()
cv2.destroyAllWindows()
```

## Model Masters πŸ§™β€β™‚οΈ

The mystical YOLOv8 Shelf Object Detection model was crafted by wizards at FODUU AI.

```bibtex
@ModelCard{
  author    = {Nehul Agrawal and
               Pranjal Singh Thakur},
  title     = {YOLOv8 Shelf Object Detection in Retail Environments},
  year      = {2023}
}
```

Join the retail magic and send your owl to info@foduu.com for any questions or enchanting contributions.

Feel free to adjust the humor and tone as needed to match the vibe you want for your model card. Enjoy your retail adventures! πŸ›’βœ¨