README.md

metadata

title: Proyecto Aves API
emoji: 🦅
colorFrom: green
colorTo: blue
sdk: docker
pinned: false
license: mit

🦅 API - Clasificador de Aves del Tolima

API REST para clasificación automática de aves endémicas del Tolima (Colombia) usando Deep Learning.

🚀 Características

• Detección YOLO: YOLOv8n para detección automática de aves en imágenes
• Clasificación ML: DenseNet121 (99%) y VGG16 (98.5%)
• 10 especies: Aves endémicas del departamento del Tolima
• API REST: Endpoints JSON para integración fácil

📡 Endpoints

GET /api/classes

Lista las 10 especies disponibles.

POST /api/detect-bird

Detecta aves en imágenes usando YOLOv8.

Input: Imagen (multipart/form-data)
Output: Coordenadas del ave detectada

POST /api/predict

Clasifica la especie del ave.

Input: Imagen recortada
Output: Top 3 predicciones con confianza

GET /api/random-images

Obtiene imágenes de ejemplo de una especie.

Query: predicted_class (nombre de la especie)
Output: 3 imágenes aleatorias

🔗 Links

• Frontend: proyecto-aves.vercel.app
• Modelos: AFELIPEY1417/aves-del-tolima
• GitHub: AndresYule1417/Proyecto_Aves

🦜 Especies

1. Anisognathus igniventris - Tángara de Vientre Naranja
2. Arremon aurantiirostris - Rascador Piquinaranja
3. Basileuterus rufifrons - Reinita de Corona Roja
4. Columba livia - Paloma Doméstica
5. Grallaria ruficapilla - Tororoi Cabecicastaño
6. Pachyramphus versicolor - Anambé Versicolor
7. Pheucticus ludovicianus - Picogrueso Pechirrosado
8. Pipra mentalis - Saltarín Cabeciamarillo
9. Sturnella magna - Turpial Oriental
10. Thraupis palmarum - Tángara de Palmeras

📄 Licencia

MIT License - Copyright (c) 2025 Andrés Yule