Learn How to Build a Number Guessing Game in Python: Absolute Beginners Tutorial

The number guessing game is one of the best first projects you can write in Python. It is short enough to finish in a single sitting, but it forces you to use loops, conditionals, user input, and the standard library all at once — the exact skills that show up in every real Python program.

Python's random module picks a secret number. A while loop keeps asking the player for guesses. An if/elif/else block gives higher/lower feedback after each guess. When the player lands on the right number, the loop ends and Python prints the result. That is the whole game in four sentences — and by the time you finish this tutorial, you will have written every line of it from scratch.

What the Game Does

Before writing code, it helps to know exactly what you are building. The higher/lower number guessing game works like this: Python secretly picks a random integer between 1 and 100. The player types a number. Python responds with "Too high," "Too low," or "Correct!" If the player guesses correctly, the game prints how many attempts it took and exits.

Here is what the complete finished game looks like when a player runs it:

Guess a number between 1 and 100: 50
Too high!
Guess a number between 1 and 100: 25
Too low!
Guess a number between 1 and 100: 37
Too high!
Guess a number between 1 and 100: 31
Correct! You got it in 4 attempts.

The Tools You Need

The game uses three Python features. You do not need to install anything extra — all three come with every standard Python installation.

Building the Game Step by Step

The full game is built piece by piece below. Each code block builds on the last. By the end of this section you will have a complete, working program.

Step 1 — Import and generate the secret number

The first two lines set everything up. import random loads Python's random number module. random.randint(1, 100) picks a whole number anywhere from 1 to 100, inclusive, and stores it in secret. The player never sees this value.

import random

secret = random.randint(1, 100)

Step 2 — Set up the game loop

Before the loop starts, two variables are initialised. attempts tracks how many guesses the player has made. guess is set to None so the while condition is true from the very first iteration. The loop runs as long as guess does not equal secret.

import random

secret = random.randint(1, 100)
attempts = 0
guess = None

while guess != secret:
    # game logic goes here
    pass

Step 3 — Read the player's guess

Inside the loop, increment attempts, then read a guess from the player. The int() wrapper is required: input() returns a string, and you cannot compare a string to an integer using > or < in Python 3.

while guess != secret:
    attempts += 1
    guess = int(input("Guess a number between 1 and 100: "))

Step 4 — Give higher/lower feedback

Immediately after reading the guess, an if/elif/else block evaluates it against the secret number and prints the appropriate hint. The else branch is never reached during normal game flow — it would only run if guess == secret, but in that case the loop condition becomes false and execution falls through to the win message anyway. The branch is included here for clarity and can be removed in the final version.

    if guess > secret:
        print("Too high!")
    elif guess < secret:
        print("Too low!")

Step 5 — Print the win message and the complete game

After the while loop exits, the player has guessed correctly. One print() call using an f-string tells them how many attempts it took. Here is the entire game in one block:

import random

secret = random.randint(1, 100)
attempts = 0
guess = None

while guess != secret:
    attempts += 1
    guess = int(input("Guess a number between 1 and 100: "))

    if guess > secret:
        print("Too high!")
    elif guess < secret:
        print("Too low!")

print(f"Correct! You got it in {attempts} attempts.")

"Simple is better than complex." — The Zen of Python (PEP 20)

Python Learning Summary Points

1. The while loop is the right tool whenever the number of iterations is not known in advance. The game could end on guess 1 or guess 50 — the loop handles both without any changes to the code.
2. input() always returns a string. Any time you need to do arithmetic or comparisons on user-provided values, you must convert them first with int(), float(), or another conversion function.
3. The random module is part of Python's standard library. You do not install it — you only import it. Understanding how to use standard library modules is a core Python skill that scales directly into larger projects.
4. f-strings (introduced in Python 3.6) are the preferred way to embed variable values inside strings. The pattern f"You took {attempts} attempts" is cleaner and faster than older string formatting approaches.
5. A well-defined game loop — initialise state, check a condition, update state, repeat — is a pattern that appears far beyond games. It shows up in data processing pipelines, network polling, and any other situation that requires repeated actions until a goal is reached.

The version above is intentionally minimal so the core mechanics are easy to read. When you are ready to extend it, consider adding a maximum attempt limit (use a separate counter with an or condition in the while), wrapping the int(input(...)) call in a try/except ValueError block to handle non-numeric input gracefully, or letting the player choose a difficulty level that adjusts the range from 1–100 to something larger.