File size: 2,977 Bytes
ae88496
 
 
 
 
 
 
 
 
 
 
 
 
 
1423b8e
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
---
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:

1. **Clone the Repository**:
   ```bash
   cd AQI_Tracking
   ```

2. **Install the dependencies**:
    ```bash
    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](https://www.firecrawl.dev/app/api-keys)

4. **Run the Gradio app**:
    ```bash
    python ai_aqi_analysis_agent.py
    ```

5. **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

1. Enter your API keys in the API Configuration section
2. Input location details:
   - City name
   - State (optional for Union Territories/US cities)
   - 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
5. 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.