Mesa is an agent-based modeling framework in Python
Python JavaScript HTML Other
Clone or download


Mesa: Agent-based modeling in Python 3+

Mesa is an Apache2 licensed agent-based modeling (or ABM) framework in Python.

It allows users to quickly create agent-based models using built-in core components (such as spatial grids and agent schedulers) or customized implementations; visualize them using a browser-based interface; and analyze their results using Python's data analysis tools. Its goal is to be the Python 3-based alternative to NetLogo, Repast, or MASON.

A screenshot of the Schelling Model in Mesa

Above: A Mesa implementation of the Schelling segregation model, being visualized in a browser window and analyzed in a Jupyter notebook.


  • Modular components
  • Browser-based visualization
  • Built-in tools for analysis
  • Example model library

Using Mesa

Getting started quickly:

$ pip install mesa

You can also use pip to install the github version:

$ pip install git+

Take a look at the examples folder for sample models demonstrating Mesa features.

For more help on using Mesa, check out the following resources:

Contributing back to Mesa

If you run into an issue, please file a ticket for us to discuss. If possible, follow up with a pull request.

If you would like to add a feature, please reach out via ticket or the dev email list for discussion. A feature is most likely to be added if you build it!