🌤️ Monitor del Clima

Un script en Python que monitorea el clima cada hora y utiliza la voz de macOS para anunciar las condiciones meteorológicas.

✨ Características

• 🕐 Ejecución automática cada hora
• 🔊 Alertas de voz en español usando las voces nativas de macOS
• 🌧️ Detección inteligente del clima:
  • Avisa si hay probabilidad de lluvia (lleva paraguas)
  • Recomienda suéter si está nublado y fresco
  • Te anima cuando está soleado

🚀 Instalación Rápida

1. Clonar el repositorio

git clone https://github.com/tu-usuario/weather-monitor.git
cd weather-monitor

2. Instalar dependencias

poetry install 

3. Configurar API Key

# Copiar el archivo de ejemplo
cp .env.example .env

# Editar .env y agregar tu API key real
nano .env

4. Obtener API Key gratuita

1. Ve a OpenWeatherMap API
2. Regístrate gratis
3. Copia tu API key
4. Pégala en el archivo .env

🎯 Uso

Ejecución normal

python app.py

Ejecución en segundo plano

nohup python3 app.py &

Detener el servicio

# Si está en primer plano: Ctrl+C
# Si está en segundo plano:
killall python

🔧 Configuración

Variables de entorno (.env)

# Tu API key de OpenWeatherMap
OPENWEATHER_API_KEY=tu_api_key_aqui

📋 Requisitos

• Python 3.13+
• macOS (para funcionalidad de voz)
• Conexión a internet
• API Key gratuita de OpenWeatherMap

Dependencias Python

• requests - Para llamadas a la API
• schedule - Para tareas programadas
• python-dotenv - Para variables de entorno

📁 Estructura del Proyecto

weather-monitor/
├── app.py      # Script principal
├── pyproject.toml       # Dependencias Python
├── .env.example          # Ejemplo de configuración
├── .gitignore           # Archivos ignorados por Git
└── README.md           # Este archivo

🤝 Contribuir

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📝 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

🙏 Reconocimientos

• OpenWeatherMap por su API gratuita
• Voces de sistema de macOS para la funcionalidad de texto a voz

⚠️ Importante

• Nunca subas tu archivo .env a GitHub - contiene tu API key
• El archivo .gitignore ya está configurado para proteger tu información sensible
• Las API keys de OpenWeatherMap son gratuitas pero tienen límites de uso

---

¿Problemas o sugerencias? Abre un issue o envía un Pull Request.