How freddyyandrews/poker-hackathon-kit works
This is a No-Limit Texas Hold’em bot hackathon kit: users supply a bot, then play matches against it and inspect results. The main runtime path is play.py → Table → hand engine, with Table requesting decisions through seats and BotProcess. The core also provides blind schedules, deterministic seeding, sandbox execution and bot validation. The README documents tournament use and sandbox constraints; the supplied excerpts do not show the full match setup or every validator and process detail, so those connections are limited to visible references.
Main entry points: play.py Match launcher · table.py Table and match · runner.py Bot protocol runner · botproc.py Bot process
Components 13
Match Runtime
- Match launcher
play.py - Table and match
pokercore/table.py - Poker engine
pokercore/engine.py - Blind structures
pokercore/structures.py - Seed derivation
pokercore/seeds.py - Player seats
pokercore/seats.py
Bot Execution
- Bot template
bots/template/bot.py - Caller bot
bots/caller/bot.py - Bot process
pokercore/botproc.py - Bot protocol runner
pokercore/sandbox/runner.py
Sandbox and Validation
- Local confinement
pokercore/sandbox/guard.py - Bot validator
pokercore/validator.py
Other components
- Kit user
Connections 18
- Kit user → Match launcher: starts match
README.md - Kit user → Bot template: customizes
README.md - Match launcher → Table and match: runs match
play.py - Match launcher → Player seats: builds seats
play.py - Match launcher → Blind structures: configures blinds
play.py - Match launcher → Seed derivation: chooses seed
play.py - Table and match → Blind structures: gets levels
pokercore/table.py - Table and match → Seed derivation: derives hand seeds
pokercore/table.py - Table and match → Poker engine: plays hand
pokercore/table.py - Table and match → Player seats: requests actions
pokercore/table.py - Player seats → Bot process: starts and queries
pokercore/seats.py - Bot process → Bot protocol runner: runs bot protocol
pokercore/botproc.py - Bot protocol runner → Local confinement: confines process
pokercore/sandbox/runner.py - Bot process → Local confinement: installs local guard
pokercore/botproc.py - Bot protocol runner → Bot template: loads bot
README.md - Bot protocol runner → Caller bot: loads bot
README.md - Kit user → Bot validator: validates bot
README.md - Bot validator → Local confinement: uses confinement
pokercore/validator.py