Astroweather is a playful yet insightful Python tool designed for astronomy enthusiasts and casual stargazers alike. It fetches real-time weather data to evaluate the observability of the night sky based on specified location and date.
- Real-time weather data retrieval for any city.
- Hourly weather breakdown.
- Custom Sky Observability Score for stargazing conditions.
- Moon phase representation with emojis.
- Easy-to-use interactive prompts.
- Python
- Requests library
- Visual Crossing Weather API
- Clone the repository.
- Install Python
- Install necessary packages:
pip install requests
- Set your Visual Crossing Weather API key as an environment variable named
API_KEY
.
To use Astroweather:
- Run
python src/main.py
in your terminal. - Enter the city name when prompted.
- Optionally, provide a date in DD-MM-YYYY format. If left blank, today's date is used.
- The program will display weather data along with the Sky Observability Score for night hours.
Contributions are welcome! Feel free to fork the repository, make your changes, and submit a pull request.
This project is open-sourced under the MIT License.