---
title: Computervisionobjectdetection
emoji: ⚡
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
---
# 📷✨ Object Detection Demo  
[![Hugging Face Space](https://img.shields.io/badge/HuggingFace-Spaces-blue?logo=huggingface)](https://huggingface.co/spaces/your-username/object-detection-demo)  
[![Gradio UI](https://img.shields.io/badge/Gradio-5.31.0-green?logo=gradio)](https://gradio.app)  
[![Model](https://img.shields.io/badge/Model-DETR--ResNet50-yellow)](https://huggingface.co/facebook/detr-resnet-50)  
[![License](https://img.shields.io/badge/License-MIT-lightgrey)](LICENSE)  

---

## 🚀 Overview  
Experience **real-time, Transformer-powered object detection** entirely on CPU.  
Upload any image and instantly see **bounding boxes**, **labels**, and **confidence scores**—all wrapped in a sleek Gradio interface.

> **Core technologies:**  
> • **DETR** (DEtection TRansformer) for end-to-end CV pipelines  
> • **Hugging Face Transformers** for model orchestration  
> • **Gradio Blocks** for interactive web UI  
> • **Pillow (PIL)** for image annotation  

---

## ✨ Key Features

| 🔑 Feature                 | 🔍 Description                                                |
|----------------------------|--------------------------------------------------------------|
| **⚡ Transformer CV**       | Uses DETR + ResNet-50 backbone for state-of-the-art accuracy |
| **🕒 Real-Time Inference**  | Sub-second CPU performance on typical images                |
| **🎨 Annotated Output**     | Red boxes + text overlays for clear visual feedback         |
| **📊 Detection Table**      | Interactive DataFrame of labels & confidence scores         |
| **☁️ Cloud-Native Deploy**  | One-click deploy on free Hugging Face Spaces                |
| **🔧 Modular Architecture** | Swap models or add filters with minimal code changes        |

---

## 🏗️ Architecture & Workflow

1. **Image Upload**  
   User drops in any JPEG/PNG.  
2. **DETR Pipeline**  
   `pipeline("object-detection", model="facebook/detr-resnet-50")`  
3. **Post-processing**  
   Draws bounding boxes + labels via PIL.  
4. **UI Rendering**  
   Gradio displays the annotated image and a label/score table.

---

## 🛠️ Quick Start (Local)

```bash
git clone https://github.com/your-username/object-detection-demo.git
cd object-detection-demo
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python app.py