Skip to content

toshi-taz/track-classifier

Repository files navigation

Wildlife Track Classifier 🐢

Herramienta de IA de campo para identificación de rastros de fauna marina. Web app for wildlife track identification using Gemini Vision AI Live: https://track-classifier.onrender.com

Python Flask Gemini License

¿Qué hace?

Sube una foto de rastros en arena → Gemini Vision identifica la especie, estima medidas, devuelve estado de conservación y recomendaciones de campo.

Especies soportadas

Especie Nombre científico Estado
Tortuga verde Chelonia mydas Endangered
Tortuga caguama Caretta caretta Vulnerable
Tortuga carey Eretmochelys imbricata Critically Endangered
Tortuga laúd Dermochelys coriacea Vulnerable

Stack

  • Backend: Python 3.14, Flask, Gemini Vision API (gemini-2.5-flash)
  • Frontend: HTML/CSS/JS vanilla, tipografía Instrument Serif + DM Mono
  • Deploy: Render.com (free tier)

Setup local

git clone https://github.com/toshi-taz/track-classifier
cd track-classifier
pip install -r requirements.txt
# Crea .env con GEMINI_API_KEY=tu_clave
python app.py

Uso CLI (modo original)

python classifier.py --image foto.jpg --mode turtle
python classifier.py --image foto.jpg --mode wildlife

Autor

Alexander Toshiro Bataz López
Ingeniería en Sistemas Energéticos y Redes Inteligentes — UPIEM–IPN
abatazl2300@alumno.ipn.mx


Desarrollado como herramienta de apoyo para FFCM Campamentos Tortugueros

🎯 Cómo Usar

  1. Descarga el código:
git clone https://github.com/toshi-taz/track-classifier.git
cd track-classifier
  1. Instala dependencias:
pip install -r requirements.txt
  1. Configura tu API key:
export GEMINI_API_KEY="tu_api_key_aqui"
  1. Ejecuta:
python app.py
  1. Abre en navegador: http://localhost:5000

🌍 Para Qué Sirve

  • 🐢 Clasificación automática de rastros marinos (Xcaret, Reserva Pacuare)
  • 🦁 Identificación de fauna terrestre (Rewilding Argentina)
  • 📸 Análisis de fotos de cámaras trampa
  • 📊 Historial georreferenciado de observaciones

🔄 Stack

Parte Tecnología
Backend Python / Flask
IA Google Gemini Vision API
Frontend HTML/CSS/Bootstrap
Datos Pandas + CSV
Deploy Render

📝 Roadmap

  • Clasificación básica
  • Historial en CSV
  • API REST
  • GPS + Mapas (en desarrollo)
  • Base de datos SQL
  • Autenticación multi-usuario

🤝 Contribuciones

¿Trabajas en monitoreo de especies o tecnología para conservación? ¡Contribuciones bienvenidas!

Desarrollado para equipos de conservación en Mesoamérica y Patagonia.

About

Flask webapp for wildlife track identification using Gemini Vision AI

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors