perudo

What problem does it solve?

Perudo orchestrates a game between AI agents by enforcing rules and narrating the action. It coordinates game state, validates bids, resolves rounds, and narrates outcomes, allowing humans to observe AI bluffing and strategy without handling low-level mechanics.

Core Features & Use Cases

• Deterministic engine execution: all game mechanics are driven by the included engine script.
• End-to-end gameplay: supports 2-6 players, including Palifico rounds and wilds for ones (except in Palifico).
• Player views and narration: presents per-player views and dramatic narration of bids, resolutions, and eliminations for immersive storytelling.
• Use Case: You want to simulate AI bluffing dynamics or watch AI agents play a complete Perudo match for analysis or entertainment.

Quick Start

Start a new game by running the engine with a player count (2–6) to initialize state and spawn AI agents.