haive.games.api.setup¶

Game API setup utilities.

This module provides utilities for setting up game APIs using the standardized GameAPI system from haive-dataflow.

Classes¶

GameAPIConfig

Configuration for game API setup.

Functions¶

create_chess_api(app[, config_overrides])

Create a Chess game API.

create_connect4_api(app[, config_overrides])

Create a Connect4 game API.

create_game_api(app, agent_class[, api_config])

Create a game API with the standardized system.

create_tic_tac_toe_api(app[, config_overrides])

Create a Tic-Tac-Toe game API.

Module Contents¶

class haive.games.api.setup.GameAPIConfig(/, **data)¶

Bases: pydantic.BaseModel

Configuration for game API setup.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Parameters:

data (Any)

haive.games.api.setup.create_chess_api(app, config_overrides=None, **kwargs)¶

Create a Chess game API.

Parameters:

  • app (fastapi.FastAPI) – FastAPI application

  • config_overrides (dict[str, Any] | None) – Configuration overrides for chess

  • **kwargs – Additional API configuration

Returns:

Configured GameAPI for chess

Return type:

haive.dataflow.api.game_api.GameAPI

Examples

>>> app = FastAPI()
>>> chess_api = create_chess_api(
...     app,
...     config_overrides={
...         "white_model": "gpt-4",
...         "black_model": "claude-3-opus",
...         "enable_analysis": True
...     }
... )
haive.games.api.setup.create_connect4_api(app, config_overrides=None, **kwargs)¶

Create a Connect4 game API.

Parameters:

  • app (fastapi.FastAPI) – FastAPI application

  • config_overrides (dict[str, Any] | None) – Configuration overrides for Connect4

  • **kwargs – Additional API configuration

Returns:

Configured GameAPI for Connect4

Return type:

haive.dataflow.api.game_api.GameAPI

Examples

>>> app = FastAPI()
>>> connect4_api = create_connect4_api(
...     app,
...     config_overrides={
...         "red_model": "gpt-3.5-turbo",
...         "yellow_model": "gpt-3.5-turbo",
...         "temperature": 0.5
...     }
... )
haive.games.api.setup.create_game_api(app, agent_class, api_config=None, **kwargs)¶

Create a game API with the standardized system.

Parameters:

  • app (fastapi.FastAPI) – FastAPI application instance

  • agent_class (type[haive.core.engine.agent.agent.Agent]) – The game agent class

  • api_config (GameAPIConfig | None) – API configuration

  • **kwargs – Additional arguments passed to GameAPI

Returns:

Configured GameAPI instance

Return type:

haive.dataflow.api.game_api.GameAPI

haive.games.api.setup.create_tic_tac_toe_api(app, config_overrides=None, **kwargs)¶

Create a Tic-Tac-Toe game API.

Parameters:

  • app (fastapi.FastAPI) – FastAPI application

  • config_overrides (dict[str, Any] | None) – Configuration overrides for Tic-Tac-Toe

  • **kwargs – Additional API configuration

Returns:

Configured GameAPI for Tic-Tac-Toe

Return type:

haive.dataflow.api.game_api.GameAPI

Examples

>>> app = FastAPI()
>>> ttt_api = create_tic_tac_toe_api(
...     app,
...     config_overrides={
...         "x_model": "claude-3-haiku",
...         "o_model": "claude-3-haiku",
...         "example_config": "budget"
...     }
... )