Papaya Pals Casino Games Web App

Overview

Papaya Pals Casino is a casino style web application that brings classic games like Slots, Roulette, Blackjack, and Wheel of Fortune to life in your browser. It's built using Streamlit for an interactive UI and is designed to simulate betting, spinning, and scoring in a playful environment.

Whether you're testing your luck or exploring game logic, Papaya Pals Casino is a fun way to gamble using virtual funds. When you run out, refill your bankroll for free. However, going bankrupt will add counters to your Shame Counter. Compete with friends to see how much money you can make, without gathering too much shame.

This project provides a containerized system through these subsystems:

1. Database: MongoDB database for storing data
2. Web Interface: Front-end display using Streamlit that displays data and enables user interfacing.

Team Members:

• Matthew Cheng
• Maya Humston
• Shamaamah Ahmad
• Suhan Suresh

Deployment:

Visit the Deployed App Here

Prerequisites

• Make sure both Docker and Docker Compose are installed.
• Python 3.10+
• pip or pipenv
• Streamlit

Configuration and Setup

Local Setup (No Docker)

1. Clone the repository:

git clone git@github.com:software-students-spring2025/5-final-papaya-pals.git

2. Create a .env file (literally named: .env) in the root directory with the following contents:

MONGO_URI = "PLACEHOLDER"

3. Install Dependencies:

pipenv install --dev
pipenv install streamlit
pipenv shell

4. Run the Streamlit App:

streamlit run web-app/app.py

Running with Docker

1. Clone the repository:

git clone git@github.com:software-students-spring2025/5-final-papaya-pals.git

2. Create a .env file (literally named: .env) in the root directory with the following contents:

MONGO_URI = "PLACEHOLDER"

3. Build and run the containers:

docker-compose up --build

4. Once the containers are up and running, open your browser and navigate to http://localhost:8501/.

Stopping the System

Run:

docker-compose down