Emporia Energy Skill

Use the scripts in {baseDir}/scripts to query Emporia Vue data directly.

Modes are selected with EMPORIA_MODE:

• - cloud: Emporia cloud API via PyEmVue (like the Home Assistant integration)
• INLINECODE3: Local ESPHome API (for flashed devices)

Choose a mode (cloud vs local)

• - Use cloud if your Emporia device is still on stock firmware or you want the simplest setup. Requires Emporia account credentials and internet access.
• Use esphome only if the device is flashed with ESPHome and on your LAN. Requires the device IP/hostname and native API access on port 6053.

If you are unsure whether the device is ESPHome-flashed, choose cloud mode.

Environment

Cloud mode

• - INLINECODE4
• INLINECODE5

Optional:

• - EMPORIA_SCALE (MINUTE, SECOND, MINUTES_15, DAY, MONTH) - defaults to INLINECODE12

ESPHome mode

• - INLINECODE13
• INLINECODE14 (optional, default 6053)
• INLINECODE16 (Noise PSK, base64) or ESPHOME_PASSWORD (legacy)

Configuration steps

Cloud:

1. 1. Set EMPORIA_MODE=cloud.
2. Set EMPORIA_EMAIL and EMPORIA_PASSWORD.
3. (Optional) Set EMPORIA_SCALE to control power vs energy units.
4. Run list first to confirm channels, then summary or circuit <name>.

ESPHome:

1. 1. Ensure the device is flashed with ESPHome and on your LAN.
2. Set EMPORIA_MODE=esphome.
3. Set ESPHOME_HOST to the device IP/hostname (not Home Assistant).
4. If the ESPHome node uses encryption, set ESPHOME_API_KEY (base64 Noise PSK).
5. Run list first to confirm channels, then summary or circuit <name>.

Commands

The scripts accept:

• - summary (default)
• INLINECODE32
• INLINECODE33

Usage

Cloud:
CODEBLOCK0

ESPHome:
CODEBLOCK1

Dependencies (pip by default)

Cloud:
CODEBLOCK2

ESPHome:
CODEBLOCK3

Optional: you can use uv instead of pip if preferred.

Output

Scripts emit JSON with:

• - timestamp
• unit
• total (best-effort)
• top circuits
• channels used

Safety

• - Never print secrets (passwords, tokens, keys).
• Do not make hardware or panel wiring recommendations.