Ladybug Tools
Ladybug Tools is a free, open-source plugin suite for Grasshopper and Rhino that wires climate files, daylight engines such as Radiance, and whole-building energy models through EnergyPlus and OpenStudio into one parametric interface for early-stage environmental design.
Most firms still bounce between a weather file viewer, a daylight app, and a separate energy modeler, then lose the thread when geometry changes. Ladybug Tools attacks that fragmentation by keeping sun paths, radiation meshes, annual daylight metrics, and HVAC-sized energy models inside the same Grasshopper graph you already use for massing (Ladybug Tools homepage, 2026).
The project bundles named modules such as Ladybug for climate graphics and sun studies, Honeybee for Radiance- and EnergyPlus-driven daylight and thermodynamic work, Dragonfly for larger district-scale questions, and Butterfly for CFD workflows tied to OpenFOAM (Ladybug Tools homepage, 2026). Honeybee’s public page spells out concrete outputs like point-in-time illuminance, annual metrics including DA, cDA, UDI, and ASE, glare studies, and end-use intensity charts fed by annual simulations (Ladybug Tools Honeybee page, 2026).
Because the code is open source and community-governed, the homepage cites more than 500,000 downloads as a signal of how widely the plugins ship in practice (Ladybug Tools homepage, 2026). That scale matters when you need forum answers, example files, and classroom adoption without a proprietary lock-in story.
Economics are simple for the core libraries: they are free to install and run, with paid hosting services such as Pollination marketed separately as a faster cloud path for some Honeybee-style workflows (Ladybug Tools homepage, 2026). Budget time for learning Grasshopper discipline and for validating results against your independent QA process, not for chasing a license invoice on day one.
Specifications
Pricing
Platforms
Used for
Used by
Tasks
Pros and cons
Pros
- No license fee for the core open-source plugins
- Tight Grasshopper integration for iterative design studies
- Combines Radiance and EnergyPlus in one toolkit narrative
- Large download footprint and active forum culture
Cons
- Steep Grasshopper learning curve for newcomers
- Simulation fidelity still depends on user inputs and QA discipline
- Some advanced paths expect comfort with Python, Radiance, and EnergyPlus concepts
Key features
Climate graphics in Grasshopper: Ladybug reads standard EnergyPlus EPW weather files and plots sun paths, psychrometrics, and outdoor comfort charts inside Rhino (Ladybug Tools Ladybug page, 2026).
Radiance-backed daylight: Honeybee runs illuminance, annual daylight (DA, cDA, UDI, ASE), glare, and advanced solar radiation studies through Radiance (Ladybug Tools Honeybee page, 2026).
EnergyPlus and OpenStudio: Honeybee builds and visualizes annual energy, HVAC sizing, thermal comfort maps, and passive or active strategy studies using EnergyPlus with OpenStudio measure hooks (Ladybug Tools Honeybee page, 2026).
District and CFD extensions: Dragonfly and Butterfly extend the same family toward larger sites and airflow networks when those modules fit the question (Ladybug Tools homepage, 2026).
Open codebase: Source lives under the Ladybug Tools GitHub organization with community forum governance (Ladybug Tools homepage, 2026).
Cross-platform Python core: Project materials describe Python-based components that can run broadly, while day-to-day designers typically host them inside Rhino and Grasshopper (Ladybug Tools homepage, 2026).
Pricing
Open source plugins
per year
Free
Core Ladybug Tools plugins are described as free and open source on the project homepage (Ladybug Tools homepage, 2026). Hosted add-ons such as Pollination are separate offerings.
Frequently asked questions
Is Ladybug Tools completely free to use commercially?
The homepage describes Ladybug Tools as free and open source, with repositories under the Ladybug Tools GitHub organization (Ladybug Tools homepage, 2026). Honeybee and Ladybug pages document professional-grade engines without asking for a per-seat fee to download the libraries themselves. If you adopt hosted services such as Pollination for cloud runs, that layer is a separate commercial product (Ladybug Tools homepage, 2026).
Does Ladybug Tools run on macOS inside Rhino?
The stack is built for Grasshopper inside Rhino, and Rhino itself ships for both Windows and macOS, which is how most architecture studios run it. The project also notes a Python core that can execute across operating systems when embedded elsewhere (Ladybug Tools homepage, 2026). Always match your Rhino service release with the plugin build you install.
Which weather and energy model file formats does Ladybug use?
Ladybug imports standard EnergyPlus weather EPW files for climate charts and sun studies (Ladybug Tools Ladybug page, 2026). Honeybee drives Radiance for daylight work and EnergyPlus with OpenStudio for annual building energy, including pathways for OpenStudio measures when you need custom HVAC logic (Ladybug Tools Honeybee page, 2026).
Can Honeybee compute annual daylight metrics like ASE and UDI?
Yes. Honeybee’s feature list explicitly includes annual daylight metrics such as DA, continuous DA, UDI, and annual sun exposure for glare-oriented studies, plus point-in-time illuminance and advanced solar radiation modes (Ladybug Tools Honeybee page, 2026). Those metrics assume correctly assigned materials, blinds, and grid resolution, so treat defaults as a starting point, not a code-compliance sign-off.
How does Ladybug plus Honeybee compare to using Climate Consultant or WeatherTool for climate graphics?
A quoted practitioner on the homepage contrasts Ladybug with older climate viewers such as WeatherTool and Climate Consultant, noting Ladybug makes it easier to crop hourly weather data and script custom graphics inside Grasshopper (Ladybug Tools homepage, 2026). The trade-off is that you must maintain a Grasshopper graph rather than a single-purpose desktop app.
Who maintains Ladybug Tools if my project runs for years?
The homepage states the tools evolve through an open community of experts, with a public Discourse forum and GitHub repositories forming the coordination layer (Ladybug Tools homepage, 2026). That model rewards teams who pin versions, document assumptions, and occasionally merge updates when new EnergyPlus or Radiance behaviors ship.