GitHunt
KE

kelwynOliveira/rock_paper_scissors

A simple, colorful and interactive Rock, Paper, Scissors game built in Python

Python

๐Ÿชจ๐Ÿ“„โœ‚๏ธ Rock, Paper, Scissors Game

A simple, colorful and interactive Rock, Paper, Scissors game built in Python!
Train your luck, challenge the machine, and enjoy the terminal experience with a touch of style.


โœจ Screenshots

welcome
score-bye


๐ŸŽฎ How to Play

The classic rules:

Move Beats
Rock (0) Scissors (2)
Paper (1) Rock (0)
Scissors (2) Paper (1)

โš™๏ธ How to Run

For macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate

For Windows:

python -m venv .venv
.venv\Scripts\activate

2๏ธโƒฃ Install dependencies

pip install -r requirements.txt

or if you're just using colorama:

pip install colorama

3๏ธโƒฃ Start the game!

python rock_paper_scissors.py

4๏ธโƒฃ Stop the game

To deactivate the virtual environment when you're done:

deactivate

๐Ÿง  Project Overview

  • ๐Ÿ† Tracks your score and the machine's.
  • ๐ŸŽจ Uses Colorama to make the terminal output fun and clear.
  • ๐Ÿ” Loop-friendly: play as many rounds as you want!
  • โšก Clear input validation and feedback.

๐Ÿ“‚ Project Structure

rock_paper_scissors/
โ”œโ”€โ”€ .venv/ (optional virtual environment)
โ”œโ”€โ”€ assets
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ requirements.txt
โ””โ”€โ”€ rock_paper_scissors.py

๐Ÿ’ก Notes

Remember:
You only deactivate the virtual environment when you're done running the project and don't need to use its dependencies anymore.
Activating and immediately deactivating doesn't make sense โ€” run the game first, then leave the environment when you're finished.

kelwynOliveira/rock_paper_scissors | GitHunt