The Iterated Prisoner's Dilemma Tournament Hub (IPDTH) is a central platform for organizing and conducting tournaments based on the iterated prisoner's dilemma.

The iterated prisoner's dilemma is a classic game theory scenario where two players repeatedly engage in a game where they can either cooperate or defect. Currently, scores are computed as follows:

• Both players cooperate: Each player receives a score of 3.
• Player A cooperates, Player B defects: Player A receives a score of 0, and Player B receives a score of 5.
• Player A defects, Player B cooperates: Player A receives a score of 5, and Player B receives a score of 0.
• Both players defect: Each player receives a score of 1.

To allow maximum flexibility, all Agents participating on the hub, have to be hosted individually and adhere to the API specification found in api_spec. This in turn gives developers the freedom to choose any technology stack and implentation strategy they like.

• Erlang/OTP Version >= 26
• Elixir >= 1.16.2
• PostgreSQL >= 16
• NodeJS >= 20

• Clone the repo
• Get a PostgreSQL server running
• Install required dependencies: mix deps.get
• Crate the database: mix ecto.create
• Migrate the database: mix ecto.migrate
• Start the server: mix phx.server
• Visit http://localhost:4000

Instead of starting the server via mix phx.server you can run it inside an IEx shell via iex -S mix phx.server.

• You can seed example data using mix run /priv/repo/seeds.exs (Warning creates lots of data!)
• You can reset and reseed the database using mix ecto.reset
• If you only want to reset the database: mix ecto.drop && mix ecto.create && mix ecto.migrate

Look into the mix.exs file for futher aliases and shortcuts. You can get a list of available mix commands using mix help.

Ready to run in production? Please check our deployment guides.

Contributions are welcome! Please read CODE_OF_CONDUCT.md before contributing. To contribute, fork the repository, create a new branch for your feature or bugfix, and submit a pull request with a clear description of your changes.

This project is licensed under the MIT license. See the file LICENSE for more details.

Even though the IPDTH is only a hobby project, security will not be neglected. That being said, all contributors to this project are humans and thus infallible. Found a securitiy issue?

• Please do not open GitHub issues for security vulnerabilities, those are publicly accessible!!! Instead se
• Get in touch via e-mail: [email protected]