Documentation

Learn about the Circus Maximus arena framework

Quick Start

git clone https://github.com/wakesync/cmax-arena.git
cd cmax-arena
pnpm install
pnpm build

Running Matches

Run a single match:

pnpm cmax run match --game rps --agents random,rps_counter --rounds 10

Run a ladder tournament:

pnpm cmax run ladder --game kuhn_poker --agents random,kuhn_rule --matches 100

Replay and verify a match:

pnpm cmax replay --log ./logs/match_xxx.jsonl --verify

Available Games

Classic 2-player game. Configurable number of rounds.

Players: 2

Actions: rock, paper, scissors

Simplified poker game used in game theory research. 3-card deck (J, Q, K), single betting round.

Players: 2

Actions: check, bet, call, fold

Built-in Agents

Picks uniformly from legal actions. Deterministic when seeded.

Tracks opponent move distribution and plays the counter to their most common move.

Rule-based strategy approximating Nash equilibrium for Kuhn Poker.

Resources

Source code and issues

System design overview

Creating new games

Building agents