/rs-poker

rs-poker is a rust library that includes all of the poker evaluation tools that you need from hand ranking and starting card enumeration to a full agent arena for self learning.

Primary LanguageRustApache License 2.0Apache-2.0

rs-poker

Crates.io Docs.rs

RS Poker is a rust library aimed to be a good starting place for many poker rust codes. Correctness and performance are the two primary goals.

Core

The Core module contains code not specific to different types of poker games. It contains:

  • Suit type
  • Value type
  • Card type
  • Deck
  • Hand iteration
  • Poker hand rank type
  • Poker hand evaluation for five-card hands.
  • Poker hand evaluation for seven card hands.
  • PlayerBitSet is suitable for keeping track of boolean values on a table.

The poker hand (5 cards) evaluation will rank a hand in ~20 nanoseconds per hand. That means that 50 Million hands per second can be ranked per CPU core. The seven-card hand evaluation will rank a hand in < 25 ns.

The hand evaluation is accurate. rs-poker does not rely on just a single kicker. This accuracy allows for breaking ties on hands that are closer.

Holdem

The holdem module contains code that is specific to holdem. It currently contains:

  • Starting hand enumeration
  • Hand range parsing
  • Monte Carlo game simulation helpers.

Arena

Arena is currently a beta feature. There are no planned breaking changes, but additions are expected.

Arena is a feature that allows the creating of agents that play a simulated Texas Holdem poker game. These autonomous agent vs agent games are ideal for determining the strength of automated strategies. Additionally, agent vs agent arenas are a good way of quickly playing lots of GTO poker.

  • Holdem simulation struct for the overall status of the simulation
  • Game state for the state of the current game
  • Agent trait that you can implement to create your more potent poker agent.
  • A few example Agents.
  • Historians who can watch every action in a simulation as it happens

Testing

The code is well-tested and benchmarked. If you find something that looks like a bug, please submit a PR with an updated test code.

5 Card + Hand iteration is used with fuzzing to validate the seven-card hand evaluation.

Fuzzing is used to validate game simulation via replay generation.