---
title: Project README
---

<!-- Badges -->
<p align="left">
  <a href="https://github.com/compolis/GABM/blob/main/LICENSE" title="License">

<img src="https://img.shields.io/github/license/compolis/GABM" alt="License" />

  </a>
  <a href="https://www.python.org/downloads/release/python-31212/" title="Python Version">

<img src="https://img.shields.io/badge/python-3.12%2B-blue.svg" alt="Python Version" />

  </a>
  <a href="https://compolis.github.io/GABM/" title="Documentation">

<img src="https://img.shields.io/badge/docs-Sphinx-green" alt="Documentation" />

  </a>
</p>

# GABM: Generative Agent-Based Model


## Overview
[GABM](https://github.com/compolis/GABM/) is a flexible, extensible [Python](https://www.python.org/) framework for developing agent-based models that use large language models (LLMs) as agent reasoning engines. It supports use of multiple LLM providers and implements persistent response caching.


## License
See [LICENSE](LICENSE.md).


## Code of Conduct and Reporting
Please see our [Code of Conduct](CODE_OF_CONDUCT.md) for guidelines on expected behavior and reporting issues.

For security or conduct concerns, you can also use the `Contact maintainers` link on the GitHub repository, or see the [SECURITY.md](SECURITY.md) file in the documentation for details on confidential reporting.


## User Guide
Please use the [User Guide](USER_GUIDE.md).


## Developer Guide
Please use the [Developer Guide](DEV_GUIDE.md).


## Roadmap
See [ROADMAP.md](ROADMAP.md) for planned next steps and future goals.


## Change Log
See [CHANGE_LOG.md](CHANGE_LOG.md) for details of each release.


## Development History
The collaborative development of GABM is captured in the [DEVELOPMENT_HISTORY.md](DEVELOPMENT_HISTORY.md).


## Acknowledgements
This project was developed with significant assistance from [GitHub Copilot](https://github.com/features/copilot) for code generation, refactoring, and documentation improvements.

We gratefully acknowledge support from the [University of Leeds](https://www.leeds.ac.uk/). Funding for this project comes from a UKRI Future Leaders Fellowship awarded to [Professor Viktoria Spaiser](https://essl.leeds.ac.uk/politics/staff/102/professor-viktoria-spaiser) (grant reference: [UKRI2043](https://gtr.ukri.org/projects?ref=UKRI2043)).