Weather Alert System is a project that aims to provide weather alerts to users via email. We have integrated Uagents library with stream-lit and fast-api to make an autonomous agents
to generate alert for weather conditions. It includes a streamlit frontend for GUI.
To get started with the Weather Alert System, follow these steps:
-
Clone the repository to your local machine.
-
Install the required dependencies.
-
Set the API key in .env file. Refer Installation for more information.
-
Run the application.
python main.py
That's it! You should now be able to use the Weather Alert System to receive weather alerts via email.
Note: Use light theme of Streamlit
for better experience.
Before running the agents, you need to obtain the required API keys:
-
Visit the Weatherapi website: https://www.weatherapi.com/
-
If you don't have an account, create one by signing up.
-
Verification mail will be sent to your gmail, verify the same.
-
Once you logged into your account, you will see on top to copy your
API-Key
.
-
We have provided you with
.env-example
file in the root directory of the repository. -
Change the file name to
.env
and paste yourAPI-key
in there.Weather_API_key="<Enter your API key here>"
-
Clone the repository using:
git clone https://github.com/AyushSenDazzler/HackAI_Hack-230459.git
-
Open a terminal in root directory of the repository and enter the following commands
poetry install cd ./src poetry shell
Note: Port 8001, 8600 & 8080 should be open for the application to work smoothly, Ensure these ports are open before starting the application.
-
To run project and its agents:
python main.py
Your application should start shortly. Now you have stream-lit app and the agents up and running 🎉.
The guidelines for contributing to the project can be found in the CONTRIBUTING.md file. It is recommended to follow these guidelines to ensure that contributions are consistent and meet the project's standards.
Team Lead: Ayush Kumar
Team members: Abhishek Patil
This project is available under the MIT License.