README.md

---
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](https://proyecto-aves.vercel.app)
- **Modelos**: [AFELIPEY1417/aves-del-tolima](https://huggingface.co/AFELIPEY1417/aves-del-tolima)
- **GitHub**: [AndresYule1417/Proyecto_Aves](https://github.com/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