========
PokerKit
========
PokerKit is an open-source software library, written in pure Python, for simulating games, evaluating hands, and facilitating statistical analysis, developed by the University of Toronto Computer Poker Student Research Group. PokerKit supports an extensive array of poker variants and it provides a flexible architecture for users to define their custom games. These facilities are exposed via an intuitive unified high-level programmatic API. The library can be used in a variety of use cases, from poker AI development, and tool creation, to online poker casino implementation. PokerKit's reliability has been established through static type checking, extensive doctests, and unit tests, achieving 99% code coverage.
Features
--------
* Extensive poker game logic for major and minor poker variants.
* High-speed hand evaluations.
* Customizable game states and parameters.
* Robust implementation with static type checking and extensive unit tests and doctests.
Installation
------------
The PokerKit library requires Python Version 3.11 or above and can be installed using pip:
.. code-block:: bash
pip install pokerkit
Usages
------
Example usages of PokerKit is shown below.
Multi-Runout in an All-In Situation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Below shows the 4-runout hand between Phil Hellmuth and the Loose Cannon Ernest Wiggins.
Link: https://youtu.be/cnjJv7x0HMY?si=4l05Ez7lQVczt8DI&t=638
Note that the starting stacks for some players are set to be ``math.inf`` as they are not mentioned.
.. code-block:: python
from math import inf
from pokerkit import Automation, Mode, NoLimitTexasHoldem
state = NoLimitTexasHoldem.create_state(
# Automations
(
Automation.ANTE_POSTING,
Automation.BET_COLLECTION,
Automation.BLIND_OR_STRADDLE_POSTING,
Automation.HOLE_CARDS_SHOWING_OR_MUCKING,
Automation.HAND_KILLING,
Automation.CHIPS_PUSHING,
Automation.CHIPS_PULLING,
),
False, # Uniform antes?
{-1: 600}, # Antes
(200, 400, 800), # Blinds or straddles
400, # Min-bet
(inf, 116400, 86900, inf, 50000, inf), # Starting stacks
6, # Number of players
mode=Mode.CASH_GAME,
)
Below are the pre-flop dealings and actions.
.. code-block:: python
state.deal_hole('JsTh') # Tony G
state.deal_hole('Ah9d') # Hellmuth
state.deal_hole('KsKc') # Wiggins
state.deal_hole('5c2h') # Negreanu
state.deal_hole('6h5h') # Brunson
state.deal_hole('6s3s') # Laak
state.fold() # Negreanu
state.complete_bet_or_raise_to(2800) # Brunson
state.fold() # Laak
state.check_or_call() # Tony G
state.complete_bet_or_raise_to(12600) # Hellmuth
state.check_or_call() # Wiggins
state.check_or_call() # Brunson
state.check_or_call() # Tony G
Below are the flop dealing and actions.
.. code-block:: python
state.burn_card('??')
state.deal_board('9hTs9s')
state.check_or_call() # Tony G
state.complete_bet_or_raise_to(17000) # Hellmuth
state.complete_bet_or_raise_to(36000) # Wiggins
state.fold() # Brunson
state.fold() # Tony G
state.complete_bet_or_raise_to(103800) # Hellmuth
state.check_or_call() # Wiggins
Below is selecting the number of runouts.
.. code-block:: python
state.select_runout_count(4) # Hellmuth
state.select_runout_count(None) # Wiggins
Below is the first runout.
.. code-block:: python
state.burn_card('??')
state.deal_board('Jh') # Turn
state.burn_card('??')
state.deal_board('Ad') # River
Below is the second runout.
.. code-block:: python
state.burn_card('??')
state.deal_board('Kh') # Turn
state.burn_card('??')
state.deal_board('3c') # River
Below is the third runout.
.. code-block:: python
state.burn_card('??')
state.deal_board('7s') # Turn
state.burn_card('??')
state.deal_board('8s') # River
Below is the fourth runout.
.. code-block:: python
state.burn_card('??')
state.deal_board('Qc') # Turn
state.burn_card('??')
state.deal_board('Kd') # River
Below are the final stacks.
.. code-block:: python
print(state.stacks) # [inf, 79400, 149700, inf, 37400, inf]
A Sample No-Limit Texas Hold'em Hand
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Below shows the first televised million-dollar pot between Tom Dwan and Phil Ivey.
Link: https://youtu.be/GnxFohpljqM
Note that the starting stack of Patrik Antonius is set to be ``math.inf`` as it is not mentioned.
.. code-block:: python
from math import inf
from pokerkit import Automation, NoLimitTexasHoldem
state = NoLimitTexasHoldem.create_state(
# Automations
(
Automation.ANTE_POSTING,
Automation.BET_COLLECTION,
Automation.BLIND_OR_STRADDLE_POSTING,
Automation.HOLE_CARDS_SHOWING_OR_MUCKING,
Automation.HAND_KILLING,
Automation.CHIPS_PUSHING,
Automation.CHIPS_PULLING,
),
True, # Uniform antes?
500, # Antes
(1000, 2000), # Blinds or straddles
2000, # Min-bet
(1125600, inf, 553500), # Starting stacks
3, # Number of players
)
Below are the pre-flop dealings and actions.
.. code-block:: python
state.deal_hole('Ac2d') # Ivey
state.deal_hole('????') # Antonius
state.deal_hole('7h6h') # Dwan
state.complete_bet_or_raise_to(7000) # Dwan
state.complete_bet_or_raise_to(23000) # Ivey
state.fold() # Antonius
state.check_or_call() # Dwan
Below are the flop dealing and actions.
.. code-block:: python
state.burn_card('??')
state.deal_board('Jc3d5c')
state.complete_bet_or_raise_to(35000) # Ivey
state.check_or_call() # Dwan
Below are the turn dealing and actions.
.. code-block:: python
state.burn_card('??')
state.deal_board('4h')
state.complete_bet_or_raise_to(90000) # Ivey
state.complete_bet_or_raise_to(232600) # Dwan
state.complete_bet_or_raise_to(1067100) # Ivey
state.check_or_call() # Dwan
Below is the river dealing.
.. code-block:: python
state.burn_card('??')
state.deal_board('Jh')
Below are the final stacks.
.. code-block:: python
print(state.stacks) # [572100, inf, 1109500]
A Sample Short-Deck Hold'em Hand
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Below shows an all-in hand between Xuan and Phua.
Link: https://youtu.be/QlgCcphLjaQ
.. code-block:: python
from pokerkit import Automation, NoLimitShortDeckHoldem
state = NoLimitShortDeckHoldem.create_state(
# Automations
(
Automation.ANTE_POSTING,
Automation.BET_COLLECTION,
Automation.BLIND_OR_STRADDLE_POSTING,
Automation.HOLE_CARDS_SHOWING_OR_MUCKING,
Automation.HAND_KILLING,
Automation.CHIPS_PUSHING,
Automation.CHIPS_PULLING,
),
True, # Uniform antes?
3000, # Antes
{-1: 3000}, # Blinds or straddles
3000, # Min-bet
(495000, 232000, 362000, 403000, 301000, 204000), # Starting stacks
6, # Number of players
)
Below are the pre-flop dealings and actions.
.. code-block:: python
state.deal_hole('Th8h') # Badziakouski
state.deal_hole('QsJd') # Zhong
state.deal_hole('QhQd') # Xuan
state.deal_hole('8d7c') # Jun
state.deal_hole('KhKs') # Phua
state.deal_hole('8c7h') # Koon
state.check_or_call() # Badziakouski
state.check_or_call() # Zhong
state.complete_bet_or_raise_to(35000) # Xuan
state.fold() # Jun
state.complete_bet_or_raise_to(298000) # Phua
state.fold() # Koon
state.fold() # Badziakouski
state.fold() # Zhong
state.check_or_call() # Xuan
Below is the flop dealing.
.. code-block:: python
state.burn_card('??')
state.deal_board('9h6cKc')
Below is the turn dealing.
.. code-block:: python
state.burn_card('??')
state.deal_board('Jh')
Below is the river dealing.
.. code-block:: python
state.burn_card('??')
state.deal_board('Ts')
Below are the final stacks.
.. code-block:: python
print(state.stacks) # [489000, 226000, 684000, 400000, 0, 198000]
A Sample Pot-Limit Omaha Hold'em Hand
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Below shows the largest online poker pot ever played between Patrik Antonius and Viktor Blom.
Link: https://youtu.be/UMBm66Id2AA
.. code-block:: python
from pokerkit import Automation, PotLimitOmahaHoldem
state = PotLimitOmahaHoldem.create_state(
# Automations
(
Automation.ANTE_POSTING,
Automation.BET_COLLECTION,
Automation.BLIND_OR_STRADDLE_POSTING,
Automation.HOLE_CARDS_SHOWING_OR_MUCKING,
Automation.HAND_KILLING,
Automation.CHIPS_PUSHING,
Automation.CHIPS_PULLING,
),
True, # Uniform antes?
0, # Antes
(500, 1000), # Blinds or straddles
1000, # Min-bet
(1259450.25, 678473.5), # Starting stacks
2, # Number of players
)
Below are the pre-flop dealings and actions.
.. code-block:: python
state.deal_hole('Ah3sKsKh') # Antonius
state.deal_hole('6d9s7d8h') # Blom
state.complete_bet_or_raise_to(3000) # Blom
state.complete_bet_or_raise_to(9000) # Antonius
state.complete_bet_or_raise_to(27000) # Blom
state.complete_bet_or_raise_to(81000) # Antonius
state.check_or_call() # Blom
Below are the flop dealing and actions.
.. code-block:: python
state.burn_card('??')
state.deal_board('4s5c2h')
state.complete_bet_or_raise_to(91000) # Antonius
state.complete_bet_or_raise_to(435000) # Blom
state.complete_bet_or_raise_to(779000) # Antonius
state.check_or_call() # Blom
Below is the turn dealing.
.. code-block:: python
state.burn_card('??')
state.deal_board('5h')
Below is the river dealing.
.. code-block:: python
state.burn_card('??')
state.deal_board('9c')
Below are the final stacks.
.. code-block:: python
print(state.stacks) # [1937923.75, 0.0]
A Sample Fixed-Limit Deuce-To-Seven Lowball Triple Draw Hand
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Below shows a bad beat between Yockey and Arieh.
Link: https://youtu.be/pChCqb2FNxY
.. code-block:: python
from pokerkit import Automation, FixedLimitDeuceToSevenLowballTripleDraw
state = FixedLimitDeuceToSevenLowballTripleDraw.create_state(
# Automations
(
Automation.ANTE_POSTING,
Automation.BET_COLLECTION,
Automation.BLIND_OR_STRADDLE_POSTING,
Automation.HOLE_CARDS_SHOWING_OR_MUCKING,
Automation.HAND_KILLING,
Automation.CHIPS_PUSHING,
Automation.CHIPS_PULLING,
),
True, # Uniform antes?
0, # Antes
(75000, 150000), # Blinds or straddles
150000, # Small-bet
300000, # Big-bet
(1180000, 4340000, 5910000, 10765000), # Starting stacks
4, # Number of players
)
Below are the pre-flop dealings and actions.
.. code-block:: python
state.deal_hole('7h6c4c3d2c') # Yockey
state.deal_hole('??????????') # Hui
state.deal_hole('??????????') # Esposito
state.deal_hole('AsQs6s5c3c') # Arieh
state.fold() # Esposito
state.complete_bet_or_raise_to() # Arieh
state.complete_bet_or_raise_to() # Yockey
state.fold() # Hui
state.check_or_call() # Arieh
Below are the first draw and actions.
.. code-block:: python
state.stand_pat_or_discard() # Yockey
state.stand_pat_or_discard('AsQs') # Arieh
state.burn_card('??')
state.deal_hole('2hQh') # Arieh
state.complete_bet_or_raise_to() # Yockey
state.check_or_call() # Arieh
Below are the second draw and actions.
.. code-block:: python
state.stand_pat_or_discard() # Yockey
state.stand_pat_or_discard('Qh') # Arieh
state.burn_card('??')
state.deal_hole('4d') # Arieh
state.complete_bet_or_raise_to() # Yockey
state.check_or_call() # Arieh
Below are the third draw and actions.
.. code-block:: python
state.stand_pat_or_discard() # Yockey
state.stand_pat_or_discard('6s') # Arieh
state.burn_card('??')
state.deal_hole('7c') # Arieh
state.complete_bet_or_raise_to() # Yockey
state.check_or_call() # Arieh
Below are the final stacks.
.. code-block:: python
print(state.stacks) # [0, 4190000, 5910000, 12095000]
A Sample Badugi Hand
^^^^^^^^^^^^^^^^^^^^
Below shows an example badugi hand from Wikipedia.
Link: https://en.wikipedia.org/wiki/Badugi
Note that the starting stacks are set to be ``math.inf`` as they are not mentioned.
.. code-block:: python
from math import inf
from pokerkit import Automation, FixedLimitBadugi
state = FixedLimitBadugi.create_state(
# Automations
(
Automation.ANTE_POSTING,
Automation.BET_COLLECTION,
Automation.BLIND_OR_STRADDLE_POSTING,
Automation.HAND_KILLING,
Automation.CHIPS_PUSHING,
Automation.CHIPS_PULLING,
),
True, # Uniform antes?
0, # Antes
(1, 2), # Blinds or straddles
2, # Small-bet
4, # Big-bet
inf, # Starting stacks
4, # Number of players
)
Below are the pre-flop dealings and actions.
.. code-block:: python
state.deal_hole('????????') # Bob
state.deal_hole('????????') # Carol
state.deal_hole('????????') # Ted
state.deal_hole('????????') # Alice
state.fold() # Ted
state.check_or_call() # Alice
state.check_or_call() # Bob
state.check_or_call() # Carol
Below are the first draw and actions.
.. code-block:: python
state.stand_pat_or_discard('????') # Bob
state.stand_pat_or_discard('????') # Carol
state.stand_pat_or_discard('??') # Alice
state.burn_card('??')
state.deal_hole('????') # Bob
state.deal_hole('????') # Carol
state.deal_hole('??') # Alice
state.check_or_call() # Bob
state.complete_bet_or_raise_to() # Carol
state.check_or_call() # Alice
state.check_or_call() # Bob
Below are the second draw and actions.
.. code-block:: python
state.stand_pat_or_discard('??') # Bob
state.stand_pat_or_discard() # Carol
state.stand_pat_or_discard('??') # Alice
state.burn_card('??')
state.deal_hole('??') # Bob
state.deal_hole('??') # Alice
state.check_or_call() # Bob
state.complete_bet_or_raise_to() # Carol
state.complete_bet_or_raise_to() # Alice
state.fold() # Bob
state.check_or_call() # Carol
Below are the third draw and actions.
.. code-block:: python
state.stand_pat_or_discard('??') # Carol
state.stand_pat_or_discard() # Alice
state.burn_card('??')
state.deal_hole('??') # Carol
state.check_or_call() # Carol
state.complete_bet_or_raise_to() # Alice
state.check_or_call() # Carol
Below is the showdown.
.. code-block:: python
state.show_or_muck_hole_cards('2s4c6d9h') # Alice
state.show_or_muck_hole_cards('3s5d7c8h') # Carol
Below are the final stacks.
.. code-block:: python
print(state.stacks) # [inf, inf, inf, inf]
print(state.payoffs) # [-4, 20, 0, -16]
Testing and Validation
----------------------
PokerKit has extensive test coverage, passes mypy static type checking with strict mode, and has been validated through extensive use in real-life scenarios.
Contributing
------------
Contributions are welcome! Please read our Contributing Guide for more information.
License
-------
PokerKit is distributed under the MIT license.
Citing
------
If you use PokerKit in your research, please cite our library:
.. code-block:: bibtex
@ARTICLE{10287546,
author={Kim, Juho},
journal={IEEE Transactions on Games},
title={PokerKit: A Comprehensive Python Library for Fine-Grained Multi-Variant Poker Game Simulations},
year={2023},
volume={},
number={},
pages={1-8},
doi={10.1109/TG.2023.3325637}}
Raw data
{
"_id": null,
"home_page": "https://github.com/uoftcprg/pokerkit",
"name": "pokerkit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "artificial-intelligence, deep-learning, game, game-development, game-theory, holdem-poker, imperfect-information-game, libratus, pluribus, poker, poker-engine, poker-evaluator, poker-game, poker-hands, poker-library, poker-strategies, python, reinforcement-learning, texas-holdem",
"author": "University of Toronto Computer Poker Student Research Group",
"author_email": "uoftcprg@studentorg.utoronto.ca",
"download_url": "https://files.pythonhosted.org/packages/bf/8a/64a13a389e0c9363f83935b34dce66521d85f9cb34f922c52370e9a17519/pokerkit-0.5.4.tar.gz",
"platform": null,
"description": "========\nPokerKit\n========\n\nPokerKit is an open-source software library, written in pure Python, for simulating games, evaluating hands, and facilitating statistical analysis, developed by the University of Toronto Computer Poker Student Research Group. PokerKit supports an extensive array of poker variants and it provides a flexible architecture for users to define their custom games. These facilities are exposed via an intuitive unified high-level programmatic API. The library can be used in a variety of use cases, from poker AI development, and tool creation, to online poker casino implementation. PokerKit's reliability has been established through static type checking, extensive doctests, and unit tests, achieving 99% code coverage.\n\nFeatures\n--------\n\n* Extensive poker game logic for major and minor poker variants.\n* High-speed hand evaluations.\n* Customizable game states and parameters.\n* Robust implementation with static type checking and extensive unit tests and doctests.\n\nInstallation\n------------\n\nThe PokerKit library requires Python Version 3.11 or above and can be installed using pip:\n\n.. code-block:: bash\n\n pip install pokerkit\n\nUsages\n------\n\nExample usages of PokerKit is shown below.\n\nMulti-Runout in an All-In Situation\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nBelow shows the 4-runout hand between Phil Hellmuth and the Loose Cannon Ernest Wiggins.\n\nLink: https://youtu.be/cnjJv7x0HMY?si=4l05Ez7lQVczt8DI&t=638\n\nNote that the starting stacks for some players are set to be ``math.inf`` as they are not mentioned.\n\n.. code-block:: python\n\n from math import inf\n\n from pokerkit import Automation, Mode, NoLimitTexasHoldem\n\n state = NoLimitTexasHoldem.create_state(\n # Automations\n (\n Automation.ANTE_POSTING,\n Automation.BET_COLLECTION,\n Automation.BLIND_OR_STRADDLE_POSTING,\n Automation.HOLE_CARDS_SHOWING_OR_MUCKING,\n Automation.HAND_KILLING,\n Automation.CHIPS_PUSHING,\n Automation.CHIPS_PULLING,\n ),\n False, # Uniform antes?\n {-1: 600}, # Antes\n (200, 400, 800), # Blinds or straddles\n 400, # Min-bet\n (inf, 116400, 86900, inf, 50000, inf), # Starting stacks\n 6, # Number of players\n mode=Mode.CASH_GAME,\n )\n\nBelow are the pre-flop dealings and actions.\n\n.. code-block:: python\n\n state.deal_hole('JsTh') # Tony G\n state.deal_hole('Ah9d') # Hellmuth\n state.deal_hole('KsKc') # Wiggins\n state.deal_hole('5c2h') # Negreanu\n state.deal_hole('6h5h') # Brunson\n state.deal_hole('6s3s') # Laak\n\n state.fold() # Negreanu\n state.complete_bet_or_raise_to(2800) # Brunson\n state.fold() # Laak\n state.check_or_call() # Tony G\n state.complete_bet_or_raise_to(12600) # Hellmuth\n state.check_or_call() # Wiggins\n state.check_or_call() # Brunson\n state.check_or_call() # Tony G\n\nBelow are the flop dealing and actions.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('9hTs9s')\n\n state.check_or_call() # Tony G\n state.complete_bet_or_raise_to(17000) # Hellmuth\n state.complete_bet_or_raise_to(36000) # Wiggins\n state.fold() # Brunson\n state.fold() # Tony G\n state.complete_bet_or_raise_to(103800) # Hellmuth\n state.check_or_call() # Wiggins\n\nBelow is selecting the number of runouts.\n\n.. code-block:: python\n\n state.select_runout_count(4) # Hellmuth\n state.select_runout_count(None) # Wiggins\n\nBelow is the first runout.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Jh') # Turn\n state.burn_card('??')\n state.deal_board('Ad') # River\n\nBelow is the second runout.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Kh') # Turn\n state.burn_card('??')\n state.deal_board('3c') # River\n\nBelow is the third runout.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('7s') # Turn\n state.burn_card('??')\n state.deal_board('8s') # River\n\nBelow is the fourth runout.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Qc') # Turn\n state.burn_card('??')\n state.deal_board('Kd') # River\n\nBelow are the final stacks.\n\n.. code-block:: python\n\n print(state.stacks) # [inf, 79400, 149700, inf, 37400, inf]\n\nA Sample No-Limit Texas Hold'em Hand\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nBelow shows the first televised million-dollar pot between Tom Dwan and Phil Ivey.\n\nLink: https://youtu.be/GnxFohpljqM\n\nNote that the starting stack of Patrik Antonius is set to be ``math.inf`` as it is not mentioned.\n\n.. code-block:: python\n\n from math import inf\n\n from pokerkit import Automation, NoLimitTexasHoldem\n\n state = NoLimitTexasHoldem.create_state(\n # Automations\n (\n Automation.ANTE_POSTING,\n Automation.BET_COLLECTION,\n Automation.BLIND_OR_STRADDLE_POSTING,\n Automation.HOLE_CARDS_SHOWING_OR_MUCKING,\n Automation.HAND_KILLING,\n Automation.CHIPS_PUSHING,\n Automation.CHIPS_PULLING,\n ),\n True, # Uniform antes?\n 500, # Antes\n (1000, 2000), # Blinds or straddles\n 2000, # Min-bet\n (1125600, inf, 553500), # Starting stacks\n 3, # Number of players\n )\n\nBelow are the pre-flop dealings and actions.\n\n.. code-block:: python\n\n state.deal_hole('Ac2d') # Ivey\n state.deal_hole('????') # Antonius\n state.deal_hole('7h6h') # Dwan\n\n state.complete_bet_or_raise_to(7000) # Dwan\n state.complete_bet_or_raise_to(23000) # Ivey\n state.fold() # Antonius\n state.check_or_call() # Dwan\n\nBelow are the flop dealing and actions.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Jc3d5c')\n\n state.complete_bet_or_raise_to(35000) # Ivey\n state.check_or_call() # Dwan\n\nBelow are the turn dealing and actions.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('4h')\n\n state.complete_bet_or_raise_to(90000) # Ivey\n state.complete_bet_or_raise_to(232600) # Dwan\n state.complete_bet_or_raise_to(1067100) # Ivey\n state.check_or_call() # Dwan\n\nBelow is the river dealing.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Jh')\n\nBelow are the final stacks.\n\n.. code-block:: python\n\n print(state.stacks) # [572100, inf, 1109500]\n\nA Sample Short-Deck Hold'em Hand\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nBelow shows an all-in hand between Xuan and Phua.\n\nLink: https://youtu.be/QlgCcphLjaQ\n\n.. code-block:: python\n\n from pokerkit import Automation, NoLimitShortDeckHoldem\n\n state = NoLimitShortDeckHoldem.create_state(\n # Automations\n (\n Automation.ANTE_POSTING,\n Automation.BET_COLLECTION,\n Automation.BLIND_OR_STRADDLE_POSTING,\n Automation.HOLE_CARDS_SHOWING_OR_MUCKING,\n Automation.HAND_KILLING,\n Automation.CHIPS_PUSHING,\n Automation.CHIPS_PULLING,\n ),\n True, # Uniform antes?\n 3000, # Antes\n {-1: 3000}, # Blinds or straddles\n 3000, # Min-bet\n (495000, 232000, 362000, 403000, 301000, 204000), # Starting stacks\n 6, # Number of players\n )\n\nBelow are the pre-flop dealings and actions.\n\n.. code-block:: python\n\n state.deal_hole('Th8h') # Badziakouski\n state.deal_hole('QsJd') # Zhong\n state.deal_hole('QhQd') # Xuan\n state.deal_hole('8d7c') # Jun\n state.deal_hole('KhKs') # Phua\n state.deal_hole('8c7h') # Koon\n\n state.check_or_call() # Badziakouski\n state.check_or_call() # Zhong\n state.complete_bet_or_raise_to(35000) # Xuan\n state.fold() # Jun\n state.complete_bet_or_raise_to(298000) # Phua\n state.fold() # Koon\n state.fold() # Badziakouski\n state.fold() # Zhong\n state.check_or_call() # Xuan\n\nBelow is the flop dealing.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('9h6cKc')\n\nBelow is the turn dealing.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Jh')\n\nBelow is the river dealing.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('Ts')\n\nBelow are the final stacks.\n\n.. code-block:: python\n\n print(state.stacks) # [489000, 226000, 684000, 400000, 0, 198000]\n\nA Sample Pot-Limit Omaha Hold'em Hand\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nBelow shows the largest online poker pot ever played between Patrik Antonius and Viktor Blom.\n\nLink: https://youtu.be/UMBm66Id2AA\n\n.. code-block:: python\n\n from pokerkit import Automation, PotLimitOmahaHoldem\n\n state = PotLimitOmahaHoldem.create_state(\n # Automations\n (\n Automation.ANTE_POSTING,\n Automation.BET_COLLECTION,\n Automation.BLIND_OR_STRADDLE_POSTING,\n Automation.HOLE_CARDS_SHOWING_OR_MUCKING,\n Automation.HAND_KILLING,\n Automation.CHIPS_PUSHING,\n Automation.CHIPS_PULLING,\n ),\n True, # Uniform antes?\n 0, # Antes\n (500, 1000), # Blinds or straddles\n 1000, # Min-bet\n (1259450.25, 678473.5), # Starting stacks\n 2, # Number of players\n )\n\nBelow are the pre-flop dealings and actions.\n\n.. code-block:: python\n\n state.deal_hole('Ah3sKsKh') # Antonius\n state.deal_hole('6d9s7d8h') # Blom\n\n state.complete_bet_or_raise_to(3000) # Blom\n state.complete_bet_or_raise_to(9000) # Antonius\n state.complete_bet_or_raise_to(27000) # Blom\n state.complete_bet_or_raise_to(81000) # Antonius\n state.check_or_call() # Blom\n\nBelow are the flop dealing and actions.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('4s5c2h')\n\n state.complete_bet_or_raise_to(91000) # Antonius\n state.complete_bet_or_raise_to(435000) # Blom\n state.complete_bet_or_raise_to(779000) # Antonius\n state.check_or_call() # Blom\n\nBelow is the turn dealing.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('5h')\n\nBelow is the river dealing.\n\n.. code-block:: python\n\n state.burn_card('??')\n state.deal_board('9c')\n\nBelow are the final stacks.\n\n.. code-block:: python\n\n print(state.stacks) # [1937923.75, 0.0]\n\nA Sample Fixed-Limit Deuce-To-Seven Lowball Triple Draw Hand\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nBelow shows a bad beat between Yockey and Arieh.\n\nLink: https://youtu.be/pChCqb2FNxY\n\n.. code-block:: python\n\n from pokerkit import Automation, FixedLimitDeuceToSevenLowballTripleDraw\n\n state = FixedLimitDeuceToSevenLowballTripleDraw.create_state(\n # Automations\n (\n Automation.ANTE_POSTING,\n Automation.BET_COLLECTION,\n Automation.BLIND_OR_STRADDLE_POSTING,\n Automation.HOLE_CARDS_SHOWING_OR_MUCKING,\n Automation.HAND_KILLING,\n Automation.CHIPS_PUSHING,\n Automation.CHIPS_PULLING,\n ),\n True, # Uniform antes?\n 0, # Antes\n (75000, 150000), # Blinds or straddles\n 150000, # Small-bet\n 300000, # Big-bet\n (1180000, 4340000, 5910000, 10765000), # Starting stacks\n 4, # Number of players\n )\n\nBelow are the pre-flop dealings and actions.\n\n.. code-block:: python\n\n state.deal_hole('7h6c4c3d2c') # Yockey\n state.deal_hole('??????????') # Hui\n state.deal_hole('??????????') # Esposito\n state.deal_hole('AsQs6s5c3c') # Arieh\n\n state.fold() # Esposito\n state.complete_bet_or_raise_to() # Arieh\n state.complete_bet_or_raise_to() # Yockey\n state.fold() # Hui\n state.check_or_call() # Arieh\n\nBelow are the first draw and actions.\n\n.. code-block:: python\n\n state.stand_pat_or_discard() # Yockey\n state.stand_pat_or_discard('AsQs') # Arieh\n state.burn_card('??')\n state.deal_hole('2hQh') # Arieh\n\n state.complete_bet_or_raise_to() # Yockey\n state.check_or_call() # Arieh\n\nBelow are the second draw and actions.\n\n.. code-block:: python\n\n state.stand_pat_or_discard() # Yockey\n state.stand_pat_or_discard('Qh') # Arieh\n state.burn_card('??')\n state.deal_hole('4d') # Arieh\n\n state.complete_bet_or_raise_to() # Yockey\n state.check_or_call() # Arieh\n\nBelow are the third draw and actions.\n\n.. code-block:: python\n\n state.stand_pat_or_discard() # Yockey\n state.stand_pat_or_discard('6s') # Arieh\n state.burn_card('??')\n state.deal_hole('7c') # Arieh\n\n state.complete_bet_or_raise_to() # Yockey\n state.check_or_call() # Arieh\n\nBelow are the final stacks.\n\n.. code-block:: python\n\n print(state.stacks) # [0, 4190000, 5910000, 12095000]\n\nA Sample Badugi Hand\n^^^^^^^^^^^^^^^^^^^^\n\nBelow shows an example badugi hand from Wikipedia.\n\nLink: https://en.wikipedia.org/wiki/Badugi\n\nNote that the starting stacks are set to be ``math.inf`` as they are not mentioned.\n\n.. code-block:: python\n\n from math import inf\n\n from pokerkit import Automation, FixedLimitBadugi\n\n state = FixedLimitBadugi.create_state(\n # Automations\n (\n Automation.ANTE_POSTING,\n Automation.BET_COLLECTION,\n Automation.BLIND_OR_STRADDLE_POSTING,\n Automation.HAND_KILLING,\n Automation.CHIPS_PUSHING,\n Automation.CHIPS_PULLING,\n ),\n True, # Uniform antes?\n 0, # Antes\n (1, 2), # Blinds or straddles\n 2, # Small-bet\n 4, # Big-bet\n inf, # Starting stacks\n 4, # Number of players\n )\n\nBelow are the pre-flop dealings and actions.\n\n.. code-block:: python\n\n state.deal_hole('????????') # Bob\n state.deal_hole('????????') # Carol\n state.deal_hole('????????') # Ted\n state.deal_hole('????????') # Alice\n\n state.fold() # Ted\n state.check_or_call() # Alice\n state.check_or_call() # Bob\n state.check_or_call() # Carol\n\nBelow are the first draw and actions.\n\n.. code-block:: python\n\n state.stand_pat_or_discard('????') # Bob\n state.stand_pat_or_discard('????') # Carol\n state.stand_pat_or_discard('??') # Alice\n state.burn_card('??')\n state.deal_hole('????') # Bob\n state.deal_hole('????') # Carol\n state.deal_hole('??') # Alice\n\n state.check_or_call() # Bob\n state.complete_bet_or_raise_to() # Carol\n state.check_or_call() # Alice\n state.check_or_call() # Bob\n\nBelow are the second draw and actions.\n\n.. code-block:: python\n\n state.stand_pat_or_discard('??') # Bob\n state.stand_pat_or_discard() # Carol\n state.stand_pat_or_discard('??') # Alice\n state.burn_card('??')\n state.deal_hole('??') # Bob\n state.deal_hole('??') # Alice\n\n state.check_or_call() # Bob\n state.complete_bet_or_raise_to() # Carol\n state.complete_bet_or_raise_to() # Alice\n state.fold() # Bob\n state.check_or_call() # Carol\n\nBelow are the third draw and actions.\n\n.. code-block:: python\n\n state.stand_pat_or_discard('??') # Carol\n state.stand_pat_or_discard() # Alice\n state.burn_card('??')\n state.deal_hole('??') # Carol\n\n state.check_or_call() # Carol\n state.complete_bet_or_raise_to() # Alice\n state.check_or_call() # Carol\n\nBelow is the showdown.\n\n.. code-block:: python\n\n state.show_or_muck_hole_cards('2s4c6d9h') # Alice\n state.show_or_muck_hole_cards('3s5d7c8h') # Carol\n\nBelow are the final stacks.\n\n.. code-block:: python\n\n print(state.stacks) # [inf, inf, inf, inf]\n print(state.payoffs) # [-4, 20, 0, -16]\n\nTesting and Validation\n----------------------\n\nPokerKit has extensive test coverage, passes mypy static type checking with strict mode, and has been validated through extensive use in real-life scenarios.\n\nContributing\n------------\n\nContributions are welcome! Please read our Contributing Guide for more information.\n\nLicense\n-------\n\nPokerKit is distributed under the MIT license.\n\nCiting\n------\n\nIf you use PokerKit in your research, please cite our library:\n\n.. code-block:: bibtex\n\n @ARTICLE{10287546,\n author={Kim, Juho},\n journal={IEEE Transactions on Games}, \n title={PokerKit: A Comprehensive Python Library for Fine-Grained Multi-Variant Poker Game Simulations}, \n year={2023},\n volume={},\n number={},\n pages={1-8},\n doi={10.1109/TG.2023.3325637}}\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An open-source Python library for poker game simulations, hand evaluations, and statistical analysis",
"version": "0.5.4",
"project_urls": {
"Documentation": "https://pokerkit.readthedocs.io/en/latest/",
"Homepage": "https://github.com/uoftcprg/pokerkit",
"Source": "https://github.com/uoftcprg/pokerkit",
"Tracker": "https://github.com/uoftcprg/pokerkit/issues"
},
"split_keywords": [
"artificial-intelligence",
" deep-learning",
" game",
" game-development",
" game-theory",
" holdem-poker",
" imperfect-information-game",
" libratus",
" pluribus",
" poker",
" poker-engine",
" poker-evaluator",
" poker-game",
" poker-hands",
" poker-library",
" poker-strategies",
" python",
" reinforcement-learning",
" texas-holdem"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d0b136ab275ca4a2833e30839d8e9cce7b7023d1edfd506cd43fbf92255e1cf",
"md5": "c4ba48c521338c56655fdc27376d3d92",
"sha256": "99c47e65fd1061cb41f9cd467daca80f8118f7d4a474fe73093840574722a6d0"
},
"downloads": -1,
"filename": "pokerkit-0.5.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c4ba48c521338c56655fdc27376d3d92",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 99163,
"upload_time": "2024-09-08T01:41:46",
"upload_time_iso_8601": "2024-09-08T01:41:46.303961Z",
"url": "https://files.pythonhosted.org/packages/4d/0b/136ab275ca4a2833e30839d8e9cce7b7023d1edfd506cd43fbf92255e1cf/pokerkit-0.5.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bf8a64a13a389e0c9363f83935b34dce66521d85f9cb34f922c52370e9a17519",
"md5": "e1e9d1e783c98fe3a4be8b5d52828909",
"sha256": "c634e830b6c35d8a17267a466c85b4778cf8c78f930fb1e323eb4b4a6f9d70b0"
},
"downloads": -1,
"filename": "pokerkit-0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "e1e9d1e783c98fe3a4be8b5d52828909",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 95236,
"upload_time": "2024-09-08T01:41:48",
"upload_time_iso_8601": "2024-09-08T01:41:48.243587Z",
"url": "https://files.pythonhosted.org/packages/bf/8a/64a13a389e0c9363f83935b34dce66521d85f9cb34f922c52370e9a17519/pokerkit-0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-08 01:41:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "uoftcprg",
"github_project": "pokerkit",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "build",
"specs": [
[
"~=",
"1.2.1"
]
]
},
{
"name": "coverage",
"specs": [
[
"~=",
"7.5.1"
]
]
},
{
"name": "flake8",
"specs": [
[
"~=",
"7.0.0"
]
]
},
{
"name": "interrogate",
"specs": [
[
"~=",
"1.7.0"
]
]
},
{
"name": "mypy",
"specs": [
[
"~=",
"1.10.0"
]
]
},
{
"name": "Sphinx",
"specs": [
[
"~=",
"7.3.7"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
"~=",
"2.0.0"
]
]
},
{
"name": "twine",
"specs": [
[
"~=",
"5.1.0"
]
]
}
],
"lcname": "pokerkit"
}
JSON
