Air You Dying For

CO2, temperature, and humidity monitor using the SCD41 sensor on Raspberry Pi 4. Exposes metrics via Prometheus.

Hardware

• Raspberry Pi 4
• Sensirion SCD41 via I2C

Metrics

Metric	Description
co2_ppm	CO2 level in PPM
temperature_celsius	Temperature in Celsius
humidity_percent	Relative humidity in percent

Quick Start

Prerequisites

Enable I2C on the Pi:

sudo raspi-config  # Interface Options → I2C → Enable

Verify i2c group GID (needed for compose):

getent group i2c | cut -d: -f3

Update group_add in docker-compose.yml if it differs from 995.

Run with Docker Compose

# Build and run locally
docker compose up -d

# Or pull from GHCR
GITHUB_REPOSITORY_OWNER=just5ky docker compose up -d

Environment Variables

Variable	Default	Description
PROMETHEUS_PORT	8000	Port to expose Prometheus metrics

Container Image

Multi-arch image (linux/arm64, linux/arm/v7) published to GHCR on every push to main and on version tags.

docker pull ghcr.io/just5ky/air-you-dying-for:latest

Development

pip install -r requirements.txt
python scd41_monitor.py