https://github.com/stavrostheocharis/air_quality_app

Aeroa: A streamlit app with plotly map for air quality visualisation
https://github.com/stavrostheocharis/air_quality_app

air-quality map plotly streamlit

Last synced: 2 months ago
JSON representation

Aeroa: A streamlit app with plotly map for air quality visualisation

• Host: GitHub
• URL: https://github.com/stavrostheocharis/air_quality_app
• Owner: stavrostheocharis
• License: mit
• Created: 2023-07-23T13:41:21.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-08-04T14:12:09.000Z (about 2 years ago)
• Last Synced: 2025-04-08T03:13:42.714Z (6 months ago)
• Topics: air-quality, map, plotly, streamlit
• Language: Python
• Homepage:
• Size: 6.29 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


![AEROA](logo.png)

"An air quality data app"

[Deployed app](https://airqualityapp-aeroa.streamlit.app/)

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![License](https://img.shields.io/badge/License-MIT-informational.svg)](https://github.com/stavrostheocharis/air_quality_app/blob/main/LICENSE)



This project is a Streamlit application for quick visualisations of air quality data for a wide range of countries in a global level. The data come from the [OpenAQ API](https://api.openaq.org/docs#/).

This project was initialised based on the [Streamlit's Hacathon](https://discuss.streamlit.io/t/connections-hackathon/47574) in order to extend and use the new built in [ExperimentalBaseConnection](https://docs.streamlit.io/library/api-reference/connections/st.connections.experimentalbaseconnection).



![interface](interface.gif)



## Install environment & dependencies (local run)

In order to run the needed scripts you need to have python installed and run the command below.

```

python3 -m venv /path/to/new/virtual/environment

```

To activate your `venv` run `source "env_name"/bin/activate`.

To install dependencies run the command:

```bash

pip install -r requirements.txt

```

## Community cloud

The app is hosted in the community cloud and you can access it directly from [here](https://airqualityapp-aeroa.streamlit.app/).

## How to contribute?

We welcome any suggestions, problem reports, and contributions!

For any changes you would like to make to this project, we invite you to submit an [issue]("https://github.com/stavrostheocharis/air_quality_app/issues").