Coupled atmosphere-interior evolution of rocky planets and exoplanets.

PROTEUS (/ˈproʊtiəs, PROH-tee-əs) is a modular Python framework that connects interior thermal evolution, volatile outgassing, atmospheric radiative transfer, atmospheric escape, and stellar evolution into a self-consistent time-stepping loop, following a planet from a molten magma ocean to a solidified surface over billions of years. 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.

Features

  • Modular backends: interior, atmosphere, escape, outgassing, stellar, and orbit domains each expose multiple interchangeable solvers behind a common interface.
  • Coupled, conservative loop: modules exchange boundary conditions every timestep, enforcing mass and energy conservation across the whole planet system.
  • Adaptive time-stepping: resolves fast transitions (solidification, escape episodes) and steps efficiently through quasi-steady phases.
  • Parameter sweeps and observations: built-in Cartesian grid sweeps over configuration parameters, plus forward models for synthetic transit and eclipse spectra.

Get started

Follow the installation guide, then run the all-dummy quick start (no external solvers, under a minute):

proteus start -c input/dummy.toml

The quick-start tutorial explains the output; the Earth analogue tutorial is a full production run.

Documentation

Full documentation: proteus-framework.org/PROTEUS

Community and citation

Ask questions on the discussions page or contact the developers. If you use PROTEUS, please cite the papers listed in the bibliography.

Project links

Data verified by PyPI on Jul 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for nichollsh from gravatar.com nichollsh Avatar for tim.lichtenberg from gravatar.com tim.lichtenberg

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Tim Lichtenberg

GitHub Statistics

Data verified by PyPI on Jul 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache 2.0 License)

Requires

Python <3.13, >=3.11

Provides Extra

atmodeller vulcan develop docs

Tags

Astronomy Exoplanets Model-coupling

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fwl_proteus-26.7.14.tar.gz (18.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fwl_proteus-26.7.14-py3-none-any.whl (508.0 kB view details)

Uploaded Python 3

File details

Details for the file fwl_proteus-26.7.14.tar.gz.

File metadata

  • Download URL: fwl_proteus-26.7.14.tar.gz
  • Upload date:
  • Size: 18.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fwl_proteus-26.7.14.tar.gz
Algorithm Hash digest
SHA256 40d1b9eb80656866cbadd00dbc209f2df8d90593144ce992f318002607b57d8a
MD5 8d28261846eed05a5d496d614200dcfa
BLAKE2b-256 8dda4267b9995770a47b18f96151cad55adce88876b257ad823760ffc813dcd0

See more details on using hashes here.

Provenance

The following attestation bundles were made for fwl_proteus-26.7.14.tar.gz:

Publisher: publish.yaml on FormingWorlds/PROTEUS

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fwl_proteus-26.7.14-py3-none-any.whl.

File metadata

  • Download URL: fwl_proteus-26.7.14-py3-none-any.whl
  • Upload date:
  • Size: 508.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fwl_proteus-26.7.14-py3-none-any.whl
Algorithm Hash digest
SHA256 b42841d637b483688cc5b726b8ffc9b8e34bad52a0eb2ea75c8a607057c598dc
MD5 3efc2ba8274ddf1151da73c869f90ec3
BLAKE2b-256 cb366ae8015e635352a6d53fbf5a28d36a47fa788ea514ff29f02d6aa3e11bde

See more details on using hashes here.

Provenance

The following attestation bundles were made for fwl_proteus-26.7.14-py3-none-any.whl:

Publisher: publish.yaml on FormingWorlds/PROTEUS

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page