Skip to main content

Poker hand evaluating modules that provide fast enumerations.

Project description


This is a python library that provides routines for very fast poker hand comparisons to power hand match ups.

Pure python and c-extention modules are included. Using the cpoker module it should be easy to write python code that will, for example, quickly caluculate expected hand strength squared and opponent cluster hand strength (EHS2/OCHS).

The rank lookup sceme uses 13 magic numbers attributed to the specialK blog, which I used to supplement my own algorithm. A pure python lite version is also included that leaves a small memory footprint and is still fast.


Cards are represented by intergers 0-51 and groups of cards are contained in lists. The pretty_args wrapper allows you to use standard card strings rather than integers. You can also convert from integers to pretty cards and back with utils.make_pretty and utils.to_cards.

>>> from poker import cpoker
>>> from poker import utils
>>> #return the evs of a match between any number of hands
>>> enum = utils.pretty_args(cpoker.full_enumeration)
>>> enum(["AsKd", "8c2s"])
[0.6753362720638392, 0.32466372793616083]
>>> enum(["AsKd", "7h 8h", "6c 6d"], "Kc 6h 9h")
[0.021040974529346623, 0.44518272425249167, 0.5337763012181617]
>>> # percentile on river vs all 990 hand combos
>>> utils.pretty_args(cpoker.rivervalue)("As Kd", "Ks Qh Jc 8s 8d")
>>> utils.make_pretty([7, 8, 9])
'Ks Qc Qd'
>>> utils.to_cards('Ks Qc Qd')
[7, 8, 9]

Compile and Install

If you have a c compiler the python dev tools for your system then hopefully this does it. All you need is python 2 or 3 to run the pure python modules.

$ python install

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pokyr-0.1.25.tar.gz (31.3 kB view hashes)

Uploaded source

Built Distributions

pokyr-0.1.25-py3.7-macosx-10.15-x86_64.egg (52.8 kB view hashes)

Uploaded 3 7

pokyr-0.1.25-py2.7-macosx-10.15-x86_64.egg (48.7 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page