Installing VPLanet

VPLanet will run on macOS 10+, most recent Linux distributions, and Windows 10 (via their free Ubuntu Linux interface). If you plan on developing VPLanet us the Developers


You can install VPLanet and its support scripts (vplot, vspace, multiplanet, and bigplanet) using pip:

python -m pip install vplanet

This will place executables of the most up-to-date, stable versions of these codes in your path (after ensuring all dependency checks are satisfied). This command will not download the repository. Please note that VPLanet requires Python 3.6 or greater.


To install VPLanet as a developer, you must clone the repository and then install the software. The first time you install VPLanet, use the following commands:

git clone
cd vplanet
python develop

After changes to the C source, make sure to re-install:

python develop


If you are running macOS Catalina or later, you may need to force the operating system to set the location of C libraries:

export CPATH=/Applications/

Thanks to Chris Colose for identifying and solving this problem.