Object Detection
ultralytics
yolo
yolov11
poultry
chicken
egg
broiler
agriculture
smart-farming
animal-welfare
precision-livestock-farming
Eval Results (legacy)
Instructions to use Williamsanderson/PoultryVision with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- ultralytics
How to use Williamsanderson/PoultryVision with ultralytics:
from huggingface_hub import hf_hub_download from ultralytics import YOLO # pick the weights file from this repo's "Files and versions" tab weights = hf_hub_download("Williamsanderson/PoultryVision", "<weights>.pt") model = YOLO(weights) source = 'http://images.cocodataset.org/val2017/000000039769.jpg' model.predict(source=source, save=True) - Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -54,7 +54,7 @@ This model **outperforms the fine-tuned YOLOv11x reported in the MVBroTrack pape
|
|
| 54 |
|
| 55 |
---
|
| 56 |
|
| 57 |
-
##
|
| 58 |
|
| 59 |
### Final metrics (validation set — 3 706 images, imgsz 640)
|
| 60 |
|
|
@@ -82,7 +82,7 @@ This model **outperforms the fine-tuned YOLOv11x reported in the MVBroTrack pape
|
|
| 82 |
|
| 83 |
---
|
| 84 |
|
| 85 |
-
##
|
| 86 |
|
| 87 |
**Reference paper** — Cardoen et al., *"Multi-camera detection and tracking for individual broiler monitoring"*, *Computers and Electronics in Agriculture*, 2025 (MVBroTrack).
|
| 88 |
|
|
@@ -102,11 +102,11 @@ Why is this model better on the unified benchmark:
|
|
| 102 |
3. **AdamW + warmup + cosine-like LR decay** (paper uses SGD).
|
| 103 |
4. **Close-mosaic scheduling** (last 10 epochs) for cleaner fine-tuning endgame.
|
| 104 |
|
| 105 |
-
>
|
| 106 |
|
| 107 |
---
|
| 108 |
|
| 109 |
-
##
|
| 110 |
|
| 111 |
```bash
|
| 112 |
pip install ultralytics huggingface_hub
|
|
@@ -156,7 +156,7 @@ model.export(format="tflite", int8=True) # Edge / Coral
|
|
| 156 |
|
| 157 |
---
|
| 158 |
|
| 159 |
-
##
|
| 160 |
|
| 161 |
This model is the single-view detection stage of a larger pipeline inspired by the MVBroTrack paper:
|
| 162 |
|
|
@@ -170,7 +170,7 @@ The full reference implementation of modules 2-5 is shipped as [`poultry_vision_
|
|
| 170 |
|
| 171 |
---
|
| 172 |
|
| 173 |
-
##
|
| 174 |
|
| 175 |
| File | Description |
|
| 176 |
|---------------------------------------|-------------------------------------------|
|
|
@@ -190,7 +190,7 @@ The full reference implementation of modules 2-5 is shipped as [`poultry_vision_
|
|
| 190 |
|
| 191 |
---
|
| 192 |
|
| 193 |
-
##
|
| 194 |
|
| 195 |
```yaml
|
| 196 |
model: yolo11m.pt
|
|
@@ -225,7 +225,7 @@ See `args.yaml` for the complete set.
|
|
| 225 |
|
| 226 |
---
|
| 227 |
|
| 228 |
-
##
|
| 229 |
|
| 230 |
- **Model weights**: **AGPL-3.0** (inherited from Ultralytics YOLOv11).
|
| 231 |
Commercial deployments without open-sourcing your full stack should acquire an [Ultralytics Enterprise License](https://www.ultralytics.com/license).
|
|
@@ -233,14 +233,14 @@ See `args.yaml` for the complete set.
|
|
| 233 |
|
| 234 |
---
|
| 235 |
|
| 236 |
-
##
|
| 237 |
|
| 238 |
If you use this model or the PoultryVision dataset, please cite:
|
| 239 |
|
| 240 |
```bibtex
|
| 241 |
@misc{williamsanderson_poultryvision_2025,
|
| 242 |
title = {PoultryVision: A YOLOv11m Model and Unified Dataset for Broiler and Egg Detection},
|
| 243 |
-
author = {Williams Anderson},
|
| 244 |
year = {2025},
|
| 245 |
howpublished = {\url{https://huggingface.co/Williamsanderson/PoultryVision}},
|
| 246 |
}
|
|
@@ -259,7 +259,7 @@ And the reference paper this work is based on:
|
|
| 259 |
|
| 260 |
---
|
| 261 |
|
| 262 |
-
##
|
| 263 |
|
| 264 |
- **Ultralytics** for the YOLOv11 architecture and training framework.
|
| 265 |
- **Cardoen et al.** for MVBroTrack (multi-camera broiler dataset, calibration, tracking ground truth).
|
|
|
|
| 54 |
|
| 55 |
---
|
| 56 |
|
| 57 |
+
## Performance
|
| 58 |
|
| 59 |
### Final metrics (validation set — 3 706 images, imgsz 640)
|
| 60 |
|
|
|
|
| 82 |
|
| 83 |
---
|
| 84 |
|
| 85 |
+
## Comparison with the reference paper
|
| 86 |
|
| 87 |
**Reference paper** — Cardoen et al., *"Multi-camera detection and tracking for individual broiler monitoring"*, *Computers and Electronics in Agriculture*, 2025 (MVBroTrack).
|
| 88 |
|
|
|
|
| 102 |
3. **AdamW + warmup + cosine-like LR decay** (paper uses SGD).
|
| 103 |
4. **Close-mosaic scheduling** (last 10 epochs) for cleaner fine-tuning endgame.
|
| 104 |
|
| 105 |
+
> Direct comparison note: our 79.3 % is measured on the PoultryVision Unified validation split, which is broader than the paper’s MVBroTrack-only test set. The ≥ 70.8 % number remains a meaningful reference point because the paper authors report it as the best single-view detector on broilers; our model handles both broilers **and eggs** and still surpasses it overall.
|
| 106 |
|
| 107 |
---
|
| 108 |
|
| 109 |
+
## Quick start
|
| 110 |
|
| 111 |
```bash
|
| 112 |
pip install ultralytics huggingface_hub
|
|
|
|
| 156 |
|
| 157 |
---
|
| 158 |
|
| 159 |
+
## Full pipeline (beyond single-view detection)
|
| 160 |
|
| 161 |
This model is the single-view detection stage of a larger pipeline inspired by the MVBroTrack paper:
|
| 162 |
|
|
|
|
| 170 |
|
| 171 |
---
|
| 172 |
|
| 173 |
+
## Files in this repo
|
| 174 |
|
| 175 |
| File | Description |
|
| 176 |
|---------------------------------------|-------------------------------------------|
|
|
|
|
| 190 |
|
| 191 |
---
|
| 192 |
|
| 193 |
+
## Training recipe (excerpt)
|
| 194 |
|
| 195 |
```yaml
|
| 196 |
model: yolo11m.pt
|
|
|
|
| 225 |
|
| 226 |
---
|
| 227 |
|
| 228 |
+
## License
|
| 229 |
|
| 230 |
- **Model weights**: **AGPL-3.0** (inherited from Ultralytics YOLOv11).
|
| 231 |
Commercial deployments without open-sourcing your full stack should acquire an [Ultralytics Enterprise License](https://www.ultralytics.com/license).
|
|
|
|
| 233 |
|
| 234 |
---
|
| 235 |
|
| 236 |
+
## Citation
|
| 237 |
|
| 238 |
If you use this model or the PoultryVision dataset, please cite:
|
| 239 |
|
| 240 |
```bibtex
|
| 241 |
@misc{williamsanderson_poultryvision_2025,
|
| 242 |
title = {PoultryVision: A YOLOv11m Model and Unified Dataset for Broiler and Egg Detection},
|
| 243 |
+
author = {Stephane Williams Anderson ASSA},
|
| 244 |
year = {2025},
|
| 245 |
howpublished = {\url{https://huggingface.co/Williamsanderson/PoultryVision}},
|
| 246 |
}
|
|
|
|
| 259 |
|
| 260 |
---
|
| 261 |
|
| 262 |
+
## Acknowledgements
|
| 263 |
|
| 264 |
- **Ultralytics** for the YOLOv11 architecture and training framework.
|
| 265 |
- **Cardoen et al.** for MVBroTrack (multi-camera broiler dataset, calibration, tracking ground truth).
|