HA-TendrilGrow

Share your Projects! Custom Integrations
1

Hi All,
I’m a coder / DevOps / Infrastructure / Tinker / Engineer that loves to Grow. This is my try on automating / monitoring / controlling my grows.

This is my very first HACS / HA Project. Looking for any community help / thoughts. I have hopes to publish this to the HACS List, but I wanted to run it here first to help work out the bugs.

Thank you all in advance for any time / thoughts / energy you put into looking at my project.

Github: HA-TendrilGrow

HA-TendrilGrow

Enterprise-grade, Home Assistant-native grow intelligence with local-first AI, auditable automation, and production safety guardrails.

Documentation and the GitHub repository are linked from my profile / the first comment below.

Executive Summary

HA-TendrilGrow brings Tendril-style grow operations directly into Home Assistant for teams that want enterprise reliability and local control. The integration focuses on controlled automation, clear operator workflows, and predictable behavior across AI, rules, and equipment actuation.

Why Teams Use This

  • Local-first operation model for data ownership and operational continuity.
  • Guarded control path for equipment actuation under strict safety constraints.
  • Structured, reviewable AI decision flow with explicit provider fallback behavior.
  • Multi-grow and multi-user workflows with role-aware access controls.

Platform Capabilities

  • Domain model for grows, spaces, equipment, rules, alerts, and access grants.
  • Method-aware reference data for stage targets, nutrient lines, and critical defaults.
  • Rules engine with deduplication, cooldown windows, acknowledgment lifecycle, and channel fanout.
  • Control ladder with clear operational modes: recommend, supervised, and full.
  • MQTT ingestion aligned with Tendril topic conventions.

Security and Safety Posture

  • Safety-first actuation guardrails for stale or unavailable sensor paths.
  • Runtime kill-switch, manual holds, conflict management, and cooldown enforcement.
  • Policy-driven integration behavior with explicit defaults and override boundaries.
  • Secrets-handling model based on Home Assistant secrets and local environment files.

Install via HACS (Recommended)

  1. Open Home Assistant.
  2. Go to HACS → Integrations.
  3. Open the menu and select Custom repositories.
  4. Repository URL: the HA-Tendril repo under the Trec-TorConsulting GitHub org.
  5. Category: Integration
  6. Click Add, then install HA-TendrilGrow.
  7. Restart Home Assistant.
  8. Go to Settings → Devices and Services → Add Integration.
  9. Search for HA-TendrilGrow and complete setup.

First-Run Workflow

  1. Configure AI provider options in integration settings.
  2. Add at least one grow camera entity.
  3. Create a grow through the setup flow.
  4. Trigger the run_health_check service.
  5. Validate resulting entities and events in Developer Tools.

Dashboard Templates

  • Beginner Hub: homeassistant/dashboards/grow.tendril.json
  • Operator Hub: homeassistant/dashboards/grow.tendril.operator.json
  • Prefilled Example: homeassistant/dashboards/grow.3x3_mothers.json
  • In Home Assistant, use Edit dashboard → Raw configuration editor and paste template JSON.

First-Run Workflow

  1. Configure AI provider options in integration settings.
  2. Add at least one grow camera entity.
  3. Create a grow through the setup flow.
  4. Trigger the run_health_check service.
  5. Validate resulting entities and events in Developer Tools.

Documentation

Full documentation is published on the project docs site (linked in the first comment). It covers Quick Start, Configuration, UI & Dashboards, Control Modes, Rules & Alerts, Access Control, AI Operations, Safety Model, Diagnostics, Grow Lifecycle, Integrations, MQTT Sensor Setup, Grow Types, Nutrients, Local Development, and Architecture.

Governance

  • Contribution process: CONTRIBUTING.md
  • Security reporting: SECURITY.md
  • Spec workflow: openspec/AGENTS.md