Real-Time AI-Powered Texas Hold'em in Python and Flask – Play in the Browser

2. Run the automated setup

   This will:

   • Check your Python environment
   • Install required dependencies
   • Create configuration files
   • Start the development server

3. Manual setup (alternative)

   # Install dependencies pip install -r requirements.txt # Start the server python run.py

4. Access the game Open your browser and navigate to:

1. Enter your player name in the lobby
2. Add AI opponents using the difficulty buttons
3. Click "Start Game" to begin
4. The game automatically handles dealing and betting rounds

1. Blinds: Small and big blinds are posted automatically
2. Pre-flop: Receive your hole cards and begin betting
3. Flop: Three community cards are revealed
4. Turn: Fourth community card revealed
5. River: Final community card revealed
6. Showdown: Remaining players reveal hands, best hand wins

• Fold: Discard your hand and sit out the current round
• Check: Stay in the game without betting (when no bet to call)
• Call: Match the current bet amount
• Raise: Increase the current bet (must meet minimum raise requirements)
• All-in: Bet all your remaining chips

Create a .env file from .env.example:

Modify config.py to adjust:

• DEFAULT_CHIPS: Starting chip count (default: 10000)
• SMALL_BLIND / BIG_BLIND: Blind amounts
• MAX_PLAYERS_PER_GAME: Maximum players per table

• Makes random decisions with basic strategy
• Good for beginners learning the game
• Occasionally makes questionable plays

• Uses hand strength evaluation
• Considers position and pot odds
• Balanced aggression and caution

• Advanced hand reading and range analysis
• Position-aware betting strategies
• Pot odds and implied odds calculations
• Capable of bluffing and semi-bluffing

• join_game: Join a game room
  { "username": "string", "room_id": "string" }
• start_game: Start a new hand
• player_action: Submit player action
  { "action": "fold|check|call|bet|raise", "amount": number }

• game_state_update: Real-time game state
• game_over: Round completion with winners
• error: Error notifications

• POST /api/user: Create new user
• GET /api/user/<username>: Get user information
• POST /api/reset_user: Reset user chips
• GET /api/games: List active games
• GET /api/game/<room_id>: Get specific game state

1. Set FLASK_DEBUG=False in .env
2. Generate a strong SECRET_KEY
3. Configure production database (PostgreSQL recommended)
4. Set proper CORS origins
5. Use gunicorn for production server:
   gunicorn -k eventlet -w 1 run:app

Server won't start:

• Check Python version (requires 3.8+)
• Verify all dependencies are installed
• Check port 5000 is available

Connection errors:

• Ensure server is running
• Check browser console for WebSocket errors
• Verify CORS settings if accessing from different domain

Game logic issues:

• Check server logs for error messages
• Verify database file permissions
• Reset game state if needed

• Server logs: poker_server.log
• Real-time logs: Browser developer console

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Follow PEP 8 for Python code
• Use meaningful commit messages
• Add tests for new features
• Update documentation accordingly

This project is licensed under the MIT License - see the LICENSE file for details.

• Poker hand evaluation logic inspired by open-source poker libraries
• UI design inspired by luxury casino aesthetics
• Socket.IO for real-time communication capabilities
• Flask community for excellent web framework documentation

Enjoy your game of Midnight Luxury Poker! 🎰♠️♥️♣️♦️

For questions or support, please check the issues section or contribute to the documentation.