自动化研究产物 — 非上游项目。

本仓库是由自动化工具链为拉瓦尔大学（Université Laval）硕士论文构建的一次性实验环境，用于复现已发表的 GitHub Actions 工作流漏洞。它是 mesa/mesa 在提交 821c14475afebc6a68a45bb4b8e87be4d36a0c41（2026-03-04）时的逐字快照，依据该项目自身的许可证重新分发，该许可证文件已原样包含在本快照中。

上游项目未参与其中，也从未成为攻击目标，此处研究的漏洞已公开。本仓库中的每个密钥和变量均为随机生成的虚拟值——不存在任何真实凭据。操作引用和运行器镜像均固定为其在 2026-03-04 解析到的版本；有关对快照所做的每项更改，请参阅工具链输出中的 pinning.md。

如有疑问或异议：[email protected]

对于 GSoC，请查看我们的 Google Summer of Code 2026 指南

Mesa：Python 中的基于智能体建模

CI/CD
包
元信息
聊天

Mesa 允许用户使用内置核心组件（如空间网格和智能体调度器）或自定义实现快速创建基于智能体的模型；使用基于浏览器的界面进行可视化；并使用 Python 的数据分析工具分析其结果。其目标是成为 NetLogo、Repast 或 MASON 的基于 Python 的替代方案。

上图：WolfSheep 模型的 Mesa 实现，可在浏览器窗口或 Jupyter 中显示。在线演示可在此处获取。

功能特性

• 模块化组件
• 基于浏览器的可视化
• 内置分析工具
• 示例模型库

使用 Mesa

要安装我们最新的稳定版本，请运行：

pip install -U mesa

从 Mesa 3.0 开始，我们默认不再安装所有依赖项。

# 您可以根据需要自定义所需的额外依赖项。可用选项包括：
pip install -U "mesa[network,viz]"

# 这等同于我们推荐的依赖项：
pip install -U "mesa[rec]"

# 要安装全部依赖项（包括开发依赖项）：
pip install -U "mesa[all]"

您也可以使用 pip 安装最新的 GitHub 版本：

pip install -U -e git+https://github.com/mesa/mesa@main#egg=mesa

或者本仓库或您自己分支上的任何其他（开发）分支：

pip install -U -e git+https://github.com/YOUR_FORK/mesa@YOUR_BRANCH#egg=mesa

资源

如需有关使用 Mesa 的资源或帮助，请查看以下内容：

• 入门指南（一系列教程，将引导您完成一个基本模型。）
• Mesa 的 GSoC — 候选人指南（适用于有兴趣参加 Mesa 的 Google Summer of Code 的候选人）
• Mesa 示例（一系列经典 ABM 的仓库，它们是 Mesa[rec] 安装的一部分，并使用最新的 Mesa 版本）
• 文档（Mesa 的文档、API 和有用的代码片段）
  • 开发版本文档（如果您使用的是预发布版本的 Mesa，请参阅最新版本文档）
• 讨论（关于 Mesa 的 GitHub 线程讨论）
• Matrix 聊天（通过 Matrix 讨论 Mesa 的聊天论坛）

在 Docker 中运行 Mesa

您可以通过几种方式在 Docker 容器中运行 Mesa。

如果您是 Mesa 开发者，请先安装 Docker Compose，然后在包含 Mesa Git 仓库的文件夹中运行：

$ docker compose up
# 如果您希望它在后台运行，则改为运行
$ docker compose up -d

这会以 Schelling 模型作为示例运行。

使用本 Git 仓库中的 docker-compose.yml 文件，docker compose up 命令会执行两项重要操作：

• 它将 mesa 根目录（相对于 docker-compose.yml 文件）挂载到 /opt/mesa，并针对该目录运行 pip install -e，以便您对 mesa 所做的更改能够反映在运行中的容器中。
• 它将 docker 容器的 8765 端口绑定到您主机系统的 8765 端口，以便您可以像往常一样通过在浏览器中访问 localhost:8765 与运行中的模型进行交互。

如果您是希望在模型上运行 Mesa 的模型开发者，您需要：

• 确保您的模型文件夹位于包含 docker-compose.yml 文件的文件夹内
• 将 docker-compose.yml 中的 MODEL_DIR 变量更改为指向您模型的路径
• 确保模型文件夹包含一个 app.py 文件

然后，您只需运行 docker compose up -d，即可从 localhost:8765 访问它。

为 Mesa 做贡献

想加入 Mesa 团队，或者只是对 Mesa 正在发生的事情感到好奇？您可以……

• 加入我们的 Matrix 聊天室，在那里可以（非正式地）讨论问题、议题和想法。
• 参加每月一次的开发会议（您可以在 Mesa 讨论中找到开发会议时间、议程和笔记）。
• 直接在 GitHub 上查看代码。

如果您遇到问题，请提交一个 工单 供我们讨论。如果可能，请随后提交一个拉取请求。

如果您想添加功能，请通过 工单 联系我们，或参加开发会议（请参阅 Mesa 讨论）。如果您自己构建该功能，那么它最有可能被添加！

别忘了查看贡献者指南。

引用 Mesa

要在您的出版物中引用 Mesa，您可以参考我们在《开放源码软件杂志》（JOSS）上发表的同行评审文章：

• ter Hoeven, E., Kwakkel, J., Hess, V., Pike, T., Wang, B., rht, & Kazil, J. (2025). Mesa 3: Agent-based modeling with Python in 2025. Journal of Open Source Software, 10(107), 7668. https://doi.org/10.21105/joss.07668

我们的 CITATION.cff 可用于生成 APA、BibTeX 和其他引用格式。