blackjack

A fully customizable blackjack simulation tool.

Installation

Clone the repository and install locally via pip.

pip install .

Getting Started

Setting up the Game

Create a Blackjack instance and configure the house rules to your liking.

from blackjack.blackjack import Blackjack

blackjack = Blackjack(
    min_bet=10,
    max_bet=500,
    s17=True,
    blackjack_payout=1.5,
    max_hands=4,
    double_down=True,
    double_after_split=False,
    resplit_aces=False,
    insurance=True,
    late_surrender=True,
    dealer_shows_hole_card=False
)

Creating Players

You can add different types of players to the game, each with unique behaviors and betting strategies.

Player

A Player uses basic strategy for every decision and always bets a fixed amount.

from blackjack.player import Player

player = Player(name='Player', bankroll=1000000, min_bet=10)

Card Counter

A CardCounter uses basic strategy in conjunction with a chosen card counting system. Bets vary based on the current running/true count.

from blackjack.card_counter import CardCounter
from blackjack.enums import CardCountingSystem

card_counter = CardCounter(
    name='Card Counter',
    bankroll=50000,
    min_bet=10,
    card_counting_system=CardCountingSystem.HI_LO,
    bet_ramp={
        1: 10,
        2: 20,
        3: 40,
        4: 80,
        5: 150
    },
    insurance=None
)

Back Counter

A BackCounter is similar to a CardCounter, but they may join the table when the running/true count is favorable or leave it when it becomes unfavorable.

from blackjack.back_counter import BackCounter
from blackjack.enums import CardCountingSystem

back_counter = BackCounter(
    name='Back Counter',
    bankroll=15000,
    min_bet=10,
    card_counting_system=CardCountingSystem.HI_LO,
    bet_ramp={
        1: 10,
        2: 20,
        3: 40,
        4: 80,
        5: 150
    },
    insurance=3,
    entry_point=2,
    exit_point=1
)

Adding Players to the Table

Player's are dealt cards in the order that they are added.

blackjack.add_player(player=player)
blackjack.add_player(player=card_counter)
blackjack.add_player(player=back_counter)

Simulation Mode

Simulate a large number of shoes:

blackjack.simulate(
    penetration=0.75,
    number_of_shoes=50000,
    shoe_size=8,
    seed=1,
    reset_bankroll=False,
    progress_bar=True
)

Although not included in this package, Python's built-in multiprocessing library can be utilized to significantly speed up the simulation process.

Viewing Results

After running, each player’s performance can be reviewed:

print(back_counter.stats.summary(string=True))

Example summary:

TOTAL ROUNDS PLAYED: 266,873
TOTAL HANDS PLAYED: 273,134
PLAYER HANDS WON: 117,328
PLAYER HANDS LOST: 132,183
PLAYER HANDS PUSHED: 23,623
PLAYER BLACKJACKS: 14,385
DEALER BLACKJACKS: 14,464
PLAYER DOUBLE DOWNS: 22,416
PLAYER SURRENDERS: 12,305
INSURANCE AMOUNT BET: $373,290.00
INSURANCE NET WINNINGS: -$118,760.00
AMOUNT BET: $14,216,900.00
NET WINNINGS: $146,990.00
TOTAL AMOUNT BET: $14,590,190.00
TOTAL NET WINNINGS: $28,230.00

If desired, the statistics at each count can be accessed as well.

back_counter.stats.stats