deeppoker 0.1.0

DeepPoker R1 - A Texas Hold'em poker game engine with FastAPI WebSocket server and AI agent framework

DeepPoker

DeepPoker R1 - A Texas Hold'em poker game engine with FastAPI WebSocket server and AI agent framework.

Features

• Pure Python game core logic (no external poker dependencies)
• FastAPI + WebSocket server architecture
• AI Agent interface for LLM RL integration
• Complete Texas Hold'em rules implementation

Installation

pip install deeppoker

Or with uv:

uv add deeppoker

Quick Start

from deeppoker import Card, Deck, Player, TexasHoldemGame

# Create players
players = [Player(f"Player {i}", chips=1000) for i in range(4)]

# Create and start a game
game = TexasHoldemGame(players, small_blind=10, big_blind=20)
game.start_hand()

Development

Clone the repository and install development dependencies:

git clone https://github.com/ziyigogogo/deeppoker.git
cd deeppoker
uv sync --all-extras

Run tests:

uv run pytest

Start the server:

uv run deeppoker

API Reference

Core Classes

• Card - Represents a playing card
• Deck - A deck of 52 cards
• Player - A poker player with chips
• TexasHoldemGame - Main game engine
• HandRank - Hand ranking enumeration
• evaluate_hand - Hand evaluation function

Agents

• BaseAgent - Abstract base class for AI agents
• RandomAgent - Random action agent for testing

License

MIT License - see LICENSE for details.