BioDynaMo  v1.05.0-137fdb15
BioDynaMo Documentation

BioDynaMo logo


Biology Dynamics Modeller
Visit our website »

Report bug · Request feature · User's guide · Developer's guide

What is BioDynaMo?

BioDynaMo is a software platform to easily create, run, and visualise 3D agent-based simulations.

  • Blazing fast: The core of the platform is written in C++ and is highly optimized to harness the computational power of modern hardware.
  • Modular: Reuse, adapt, or create modules that represents a specific biological behavior or entity. With BioDynaMo you don't need to start from scratch anymore!
  • Visual: Effortlessly create astonishing images and animations of your simulations. Your publications and presentations will stand out even more!


Simply run the following command:

curl | bash

For more information, check out our user's guide.


The main purpose of this repository is to evolve BioDynaMo, making it faster and easier to use. Development of BioDynaMo happens in the open on Github, and we are grateful to the community for contributing bugfixes and improvements. Please read our contribution guide and learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to BioDynaMo.

We expect contributors to adhere to our Contributor Covenant.


When citing BioDynaMo, please use this reference:

Lukas Breitwieser et al. BioDynaMo: a modular platform for high-performance agent-based simulation.
Bioinformatics, 2021. DOI:

We recommend specifying the exact BioDynaMo version used in the methods section. For example:

We use BioDynaMo v1.01.115-e1088d4a (Breitwieser el al., 2021) for all simulations in this article.

The version can be obtained by executing biodynamo --version and can be interpreted as follows: vMAJOR.MINOR.PATCH-SHA SHA is the git commit hash that can be used to check out the exact BioDynaMo version with git checkout SHA.


BioDynaMo is Apache 2.0 licensed.