PokerKit, hands-on

python3 --version            # must say 3.11 or higher
mkdir pokerkit-lab && cd pokerkit-lab
python3 -m venv .venv
source .venv/bin/activate    # Windows: .venv\Scripts\activate
pip install pokerkit
python -c "import pokerkit; print('ready')"

from pokerkit import StandardHighHand

mine  = StandardHighHand.from_game('AsKs', 'QsJsTs2c3d')
yours = StandardHighHand.from_game('AhAd', 'QsJsTs2c3d')

print(mine)          # the best 5 cards it found
print(yours)
print(mine > yours)  # compare like numbers

from pokerkit import Automation, NoLimitTexasHoldem

state = NoLimitTexasHoldem.create_state(
    (
        Automation.ANTE_POSTING,
        Automation.BET_COLLECTION,
        Automation.BLIND_OR_STRADDLE_POSTING,
        Automation.CARD_BURNING,
        Automation.HOLE_CARDS_SHOWING_OR_MUCKING,
        Automation.HAND_KILLING,
        Automation.CHIPS_PUSHING,
        Automation.CHIPS_PULLING,
    ),
    True,     # uniform antes?
    0,        # antes
    (1, 2),   # blinds
    2,        # min-bet
    200,      # every stack = 200
    2,        # players
)

state.deal_hole('AsKs')   # player 0
state.deal_hole('7h7d')   # player 1
print('stacks  :', state.stacks)
print('to act  :', state.actor_index)

state.complete_bet_or_raise_to(6)   # player 1 raises TO 6
state.check_or_call()               # player 0 calls
state.deal_board('Qs Js 2c')        # flop

state.check_or_call()               # player 0 checks
state.complete_bet_or_raise_to(8)   # player 1 bets 8
state.fold()                        # player 0 folds

print('running?:', state.status)
print('stacks  :', state.stacks)
print('payoffs :', state.payoffs)

from pokerkit import Automation, NoLimitTexasHoldem

state = NoLimitTexasHoldem.create_state(
    (Automation.ANTE_POSTING, Automation.BET_COLLECTION,
     Automation.BLIND_OR_STRADDLE_POSTING, Automation.CARD_BURNING,
     Automation.HOLE_DEALING, Automation.BOARD_DEALING,
     Automation.HOLE_CARDS_SHOWING_OR_MUCKING, Automation.HAND_KILLING,
     Automation.CHIPS_PUSHING, Automation.CHIPS_PULLING),
    True, 0, (1, 2), 2, 200, 2,
)

print(state.can_complete_bet_or_raise_to(3))
print(state.min_completion_betting_or_raising_to_amount)
try:
    state.complete_bet_or_raise_to(3)
except ValueError as e:
    print('ValueError:', e)
print(state.stacks)

from pokerkit import (
    Card, Deck, StandardHighHand, calculate_equities, parse_range,
)

print(len(parse_range('AKs')), 'combos of AKs')
print(len(parse_range('AK')),  'combos of AK')
print(len(parse_range('22')),  'combos of 22')

eq = calculate_equities(
    (parse_range('AsKs'), parse_range('7h7d')),  # the two hands
    Card.parse('QsJs2c'),                        # board so far
    2,                    # hole cards per player
    5,                    # board cards at the end
    Deck.STANDARD,
    (StandardHighHand,),
    sample_count=20000,
)
print('AsKs vs 7h7d on QsJs2c:', eq)

import random
from pokerkit import Automation, NoLimitTexasHoldem

AUTO = (
    Automation.ANTE_POSTING, Automation.BET_COLLECTION,
    Automation.BLIND_OR_STRADDLE_POSTING, Automation.CARD_BURNING,
    Automation.HOLE_DEALING, Automation.BOARD_DEALING,
    Automation.RUNOUT_COUNT_SELECTION,
    Automation.HOLE_CARDS_SHOWING_OR_MUCKING, Automation.HAND_KILLING,
    Automation.CHIPS_PUSHING, Automation.CHIPS_PULLING,
)
game = NoLimitTexasHoldem(AUTO, True, 0, (1, 2), 2)   # a factory

def random_bot(state):
    choices = []
    if state.can_fold():
        choices.append('fold')
    if state.can_check_or_call():
        choices.append('call')
    if state.can_complete_bet_or_raise_to():
        choices.append('raise')
    pick = random.choice(choices)
    if pick == 'fold':
        state.fold()
    elif pick == 'call':
        state.check_or_call()
    else:
        lo = state.min_completion_betting_or_raising_to_amount
        hi = state.max_completion_betting_or_raising_to_amount
        state.complete_bet_or_raise_to(random.randint(lo, hi))

random.seed(1)
totals = [0, 0, 0]
for _ in range(1000):
    state = game(100, 3)            # fresh hand: 3 players, 100 chips
    while state.status:
        random_bot(state)
    assert sum(state.payoffs) == 0
    totals = [t + p for t, p in zip(totals, state.payoffs)]

print('net chips after 1000 hands:', totals)
print('sum:', sum(totals))

from pokerkit import Automation, KuhnPoker

state = KuhnPoker.create_state(
    (
        Automation.ANTE_POSTING, Automation.BET_COLLECTION,
        Automation.BLIND_OR_STRADDLE_POSTING, Automation.CARD_BURNING,
        Automation.HOLE_CARDS_SHOWING_OR_MUCKING, Automation.HAND_KILLING,
        Automation.CHIPS_PUSHING, Automation.CHIPS_PULLING,
    ),
)
state.deal_hole('Js')     # player 0 gets the Jack
state.deal_hole('Ks')     # player 1 gets the King

state.complete_bet_or_raise_to()   # P0 bluffs with J
state.check_or_call()              # P1 calls with K

print('payoffs:', state.payoffs)

from pokerkit import Automation, HandHistory, NoLimitTexasHoldem

game = NoLimitTexasHoldem(
    (Automation.ANTE_POSTING, Automation.BET_COLLECTION,
     Automation.BLIND_OR_STRADDLE_POSTING, Automation.CARD_BURNING,
     Automation.HOLE_CARDS_SHOWING_OR_MUCKING, Automation.HAND_KILLING,
     Automation.CHIPS_PUSHING, Automation.CHIPS_PULLING),
    True, 0, (1, 2), 2,
)
state = game(200, 2)
state.deal_hole('AsKs')
state.deal_hole('7h7d')
state.complete_bet_or_raise_to(6)
state.check_or_call()
state.deal_board('QsJs2c')
state.check_or_call()
state.complete_bet_or_raise_to(8)
state.fold()

hh = HandHistory.from_game_state(game, state)
hh.players = ['Nut', 'Bot']
with open('my_hand.phh', 'wb') as f:
    hh.dump(f)
print(open('my_hand.phh').read())

with open('my_hand.phh', 'rb') as f:
    replay = HandHistory.load(f)
for i, s in enumerate(replay):   # one state per action
    print(i, s.stacks)