metadata

title: AI AQI Agent
emoji: 🌍
colorFrom: red
colorTo: gray
sdk: gradio
sdk_version: 5.34.2
app_file: app.py
pinned: false
license: mit
short_description: ' Air quality monitoring and health recommendation tool power'

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

AQI Tracking and 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
- Example queries for quick testing

How to Run

Follow these steps to set up and run the application:

Clone the Repository:
```
cd AQI_Tracking
```
Install the dependencies:
```
pip install -r requirements.txt
```
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
Run the Gradio app:
```
python ai_aqi_analysis_agent.py
```
Access the Web Interface:
- The terminal will display two URLs:
  - Local URL: http://127.0.0.1:7860 (for local access)
  - Public URL: https://xxx-xxx-xxx.gradio.live (for temporary public access)
- Click on either URL to open the web interface in your browser

Usage

Enter your API keys in the API Configuration section
Input location details:
- City name
- State (optional for Union Territories/US cities)
- Country
Provide personal information:
- Medical conditions (optional)
- Planned outdoor activity
Click "Analyze & Get Recommendations" to receive:
- Current air quality data
- Health impact analysis
- Activity safety recommendations
Try the example queries for quick testing

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.