dda1010/hydroponic-control

Analysis updated 2026-05-18

★ 3PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((Hydroponic Control))
    Core features
      Pump irrigation cycle
      Grow light photoperiod
      Temperature window
    Safety gates
      Dry-run protection
      Pump fault detection
      Flood and leak alarm
    Modes
      Auto
      Manual
      Maintenance
      Vacation
    Works with
      Tuya and Zigbee
      ESPHome and MQTT
      Any HA entity

mindmap root((Hydroponic Control)) Core features Pump irrigation cycle Grow light photoperiod Temperature window Safety gates Dry-run protection Pump fault detection Flood and leak alarm Modes Auto Manual Maintenance Vacation Works with Tuya and Zigbee ESPHome and MQTT Any HA entity

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Automate a DWC or tower garden pump cycle and grow light schedule in Home Assistant without writing YAML

USE CASE 2

Add dry-run and pump fault protection to a smart plug running a hydroponic pump

USE CASE 3

Get mobile push notifications when a water level or temperature alarm triggers in a grow room

What is it built with?

PythonHome AssistantHACS

How does it compare?

	dda1010/hydroponic-control	0marildo/imago	agentlexi/agent-lexi
Stars	3	3	3
Language	Python	Python	Python
Setup difficulty	moderate	easy	moderate
Complexity	3/5	2/5	4/5
Audience	general	general	vibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Home Assistant 2024.12+. A pump switch entity must already be configured. Water sensor strongly recommended for safety features.

Use freely for personal or commercial projects, keep the copyright notice.

In plain English

This is a Home Assistant integration that automates a hydroponic garden using smart plugs and sensors you already have set up. Home Assistant is a popular home automation platform that connects to a wide range of smart home devices. This integration adds controls and logic specifically designed for indoor growing systems such as tower gardens, NFT channels, and deep water culture buckets. Instead of writing complex YAML automations yourself to manage pump timing, grow light schedules, and safety cutoffs, you install this integration through the Home Assistant community store and configure it through the standard UI. You point it at your existing pump switch, water sensor, light switch, and temperature sensor entities, and it handles the rest. The core features cover three areas. First, irrigation cycling: the pump runs on a configurable on/off schedule (for example, 15 minutes on, 45 minutes off), which you can adjust live without restarting. Second, grow light control: you set an on time and off time for a photoperiod schedule, and the integration handles midnight crossings and daylight saving time correctly. Third, safety protection: the pump is blocked from running when the reservoir is empty (dry-run protection), a pump fault is detected when real power draw is not confirmed after switching on, and a flood sensor can trigger an immediate stop. Temperature alerts can drive a fan or heater. The integration works with any hardware Home Assistant already supports (Tuya, Zigbee, ESPHome, MQTT, and others) because it controls Home Assistant entities rather than talking to hardware directly. It is installable via HACS, the standard community store for Home Assistant integrations. The project is MIT licensed.

Copy-paste prompts

Prompt 1

Set up Hydroponic Control in Home Assistant for a DWC bucket with a Tuya smart plug as the pump and a Zigbee water sensor. Walk me through the HACS installation and initial configuration steps.

Prompt 2

My Hydroponic Control pump keeps triggering a dry-run alarm even though there is water in the reservoir. How do I check and fix the water sensor polarity setting?

Prompt 3

Write a Home Assistant automation YAML that sends a push notification to my phone whenever hydroponic_control_alert fires with severity: critical.

Prompt 4

What entities does Hydroponic Control create and which ones should I add to a Lovelace dashboard card to monitor my grow room at a glance?

Frequently asked questions

What is hydroponic-control?

A Home Assistant integration that automates a hydroponic garden with configurable pump cycling, grow light photoperiod, and safety gates for dry-run, leak, pump fault, and temperature. Works with any HA-compatible hardware, configured in the UI.

What language is hydroponic-control written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

What license does hydroponic-control use?

Use freely for personal or commercial projects, keep the copyright notice.

How hard is hydroponic-control to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hydroponic-control for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub dda1010 on gitmyhub

Verify against the repo before relying on details.