Energyworx Shareable Packages

Energyworx publishes customer-facing packages to Google Artifact Registry. Each package serves a different purpose and has its own Python version requirement:

Package	Python	Purpose
ewx-public	3.11	Write and unit-test custom rules locally with type hints and IDE support
ewx-cli + pytest-bdd-ewx	3.13	Manage configurations and run automated BDD tests against a live environment
standard-packages	3.11–3.13	Deploy the standard EDM configuration packages (VEE, billing, master data, device control, energy communities)

Because the Python version requirements differ, use separate virtual environments for each.

standard-packages is separately licensed

Unlike the other shareable packages, standard-packages is a paid add-on: it is published to a dedicated, access-restricted registry, and access is granted only to organizations with a standard-packages agreement. See standard-packages for details.

Versioning

Shared package versions track the platform release. For platform release YY.MM, the matching package version is YY.M.0 (the month is not zero-padded in the package version).

Platform release	Package version
26.02	26.2.0
26.03	26.3.0
26.10	26.10.0

Pin the package to the version that matches the platform release you target. Older 2.x style versions (e.g. ewx-cli==2.11.0) are no longer published — pinning to one will fail with Could not find a version that satisfies the requirement.

The current platform release is shown in the bottom-left of the Energyworx console (or in the release notes); ask Service Desk if you are unsure which release your environment is on.

Prerequisites (shared)

• gcloud CLI
• Access to Artifact Registry project ewx-global

Authenticate with gcloud

gcloud auth application-default login

For detailed installation instructions, see the dedicated package pages:

• ewx-public — install ewx-public for writing and unit-testing custom rules locally. See Local Rule Development for the full rule-development workflow.
• pytest-bdd-ewx — install ewx-cli and pytest-bdd-ewx for running automated BDD scenarios against a live environment. See Automated Platform Testing for the testing workflow.
• standard-packages — install and deploy the standard EDM configuration packages (requires a standard-packages agreement). See the Energy Data Management Module for the functional documentation.

Installation Issues

Common issues and fixes:

1. Authorization error to Artifact Registry:
   • Re-run gcloud auth application-default login.
   • For uv, refresh token export variables.
2. ...doesn't match any versions:
   • Usually indicates auth/source configuration is missing for private packages.
3. Plugin not loaded in pytest:
   • Confirm pytest-bdd-ewx is installed in the active environment.

If issues persist, contact support with:

• full command
• full error output
• Python version
• package manager (pip or uv)