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

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.56.117
File	Size	Uploaded
phx-1.56.117.tar.gz	387.4 kB	Sep 15, 2026	Details

Built distribution (wheel)

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

Total release size: 857.1 kB

Release files / phx-1.56.117.tar.gz

Download URL	phx-1.56.117.tar.gz
Size	387.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`f6176a55da4440d6bc49750e223296b79cf96096de45750fc875ddf1a191f40a`
BLAKE2b-256 checksum How to use checksums	`6f5a2378507c92ad93e285dfe9541af96eabbe8c09ba78da3238075841a46179`
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/6f81e7e3741aac1ef7a533f6f4b584601309764e

Workflow

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

Artifact

Subject: phx-1.56.117.tar.gz
SHA-256 checksum: f6176a55da4440d6bc49750e223296b79cf96096de45750fc875ddf1a191f40a Verifying attestations

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

Download URL	phx-1.56.117-py3-none-any.whl
Size	469.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a992f61f57c27c06967b0c5c319419f2c145740f1abd35c17cee932a439a0bd4`
BLAKE2b-256 checksum How to use checksums	`c46545aab3f883e87c2ff8d64d60f0ca74505d11b84f542cd919f47773086746`
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/6f81e7e3741aac1ef7a533f6f4b584601309764e

Workflow

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

Artifact

Subject: phx-1.56.117-py3-none-any.whl
SHA-256 checksum: a992f61f57c27c06967b0c5c319419f2c145740f1abd35c17cee932a439a0bd4 Verifying attestations