Open Source & MIT Licensed

Pro-Grade Home Assistant
Automation Blueprints

Production-ready automation templates that solve real household needs. Battle-tested logic, beautiful documentation, and sensible defaults.

5 Blueprints
MIT Licensed
100% Documented
adaptive_comfort_control.yaml
blueprint:
  name: "Adaptive Comfort Control Pro"
  description: "ASHRAE-55 adaptive comfort"
  domain: automation
  input:
    climate_entity:
      name: "Climate Device"
      selector:
        entity:
          domain: climate

Why These Blueprints?

Built with real-world experience and engineering rigor

Battle-Tested

Robust logic with clear input validation, sane defaults, and edge case handling for real-world scenarios.

Efficient

Avoids unnecessary service calls, respects device limits, and reduces network chatter for optimal performance.

Configurable

Sensible presets with advanced controls when you need them. Start simple, customize as needed.

Documented

Comprehensive README per blueprint, changelogs following semantic versioning, and conventional commits.

Observable

Debug levels (off/basic/verbose) and traceable decision paths make troubleshooting a breeze.

MIT Licensed

Permissive licensing for personal and commercial use. Use freely, modify as needed.

Visual Learning

Interactive decision tree visualizer helps you understand how blueprints evaluate conditions and select actions.

Blueprints Gallery

Click any blueprint to import directly into Home Assistant

Adaptive Comfort Control Pro

Advanced HVAC automation implementing ASHRAE-55 adaptive comfort with built-in psychrometrics (dew point, absolute humidity, enthalpy), vendor auto-profiles, seasonal bias, CO2-aware ventilation, and smart pause acceleration.

HVAC Climate ASHRAE-55

Bathroom Light Fan Control Pro

Coordinated bathroom light and fan automation with occupancy ("Wasp-in-a-Box"), humidity delta and rate-of-change detection, night mode, and manual override support.

Bathroom Fan Humidity

Multi Switch Light Control Pro

A single automation that adapts to Zooz/Inovelli Central Scene switches or Lutron Pico remotes, auto-detects the selected hardware, and unifies dimming/transition tuning across every trigger.

Switches Lighting Z-Wave

Adaptive Shades Pro

Solar-aware shade control for venetian/vertical slats or zebra shades with direct vs diffuse detection, temperature bands, presence/quiet hours, glare handling, and night close/resume behavior.

Shades Solar Blinds

Ceiling Fan Climate Control Pro

HVAC-aware ceiling fan automation with EN 16798 adaptive comfort model, heat index calculation, deviation-based speed control, occupancy awareness, and optional direction control for seasonal optimization.

Fan Climate EN 16798

Quick Start

Get up and running in under 2 minutes

1

Click Import

Click the Import button on any blueprint card above. This opens Home Assistant's import dialog.

2

Preview & Import

Home Assistant will show you a preview. Click Import Blueprint to add it to your instance.

3

Create Automation

Go to Settings → Automations → Create Automation, select your imported blueprint, and configure the inputs.

4

Enable & Test

Save your automation, enable it, and use Traces to verify it's working correctly.

Tip: Enable the blueprint's Debug level (basic or verbose) to see key decisions and sensor values in your logs.

Blueprint Logic Explorer

Understand exactly what each blueprint does: see every trigger, condition, and action in plain English

Select a Blueprint

Choose a blueprint from the dropdown above to see exactly how it works - what triggers it, what it checks, and what actions it takes

Understanding Blueprint Logic

🎯

Triggers

Events that start the automation. Examples: motion detected, humidity changed, button pressed, or timer elapsed.

Conditions

Checks that must pass before actions run. Examples: "someone is home", "room is dark enough", "no manual override".

Actions

What the automation actually does. Examples: turn on lights, adjust fan speed, set thermostat.

🛠 Developer Utilities

Developer Tools

Command-line utilities for blueprint development and Home Assistant debugging. Validate your YAML before importing and query your HA instance in real-time.

validate-blueprint

Go CLI

A fast, compiled validator that checks blueprint YAML files for common issues before you import them into Home Assistant. Catches syntax errors, structural problems, and template issues.

Key Features

  • YAML syntax and structure validation
  • Trigger, input, and action validation
  • Jinja2 template syntax checking
  • Detection of !input tags inside template blocks
  • Hysteresis boundary validation
  • ~16x faster than Python version
Terminal
# Validate a single blueprint
./scripts/validate-blueprint-go/validate-blueprint path/to/blueprint.yaml

# Validate all blueprints
./scripts/validate-blueprint-go/validate-blueprint --all

ha-ws-client

Go CLI WebSocket

A high-performance WebSocket API client for querying Home Assistant and debugging automations. Written in Go for fast startup (~10ms), low memory (~5-10MB), and easy deployment as a single static binary—optimized for Raspberry Pi and Claude Terminal add-on environments. Place the binary in /config or /config/.claude for seamless integration.

Key Features

  • Zero runtime dependencies—single static binary
  • Cross-compiled for all Raspberry Pi variants
  • HA Add-on ready—works with Claude Terminal
  • Automation trace debugging (step-by-step)
  • Live monitoring with anomaly detection
  • Multiple output formats (JSON, compact, default)
Terminal
# Get entity state
ha-ws-client state sun.sun

# Debug automation trace
ha-ws-client trace-debug <run_id>