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.1

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.1
File	Size	Uploaded
phx-1.57.1.tar.gz	387.6 kB	Sep 15, 2026	Details

Built distribution (wheel)

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

Total release size: 857.5 kB

Release files / phx-1.57.1.tar.gz

Download URL	phx-1.57.1.tar.gz
Size	387.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`422b6fc22a2a2aec30fcb66d406d86b5c1bca59ea4c051f0003828a93039102d`
BLAKE2b-256 checksum How to use checksums	`8d9d1be99d0c9548df37906ddc83d3fb1735811edbb41d6e4c85d97148fb2ec1`
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/6939b05128b35080d427092bc66a492d458835ad

Workflow

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

Artifact

Subject: phx-1.57.1.tar.gz
SHA-256 checksum: 422b6fc22a2a2aec30fcb66d406d86b5c1bca59ea4c051f0003828a93039102d Verifying attestations

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

Download URL	phx-1.57.1-py3-none-any.whl
Size	469.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`261577826291cc4414cbd7d54a7014bb84fa612aa3972483bc01f5f51e2be173`
BLAKE2b-256 checksum How to use checksums	`6c40a02ff3b4038f49d17e5f30d636dcb7bda4523aca9ba6f47d8c6c3147ba0c`
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/6939b05128b35080d427092bc66a492d458835ad

Workflow

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

Artifact

Subject: phx-1.57.1-py3-none-any.whl
SHA-256 checksum: 261577826291cc4414cbd7d54a7014bb84fa612aa3972483bc01f5f51e2be173 Verifying attestations