# Shelly Taupunktlüfter ("Taupi") 💨

Automated psychrometric cellar ventilation controller for mold prevention, running on a Shelly Plug S (Gen 3) paired with outdoor and indoor Shelly BLU H&T Bluetooth low-energy sensors.

## Features

- **Dew Point Ventilation**: Dynamically switches the ventilation fan based on indoor and outdoor psychrometric dew point calculations.
- **Sedlbauer LIM I Mold Alert**: Decoupled mold danger warning curve evaluated against Fraunhofer IBP Lowest Isopleth for Mould specifications.
- **Thermal Governors**: Summer cellar overheating protection (blocks warm moist air ingestion) and winter frost/overcooling protection.
- **Prometheus Metrics Pipeline**: Generates standard Prometheus exposition text scraped by cluster monitoring.
- **Automated Deployment**: Templated JavaScript upload via local Shelly RPC API orchestrated by Terraform.

## Usage

```bash
# Initialize Terraform providers
terraform init

# Plan and preview changes
terraform plan

# Deploy templated Taupi script to the Shelly device
terraform apply
```

For in-depth architectural decisions, state-machine logic gates, and sensor parameters, see [AGENTS.md](AGENTS.md).