airq

Check air quality from your terminal. Any city in the world, no API key needed.

Two data providers:

• Open-Meteo — global coverage, PM2.5, PM10, CO, NO2 (default)
• Sensor.Community — citizen science sensors, real-time PM2.5/PM10

Install

cargo install airq

Usage

By city name (geocoding via Open-Meteo)

airq --city tokyo
airq --city "new york"
airq --city gazipasa
airq --city berlin
airq --city анталья     # unicode works

Any city, town, or village — resolved automatically via Open-Meteo geocoding API:

$ airq --city gazipasa
Resolved city: Gazipaşa, Türkiye
Air Quality for Coordinates: 36.3, 32.3
--------------------------------------------------
PM2.5: 12.8 μg/m³    (green = good)
PM10: 16.6 μg/m³     (green = good)
CO: 160 μg/m³        (green = good)
NO2: 2 μg/m³         (green = good)

By coordinates

airq --lat 55.75 --lon 37.62          # Moscow
airq --lat 36.27 --lon 32.30          # Gazipasa

Sensor.Community (citizen science sensors)

Real-time data from sensor.community network — 15,000+ sensors worldwide:

# Use specific sensor by ID
airq --city gazipasa --provider sensor-community --sensor-id 77955

# Find nearby sensors
airq nearby --lat 36.27 --lon 32.30

JSON output

airq --city berlin --json

{
  "latitude": 52.5,
  "longitude": 13.4,
  "current": {
    "pm2_5": 4.8,
    "pm10": 5.9,
    "carbon_monoxide": 192.0,
    "nitrogen_dioxide": 14.9
  }
}

Color coding (WHO thresholds)

Output is color-coded based on WHO Air Quality Guidelines (2021):

Data sources

• Open-Meteo Air Quality API — free, no key, global coverage
• Open-Meteo Geocoding API — city name → coordinates
• Sensor.Community — citizen science, real-time sensors

Built with

This project was created by rust-code AI agent in autonomous BigHead mode — from cargo init to cargo publish without human edits.

License

MIT