Python GUI Calculator Using Tkinter – Beginner Project with Explanation

← Back to Projects

Python GUI Calculator

Visit BlogAdda.com to discover Indian blogs

About the project: This project is building a GUI version of calculator in python.

Project Level: Beginner

Project Overview

The Python GUI Calculator (Smart Version) is a beginner-friendly desktop application built using Python’s tkinter library. This project introduces learners to graphical user interface (GUI) programming, allowing them to move beyond command-line applications.

By building this calculator, learners understand how buttons, input fields, and events work together to create an interactive desktop application.


What You Will Learn From This Project

  • Basics of GUI programming using Python
  • How to use the tkinter library
  • Creating buttons, input fields, and layouts
  • Handling button click events
  • Performing mathematical operations programmatically
  • Building a complete desktop application

How the GUI Calculator Works

The calculator interface is created using the tkinter library. An input field at the top displays the current expression or result, while buttons allow the user to enter numbers and operators.

Each button press updates the input field dynamically. When the equals button is pressed, the calculator evaluates the mathematical expression and displays the result.

The clear button resets the calculator to its initial state, making the application easy and intuitive to use.


Sample Output

Below are screenshots showing how the GUI calculator looks and behaves when running. These examples confirm that the application works as expected.

Calculator Interface




Performing a Calculation


After pressing Equals(=) button





Clearing the Input



Visual output helps beginners understand how the application behaves and reassures them that their implementation is correct.

Application Workflow

  1. The application window is initialized using tkinter.
  2. The input display is created to show numbers and expressions.
  3. Buttons are arranged in a grid layout.
  4. User clicks are captured and processed.
  5. The result is calculated and displayed instantly.

You will be able to create a GUI calculator by following below steps.

You can directly copy the below snippet code with the help of green copy button, paste it and run it in any Python editor you have.

Steps: Follow these steps

Step 1: Copy below code using green 'copy' button.

Step 2: Paste the code on your chosen editor.

Step 3: Save the code with filename and .py extention.

Step 4: Run (Press F5 if using python IDLE)



import tkinter as tk

def press(num):
    current = entry.get()

    if current == "0":
        if num in "0123456789":
            entry.delete(0, tk.END)
            entry.insert(0, str(num))
        else:
            entry.insert(tk.END, str(num))
    else:
        last_char = current[-1]
        if last_char in "+-*/" and num == "0":
            entry.insert(tk.END, str(num))
        elif current[-2:] in ("+0", "-0", "*0", "/0") and num in "123456789":
            entry.delete(len(current)-1, tk.END)
            entry.insert(tk.END, str(num))
        else:
            entry.insert(tk.END, str(num))

def equal():
    expression = entry.get()
    if expression.strip() == "":
        entry.delete(0, tk.END)
        entry.insert(0, "Error")
        return
    try:
        result = eval(expression)
        if isinstance(result, float) and result.is_integer():
            result = int(result)
        entry.delete(0, tk.END)
        entry.insert(0, str(result))
    except Exception:
        entry.delete(0, tk.END)
        entry.insert(0, "Error")

def clear():
    entry.delete(0, tk.END)
    entry.insert(0, "0")

root = tk.Tk()
root.title("Smart Calculator")
root.geometry("360x450")
root.resizable(False, False)

entry = tk.Entry(root, font=("Arial", 24), bd=10, relief=tk.RIDGE, justify="right")
entry.grid(row=0, column=0, columnspan=4, sticky="nsew", padx=10, pady=10)
entry.insert(0, "0")

buttons = [
    ('7', 1, 0), ('8', 1, 1), ('9', 1, 2), ('/', 1, 3),
    ('4', 2, 0), ('5', 2, 1), ('6', 2, 2), ('*', 2, 3),
    ('1', 3, 0), ('2', 3, 1), ('3', 3, 2), ('-', 3, 3),
    ('0', 4, 0), ('.', 4, 1), ('=', 4, 2), ('+', 4, 3),
]

for (text, row, col) in buttons:
    if text == '=':
        btn = tk.Button(root, text=text, font=("Arial", 18), bg="#4CAF50", fg="white",
                        command=equal)
    else:
        btn = tk.Button(root, text=text, font=("Arial", 18),
                        command=lambda t=text: press(t))
    btn.grid(row=row, column=col, sticky="nsew", padx=5, pady=5)

clear_btn = tk.Button(root, text='C', font=("Arial", 18), bg="#f44336", fg="white", command=clear)
clear_btn.grid(row=5, column=0, columnspan=4, sticky="nsew", padx=10, pady=10)

for i in range(6):
    root.grid_rowconfigure(i, weight=1)
for i in range(4):
    root.grid_columnconfigure(i, weight=1)

root.mainloop()


Code Walkthrough

1. Importing Tkinter

The tkinter module is imported to create graphical components such as buttons and input fields.

2. Handling Button Press

The press() function manages user input and ensures valid expressions are formed when numbers or operators are clicked.

3. Evaluating the Expression

When the equals button is pressed, the equal() function evaluates the expression and displays the result safely.

4. Clearing the Input

The clear function resets the calculator to its default state, improving usability.

5. Creating the GUI Layout

Buttons and the display are placed using a grid layout to maintain a clean and responsive design.


Common Beginner Mistakes & How to Fix Them

  • Calculator not responding:
    This usually happens when button commands are not properly linked to functions. Always ensure the command parameter is correctly assigned.
  • Application crashes on '=' press:
    Invalid expressions can cause errors. Wrapping eval() inside a try-except block prevents crashes.
  • Buttons misaligned:
    Incorrect grid row or column values may break layout. Double-check grid positions and column spans.
  • Security concerns with eval():
    Using eval() blindly can be unsafe. For learning projects it is acceptable, but real-world apps should use safer parsing methods.

Real-World Applications

This project demonstrates concepts that are widely used in real desktop applications:

  • Desktop calculator applications
  • Point-of-sale (POS) systems
  • Educational tools for learning mathematics
  • Financial or accounting software interfaces

Improved Version: Better Error Handling

To make the calculator more user-friendly, you can display a clearer error message instead of just showing "Error". 


except Exception:
    entry.delete(0, tk.END)
    entry.insert(0, "Invalid Expression")

Small improvements like this greatly enhance user experience and make the application feel more professional.

Enhancement Ideas

  • Add keyboard input support
  • Include scientific calculator functions
  • Add calculation history
  • Improve UI using themes or colors
  • Convert it into an executable desktop app

Frequently Asked Questions

Is this project suitable for beginners?

Yes, this project is designed for beginners who want to learn GUI programming using Python.

Do I need to install any extra libraries?

No, tkinter comes pre-installed with most Python distributions.

Can I customize this calculator?

Yes, you can add new features or redesign the interface to enhance functionality.


Tested Environment

  • Python Version: Python 3.10+
  • Operating System: Windows 10 / Windows 11
  • GUI Library: Tkinter (Built-in)
  • Editor Used: VS Code / Python IDLE

Conclusion

The Python GUI Calculator (Smart Version) is an excellent project for learning how to build desktop applications using Python. It helps beginners understand event handling, GUI layouts, and user interaction.

Completing this project provides a strong foundation for building more advanced graphical applications in the future.


Next Project: Python Console To-Do List App


← Previous Next →