Honeybee-PH and its Grasshopper toolkit are free and open-source. Feel free download and give it a try.
YouTube Walk Through
Watch a detailed step-by-step walk through showing both the LadybugTools installation and the Honeybee-PH installation here: Installation Walk Through
Requirements
In order to successfully install Honeybee-PH, please make sure that your system already has all of the required software installed and working:
- Rhino-3D v7+
- Ladybug-Tools v1.7+
- WUFI-Passive
- PHPP v9 or v10
- Windows v10+ or MacOS v13+
Please Note: The installation file for Honeybee-PH does NOT include either WUFI-Passive or PHPP. Those programs must be purchased separately in order to use them. Honeybee-PH is an interface for those tools, not a replacement for them.
Rhino / Grasshopper Installation
In order to successfully install the Honeybee-PH toolkit, follow the steps outlined below:
- Step 1: Ensure you have Rhino v7 or better installed.
- Step 2: WINDOWS USERS Use the One-Click Installer for Grasshopper in order to install Ladybug Tools onto your system.
- Step 3: MACOS USERS Use the Food4Rhino Installer in order to install Ladybug Tools onto your system.
- Step 4: In Grasshopper, use the Ladybug Tools “LB Versioner” component to update your installation to the latest version.
- Step 5: Download the HBPH Installation File: Download Honeybee-PH Installer File ⤓
- Step 6: Open the HBPH Installation File using Rhino / Grasshopper and follow the instructions shown. (Note: If you are on Windows and you run into permissions trouble during the install, try opening Rhino ‘as administrator’.)
- Step 7: Restart Rhino and Grasshopper to ensure that all the new components are properly added to your installation. Done!
Install Trouble?
If you run into any errors or trouble during install, check:
Do you have Rhino v7 or v8? HBPH is not compatible with earlier versions of Rhino.
If you are on Windows, are you using the Ladybug Tools Pollination One-Click Installer for Grasshopper? This is the recommended method now for all Windows users. It’s free, and much easier than the older Food4Rhino installer.
Are you sure you already have Ladybug-Tools and Honeybee installed? You can use the Honeybee “HB Check Versions” component to check that your Python, Radiance, and OS installs are working properly?
Do you have a compatible version of Ladybug Tools installed? Honeybee-PH requires Ladybug Tools v1.7 or better to work properly. If you have an older version of Ladybug Tools installed, you should use the Ladybug Tools “LB Versioner” component to update your installation to the latest version before trying to use Honeybee-PH.
Are you using vanilla Ladybug-Tools, or are you using Pollination? If you are using Pollination on Windows, it is possible that your Ladybug-Tools are installed in a different directory than normal. This means you may need additional permissions before you can install Honeybee-PH. If you run into any permissions issues, try running Rhino ‘Run as administrator’ from your Start Menu and then running the Installation.
Still having trouble? Check out the Contact page for additional resources.