Mesa-LLM: Generative Agent-Based Modeling with Large Language Models Empowered Agents

CI/CD
Package
Meta
Chat

Mesa-LLM integrates large language models (LLMs) as decision-making agents into the Mesa agent-based modeling (ABM) framework. It enables sophisticated, language-driven agent behaviors, allowing researchers to model scenarios involving communication, negotiation, and decision-making influenced by natural language.

⚠️ WARNING ⚠️ This repository is currently under active development. The API and functionality may change significantly. Please stay tuned for our first release coming soon!

Installation

To install Mesa-LLM, run:

pip install -U mesa-llm

Mesa-LLM pre-releases can be installed with:

pip install -U --pre mesa-llm

You can also use pip to install the GitHub version:

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

Or any other (development) branch on this repo or your own fork:

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

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

• Getting Started
• Docs
• Mesa-LLM Discussions
• PyPI

Supported LLM Providers

Mesa-LLM supports the following LLM providers:

• OpenAI
• Anthropic
• xAI
• Hugging Face
• Ollama
• OpenRouter
• Novita AI
• Google Gemini

Contributing to Mesa-LLM

Want to join the team, or just curious about what is happening with Mesa and Mesa-LLM? You can:

• Join our Matrix chat room where questions, issues, and ideas can be discussed informally.
• Come to a monthly dev session (you can find dev session times, agendas, and notes at Mesa discussions).
• Check out the code on GitHub.

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 a ticket or join a dev session (see Mesa discussions).

A feature is most likely to be added if you build it!

Don't forget to check out the Contributors Guide.