typhon is an AC Infinity telemetry exporter that polls the AC Infinity cloud API and exposes Prometheus metrics for Grafana dashboards and alerting.

Stage 1 scope:

ingest controller climate telemetry (temperature, humidity, VPD)
ingest fan/port telemetry (online state, power state, speed, mode)
expose /metrics + /healthz

Stage 2 scope:

add authenticated control APIs and UI for climate.bstein.dev

API behavior (based on homebridge-acinfinity)

This implementation follows the same API conventions used by keithah/homebridge-acinfinity:

host: http://www.acinfinityserver.com
login endpoint: /api/user/appUserLogin
list endpoint: /api/user/devInfoListAll
mode endpoint: /api/dev/getdevModeSettingList
auth header: token: <appId>
request headers include phoneType=1, appVersion=1.9.7, and User-Agent matching the official app style
password field key is intentionally appPasswordl
API only honors the first 25 chars of password

Configuration

Environment variables:

ACI_EMAIL (required)
ACI_PASSWORD (required, use <= 25 chars for reliability)
ACI_HOST (optional, default http://www.acinfinityserver.com)
POLL_INTERVAL_SECONDS (optional, default 30)
REQUEST_TIMEOUT_MS (optional, default 10000)
LISTEN_PORT (optional, default 9108)
LOG_LEVEL (optional, default info)

Kubernetes runtime is expected to source ACI_EMAIL/ACI_PASSWORD from Vault.

Local development

npm ci
npm run lint
npm test
npm run build

Run locally:

ACI_EMAIL='you@example.com' \
ACI_PASSWORD='your-password' \
npm run dev

Metrics endpoint:

http://localhost:9108/metrics
http://localhost:9108/healthz