AI Board Games Engines

This repository contains implementations of AI algorithms for several popular board games. The project was developed as part of an AI reasoning course and showcases various AI techniques applied to these games.

Table of Contents

• About the Project
• Games Included
• Installation
• Usage
• Contributing
• License
• Contact

About the Project

This project demonstrates the application of AI algorithms in the domain of board games. The primary goal was to create engines that can play these games with a certain level of intelligence, leveraging strategies such as Minimax, Alpha-Beta Pruning, and more.

Games Included

1. Clobber

• Notebook: Clobber_algorithm.ipynb
• Description: Clobber is a two-player abstract strategy game where the goal is to capture the opponent's pieces. The AI implemented here aims to play optimally using strategic evaluations.

2. Connect4

• Notebook: Connect4_algorithm.ipynb
• Description: Connect4 is a two-player connection game in which the players first choose a color and then take turns dropping colored discs into a grid. The AI implemented uses various algorithms to decide the best moves.

3. Gin Rummy

• Notebook: Gin_Rummy_Final.ipynb
• Description: Gin Rummy is a popular two-player card game. The AI implemented here seeks to minimize the score difference with the opponent through optimal card selection and discard strategies.

Installation

1. Clone the repository:

   git clone https://github.com/your_username/AI-Board-Games-Engines.git

2. Navigate to the project directory:

   cd AI-Board-Games-Engines

3. Install the necessary dependencies. It is recommended to use a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`
   pip install -r requirements.txt

Usage

Each game has its own Jupyter Notebook, where you can run the AI algorithms and observe their performance. To get started, simply open the desired notebook and follow the instructions provided within.

jupyter notebook

Navigate to the respective game folder and open the notebook to start experimenting with the AI engines.

Contributing

Contributions are welcome! If you have improvements or additional features in mind, feel free to fork this repository, make your changes, and submit a pull request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Juan Rubiales - jrubialesv@gmail.com

Project Link: https://github.com/jrubialesv/AI-Board-Games-Engines