Spaces:
Running
Running
| 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. | |