Skip to main content

Mesa: Agent-based modeling in Python 3+

https://api.travis-ci.org/projectmesa/mesa.svg?branch=master https://codecov.io/gh/projectmesa/mesa/branch/master/graph/badge.svg https://img.shields.io/badge/code%20style-black-000000.svg

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.

Features

  • 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 -e git+https://github.com/projectmesa/mesa#egg=mesa

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

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

Running Mesa in Docker

You can run Mesa in a Docker container in a few ways.

If you are a Mesa developer, first install docker-compose and then run:

$ docker-compose build --pull
...
$ docker-compose up -d dev # start the docker container
$ docker-compose exec dev bash # enter the docker container that has your current version of Mesa installed at /opt/mesa
$ mesa runserver examples/Schelling # or any other example model in examples

The docker-compose file does two important things:

  • It binds the docker container’s port 8521 to your host system’s port 8521 so you can interact with the running model as usual by visiting localhost:8521 on your browser

  • It mounts the mesa root directory (relative to the docker-compose.yml file) into /opt/mesa and runs pip install -e on that directory so your changes to mesa should be reflected in the running container.

If you are a model developer that wants to run Mesa on a model (assuming you are currently in your top-level model directory with the run.py file):

$ docker run --rm -it -p127.0.0.1:8521:8521 -v${PWD}:/code comses/mesa:dev mesa runserver /code

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!

Metadata

Release files for Mesa 0.8.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Mesa 0.8.8.1
File Size Uploaded Provenance Actions
Mesa-0.8.8.1.tar.gz 646.2 kB Without provenance Details for Mesa-0.8.8.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for Mesa 0.8.8.1
File Interpreter ABI Platform Actions
Mesa-0.8.8.1-py3-none-any.whl Python 3 none any Details for Mesa-0.8.8.1-py3-none-any.whl

Total release size: 1.3 MB

Release files / Mesa-0.8.8.1.tar.gz

Download URL Mesa-0.8.8.1.tar.gz
Size 646.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1381f5d3a8a7c4c06978bddfe8a60d494db28004876171bd63298c308ca66235
BLAKE2b-256 checksum
How to use checksums
8afa218a3ff0ede43b18356a7c9de44fc922b7ac32a2856ea27ece439fe8eb6c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

Release files / Mesa-0.8.8.1-py3-none-any.whl

Download URL Mesa-0.8.8.1-py3-none-any.whl
Size 667.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cecae54e2a857e0493cf366ec580d131932f2bbcff84b3c77e3cbe7c911c9704
BLAKE2b-256 checksum
How to use checksums
2d71b5a5f8dd3f3924ef50889bfad90aa5b13f87198fe4ed5a297b27ed04c238
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

Security for Mesa 0.8.8.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.8.8.1 This release

2 release files No provenance

0.7.8

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page