Skip to content

Una aplicación de escritorio moderna para consultar el clima actual de cualquier ciudad del mundo, desarrollada con Python y CustomTkinter.

Notifications You must be signed in to change notification settings

Kenkyoo/python-weather

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

🌤️ Weather App

Una aplicación de escritorio moderna para consultar el clima actual de cualquier ciudad del mundo, desarrollada con Python y CustomTkinter.

Python CustomTkinter License

✨ Características

  • 🎨 Interfaz moderna y atractiva con CustomTkinter
  • 🌍 Consulta el clima de cualquier ciudad del mundo
  • 🌡️ Muestra temperatura actual y sensación térmica
  • 💧 Información de humedad
  • 🌦️ Emojis dinámicos según las condiciones climáticas
  • 🌙 Tema oscuro por defecto
  • ⚡ Búsqueda rápida con Enter
  • 🇪🇸 Descripciones del clima en español

📸 Captura de Pantalla

┌─────────────────────────────────┐
│      🌤️ Weather App            │
│                                 │
│   Consulta del Clima            │
│   Ingresa el nombre de ciudad   │
│                                 │
│   [Buenos Aires...] [🔍 Buscar] │
│                                 │
│   ┌─────────────────────────┐   │
│   │  Buenos Aires, AR       │   │
│   │                         │   │
│   │      ☀️ 28.5°C         │   │
│   │    Cielo despejado      │   │
│   │                         │   │
│   │  🌡️ Sensación: 30.2°C  │   │
│   │  💧 Humedad: 65%        │   │
│   └─────────────────────────┘   │
│                                 │
│  Powered by OpenWeatherMap      │
└─────────────────────────────────┘

🚀 Instalación

Requisitos Previos

  • Python 3.8 o superior
  • pip (gestor de paquetes de Python)

Pasos de Instalación

  1. Clona el repositorio

    git clone https://github.com/tu-usuario/weather-app.git
    cd weather-app
  2. Crea un entorno virtual (opcional pero recomendado)

    python -m venv venv
    
    # En Windows
    venv\Scripts\activate
    
    # En Linux/Mac
    source venv/bin/activate
  3. Instala las dependencias

    pip install -r requirements.txt
  4. Ejecuta la aplicación

    python weather_app.py

📦 Dependencias

customtkinter==5.2.2
requests==2.31.0

🔑 API Key

Esta aplicación utiliza la API de OpenWeatherMap. La clave API incluida en el código es solo para demostración. Para uso en producción:

  1. Registrate en OpenWeatherMap
  2. Obtén tu API Key gratuita
  3. Reemplaza la API Key en el código:
    resp = requests.get(
        f'http://api.openweathermap.org/data/2.5/weather?q={city}&appid=TU_API_KEY&units=metric&lang=es'
    )

🎯 Uso

  1. Ejecuta la aplicación
  2. Escribe el nombre de una ciudad en el campo de búsqueda
  3. Presiona "Buscar" o Enter
  4. Visualiza la información del clima actual

Ejemplos de búsqueda válidos:

  • Buenos Aires
  • London
  • Tokyo
  • New York
  • Madrid

🛠️ Estructura del Proyecto

weather-app/
│
├── weather_app.py          # Archivo principal de la aplicación
├── requirements.txt        # Dependencias del proyecto
├── README.md              # Este archivo
└── .gitignore             # Archivos a ignorar por Git

🌟 Funcionalidades Futuras

  • Selector de tema claro/oscuro
  • Pronóstico extendido (5 días)
  • Guardar ciudades favoritas
  • Información adicional (viento, presión, visibilidad)
  • Gráficos de temperatura
  • Soporte para múltiples idiomas
  • Notificaciones de alertas meteorológicas

🤝 Contribuciones

Las contribuciones son bienvenidas. Si quieres mejorar esta aplicación:

  1. Haz un Fork del 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. Consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

  • OpenWeatherMap por proporcionar la API del clima
  • CustomTkinter por la biblioteca de UI moderna
  • La comunidad de Python por las excelentes herramientas

⭐ Si te gusta este proyecto, ¡dale una estrella en GitHub!

About

Una aplicación de escritorio moderna para consultar el clima actual de cualquier ciudad del mundo, desarrollada con Python y CustomTkinter.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages