Schnapsen platform - Project Intelligent Systems 2022-2023

Getting started

This is the improved platform for the schnapsen card game. To get to know the concept of the game, please visit this web page.

To use the platform, your python version must be at least 3.9, we suggest installing conda an using an environment.

To get started, install the schnapsen package and itse dependencies in editable mode by running:

pip install -e .

To run the tests, run:

pip install -e '.[test]'  # on Linux / MacOS
pip install -e ".[test]"  # on Windows
pytest ./tests

If the above fails, try deactivating your environment and activating it again. Then retry installing the dependencies.

Opening the executables folder

The executables folder contains the cli.py and server.py files (among others). In order to run commands for cli.py and server.py without having to type 'executables/' before the file names, run:

cd executables

Running the CLI

After installing, you can try the provided command line interface examples. Most examples are bots playing against each other; read the code for details.

To run the CLI, run:

python cli.py

This will list the available commands.

For example, if you want try a RandBot play against another RandBot, type python executables/cli.py random-game.

Running the GUI

The graphical user interface (GUI) lets you play visually against a bot (e.g., You vs. RandBot).

To start a single game in the GUI, run:

python server.py single -b [INSERT OPPONENT_BOT_NAME]

Replace [INSERT OPPONENT_BOT_NAME] with the bot you want to play a single game against (e.g. MLPlayingBot).

Now, open your web browser and type in the server address (i.e., http://127.0.0.1:8080). By default, you are playing against OkiBot. You can also play against other bots.

To start a loop of 30 games in the GUI, run:

python server.py multiple [INSERT HUMAN_PLAYER_NAME]

Replace [INSERT HUMAN_PLAYER_NAME] with the name of the human player that will play 15 games each against ml_bot and okibot (e.g. Leen).

For more details, run:

python server.py --help

python server.py single --help

python server.py multiple --help

Implementing more bots

You will find bot examples in the src/schnapsen/bots folder. You can look at the example_bot.py file for various methods provided to your bot.

Troubleshooting

Getting the right python

The first hurdle in getting the platform to run is getting the right python version on your system. An easy way to get that is using virtual environments. We suggest you install conda to manage them. Then, you can use conda to create a new environment by running

conda create --name project_is python=3.10

With this environment created, you can start it

conda activate project_is

Inside this environment you can install the dependencies as instructed above.

Run the right python

If you install conda and create an environment, you can run python by just running the python command. However, often your system also provides a python version. To know which python is running, use

which python    # on linux
where python    # on windows (untested)

Now, you want to look at the output and make sure that this executable is inside the anaconda folder and not where your system stores its executables.

Documentation

The code is documented using reStructuredText. You can either read the documentation along the code, or generate a more suer friendly version. A pregenerated version of the documentation can be found int he doc folder. It can be regenerated by runnign the following in the root of the repository.

pip install pdoc
pdoc --html src/schnapsen executables/ -o doc/