haive.games.hold_em.generic_engines¶

Generic Hold’em engine creation using the generic player agent system.

This module provides generic engine creation functions for Texas Hold’em games, allowing for configurable LLM models and game-specific player identifiers.

Classes¶

`HoldemEngineFactory`	Factory for creating Texas Hold'em game engines.
`HoldemPlayerIdentifiers`	Player identifiers for Texas Hold'em game.
`HoldemPromptGenerator`	Prompt generator for Texas Hold'em game.

Functions¶

`create_budget_holdem_engines`(**kwargs)	Create budget-friendly Hold'em engines.
`create_generic_holdem_config_from_example`(example_name)	Create Hold'em engines from a predefined example configuration.
`create_generic_holdem_engines`(player_configs)	Create Hold'em engines from detailed player configurations.
`create_generic_holdem_engines_simple`(player1_model, ...)	Create Hold'em engines with simple model specifications.
`create_heads_up_holdem_engines`(**kwargs)	Create specialized Hold'em engines for heads-up play.
`create_mixed_holdem_engines`(**kwargs)	Create mixed-provider Hold'em engines.
`create_poker_pro_holdem_engines`(**kwargs)	Create poker professional-style Hold'em engines with high-powered models.

Module Contents¶

class haive.games.hold_em.generic_engines.HoldemEngineFactory¶

Bases: haive.games.core.agent.generic_player_agent.GenericGameEngineFactory[str, str]

Factory for creating Texas Hold’em game engines.

Init .

Returns:: Add return description]
Return type:: [TODO

get_structured_output_model(role)¶

Get the structured output model for a specific role.

Parameters:: role (str)
Return type:: type

class haive.games.hold_em.generic_engines.HoldemPlayerIdentifiers¶

Bases: haive.games.core.agent.generic_player_agent.GamePlayerIdentifiers[str, str]

Player identifiers for Texas Hold’em game.

Init .

Returns:: Add return description]
Return type:: [TODO

class haive.games.hold_em.generic_engines.HoldemPromptGenerator(players)¶

Bases: haive.games.core.agent.generic_player_agent.GenericPromptGenerator[str, str]

Prompt generator for Texas Hold’em game.

Init .

Parameters:: players (GamePlayerIdentifiers[PlayerType, PlayerType2]) – [TODO: Add description]

create_analyzer_prompt(player)¶

Create analysis prompt for Hold’em game state.

Parameters:: player (str)
Return type:: langchain_core.prompts.ChatPromptTemplate

create_move_prompt(player)¶

Create move prompt for Hold’em player.

Parameters:: player (str)
Return type:: langchain_core.prompts.ChatPromptTemplate

haive.games.hold_em.generic_engines.create_budget_holdem_engines(**kwargs)¶

Create budget-friendly Hold’em engines.

Return type:: dict[str, haive.core.engine.aug_llm.AugLLMConfig]

haive.games.hold_em.generic_engines.create_generic_holdem_config_from_example(example_name, temperature=0.4)¶

Create Hold’em engines from a predefined example configuration.

Parameters:

example_name (str) – Name of the example configuration
temperature (float) – Generation temperature

Returns:

Dictionary of Hold’em engines

Return type:

Dict[str, AugLLMConfig]

Available examples:

“gpt_vs_claude”: GPT vs Claude
“gpt_only”: GPT for both players
“claude_only”: Claude for both players
“budget”: Cost-effective models
“mixed”: Different provider per role
“poker_pros”: High-powered models for strategic gameplay
“heads_up”: Specialized for heads-up play

haive.games.hold_em.generic_engines.create_generic_holdem_engines(player_configs)¶

Create Hold’em engines from detailed player configurations.

Parameters:: player_configs (dict[str, haive.games.core.agent.player_agent.PlayerAgentConfig]) – Dictionary mapping role names to player configurations
Returns:: Dictionary of Hold’em engines
Return type:: Dict[str, AugLLMConfig]