poker-odds-calc - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #llm #golang #go #android #deep-learning #docker #nodejs #awesome-list #vue #mcp #ios #open-source

poker-odds-calc

(★ 99)

Fastest and most accurate node module for calculating odds of poker games Texas Hold'em, Texas Shortdeck/Sixplus and Omaha.

File Explorer

Download Latest Version (.zip)

- - Board.ts
  - Card.ts
  - Deck.ts
  - Game.ts
  - Interfaces.ts
  - Player.ts
  - Result.ts
  - Table.ts
  - Utils.ts
- - omaha.ts
  - texas.ts
  - texas_short.ts
- index.ts
.gitignore
.npmignore
CHANGELOG.md
lib.d.ts
LICENSE.md
package-lock.json
package.json
README.md
ts-lint.json
tsconfig.json

# Installation Guide

1. Get the code

git clone https://github.com/siavashg87/poker-odds-calc

Downloads the entire project code from GitHub to your computer.

cd poker-odds-calc

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Node.js Node.js must be installed to use npm.

npm install -g poker-odds-calc

Installs the package published on the npm registry globally — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

npm install -g poker-odds-calc

Installs the package published on the npm registry globally — no need to clone the source.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Poker Odds Calc

[![Build Status](https://travis-ci.org/rundef/node-poker-odds-calculator.svg?branch=master)](https://travis-ci.org/rundef/node-poker-odds-calculator)
[![Node version required](https://img.shields.io/node/v/poker-odds.svg)](https://www.npmjs.com/package/poker-odds-calc)
[![Latest Stable Version](https://img.shields.io/npm/v/poker-odds-calc.svg)](https://www.npmjs.com/package/poker-odds-calc)

Fastest and most accurate node module for calculating odds of poker games Texas Hold'em, Texas Shortdeck/Sixplus and Omaha.

## Installation

```bash
npm install -g poker-odds-calc
```

### Usage

```bash
poker-odds-calc -p AdKh -p AcKh -b 5sTd9c

# options
-g, --game texas_holdem     # Select between texas_holdem, shortdeck_holdem and omaha. Default texas_holdem.
-b, --board 5sTd9cTh        # Define community cards.
-p, --player AcKh           # Define any number of player hand.
-l, --limit 1000            # Limit number of iterations. Default 100,000.
-e, --exhaustive            # Run all possible board combinations, regardless limit option.
-d, --dead 2s2d             # Dead card(s) to exclude from calculation.
--tripsbeatstraight         # Option only available for -g shortdeck_holdem
-h, --help                  # Show help
```

poker-odds-calc -p QsKs -p QdKd -b JsTs5hTd

![--example](https://i.imgur.com/CDxNZcz.png)

## API Usage

Let's take the previous example, but use the API instead:

```js
import {TexasHoldem, SixPlusHoldem, Omaha} from './index';

const Table = new TexasHoldem();
Table
  .addPlayer(["Qs", "Ks"])
  .addPlayer(["Qd", "Kd"])

.setBoard(["Js","Ts","5h","Td"])
  // or
  .boardAction(board => {
    board
      .setFlop(["Js", "Ts", "5h"])
      .setTurn("Td")
  })
  ;

const Result = Table.calculate();

Result.getPlayers().forEach(player => {
  console.log(`${player.getName()} - ${player.getHand()} - Wins: ${player.getWinsPercentageString()} - Ties: ${player.getTiesPercentageString()}`);
});

console.log(`Board: ${Result.getBoard()}`);
console.log(`Iterations: ${Result.getIterations()}`);
console.log(`Time takes: ${Result.getTime()}ms`);

// Outputs:
// Player #1 - QsKs - Wins: 20.45% - Ties: 79.55%
// Player #2 - QdKd - Wins: 0.00% - Ties: 79.55%
// Board: JsTs5hTd
// Iterations: 44
// Time takes: 8ms

```

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.