# 🚀 YOLO Object Detection

This project implements an **object detection system** using **YOLOv8 (Ultralytics)**.

It allows detection from:

- 🖼️ **Images**

- 🎥 **Videos**

- 📷 **Webcam (real-time)**

---

## 🔧 Installation

1. Clone the repository:

  ```bash

  git clone https://github.com/your-username/YOLO-Object-Detection.git

  cd YOLO-Object-Detection

  ```

2. Install the required dependencies:

  ```bash

  pip install -r requirements.txt

  ```

---

## ▶️ Usage

Run the Jupyter Notebook in **VS Code** or **Jupyter Lab**:

jupyter notebook YOLO\_Object\_Detection.ipynb

When running, you can select:

- Model size: n, s, m, l, x (nano → extra large)

- Mode: image, video, or webcam

---

## 📌 Requirements

- Python 3.8+

- Ultralytics (YOLOv8)

- OpenCV

- PyTorch

- NumPy, Matplotlib, Pillow

---

## 📷 Demo

### Image Detection


### Video Detection

[▶️ Watch the demo video](assets/video_demo.mp4)

### Webcam Detection

Works in real-time.

*(Not shown here for privacy, but runs the same as video detection.)*

---

## 📝 Notes

- YOLOv8 weights are downloaded automatically on first run (no manual setup needed).

- Press **q** to exit webcam or video mode.

---

## 📄 License

This project is licensed under the **MIT License** — you are free to use, modify, and distribute it, provided proper credit is given.