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/wang-boyu/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:

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.0.2.tar.gz (19.3 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.0.2-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mesa_llm-0.0.2.tar.gz
Algorithm Hash digest
SHA256 219c4e67a04ce9e4df1955b696b345895f0120781ff9010d4016931745a3f66e
MD5 96387c3458edc11ff41c86a1c7d98ef0
BLAKE2b-256 ce28d4be8b115887756595a73fe4d18c04ff36ccfd3aa68ab184fcac12c4d1db

See more details on using hashes here.

Provenance

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

Publisher: release.yml on wang-boyu/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.0.2-py3-none-any.whl.

File metadata

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

File hashes

Hashes for mesa_llm-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6f0d88699f29f17f8d60505dfebbd52c605ec6a5a23b71fb6085c830b0187cf3
MD5 29fb3ad7e4c09db3e183a41df266d9f8
BLAKE2b-256 74b868a7c6c7e221675840002b27237252de4b86eb91d1a3e5996c5dc5beeb84

See more details on using hashes here.

Provenance

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

Publisher: release.yml on wang-boyu/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