README.md

ReversiAI

Brief Description

A Reversi game with an AI implementation that uses minimax with alphabeta pruning and different heuristics to play.

Made for the course TKT20010 at the University of Helsinki.

The project test coverage can be checked at the top of the readme where it says codecov

Key Features

• AI Opponent: Face off against an AI adversary with advanced decision-making capabilities.
• Comprehensive Testing: Thorough test coverage ensures robustness and reliability.
• Extensive Documentation: Detailed documentation provides insights into project specifications, implementation details, and gameplay instructions.

Documentation

• Project Specification: Details regarding project description, data sctructures, etc.
• Manual/Instructions: How to install and run the game, how to play Reversi/Othello and modify the difficulty.
• Testing: What is being tested, and how to replicate the tests.
• Implementation: How the project was implemented and other details.

Weekly Reports

Track the progress and development of the project through weekly reports:

• Hours Worked
• Week 1
• Week 2
• Week 3
• Week 4
• Week 5
• Week 6

Instructions

You can check a more detailed version in the Manual/Instructions.

1. Clone the repo and then access the directory

git clone https://github.com/LittleHaku/ReversiAI/

2. Install poetry, skip if you already have it

make install_poetry

or

curl -sSL https://install.python-poetry.org | python3 -

3. Install dependencies

make dependencies

4. Run the game

make play