Skip to main content

Generative Agent-Based Modeling with Large Language Models Empowered Agents

Project description

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

CI/CD GitHub CI Read the Docs Codecov
Package PyPI PyPI - License PyPI - Downloads
Meta linting - Ruff code style: black Hatch project
Chat 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!

Using Mesa-LLM

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:

Using Mesa-LLM

Mesa-LLM supports the following LLM models :

  • OpenAI
  • Anthropic
  • xAI
  • Huggingface
  • Ollama
  • OpenRouter
  • NovitaAI
  • Gemini

Contributing to Mesa-LLM

Want to join the team or just curious about what is happening with Mesa & Mesa-LLM? You can...

  • Join our Matrix chat room in which questions, issues, and ideas can be (informally) discussed.
  • Come to a monthly dev session (you can find dev session times, agendas and notes at Mesa discussions.
  • Just check out the code at 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 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mesa_llm-0.2.0.tar.gz (152.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mesa_llm-0.2.0-py3-none-any.whl (47.9 kB view details)

Uploaded Python 3

File details

Details for the file mesa_llm-0.2.0.tar.gz.

File metadata

  • Download URL: mesa_llm-0.2.0.tar.gz
  • Upload date:
  • Size: 152.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mesa_llm-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a2203935349db837aa03c9990a994afad1db86ea55e9d93f86c29f54040d9aa8
MD5 c9906b52d1b10e4324a3c502e461f606
BLAKE2b-256 9f149a494fd2af9172eba249cf6c1c4b0a5b68c1f440b1d1b9e80d0cbc48e6ac

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesa_llm-0.2.0.tar.gz:

Publisher: release.yml on mesa/mesa-llm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mesa_llm-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: mesa_llm-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 47.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mesa_llm-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0071dac46b60824f68265f1371da029ee187c3716a36fe40e923c781bce0524c
MD5 49ef44cfc701e23928e3c0191a508b8c
BLAKE2b-256 966201c4cced8f57e0c5fe32fbb52756349ad5f42e297b04423e086720cc064a

See more details on using hashes here.

Provenance

The following attestation bundles were made for mesa_llm-0.2.0-py3-none-any.whl:

Publisher: release.yml on mesa/mesa-llm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page