README.md

In systats/pokerena:

Pokerena ♣️ ♦️ ♠️ ♥️

A Poker engine for AI development in R.

Tutorial

This tutorial leads you to start point of poker AI development…

… But first install.

devtools::install_github("systats/pokerena")

There are two main ways to deploy a bot, as there are two ways for using the poker backend.

1. preregister functions in interactive R session
2. call a separate HTTP API endpoint from a job.

In general players just return a tibble with an action and amount of chips to bet.

player_call <- function(state_, ...){
  tibble(chips = state_$to_call, action = "call")
}

players <- rbind(
  tibble(name = "caller", fun = list(player_call)), # player 1
  tibble(name = "radnom", fun = list(player_random)), # player 2
  tibble(name = "potman", fun = list(player_api)), # player 2
  tibble(name = "folder", fun = list(player_fold)) # player 4
) %>% mutate(credit = 100, bb = 2)

g <- game$new(players, delay = 0)
g$run()

g$session %>% glimpse

## Rows: 4
## Columns: 25
## $ game_id  <chr> "1596882299934232064", "1596882299934232064", "1596882299934…
## $ time     <chr> "2020-08-08 12:24:59", "2020-08-08 12:24:59", "2020-08-08 12…
## $ name     <chr> "caller", "radnom", "potman", "folder"
## $ credit   <dbl> 88, 88, 100, 100
## $ bb       <dbl> 2, 2, 2, 2
## $ seat_id  <int> 1, 2, 3, 4
## $ position <int> 1, 2, 3, 4
## $ state    <dbl> 3, 3, 3, 3
## $ chips    <dbl> 0, 0, 0, 0
## $ to_call  <dbl> 0, 0, 12, 12
## $ s_stake  <dbl> 0, 0, 0, 0
## $ t_stake  <dbl> 12, 12, 0, 0
## $ pot      <dbl> 24, 24, 24, 24
## $ allin    <dbl> 0, 0, 0, 0
## $ folded   <dbl> 0, 1, 1, 1
## $ n_player <int> 4, 4, 4, 4
## $ n_in     <dbl> 1, 1, 1, 1
## $ hand     <chr> "QH 9C", "3C 5S", "KC 8H", "JC 2D"
## $ board    <chr> "QS 10H 4H 9S", "QS 10H 4H 9S", "QS 10H 4H 9S", "QS 10H 4H 9…
## $ runout   <chr> "QS 10H 4H 9S", "QS 10H 4H 9S", "QS 10H 4H 9S", "QS 10H 4H 9…
## $ main     <chr> "Two Pair", "Board Lead", "High Card", "Board Lead"
## $ winner   <dbl> 1, 0, 0, 0
## $ rank     <dbl> 1, 2, 2, 2
## $ ret      <dbl> 24, 0, 0, 0
## $ net      <dbl> 12, -12, 0, 0

g$events %>% glimpse

## Rows: 11
## Columns: 30
## $ game_id  <chr> "1596882299934232064", "1596882299934232064", "1596882299934…
## $ time     <chr> "2020-08-08 12:24:59", "2020-08-08 12:24:59", "2020-08-08 12…
## $ name     <chr> "caller", "radnom", "potman", "folder", "caller", "radnom", …
## $ credit   <dbl> 100, 100, 100, 100, 99, 98, 98, 88, 88, 88, 88
## $ bb       <dbl> 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2
## $ seat_id  <int> 1, 2, 3, 4, 1, 2, 1, 1, 2, 1, 2
## $ position <int> 1, 2, 3, 4, 1, 2, 1, 1, 2, 1, 2
## $ state    <dbl> 1, 1, 1, 1, 1, 1, 1, 2, 2, 3, 3
## $ chips    <dbl> 1, 2, 0, 0, 1, 10, 10, 0, 0, 0, 0
## $ to_call  <dbl> 2, 2, 2, 2, 1, 0, 10, 0, 0, 0, 0
## $ s_stake  <dbl> 0, 0, 0, 0, 1, 2, 2, 0, 0, 0, 0
## $ t_stake  <dbl> 0, 0, 0, 0, 1, 2, 2, 12, 12, 12, 12
## $ pot      <dbl> 0, 0, 3, 3, 3, 4, 14, 24, 24, 24, 24
## $ allin    <dbl> 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
## $ folded   <dbl> 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1
## $ n_player <int> 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4
## $ n_in     <dbl> 4, 4, 4, 3, 2, 2, 2, 2, 2, 2, 2
## $ hand     <chr> "", "", "KC 8H", "JC 2D", "QH 9C", "3C 5S", "QH 9C", "QH 9C"…
## $ board    <chr> "", "", "", "", "", "", "", "QS 10H 4H", "QS 10H 4H", "QS 10…
## $ action   <chr> "sb", "bb", "fold", "fold", "call", "raise", "call", "check"…
## $ stake    <dbl> 1, 2, 0, 0, 1, 10, 10, 0, 0, 0, 0
## $ t_stake_ <dbl> 1, 2, 0, 0, 2, 12, 12, 12, 12, 12, 12
## $ s_stake_ <dbl> 1, 2, 0, 0, 2, 12, 12, 0, 0, 0, 0
## $ credit_  <dbl> 99, 98, 100, 100, 98, 88, 88, 88, 88, 88, 88
## $ pot_     <dbl> 1, 2, 3, 3, 4, 14, 24, 24, 24, 24, 24
## $ runout   <chr> "QS 10H 4H 9S", "QS 10H 4H 9S", "QS 10H 4H 9S", "QS 10H 4H 9…
## $ winner   <dbl> 1, 0, 0, 0, 1, 0, 1, 1, 0, 1, 0
## $ rank     <dbl> 1, 2, 2, 2, 1, 2, 1, 1, 2, 1, 2
## $ ret      <dbl> 24, 0, 0, 0, 24, 0, 24, 24, 0, 24, 0
## $ net      <dbl> 12, -12, 0, 0, 12, -12, 12, 12, -12, 12, -12

Similarily a tournament can be set up.

config <- list(
  credit = 100, # inital stack size, if NULL assumes individual credits
  max_round = 50, # how many rounds at max should be played
  bb = 2, # inital big blind
  bb_rounds = 10, # increase blinds after x hands
  bb_slope = "linear" # how to increase blinds
)

tourn <- tournament$new(players, config)
tourn$run(T)

tourn$games %>% glimpse

## Rows: 45
## Columns: 4
## $ game_id <chr> "1596879102417853952", "1596879103175256064", "15968791053602…
## $ result  <list> [<tbl_df[4 x 7]>, <tbl_df[4 x 7]>, <tbl_df[4 x 7]>, <tbl_df[…
## $ events  <list> [<tbl_df[6 x 30]>, <tbl_df[13 x 30]>, <tbl_df[12 x 30]>, <tb…
## $ log     <list> [<tbl_df[0 x 0]>, <tbl_df[0 x 0]>, <tbl_df[0 x 0]>, <tbl_df[…

tourn$games %>% 
  transmute(id = 1:n(), result) %>% 
  unnest("result") %>% 
  distinct(id, bb) %>% 
  ggplot(aes(id, bb)) +
  geom_line()

credit <- tourn$games %>% 
  transmute(id = 1:n(), result) %>% 
  unnest("result") %>% 
  ggplot(aes(id, credit, colour = name)) + 
  geom_line() +
  scale_colour_viridis_d()

net <- tourn$games %>% 
  transmute(id = 1:n(), result) %>% 
  unnest("result") %>% 
  ggplot(aes(id, net, fill = name)) + 
  geom_col(postion = ggplot2::position_dodge(), alpha = .7, show.legend = F) +
  scale_fill_viridis_d()

gridExtra::grid.arrange(net, credit, ncol = 2)

ranges <- tourn$games %>% 
  transmute(id = 1:n(), events) %>% 
  unnest("events") %>% 
  filter(hand != "" & action != "fold") %>% 
  distinct(game_id, name, hand) %>%
  mutate(hand = hand %>% stringr::str_replace_all("10", "T")) %>% 
  tidyr::separate(hand, into = c("card1", "card2"), sep = "\\s+") %>% 
  left_join(pockets_both()) %>% 
  count(name, value1, value2)

ranges %>% 
  ggplot(aes(value1, value2, fill = n)) +
  geom_tile(alpha = .7) +
  scale_fill_viridis_c() +
  facet_wrap(~name) #, scales = "free_y" 

library(tidygraph)
library(ggraph)

pay_network <- tourn$games %>% 
  transmute(id = 1:n(), result) %>% 
  unnest("result") %>% 
  group_by(id) %>% 
  mutate(winner_name  = ifelse(winner == 1, name, NA)) %>% 
  fill(winner_name, .direction = "updown") %>% 
  ungroup() %>% 
  group_by(name, winner_name) %>% 
  summarise(net = sum(net)) %>% 
  as_tbl_graph()

pay_network %>% 
  ggraph(layout = 'linear') + #, circular = TRUE
  geom_edge_arc0(aes(colour = net), arrow = arrow(length = unit(4, 'mm')), width = 1, alpha = .8) +
  #scale_edge_alpha('Pay direction', guide = 'edge_direction') + 
  scale_edge_color_viridis(direction = -1) +
  geom_node_text(aes(label = name))

Main Dependencies

• Poker: generic R poker hand evaluator
• tidyvrse: everything else
• R6: class management
• plumber: serving a local poker server

Unit Testing

testthat::test_package("pokerena")

## ══ testthat results  ══════════════════════════════════════════
## [ OK: 18 | SKIPPED: 0 | WARNINGS: 0 | FAILED: 0 ]

Roadmap

Engine

• [x] poker hand evaluation
• [x] support going allin
• [x] multiple split and side pots
• [x] tournament flow
• [ ] log messages for debugging
• [ ] unit tests for more situations
• [ ] improved cli output
• [ ] support replay for (MC) simulations

AI

• [ ] RL script with replay buffer
• [ ] control flow for multiplayer self-play
• [ ] tree search and pruning

Analytics

• [ ] Leaderboard
• [ ] HUD

systats/pokerena documentation built on Sept. 17, 2020, 2:35 p.m.