♠️ BlackJack Casino AI – A Scalable Real-time Blackjack Game

Overview
BlackJack Casino AI is a robust, scalable, and real-time Blackjack game developed using Python, Flask, SocketIO, and Redis. This project boasts an AI opponent equipped with three distinct difficulty levels, designed to enhance the player's experience in a casino environment. The architecture is tailored for production deployment, ensuring seamless performance even under heavy load.

✨ Key Features

• Real-time Gameplay: Leverages WebSocket technology (via Flask-SocketIO) to ensure instant synchronization of game state between the server and clients, providing an engaging gaming experience.
• Scalable Session Management: Implements Redis as the session storage, enabling the application to scale efficiently while maintaining user states across multiple processes (e.g., Gunicorn workers).
• AI Opponent: Challenge yourself against an AI opponent that offers three levels of difficulty: Easy, Medium, and Hard, catering to both novices and seasoned players.
• Persistent Balance: Player balances are reliably stored in an SQL database (SQLite/PostgreSQL) facilitated by SQLAlchemy, ensuring data persistence across sessions.
• Asynchronous Task Handling: Utilizes eventlet to manage background tasks for AI and Dealer turns, guaranteeing that the player's user interface remains responsive.

🛠️ Tech Stack

Backend

• Python 3.10+
• Flask: The main web application framework
• Flask-SocketIO: Enables real-time bidirectional communication
• Redis: Provides scalable session storage for active game sessions
• Flask-SQLAlchemy: Manages persistent storage for user data
• Eventlet / Gunicorn: Asynchronous WSGI server suitable for production
• python-dotenv: Controls environment variables

Frontend

• HTML5
• CSS3: Custom casino-themed styles
• JavaScript (ES6+): Utilizes Socket.IO for state-driven UI updates

📂 Project Structure

The project follows a well-organized structure, facilitating easy navigation and contribution:

blackjack/  
├── game/                  # Core game logic package  
│   ├── __init__.py      # Package initializer  
│   ├── logic.py         # Pure game logic: Card, Deck, Player, GameSession  
│   └── routes.py        # SocketIO events and HTTP routes  
│   
├── static/                # Frontend assets  
│   ├── style.css  
│   └── app.js  
│   
├── templates/             # Flask/Jinja2 templates  
│   └── index.html  
│   
├── .env                   # Environment variables  
├── .env.example           # Template for environment variables  
├── .gitignore             # Git ignore list  
├── app.py                 # Flask application factory  
├── config.py              # Configuration classes  
├── extensions.py          # Instances for db, socketio, redis_client  
├── models.py              # SQLAlchemy User model  
├── requirements.txt       # Python dependencies  
├── utils.py               # Logging setup and utilities  
└── wsgi.py                # WSGI entry point for the server launch  

Unleash your Blackjack strategy with BlackJack Casino AI and enjoy an immersive gaming experience powered by advanced technology.