mesa/mesa

Mesa is an open-source Python library for agent-based modeling, ideal for simulating complex systems and exploring emergent behaviors.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 15 minutes ago
Added to GitGenius on September 18th, 2026
Created on September 19th, 2014
Open Issues & Pull Requests: 101 (-2)
GitHub issues: Enabled
Number of forks: 1,314
Total Stargazers: 3,854 (+0)
Total Subscribers: 91 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 10.1 hours
Mean response time: 123.5 days
90th percentile: 106.5 days
Tracked items: 509

Most active contributors

Sign in to see contributor activity.

How this project is maintained

About 3% of issues opened in the past year have never received a reply. 51% of open issues come from outside the core team, a mix of external reports and the maintainers' own roadmap. Work labelled "enhancement" is answered fastest, typically in about 6 hours, while "1 - Backlog" waits about 13 months. 59% of tracked open issues have had no activity in three months. 82% of issues opened in the past year have been closed, leaving a working backlog.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 78
New in 7 days: 7
Closed in 7 days: 9
Avg open age: 411 days
Stale 30+ days: 62
Stale 90+ days: 58

Recent activity

Opened in 7 days: 5
Closed in 7 days: 9
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • bug (55)
  • docs (36)
  • visualisation (31)
  • feature (26)
  • enhancement (18)
  • Sprints! (16)
  • 0 - Triage (15)
  • good first issue (15)

Detailed Description

Mesa is a Python library for agent-based modeling that lets you build simulations of complex systems where autonomous agents interact and produce emergent behaviors.

Agent-based modeling requires defining individual agents with their own rules and interactions, then running the simulation to observe system-level patterns that emerge from those local behaviors. Mesa provides the core infrastructure to manage agent populations, handle spatial environments, schedule agent actions, and collect data from running simulations. The library handles the mechanics of stepping through time, tracking agent state, and organizing agents in space so you can focus on defining the domain-specific logic of your model.

Mesa suits researchers and practitioners building simulations of social systems, economic markets, ecological dynamics, or any domain where agent interactions drive outcomes. It works well for exploratory modeling where you want to test how different agent behaviors and interaction rules produce different system-level results. The library includes built-in support for spatial models and GIS integration, making it particularly useful if your agents operate in geographic or grid-based environments. If you are choosing between frameworks, Mesa is designed specifically for agent-based modeling rather than being a general-purpose simulation tool adapted to the task.

The project maintains steady development with regular commits addressing bug fixes, feature additions, and documentation improvements. The codebase receives ongoing refinement to the core simulation engine and agent scheduling mechanisms. Pull requests are reviewed and merged consistently, indicating active maintenance. The project sustains engagement with its user community through issue responses and documentation updates.