Colosseum Agent Battles provides a modular Python SDK for constructing AI agent competitions in customizable arenas. Users can define environments with specific terrain, resources, and rulesets, then implement agent strategies via a standardized interface. The framework manages battle scheduling, referee logic, and real-time logging of agent actions and outcomes. It includes tools for running tournaments, tracking win/loss statistics, and visualizing agent performance through charts. Developers can integrate with popular machine learning libraries to train agents, export battle data for analysis, and extend referee modules to enforce custom rules. Ultimately, it streamlines the benchmarking of AI strategies in head-to-head contests. It also supports logging in JSON and CSV formats for downstream analytics.

At its core, Gomoku Battle provides a robust simulation environment where AI agents adhere to a JSON-based protocol to receive board state updates and submit move decisions. Developers can integrate custom strategies by implementing simple Python interfaces, leveraging provided sample bots for reference. The built-in tournament manager automates scheduling of round-robin and elimination matches, while detailed logs capture metrics like win rates, move times, and game histories. Outputs can be exported as CSV or JSON for further statistical analysis. The framework supports parallel execution to accelerate large-scale experiments and can be extended to include custom rule variations or training pipelines, making it ideal for research, education, and competitive AI development.