🎮 Rock Paper Scissors Game

This is a fun and interactive Rock Paper Scissors game built using Streamlit. Challenge the computer, track your scores, and see if you can become the ultimate champion! The game features a user-friendly interface, dynamic visuals, and real-time score tracking.

---

Features

• Interactive Gameplay: Choose between Rock, Paper, or Scissors and see if you can beat the computer.
• Real-Time Results: Displays your choice, the computer's choice, and whether you win, lose, or tie.
• Score Tracking: Keeps track of wins, losses, and ties across multiple rounds.
• Dynamic Visuals: Images and animations enhance the gameplay experience.
• Streamlit Integration: Built with Streamlit for a seamless web-based experience.

---

Requirements

To run this project locally, ensure you have the following installed:

• Python 3.7 or higher
• Streamlit library

Install the required dependencies using pip:

pip install streamlit

---

How to Run

Follow these steps to play the game locally:

1. Clone this repository to your local machine:

git clone https://github.com/apurvafx/rock-paper-scissors-game.git

3. Navigate to the project directory:

cd rock-paper-scissors-game

4. Run the Streamlit app:

streamlit run app.py

6. Open the link provided in your terminal (usually http://localhost:8501) to play the game in your browser.

---

Gameplay Instructions

1. Select your choice (Rock ✊, Paper ✋, or Scissors ✌️) using the radio buttons.
2. Click on the "Play" button to challenge the computer.
3. Watch as the computer makes its choice and see who wins!
4. Track your scores (Wins, Losses, Ties) displayed at the bottom of the page.

---

File Structure

rock-paper-scissors-game/
├── app.py # Main application code
├── rock.png # Image for Rock
├── paper.png # Image for Paper
├── scissors.png # Image for Scissors
├── winner.gif # Animation for winning
├── loser.gif # Animation for losing
├── tie.gif # Animation for tie
└── README.md # Documentation file

Ensure that all image and GIF files are placed in the same directory as app.py.

---

Troubleshooting

1. Streamlit Not Installed:

   • Ensure you’ve installed Streamlit using pip install streamlit.

2. Images Not Displaying:

   • Verify that all image files (rock.png, paper.png, scissors.png, etc.) are in the same directory as app.py.

3. App Not Running:

   • Check if Python is installed correctly and ensure you're running Streamlit with Python 3.x.

4. Browser Issues:

   • If the app doesn’t open automatically, manually navigate to http://localhost:8501 in your browser.

---

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute it as needed.

---

Acknowledgments

• Streamlit: For providing an amazing framework for building web applications.
• Icons/Images: Thanks to free resources for providing high-quality images and animations.

---

📖 DeepWiki Documentation

This repository is indexed and documented by DeepWiki, an AI-powered platform that provides interactive code exploration and detailed documentation.

Explore the system architecture, game logic, user interface, and state management with helpful explanations and diagrams generated automatically.

Check it out for a deeper understanding of the codebase and to get instant answers about this project!

---

Made with ❤️ using Streamlit