travis codecov Documentation Status PyPI - License black

ambient is a building physics and simulation Python library.

The aims of ambient are to be:

  1. Simple: Provide intuitive defaults to get started quickly.

  2. Modular: Simulate only the parts you are interested in.

  3. Extensible: Enable users to create and modify their own components.

  4. Open: Provide an open-source building simulation library.


ambient currently offers modules for the analysis of:

  • Layered constructions (including steady-state and dynamic response)

  • Solar conditions (including design day calculations)

  • Psychrometrics of moist air

Simulations can be read from, and written to, JSON format.


Install ambient in a virtual environment using:

pip install ambient


ambient is licensed under the terms of the Apache License, Version 2.0. Refer to the LICENSE file for details.