https://github.com/dynamic-stall/blackjack-python
Terminal-based, single-player Blackjack game using Python
https://github.com/dynamic-stall/blackjack-python
blackjack blackjack-cli blackjack-game blackjack-python card-game pandas python python-game python-games python3
Last synced: about 1 month ago
JSON representation
Terminal-based, single-player Blackjack game using Python
- Host: GitHub
- URL: https://github.com/dynamic-stall/blackjack-python
- Owner: dynamic-stall
- Created: 2025-04-15T17:55:34.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-15T18:11:20.000Z (about 1 month ago)
- Last Synced: 2025-04-15T18:48:31.815Z (about 1 month ago)
- Topics: blackjack, blackjack-cli, blackjack-game, blackjack-python, card-game, pandas, python, python-game, python-games, python3
- Language: Python
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Python Blackjack Game
A simple command-line blackjack game implemented in Python.
## Features
- Single-player gameplay against the dealer
- Visual card representation in the terminal
- Chip-based betting system (white $1, red $5, green $25, black $100, purple $500, orange $1000)
- Account balance tracking with transaction history
- Interactive gameplay with options to hit, stand, or double down
## Installation
1. Clone this repository:
```bash
git clone https://github.com/dynamic-stall/blackjack-python.git
cd blackjack-python
```
2. Create and activate the conda environment from the provided file:
```bash
conda env create -f environment.yml
conda activate blackjack
```
- (Refer to my [aws-iam-credential-report](https://github.com/dynamic-stall/aws-iam-credential-report/) repo for Miniconda installation assistance, if Python is not present on your system.)
## Project Structure
```
blackjack-python/
├── __init__.py
├── account.py # Account management for betting
├── card_components.py # Card, Deck, and Hand classes
├── constants.py # Game constants (cards, chips)
├── environment.yml # Conda environment configuration
├── game.py # Main game logic
├── main.py # Entry point
├── players.py # Player and Dealer classes
└── README.md # (This file)
```
## How to Play
1. Run the game directly:
```bash
python3 main.py
```
2. Enter your name when prompted
3. Place bets using chip colors:
- Format: "[number] [color] [number] [color] ..."
- Example: "2 black 1 green" for $225 ($100 x 2 + $25)
4. Game Actions:
- `hit`: Draw another card
- `stand`: Keep current hand
- `double`: Double your bet and receive one more card (only available on initial hand)
5. Win Conditions:
- Get closer to 21 than the dealer without going over
- Dealer busts (goes over 21)
- Initial two cards totaling 21 (Blackjack)
## Note
This game uses pandas for transaction tracking. Make sure you have it installed via the ```environment.yml``` file.
## Future Improvements (at some point...)
- Multiple player support
- Split pairs option
- Insurance bets
- Save game progress
- Statistics tracking