PROTEUS (/ˈproʊtiəs, PROH-tee-əs) is a modular Python framework that simulates the coupled evolution of the atmospheres and interiors of rocky planets and exoplanets. Inspired by the Greek god of elusive sea change, who could change his form at will, PROTEUS is designed to be flexible and adaptable to a wide range of planetary environments. It can foretell the future, but answers only to those who are capable of asking the right questions.

Schematic of PROTEUS components and corresponding modules.

Quick links:

• Model description -- outline of the code and its structure
• Installation -- set up PROTEUS on your machine
• Usage -- run your first simulation
• Configuration -- customise model parameters
• Troubleshooting -- common errors and fixes
• Contributing -- how to change or contribute source code
• Team -- meet the developers
• Contact -- get in touch with the developers

Citation and credit

If you make use of PROTEUS, please reference scientific manuscripts outlined in Bibliography, state the code version used, and include an acknowledgement. We provide a suggested acknowledgement in the contributing page.