blackjack-gui 0.3.0

A game of Blackjack with graphical user interface.

blackjack-gui

Single-player Blackjack including GUI and CLI interfaces. Can be used to simulate games (with simple card counting) and learn basic strategy.

Installation

blackjack-gui uses tkinter. Make sure it's installed in your system:

$ sudo apt install python3-tk

or similar. Otherwise, you get an error message like ModuleNotFoundError: No module named 'tkinter'.

After that:

$ python3 -m venv venv
$ source venv/bin/activate
$ pip3 install blackjack-gui

Usage

GUI version

blackjack [OPTION...]

CLI version

blackjack --gui=False [OPTION...]

Options

Name	Default	CLI only	Description
--stack	1000		Initial stack.
--bet	1		Initial bet size.
--n_games	10	x	Number of rounds to be played.
--ai	False	x	If True, computer plays instead of you.
--count	False	x	If True, ai uses card counting.
--loglevel	DEBUG	x	Adjust amount of logging: DEBUG or INFO.
--cards			Determine the first player cards, e.g. --cards=A,8,K. Shuffles the shoe after every hand.
--dealer_cards			Determine the first dealer cards. Useful for testing.

Examples

Open the GUI version:

$ blackjack

With the default settings, play 10 rounds of Blackjack without GUI:

$ blackjack --gui=False

Let the computer play perfect basic game and use card counting technique to bring down the house:

$ blackjack --n_games=100000 --ai=True --count=True --loglevel=INFO --gui=False

Simulate soft 19 starting hand only:

$ blackjack --n_games=10000 --ai=True --loglevel=INFO --gui=False --cards=A,8

Basic strategy chart

• Note that 16 vs 10 with 3 or more cards = Stay

Tests

Install blackjack-gui from GitHub and pytest:

$ git clone https://github.com/tukiains/blackjack-gui
$ cd blackjack-gui/
$ python3 -m venv venv
$ source venv/bin/activate
$ pip3 install .
$ pip3 install pytest

Run unit and integration tests:

$ pytest-3 tests/unit.py
$ pytest-3 tests/integration.py

Notes

• Uses 6 decs and shuffles after 5.
• Rules follow: https://casinohelsinki.fi/en/games/blackjack-eng/.
• Card images taken from here.

Licence

MIT