A repository to reproduce Axelrod's iterated prisoner's dilemma. Please contribute strategies via pull request (or just get in touch with me).

For an overview of how to use and contribute to this repository, see the documentation: http://axelrod.readthedocs.org/

The simplest way to install is:

$ pip install axelrod

Here is an asciicast showing how to install and use the library:

Otherwise:

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

Note that (as documented at http://axelrod.readthedocs.org/) you do not need to run the last step to use this package (you can run all the code from the root of the directory).

This repository contains Python (2.7) code that reproduces the tournament. To run the tournament, you simply need to:

$ python run_tournament.py

This automatically outputs a png file with the results. You can see the results from the latest run of the tournament here:

As you can see: the 'tit for tat' strategy has not won in this instance, that is mainly because more strategies are needed to get anywhere near Axelrod's tournament.

You can see the results from the latest run of the tournament here with the cheating strategies (which manipulate/read what the opponent does):

Please do contribute :)

Note that you can run python run_tournament.py -h for further options available: for example, cheating strategies can be excluded for faster results by running:

$ python run_tournament.py --xc --xa

You can also run the tournament in parallel (below will run 4 parallel processes):

$ python run_tournament.py -p 4

You can run with all available CPUs with:

$ python run_tournament.py -p 0

martinjc put together a pretty awesome visualisation of this using d3. Hosted on gh-pages it can be seen here: drvinceknight.github.io/Axelrod.

There is currently a very sparse set of documentation up here: axelrod.readthedocs.org/.

To write/render the documenation locally, you will need sphinx:

$ pip install sphinx sphinx-autobuild

Once you have sphinx:

$ cd docs
$ make html

All contributions are welcome: with a particular emphasis on contributing further strategies.

You can find helpful instructions about contributing in the documentation: http://axelrod.readthedocs.org/en/latest/contributing.html.

• JasYoung314
• Karlos78
• drvinceknight
• geraintpalmer
• hollymarissa
• jomuel
• langner
• marcharper
• martinjc
• meatballs
• theref
• timothyf1
• uglyfruitcake
• pmslavin