Greenhouse AI Monitor

MVP implementation for Frigate snapshot based polyhouse monitoring.

Current scope

• FastAPI backend
• SQLite persistence
• Polygon ROI storage per grow bed
• Frigate latest snapshot ingestion
• OpenCV green/yellow/soil coverage metrics
• MQTT publishing per bed
• Rule-based metric alerts per bed
• React ROI calibration canvas
• Per-bed metric history and dashboard sparklines
• Generic Home Assistant sensor ingestion for temperature, humidity, lux, soil moisture, or other numeric entities
• Scheduled Frigate snapshot ingestion
• Sensor-based alerts for temperature, humidity, and stale readings
• Generic external plant/disease identification API calls
• Dashboard close-up image upload for plant/disease diagnosis
• Alert de-duplication window for repeated alerts

Quick start

cd backend
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python -m uvicorn app.main:app --host 0.0.0.0 --port 8088 --reload

cd frontend
npm install
npm run dev

Backend tests:

backend/.venv/bin/python -m pytest backend/tests

Smoke check:

scripts/smoke_check.sh

Optional local environment:

cp .env.example .env

The frontend reads VITE_API_BASE_URL; by default it uses http://localhost:8088.

Deployment details are in docs/DEPLOYMENT.md.

Scheduled camera ingestion

The backend can ingest the Frigate snapshot on a fixed interval:

SCHEDULED_INGEST_ENABLED=true
ANALYSIS_INTERVAL_SECONDS=1800

The scheduler waits one full interval after backend startup before its first automatic ingestion. Manual ingestion remains available from the dashboard.

Home Assistant sensors

Create a Home Assistant long-lived access token and map any numeric entities through .env:

HOME_ASSISTANT_BASE_URL=http://<home-assistant-host>:8123
HOME_ASSISTANT_TOKEN=your-long-lived-access-token
HOME_ASSISTANT_SENSORS=[{"entity_id":"sensor.polyhouse_temperature","sensor_type":"temperature","unit":"C"},{"entity_id":"sensor.polyhouse_humidity","sensor_type":"humidity","unit":"%"},{"entity_id":"sensor.bed_1_soil_moisture","sensor_type":"soil_moisture","unit":"%","bed_id":1}]

Use any sensor_type name for other parameters, such as lux, soil_moisture, vpd, or co2. Omit bed_id for whole-polyhouse readings.

External plant and disease identification

External plant or disease APIs can be called through a generic multipart integration:

PLANT_IDENTIFICATION_API_URL=
PLANT_IDENTIFICATION_API_KEY=
DISEASE_IDENTIFICATION_API_URL=
DISEASE_IDENTIFICATION_API_KEY=
EXTERNAL_DIAGNOSIS_API_KEY_HEADER=Api-Key
EXTERNAL_DIAGNOSIS_IMAGE_FIELD=image

The backend posts the image file plus a JSON context field containing bed, latest image metrics, and latest sensor readings when bed_id is supplied.

Tunable thresholds

OpenCV HSV ranges and alert thresholds can be changed in .env without code edits:

GREEN_HSV_LOWER=35,35,35
GREEN_HSV_UPPER=90,255,255
YELLOW_HSV_LOWER=22,95,90
YELLOW_HSV_UPPER=34,255,255
SOIL_HSV_LOWER=5,20,20
SOIL_HSV_UPPER=25,210,220

ALERT_GREEN_CRITICAL_BELOW=15
ALERT_GREEN_WARNING_BELOW=30
ALERT_YELLOW_CRITICAL_ABOVE=15
ALERT_YELLOW_WARNING_ABOVE=8
ALERT_SOIL_WARNING_ABOVE=65
ALERT_TEMP_WARNING_ABOVE=38
ALERT_TEMP_CRITICAL_ABOVE=45
ALERT_HUMIDITY_WARNING_BELOW=35
ALERT_HUMIDITY_WARNING_ABOVE=85
ALERT_SENSOR_STALE_MINUTES=60
ALERT_DEDUPE_MINUTES=60

P0 endpoints

• GET /api/beds
• POST /api/beds
• PUT /api/beds/{bed_id}
• POST /api/ingest/frigate
• POST /api/ingest/upload
• GET /api/snapshots/latest
• GET /api/metrics
• GET /api/beds/{bed_id}/metrics/history
• POST /api/observations
• POST /api/alerts
• GET /api/sensor-readings
• POST /api/sensor-readings
• POST /api/sensor-readings/home-assistant
• POST /api/diagnostics/external

Expected Frigate snapshot URL

http://<frigate-host>:5000/api/<camera_name>/latest.jpg