Metadata-Version: 2.3
Name: deeppoker
Version: 0.1.0
Summary: DeepPoker R1 - A Texas Hold'em poker game engine with FastAPI WebSocket server and AI agent framework
Keywords: poker,texasholdem,holdem,game,ai,agent
Author: Ziyi
Author-email: Ziyi <ziyigogogo@gmail.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Requires-Dist: fastapi>=0.109.0
Requires-Dist: uvicorn[standard]>=0.27.0
Requires-Dist: websockets>=12.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0 ; extra == 'dev'
Requires-Dist: httpx>=0.26.0 ; extra == 'dev'
Requires-Python: >=3.10
Provides-Extra: dev
Description-Content-Type: text/markdown

# 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

```bash
pip install deeppoker
```

Or with uv:

```bash
uv add deeppoker
```

## Quick Start

```python
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:

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

Run tests:

```bash
uv run pytest
```

Start the server:

```bash
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](LICENSE) for details.
