PHX (Passive House Exchange):

The Passive House Exchange (PHX) package enables users to move building model data into and out of the Passive House energy modeling software platforms (PHPP or WUFI-Passive).

PHX converts live Honeybee models carrying honeybee-ph data into 'PH-Style' objects and then manages data input to proprietary PH calculators such as PHPP and WUFI-Passive. File-oriented workflows may first read a HBJSON file into that Honeybee model.

PHX itself does not have serialization / deserialization, and is not intended to be stored or written directly: it is an in-memory-only model which is created as a middle-step when moving the building data from the source (usually a HBJSON file) to the destination (PHPP, WUFI-Passive).

This library is designed to be used as part of the Honeybee-PH plugin workflow, or other similar tools which require interfacing with the Passive House modeling platforms.

from PHX.conversion import from_honeybee

phx_project = from_honeybee(hb_model)

Packages:

conversion: Public live Honeybee / honeybee-ph Model → transient PhxProject API.
from_HBJSON: Honeybee conversion implementation and HBJSON file-reading helpers retained for existing workflows.
from_WUFI_XML: Modules used to create a new PHX model from an existing WUFI-Passive XML file.
from_PHPP: Modules used to create a new PHX model from an existing PHPP file.'
model: The PHX model classes and structures. These objects are designed to be built by one of the 'from_*' libraries above.
to_PHPP: Libraries to allow for the export of PHX data to a PHPP Microsoft Excel spreadsheet.
to_WUFI_XML: Libraries to allow for the export of a WUFI-Passive XML file with all of the PHX model data. This XML file can then be opened from within the WUFI-Passive application.
to_PPP / to_METr_JSON: Additional exporters for the PPP and METr-JSON target formats.

Development:

Python: 3.10+ (CPython). Runs as a library/CLI, not inside Rhino (except the PHX/run.py Grasshopper shim).
Tests: python -m pytest tests/.
Commits: conventional commits (feat(scope): / fix(scope):) drive semantic-release auto-publishing to PyPI.
Agent/contributor orientation: CLAUDE.md, the context/ folder, and the deep architecture docs under docs/dev/ and docs/reference/.

More Information:

For more information on the use of these tools, check out the the Passive House Tools website: https://passivehousetools.com/

Tests versions

Metadata

Release files for PHX 1.57.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for PHX 1.57.0
File	Size	Uploaded
phx-1.57.0.tar.gz	387.5 kB	Sep 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for PHX 1.57.0
File	Interpreter	ABI	Platform	Reset
phx-1.57.0-py3-none-any.whl 469.8 kB Sep 15, 2026	Python 3	none	any	Details

Total release size: 857.3 kB

Release files / phx-1.57.0.tar.gz

Download URL	phx-1.57.0.tar.gz
Size	387.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`7605f95e84c9d096cffdbaaf744b01a012f3cbbc00e0bac7c0e89c3f60d04e52`
BLAKE2b-256 checksum How to use checksums	`5ff0d8071babfe60fb9d8455c44abeae08a0ca41c221ccdb18ddaf927f5095c6`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/PH-Tools/PHX
Publishing commit: github.com/PH-Tools/PHX/tree/ebe08c37bf00936203e16d29157312dfe5b96d96

Workflow

Publishing configuration: github.com/PH-Tools/PHX/blob/ebe08c37bf00936203e16d29157312dfe5b96d96/.github/workflows/ci.yml
Publishing logs: github.com/PH-Tools/PHX/actions/runs/35027741524/attempts/1

Artifact

Subject: phx-1.57.0.tar.gz
SHA-256 checksum: 7605f95e84c9d096cffdbaaf744b01a012f3cbbc00e0bac7c0e89c3f60d04e52 Verifying attestations

Release files / phx-1.57.0-py3-none-any.whl

Download URL	phx-1.57.0-py3-none-any.whl
Size	469.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c58973a6ea86703519bdcb615faf9c84eaa553397a79fc87632b8d4bd91c7182`
BLAKE2b-256 checksum How to use checksums	`337fe20a4db39ca99fe4999ddc0ab038f286788c3987358105c1c3e94edb679c`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/PH-Tools/PHX
Publishing commit: github.com/PH-Tools/PHX/tree/ebe08c37bf00936203e16d29157312dfe5b96d96

Workflow

Publishing configuration: github.com/PH-Tools/PHX/blob/ebe08c37bf00936203e16d29157312dfe5b96d96/.github/workflows/ci.yml
Publishing logs: github.com/PH-Tools/PHX/actions/runs/35027741524/attempts/1

Artifact

Subject: phx-1.57.0-py3-none-any.whl
SHA-256 checksum: c58973a6ea86703519bdcb615faf9c84eaa553397a79fc87632b8d4bd91c7182 Verifying attestations