---
id: pyemvue
version: "0.18.9"
license: unclear
license_treatment: permissive
maintenance: aging
---

# pyemvue — Unofficial library for interacting with the Emporia Vue energy monitor.

License: permissive · Maintenance: aging · Downloads: 131.2K/mo

## What it is and what it does

PyEmVue is an unofficial Python client for the Emporia Vue energy monitoring system. It authenticates with your Vue account, retrieves device and channel information, and fetches energy usage data at various time scales. The library also supports controlling smart outlets and EV chargers connected to your Vue setup.

The package handles login via username/password or stored tokens, manages token refresh automatically, and provides methods to query usage over time ranges or at specific instants. It requires Python 3.9+ and depends on pycognito for authentication, requests for HTTP calls, python-dateutil for time handling, and typing-extensions for type hints.

Use it for:

- Monitor real-time or historical energy consumption by device or circuit in your home
- Build a dashboard or logging system that pulls Vue data into a home automation platform
- Programmatically toggle smart outlets or EV chargers based on energy usage patterns
- Export energy usage data for analysis or billing reconciliation
- Integrate Vue monitoring into a custom home energy management application

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

PyEmVue reads energy usage data from Emporia Vue home energy monitors and provides programmatic control over outlets and EV chargers through the Vue API.

Yes, if you own an Emporia Vue system and need programmatic access to its data or control capabilities. The library is straightforward to use, has low install friction, and carries no security vulnerabilities. However, maintenance is aging—activity is sparse—so verify that the authentication flow and API compatibility remain current before relying on it in production.

## Install

pip install pyemvue
uv add pyemvue
poetry add pyemvue

## Installing pyemvue

Before you install: Low install friction with a pure Python wheel and four lightweight runtime dependencies. Maintenance is aging—last commit was 2025-12-26, though the repository remains active with 240 stars.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.

Quickstart:

import pyemvue
from pyemvue.enums import Scale, Unit

vue = pyemvue.PyEmVue()
vue.login(username='you@email.com', password='password', token_storage_file='keys.json')
devices = vue.get_devices()
device_gids = [d.device_gid for d in devices]
usage = vue.get_device_list_usage(deviceGids=device_gids, instant=None, scale=Scale.MINUTE.value, unit=Unit.KWH.value)

Requires Python 3.9+; you must have an active Emporia Vue account and valid credentials

Verify before relying:

- Whether the Emporia Vue API remains stable and whether the library continues to work with current Vue hardware/firmware versions
- Current state of the authentication flow and whether token refresh works reliably in production

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 131.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

emporia vue energy monitor api, home energy usage tracking, smart outlet control python, ev charger management, electricity consumption monitoring, home-automation, energy-monitoring, iot

[View on SkillFed](https://skillfed.io/packages/pyemvue) · [View on PyPI](https://pypi.org/project/pyemvue/)