gamescape 0.1.0

CLI tool for visualizing evolutionary game theory dynamics — replicator equations, fixed points, and phase portraits in your terminal

gamescape

Visualize evolutionary game theory dynamics in your terminal. Computes replicator equations, finds fixed points, classifies games, and renders ASCII phase portraits.

Install

pip install -e .

Usage

# Analyze a classic game
gamescape prisoners-dilemma
gamescape stag-hunt
gamescape hawk-dove
gamescape coordination
gamescape harmony

# Custom payoff matrix (CC, CD, DC, DD)
gamescape --matrix 3,0,5,1

# List available games
gamescape --list

# Disable colors
gamescape hawk-dove --no-color

What it shows

• Payoff matrix — the 2x2 symmetric game
• Classification — dominant-cooperate, dominant-defect, coordination, coexistence, bistable
• Fixed points — boundary and interior equilibria with stability (@ = stable, o = unstable)
• Phase flow — 1D flow line showing direction of replicator dynamics
• Trajectories — x(t) plot from 5 initial conditions converging to attractors

Example output

  Classification: coexistence

  Fixed Points:
    o x=0.0000 (all-D, unstable)
    @ x=0.2857 (interior, stable)
    o x=1.0000 (all-C, unstable)

  Phase Flow:
  all-D |o>>>>>>>>>>>>>>>>@<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<o| all-C

As a library

from gamescape.dynamics import PayoffMatrix, find_fixed_points, classify_game, trajectory

game = PayoffMatrix(a=3, b=0, c=5, d=1)  # Prisoner's Dilemma
print(classify_game(game))  # "dominant-defect"

for fp in find_fixed_points(game):
    print(f"x={fp.x:.2f} stable={fp.stable} ({fp.label})")

traj = trajectory(game, x0=0.5)  # simulate from x=0.5

Tests

pip install -e ".[dev]"
pytest tests/ -v

License

MIT