Cookbook#

Short, standalone, copy-pasteable recipes for common EMHASS patterns. Each recipe follows a fixed template: Goal / Prerequisites / Config / Snippet / Caveats / Credits.

If you need a longer narrative walkthrough, see Study Cases. The Cookbook is the Diátaxis how-to-guide quadrant — short, task-oriented, scannable.

How to contribute#

  1. Copy _template.md to <category>_<pattern>.md (e.g. ev_calendar_driven.md).

  2. Fill the 6 sections.

  3. Link your file under the matching category below.

  4. Open a PR. Contributor rules are inside the template.

Recipes by category#

EV charging#

No recipes yet. EVCC integration architecture is under active discussion at evcc-io/evcc#29815 — EV-EVCC-coupled recipes will land after that resolves.

Seed material for HA-flavored EV recipes (community contributions welcome): Discussion #824 thread (daily-commute, surplus-only, multi-day, calendar-driven, negative-price-aware, modulating-power patterns).

Domestic hot water (DHW)#

No recipes yet. See docs/study_cases/dhw_walkthrough.md for the long-form walkthrough. Contributions welcome.

Heat pump#

No recipes yet. See docs/study_cases/heat_pump_walkthrough.md for the long-form walkthrough. Contributions welcome.

Battery#

Additional battery recipes welcome (charging-from-grid strategies, calendar-aware reservation, etc.) — see Discussion #823 for good-practices crowdsourcing.

Forecast#

No recipes yet. Topics that would fit: ML vs naive load forecaster selection, custom forecast injection via runtime params, dealing with forecast outages. Contributions welcome.

Tariff#

No recipes yet. Topics that would fit: dynamic-price (EPEX, Tibber, etc.) injection, multi-tier tariffs, sell-vs-self-consume thresholds. Contributions welcome.

Transport / integration#

Additional transport recipes welcome: Home Assistant rest_command (HA users — see Discussion #824 for community patterns), AppDaemon, EVCC API integration (pending #29815), other smart-home-native integrations, etc.