awesome-llm-apps/ai_agent_tutorials/ai_aqi_analysis_agent/README.md

🌍 AQI Analysis Agent

The AQI Analysis Agent is a powerful air quality monitoring and health recommendation tool powered by Firecrawl and Agno's AI Agent framework. This app helps users make informed decisions about outdoor activities by analyzing real-time air quality data and providing personalized health recommendations.

Features

• Multi-Agent System

  • AQI Analyzer: Fetches and processes real-time air quality data
  • Health Recommendation Agent: Generates personalized health advice

• Air Quality Metrics:

  • Overall Air Quality Index (AQI)
  • Particulate Matter (PM2.5 and PM10)
  • Carbon Monoxide (CO) levels
  • Temperature
  • Humidity
  • Wind Speed

• Comprehensive Analysis:

  • Real-time data visualization
  • Health impact assessment
  • Activity safety recommendations
  • Best time suggestions for outdoor activities
  • Weather condition correlations

• Interactive Features:

  • Location-based analysis
  • Medical condition considerations
  • Activity-specific recommendations
  • Downloadable reports

How to Run

Follow these steps to set up and run the application:

1. Clone the Repository:

   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd ai_agent_tutorials/ai_aqi_analysis_agent
   

2. Install the dependencies:

   pip install -r requirements.txt
   

3. Set up your API keys:

   • Get an OpenAI API key from: https://platform.openai.com/api-keys
   • Get a Firecrawl API key from: Firecrawl website

4. Run the Streamlit app:

   streamlit run ai_aqi_analysis_agent.py
   

Usage

1. Enter your API keys in the sidebar
2. Input location details:
   • City name
   • State (optional)
   • Country
3. Provide personal information:
   • Medical conditions (optional)
   • Planned outdoor activity
4. Click "Analyze & Get Recommendations" to receive:
   • Current air quality data
   • Health impact analysis
   • Activity safety recommendations
   • Downloadable report

Note

The air quality data is fetched using Firecrawl's web scraping capabilities. Due to caching and rate limiting, the data might not always match real-time values on the website. For the most accurate real-time data, consider checking the source website directly.