Skip to main content

Reproduce the Axelrod iterated prisoners dilemma tournament

Project description

https://img.shields.io/pypi/v/Axelrod.svg https://zenodo.org/badge/19509/Axelrod-Python/Axelrod.svg https://github.com/Axelrod-Python/Axelrod/workflows/CI/badge.svg

Join the chat at https://gitter.im/Axelrod-Python/Axelrod

Axelrod

Goals

A Python library with the following principles and goals:

  1. Enabling the reproduction of previous Iterated Prisoner’s Dilemma research as easily as possible.

  2. Creating the de-facto tool for future Iterated Prisoner’s Dilemma research.

  3. Providing as simple a means as possible for anyone to define and contribute new and original Iterated Prisoner’s Dilemma strategies.

  4. Emphasizing readability along with an open and welcoming community that is accommodating for developers and researchers of a variety of skill levels.

Features

With Axelrod you:

The library has 100% test coverage and is extensively documented. See the documentation for details and examples of all the features: http://axelrod.readthedocs.org/

An open reproducible framework for the study of the iterated prisoner’s dilemma: a peer reviewed paper introducing the library (22 authors).

Installation

The library is tested on Python versions 3.8, 3.9, and 3.10.

The simplest way to install is:

$ pip install axelrod

To install from source:

$ git clone https://github.com/Axelrod-Python/Axelrod.git
$ cd Axelrod
$ python setup.py install

Quick Start

The following runs a basic tournament:

>>> import axelrod as axl
>>> players = [s() for s in axl.demo_strategies]  # Create players
>>> tournament = axl.Tournament(players, seed=1)  # Create a tournament
>>> results = tournament.play()  # Play the tournament
>>> results.ranked_names
['Defector', 'Grudger', 'Tit For Tat', 'Cooperator', 'Random: 0.5']

Examples

Contributing

All contributions are welcome!

You can find helpful instructions about contributing in the documentation: https://axelrod.readthedocs.io/en/latest/how-to/contributing/index.html

Publications

You can find a list of publications that make use of or cite the library on the citations page.

Contributors

The library has had many awesome contributions from many great contributors. The Core developers of the project are:

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

Axelrod-4.13.0.tar.gz (890.7 kB view hashes)

Uploaded Source

Built Distribution

Axelrod-4.13.0-py2.py3-none-any.whl (348.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

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