emporia-energy

Query Emporia Vue energy data via PyEmVue cloud or local ESPHome API.

61|11|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/viralcode/openwhale --skill emporia-energy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: emporia-energy
Source: https://github.com/viralcode/openwhale/tree/main/skills/emporia-energy
Command: npx skills add https://github.com/viralcode/openwhale --skill emporia-energy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyemvue, aioesphomeapi, and includes scripts (resource) and references (resource) and requirements-cloud.txt (resource) and requirements-esphome.txt (resource) components.

What problem does it solve?

This Skill provides direct access to your Emporia Vue energy monitoring data, whether through the cloud API or a local ESPHome setup, allowing you to track and understand your home's energy consumption.

Core Features & Use Cases

  • Dual Mode Support: Connects via Emporia's cloud API (PyEmVue) or directly to a locally flashed ESPHome device.
  • Data Retrieval: Fetches summary energy data, lists available circuits, and provides detailed circuit-specific information.
  • Use Case: Automatically check your home's current energy usage and identify the top consuming circuits at any given time, helping you identify potential energy savings.

Quick Start

Export your Emporia cloud credentials and run the summary command to get your energy usage.

Frequently Asked Questions about emporia-energy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve Emporia Vue energy monitoring data using Python?

You can retrieve Emporia Vue energy monitoring data using Python by running the provided scripts that query either the PyEmVue cloud API or a local ESPHome API to fetch energy consumption summaries and circuit details.

Can I monitor home energy usage locally with ESPHome instead of using the Emporia cloud?

Yes, you can monitor home energy usage locally by connecting directly to a locally flashed ESPHome device using the aioesphomeapi library, bypassing the Emporia cloud API entirely.

What environment variables do I need to set up for Emporia Vue energy data retrieval?

You must export environment variables for Emporia cloud authentication credentials and mode selection to authorize the PyEmVue API and configure the scripts before executing energy data queries.

Does the Emporia Vue energy monitoring skill support listing individual circuit consumption?

Yes, the Emporia Vue energy monitoring skill supports listing available circuits and detailing specific circuit consumption, allowing you to identify top consuming circuits at any given time for potential energy savings.

What is the best way to query specific circuit energy consumption from an Emporia Vue device?

The best way to query specific circuit energy consumption from an Emporia Vue device is by executing the included Python scripts configured with your preferred mode, fetching detailed circuit-specific information directly.

Why does my ESPHome API connection fail when retrieving local energy monitoring data?

ESPHome API connection failures during local energy monitoring data retrieval typically occur if the device is not properly flashed or if the required environment variables for mode selection and local authentication are missing.