Self-Hosted · Multi-Agent · Codex + StuClaw

PokerBot

AI bots with distinct personalities play Texas Hold'em against you. Self-hosted game server, GTO strategy engine, and live coaching — all powered by Codex with StuClaw app orchestration.

Subsystems

AI Bots

GTO Tools

Strategy Docs

Get Started View on GitHub

Quick Start

Prerequisites: StuClaw Desktop + Codex runtime · Node.js 22 · Python 3.11+

Install & check

Install PokerBot from StuClaw Desktop, then run Dependency check from the app card.

Open Codex in PokerBot/

The AGENTS.md file auto-loads everything. Just start talking.

Play!

Say any of these:

"play poker" — start server, open browser UI "add bots" — add AI players to the table "create a new bot, aggressive old man who loves to bluff" "join pokernow.com/games/pglXXXXXX" — join external room

Get coached

CoachBot is always active. Ask for GTO advice, hand analysis, or strategy tips mid-game. It reads your game state in real-time and responds in your language.

Stop

Say "stop game" and everything shuts down cleanly.

Features

Everything you need for a full AI poker experience.

♠

Self-Hosted Server

Full Texas Hold'em engine running on localhost. HTTP + WebSocket on port 3457, browser UI for human players, API endpoints for bots. No external dependencies.

Node.js WebSocket Browser UI

♦

Multi-Agent Bots

Six AI personalities from fish to pro, each with unique play styles, tells, and decision workflows. Create custom bots with natural language descriptions.

Codex gpt-5.4 Personalities

♣

GTO Strategy Engine

Five strategy documents and four user-facing Python calculation tools. Equity calculator, pot odds, preflop charts, and hand evaluator, with range parsing support under the hood.

Python Equity Ranges

♥

Live Coaching

CoachBot runs through the relay in an app-private mapped Codex session. You get real-time GTO advice, hand analysis, and strategy tips while you play.

Real-time GTO Advice Bilingual

⇄

Dual-Session Architecture

Foreground app management + background BotManager decisions. Each bot uses its own mapped Codex session and only receives its own information-isolated table state.

Isolation Parallel Fair Play

🌐

PokerNow Fallback

Experimental adapter for pokernow.com rooms. WebSocket bridge + file-based IPC orchestrator, kept outside the default desktop path.

pokernow.com WebSocket Bridge

Architecture

Four subsystems, three ports, three isolation layers.

CoachBot / You

:3456

Main session · relay layer

↔

Poker Server

:3457

Game engine · BotManager API

poker-server/ PRIMARY

Self-hosted Texas Hold'em backend. HTTP + WebSocket on port 3457, browser UI, /state and /action API for bots. Optional --public for LAN play.

poker-strategy/ GTO BRAIN

Five strategy docs (1,025 lines) + five Python tools (1,343 lines). Equity, odds, preflop, evaluator, range parser. Three-layer: Thinking → Application → Tools.

bot-management/ BOTS

BotManager subscribes to server turn events, invokes the shared Desktop Codex runner, parses each bot's JSON decision, and submits the action through the server API.

pokernow-runtime/ FALLBACK

WebSocket bridge to pokernow.com rooms. Orchestrator manages bot connections + file-based IPC. Only used when joining external rooms.

Information Isolation

Three layers ensure no bot cheats.

Data Layer

Each bot only receives its own hole cards. No cross-bot data at the API level.

Prompt Layer

Bot prompts contain only the bot's own table state. Tool and doc requests are served by BotManager from an allowlisted strategy set.

Session Layer

CoachBot and bot decisions run in separate app-private Desktop Codex runner sessions. User cards never enter another bot's prompt.

Bot Roster

From fish to pro. Create new bots with natural language.

GTO Grace gpt-5.4

Balanced pro — plays GTO with full tool access, exploits deviations.

Balanced GTO Tools Reads Opponents

Shark Alice gpt-5.4

Ice-cold shark — tight-aggressive, preys on weakness, minimal tells.

TAG Predatory Silent

ARIA Bot gpt-5.4

Steady regular — solid fundamentals, adapts to table dynamics.

Regular Adaptive Consistent

Maniac Charlie gpt-5.4

Reckless LAG — loves to bluff, puts max pressure, unpredictable.

LAG Aggressive Bluff-heavy

Fish Bob gpt-5.4

Happy fish — calls too much, chases draws, having a great time.

Loose-Passive No Tools Fun

Your Custom Bot

Describe a personality in natural language and a new bot is created. "Create a TAG-style bot using gpt-5.4 model" — that's all it takes.

Natural Language Any Style