Demo Samsung Now Brief hecho en México

• Aquí puedes ver el video de YouTube asociado: Demo Samsung Now Brief

📖 Descripción

Este proyecto es un demo de línea de comandos en Python que:

• Obtiene el clima de una ciudad usando la API de OpenWeatherMap.
• Recupera las noticias principales de una ciudad mediante NewsAPI.
• Genera un resumen del día combinando ambos datos con la API de OpenAI.

Es ideal para aprender sobre consumo de APIs REST, manejo de variables de entorno y generación de texto con IA.

🚀 Características principales

1. Modularidad: Funciones independientes para clima, noticias y resumen.
2. Manejo de errores: Validaciones de respuestas HTTP y captura de excepciones.
3. Buenas prácticas: Uso de variables de entorno con python-dotenv.
4. Extensible: Fácil adaptación para múltiples ciudades o nuevas fuentes de datos.

🔧 Prerrequisitos

• Python 3.8 o superior

• Una cuenta y claves de API para:

  • OpenWeatherMap
  • NewsAPI
  • OpenAI

💾 Instalación

1. Clona el repositorio

   git clone https://github.com/josejesusguzman/demo-now-brief.git
   cd demo-now-brief
   

2. Crea un entorno virtual (recomendado)

   python -m venv venv
   source venv/bin/activate      # Linux/MacOS
   venv\Scripts\activate       # Windows
   

3. Instala dependencias

   pip install -r requirements.txt
   

4. Configura variables de entorno

   • Crea un archivo .env en la raíz del proyecto

   • Agrega tus claves:

     OPENWEATHER_API_KEY=tu_clave_openweather
     NEWSAPI_API_KEY=tu_clave_newsapi
     OPENAI_API_KEY=tu_clave_openai
     

⚙️ Uso

Desde la raíz del proyecto, ejecuta:

python app.py

Nota: app.py es el nombre del script principal. Ajusta según tu estructura.

Ejemplo de salida

Resumen del Clima para London:
  Temperatura: 12°C
  Descripción: Nublado
  Humedad: 78%

Noticias Principales:
- Titular noticia 1
- Titular noticia 2
- Titular noticia 3

Resumen del Día:
Hoy en London, el clima se presenta con cielos nublados...

🤝 Contribuciones

1. Haz un fork del repositorio.
2. Crea tu branch: git checkout -b feature/nueva-funcionalidad
3. Realiza tus cambios y haz commit: git commit -m "feat: descripción breve"
4. Sube tu branch: git push origin feature/nueva-funcionalidad
5. Abre un Pull Request.

📄 Licencia

Este proyecto está bajo la licencia MIT. ¡Siéntete libre de usarlo y adaptarlo!

---