Nightly Punk Masters

    poker-odds

    1.0.1 • Public • Published

    poker-odds

    Latest npm version Node version required Build Status Test Coverage Donate

    A lightweight command line tool for calculating poker hand probabilities. No dependencies. No huge data files.

    Installation

    # yarn 
    yarn global add poker-odds
     
    # npm 
    npm install -g poker-odds

    Usage

    poker-odds AcKh KdQs   # any number of hands supported 
                           # use .. for random cards, .... for a random hand 
     
    # options 
    -b, --board Td7s8d     # community cards 
    -i, --iterations 1000  # number of preflop simulations to run, default: 100000 
    -e, --exhaustive       # run all preflop simulations 
    -p, --possibilities    # show individual hand possibilities 
    -n, --no-color         # disable color output 
    -v, --version          # show version 
    -h, --help             # show help 

    Use --board or -b to define community cards.

    --board example

    Use --exhaustive or -e to run all preflop simulations. Note that this will take some time.

    --exhaustive example

    Use --possibilities or -p to show all possible hand outcomes. Hand possibilities are shown by default if only one hand is defined.

    --possibilities example

    API

    The method used to calculate probabilities can be imported and used directly in a JS/node project:

    import { calculateEquity } from 'poker-odds'
     
    const hands = [['As', 'Kh'], ['Kd', 'Qs']]
    const board = ['Td', '7s', '8d']
    const iterations = 100000 // optional
    const exhaustive = false // optional
     
    calculateEquity(hands, board, iterations, exhaustive)

    calculateEquity() returns an array of hands with the results of the simulations:

    [
      {
        "hand": [
          "Ac",
          "Kh"
        ],
        "count": 990,
        "wins": 803,
        "ties": 15,
        "handChances": [
          { "name": "high card", "count": 376 },
          { "name": "one pair", "count": 479 },
          { "name": "two pair", "count": 78 },
          { "name": "three of a kind", "count": 13 },
          { "name": "straight", "count": 44 },
          { "name": "flush", "count": 0 },
          { "name": "full house", "count": 0 },
          { "name": "four of a kind", "count": 0 },
          { "name": "straight flush", "count": 0 },
          { "name": "royal flush", "count": 0 }
        ],
        "favourite": true
      },
      {
        "hand": [
          "Kd",
          "Qs"
        ],
        "count": 990,
        "wins": 172,
        "ties": 15,
        "handChances": [
          { "name": "high card", "count": 351 },
          { "name": "one pair", "count": 463 },
          { "name": "two pair", "count": 77 },
          { "name": "three of a kind", "count": 13 },
          { "name": "straight", "count": 41 },
          { "name": "flush", "count": 45 },
          { "name": "full house", "count": 0 },
          { "name": "four of a kind", "count": 0 },
          { "name": "straight flush", "count": 0 },
          { "name": "royal flush", "count": 0 }
        ],
        "favourite": false
      }
    ]

    Keywords

    none

    Install

    npm i poker-odds

    DownloadsWeekly Downloads

    67

    Version

    1.0.1

    License

    MIT

    Last publish

    Collaborators

    • cookpete