An open API service indexing awesome lists of open source software.

https://github.com/kasraskari/guess-the-number

A simple Python game with two modes: guess a number chosen by the system or let the system guess your number based on feedback.
https://github.com/kasraskari/guess-the-number

game guess-the-number guessing-number-game python random

Last synced: about 1 month ago
JSON representation

A simple Python game with two modes: guess a number chosen by the system or let the system guess your number based on feedback.

Awesome Lists containing this project

README

        

# Guess The Number 🎲

**A fun and interactive game to challenge your guessing skills!**

---

## 🎯 Overview
This Python-based project consists of two versions of the number-guessing game:
1. **User Guess:** The user tries to guess the number randomly generated by the system.
2. **System Guess:** The system guesses a number chosen by the user.

Each version provides an engaging experience with clear feedback mechanisms to guide the guesses.

---

## 🚀 Features
- Two game modes:
- **User Guess Mode:** The user guesses the number.
- **System Guess Mode:** The system guesses the user's number.
- Adjustable range for number generation (e.g., 1-100).
- Feedback for each guess (higher or lower).
- Tracks the number of attempts.
- Simple and user-friendly interface.

---

## 🛠️ How It Works

### **1. User Guess Mode**
1. The system generates a random number within a predefined range.
2. The user inputs guesses.
3. The program provides feedback: "Too High" or "Too Low."
4. The game ends when the user guesses the correct number.

### **2. System Guess Mode**
1. The user selects a number secretly within the range.
2. The system makes guesses and adjusts based on user feedback ("higher" or "lower").
3. The system continues until it correctly identifies the user's number.

---

## 💡 How to Run
1. Clone the repository:
```bash
git clone https://github.com/KasrAskari/Guess-The-Number.git
```
2. Navigate to the project folder:
```bash
cd Guess-The-Number
```
3. Run the desired version of the game:

- **User Guess Mode:**
```bash
python user_guess.py
```

- **System Guess Mode:**
```bash
python system_guess.py
```

---

## 🔧 Technologies Used
- **Programming Language:** Python

---

## 📋 License
This project is licensed under the MIT License.