README.md

metadata

license: apache-2.0
title: object-detection-app
sdk: gradio
emoji: 👀
short_description: Applicazione web per il rilevamento di oggetti in tempo real
sdk_version: 5.7.1

🔍 Real-Time Object Detection Web App

Applicazione web per il rilevamento di oggetti in tempo reale utilizzando YOLOv8 e Gradio.

🌟 Caratteristiche

• 📸 Rilevamento oggetti in tempo reale dalla webcam
• 🎯 Visualizzazione immediata dei risultati
• 🎨 Bounding box colorati basati sulla confidenza
• 📊 Conteggio oggetti e dettagli in tempo reale
• 🚀 Interfaccia intuitiva e responsive
• 📱 Supporto per dispositivi mobili

🛠️ Tecnologie Utilizzate

• Backend: Python
• Framework UI: Gradio
• Modello ML: YOLOv8/Modello personalizzato
• Deployment: Hugging Face Spaces

📦 Requisiti

ultralytics
gradio
opencv-python-headless
torch
numpy

🚀 Avvio Rapido

1. Clona il repository

   git clone <repository-url>
   cd object_detection_app
   

2. Installa le dipendenze

   pip install -r requirements.txt
   

3. Avvia l'applicazione

   python app.py
   

4. Apri nel browser

   • L'app sarà disponibile su http://localhost:7860

💡 Come Usare

1. Apri l'applicazione nel browser
2. Concedi l'accesso alla webcam quando richiesto
3. Il rilevamento inizierà automaticamente
4. Gli oggetti rilevati verranno mostrati con:
   • Bounding box colorati (verde = alta confidenza, rosso = bassa)
   • Etichette con nome oggetto e confidenza
   • Conteggio totale degli oggetti
   • Dettagli di ogni rilevamento

⚙️ Configurazione

• Confidenza minima: 25%
• Risoluzione video: 320x240
• Modello: Supporta sia YOLOv8 che modelli personalizzati

🔒 Privacy e Sicurezza

• Elaborazione locale delle immagini
• Nessun dato viene salvato o trasmesso
• Accesso alla webcam solo dopo autorizzazione utente

📝 Note

• Per prestazioni ottimali, usa un browser moderno
• La qualità del rilevamento dipende dall'illuminazione e dalla qualità della webcam
• Il modello può essere personalizzato per casi d'uso specifici

🤝 Contribuire

Sentiti libero di:

• Aprire issues per bug o suggerimenti
• Proporre miglioramenti tramite pull requests
• Condividere il progetto

📄 Licenza

Questo progetto è distribuito sotto licenza MIT.