File size: 3,410 Bytes
f1bed27
 
 
 
 
 
 
 
 
 
165ffff
 
 
 
 
f1bed27
165ffff
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7c17e55
 
 
 
c6adb00
c5e439c
bc177a5
2488498
a8ce133
2803790
4063870
65c4a17
5fce016
f9a532d
5d194e2
7c17e55
 
 
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
---
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

## Latest Update

- Upgraded DETR model for better accuracy. - May 29, 2025 📝
- Improved bounding box visualization. - June 09, 2025 📝
- Upgraded DETR model for better accuracy. 🎨 - June 08, 2025 📝
- Added support for multiple object classes. 🔧 - June 07, 2025 📝
- Optimized CPU inference for faster detection. 📊 - June 06, 2025 📝
- Enhanced Gradio UI for image uploads. 🔧 - June 05, 2025 📝
- Improved bounding box visualization. - June 04, 2025 📝
- Upgraded DETR model for better accuracy. ⚡ - June 03, 2025 📝
- Added support for multiple object classes. - June 02, 2025 📝
- Optimized CPU inference for faster detection. 📷 - June 01, 2025 📝
- Enhanced Gradio UI for image uploads. 🎨 - May 31, 2025 📝
- Improved bounding box visualization. - May 30, 2025 📝

**Website**: https://ghostainews.com/
**Discord**: https://discord.gg/BfA23aYz