Texas Hold'em hand evaluator and simulation engine.
Get Started
$ dotnet add package PokerAlgoReadme
🍑 PokerAlgo - Texas Hold 'em hand evaluator and simulation engine.
PokerAlgo is a C# library for evaluating poker hands, determining winners, and simulating win probabilities in Texas Hold 'em.
Features
- Determines the "winning hand" of a given Player.
- Determines the winner or winners in case of a tie.
- Given a winning hand, it will provide a "pretty" name. For example, "Full House, 7s over 5s" or "Pair of 7s".
- Provides the chances of winning or tying a round of Texas Hold 'em.
- Pre-flop, given a Player's hole cards, it can provide the chances of winning or tying using Monte Carlo simulations or using pre-computed data from a file.
- Post-flop, it can compute the chances of a player winning or tying using Monte Carlo simulations.
- Given a Player's hole cards, it can provide a hand strength value using Bill Chen's formula. A value ranging from -1 to 22.
Something to note about these predictions is that they are independent of other players. They are only calculated based on what a given player knows, hence why the chances don't add to 100%. The reason I added predictions is so I could build an AI that would make decisions based on its probabilities of winning.
- Monte Carlo Simulations are parallelized.
Future Improvements
- Simulate all players together for chances that add up to 100% on the board.
- Compute data tables for post-flop hands to avoid using simulations during a live game.
Compatibility
- .NET 6+
- Usable in any C# project
Installation
dotnet add package PokerAlgo
How to use
using PokerAlgo;
namespace PokerAlgoTest;
class Program
{
static void Main()
{
Deck deck = new();
List<Player> players = new() // at least 2 players
{
new Player("Player 1", deck.NextCard(), deck.NextCard()),
new Player("Player 2", deck.NextCard(), deck.NextCard()),
new Player("Player 3", deck.NextCard(), deck.NextCard()),
new Player("Player 4", deck.NextCard(), deck.NextCard()),
new Player("Player 5", deck.NextCard(), deck.NextCard()),
};
List<Card> community = deck.NextCards(5);
Console.WriteLine("Players:");
foreach (var player in players)
{
Console.WriteLine(player);
}
Console.WriteLine("\nCommunity Cards:");
foreach (Card item in community)
{
Console.Write(item + " ");
}
Console.WriteLine();
Player player1 = players[0];
HandEvaluator evaluator = new();
WinningHand winningHand = evaluator.GetWinningHand(player1.HoleCards, community);
Console.WriteLine("\nPlayer 1 WinningHand: \n" + winningHand);
Console.WriteLine("\nChances of Player 1 Winning:");
var chances = ChanceCalculator.GetWinningChanceSimParallel(player1.HoleCards, community, players.Count - 1, 10_000);
Console.WriteLine($"Win: {chances.winChance}\nTie: {chances.tieChance}");
List<Player> winners = Algo.GetWinners(players, community);
Console.WriteLine();
Console.WriteLine(winners.Count == 1 ? "Winner:" : "Tie:");
foreach (Player winner in winners)
{
Console.WriteLine(winner);
Console.WriteLine(winner.WinningHand);
Console.WriteLine(Helpers.GetPrettyHandName(winner.WinningHand));
Console.WriteLine();
}
}
}