Python Errors on Python Beginner Help

AssertionError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

AssertionError in Python: Causes and Fixes

AssertionError happens when an assert statement checks a condition and that condition is False.

This error usually means your program reached a state that the code assumed should never happen. It is common in debugging, tests, and code that checks important assumptions.

Quick fix #

age = 20
assert age >= 18

name = ""
assert name, "name must not be empty"

AssertionError happens when an assert condition is False. To fix it:

AttributeError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError in Python: Causes and Fixes

AttributeError happens when Python cannot find an attribute or method on an object.

This usually means one of these is true:

You used a method on the wrong type of value
You misspelled the attribute name
Your variable is None
The variable changed to a different type earlier in the code

A common example is trying to use .split() on a list instead of a string.

AttributeError: 'int' object has no attribute (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError: `'int'` object has no attribute (Fix)

Fix the error AttributeError: 'int' object has no attribute by finding where a number is being used like a string, list, dictionary, or custom object.

This usually means a variable contains an int, but your code is trying to use a method or attribute that belongs to some other type.

Quick fix #

value = 123

# Wrong: integers do not have string methods
# print(value.lower())

# Fix 1: convert to string first
print(str(value).lower())

# Fix 2: check the type before calling an attribute
if isinstance(value, str):
 print(value.lower())
else:
 print(value)

This error happens when you call a method or access an attribute that integers do not have, such as .lower(), .append(), .keys(), or a custom attribute name.

AttributeError: 'list' object has no attribute (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError: `'list' object has no attribute` (Fix)

This error happens when Python sees a list, but your code tries to use a method or attribute that lists do not have.

A common example is using a string method like lower() on a list:

my_list = ["A", "B", "C"]
my_list.lower()

That fails because lower() works on strings, not on lists.

Quick fix #

my_list = ["a", "b", "c"]

# Wrong: lists do not have string methods like lower()
# my_list.lower()

# Fix 1: use a list method
my_list.append("d")

# Fix 2: apply the string method to each item
lowered = [item.lower() for item in my_list]
print(lowered)

Output:

AttributeError: 'NoneType' object has no attribute (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError: `'NoneType' object has no attribute` (Fix)

This error happens when you try to use an attribute or method on None.

In Python, None means “no value”. So if a variable is None, you cannot call methods like .strip(), .append(), .get(), or access attributes on it.

The fix is usually simple:

find where None came from
make sure you have the right object before using it
add a check or default value if None is possible

Quick fix #

name = get_name()

if name is not None:
 print(name.strip())
else:
 print("No name returned")

This error happens when you try to use a method or attribute on None. Check the variable before calling methods like .strip(), .append(), or .get().

AttributeError: 'str' object has no attribute (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError: `'str' object has no attribute` (Fix)

This error happens when your variable is a string, but your code uses a method or attribute that does not belong to Python strings.

In simple terms, Python is telling you:

“This value is text”
“The thing after the dot does not exist on text”

This often happens when you expected a list, dictionary, or custom object, but the variable is actually a string.

AttributeError: module has no attribute (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError: module has no attribute (Fix)

Fix the error AttributeError: module has no attribute by checking what module Python imported, whether the attribute name is correct, and whether your own file name is hiding the real module.

Quick fix #

import math
print(math.sqrt(9))

# Check what names the module actually has
print(dir(math))

If the attribute is missing, check:

the spelling
your import statement
whether you named your own file the same as the module

What this error means #

This error means:

AttributeError: object has no attribute (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

AttributeError: object has no attribute (Fix)

This error happens when Python finds the object before the dot, but cannot find the attribute or method after the dot.

In simple terms:

The variable exists
But that kind of object does not have the thing you tried to use

For example, a list has append(), but an integer does not. A string has upper(), but a list does not.

If you are not sure what value you actually have, start by checking its type with type().

Common Python Errors Explained (Beginner Guide)

Tue, 09 Jun 2026 00:00:00 +0000

Common Python Errors Explained (Beginner Guide)

Python error messages can look confusing at first. This page gives you a simple map of the errors beginners see most often.

You will learn:

what common error types usually mean
how to read a traceback
how to tell syntax, type, value, name, index, and file errors apart
which specific error page to open next

This is an overview page. It is meant to help you identify the error category quickly, not replace detailed fix guides for each exact error.

FileNotFoundError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

FileNotFoundError in Python: Causes and Fixes

FileNotFoundError means Python could not find the file or folder you asked it to use.

This error often appears when you use open(), os.rename(), os.remove(), or other file operations. In most cases, the problem is not Python itself. The problem is the path.

A very common beginner mistake is thinking Python looks for files in the same folder as the script. Sometimes it does, but often Python uses the current working directory instead.

FileNotFoundError vs PermissionError Explained

Tue, 09 Jun 2026 00:00:00 +0000

FileNotFoundError vs PermissionError Explained

These two Python errors look similar because both happen when you work with files or folders.

But they mean different things:

FileNotFoundError means Python cannot find the path you gave.
PermissionError means Python found the path, but it is not allowed to access it.

This page helps you tell them apart quickly, understand why each one happens, and choose the right fix.

Quick fix #

Use this pattern to separate a missing file problem from a permission problem:

FileNotFoundError: [Errno 2] No such file or directory (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

FileNotFoundError: [Errno 2] No such file or directory (Fix)

FileNotFoundError: [Errno 2] No such file or directory means Python could not find the file or folder path you gave it.

This error is very common when working with open(), os, or pathlib. In most cases, the problem is one of these:

The file name is wrong
The file is in a different folder
The path is relative, but Python is running from a different working directory
A folder in the path does not exist

If you want a fast way to check the path before opening the file, use this:

ImportError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

ImportError in Python: Causes and Fixes

ImportError means Python could not complete an import statement.

This usually happens because:

the module is missing
the name you are trying to import does not exist
Python is using the wrong environment
your project files are named or arranged in a way that breaks imports

Beginners often mix up ImportError and ModuleNotFoundError.

ModuleNotFoundError is more specific
ImportError is broader
Python may find the module, but still fail to import something from it

This page helps you check the most common causes step by step.

ImportError: cannot import name (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ImportError: cannot import name (Fix)

If you see the Python error ImportError: cannot import name ..., Python was able to find the module, but it could not find the specific function, class, or variable you asked for.

This usually happens because:

the name is spelled wrong
you imported from the wrong module
the name is not available at the top level
there is a circular import
a local file is conflicting with a real module

This guide shows how to find the cause and fix it.

ImportError: No module named X (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ImportError: No module named X (Fix)

This error happens when Python tries to import a module but cannot find it.

In many cases, the fix is simple:

The package is not installed
It was installed in the wrong Python environment
The import name is wrong
Your own file name is blocking the real module

Start with the fastest checks first. That usually solves the problem quickly.

Quick fix #

python -m pip install package_name

Use the same Python interpreter that runs your script. Replace package_name with the real package name.

IndentationError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

IndentationError in Python: Causes and Fixes

Fix IndentationError by understanding what the error means, why Python requires indentation, and how to correct common spacing mistakes in your code.

Quick fix #

if True:
 print("Correct indentation")

for i in range(3):
 print(i)

def greet():
 print("Hello")

After a line that ends with a colon (:), indent the next block consistently. Use the same indentation style throughout the file.

What this error means #

Python uses indentation to define code blocks.

IndentationError: expected an indented block (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

IndentationError: expected an indented block (Fix)

Python shows IndentationError: expected an indented block when it reaches a line that should contain a code block, but the next line is not indented.

This usually happens after lines like if, for, while, def, class, try, or else.

Quick fix #

if True:
 print("This line is indented correctly")

Python expects an indented block after lines like if, for, while, def, class, try, and else. Add indentation, usually 4 spaces.

IndentationError: unexpected indent (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

IndentationError: unexpected indent (Fix)

IndentationError: unexpected indent means Python found spaces or tabs at the start of a line where it was not expecting a new block.

This usually happens when:

a top-level line starts with extra spaces
a line is indented even though the line above it did not start a block
copied code contains hidden tabs or spaces

The good news is that this error is usually fast to fix. Python often points to the exact line that caused the problem.

IndentationError: unindent does not match any outer indentation level (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

IndentationError: unindent does not match any outer indentation level (Fix)

Fix the Python error IndentationError: unindent does not match any outer indentation level. This error usually means one line is indented differently from the surrounding block. On this page, you will learn what the error means, why it happens, how to find the bad indentation, and how to fix it.

Quick fix #

Use one indentation style consistently. For most beginners, the safest choice is 4 spaces per indentation level. Do not mix tabs and spaces.

IndexError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

IndexError in Python: Causes and Fixes

IndexError means your code tried to use a position that does not exist in a sequence.

This usually happens with:

lists
tuples
strings

In Python, indexing starts at 0, not 1.

So if a list has 3 items, the valid indexes are:

If you try to access index 3, Python raises an IndexError.

Quick fix #

If you are not sure whether an index exists, check it before using it:

IndexError: list index out of range (Fix Explained)

Tue, 09 Jun 2026 00:00:00 +0000

IndexError: list index out of range (Fix Explained)

IndexError: list index out of range means your code is trying to read a list position that does not exist.

This usually happens when:

the index is too large
the list is empty
a loop goes one step too far
you expect more items than are really in the list

The good news is that this error is usually easy to fix. In most cases, you need to check the list length with len() or use a safer looping pattern.

IndexError: tuple index out of range (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

IndexError: tuple index out of range (Fix)

IndexError: tuple index out of range means your code is trying to read a tuple position that does not exist.

This usually happens when you use an index that is too large, or when you forget that Python indexes start at 0.

Quick fix #

colors = ("red", "green", "blue")

# Wrong: colors[3] # IndexError

# Correct: use a valid index
print(colors[2])

# Or check length first
index = 3
if index < len(colors):
 print(colors[index])
else:
 print("Index out of range")

Tuple indexes start at 0. A tuple with 3 items has valid indexes 0, 1, and 2.

IsADirectoryError: [Errno 21] Is a directory (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

IsADirectoryError: [Errno 21] Is a directory (Fix)

IsADirectoryError: [Errno 21] Is a directory happens when your Python code tries to open, read, write, or otherwise use a folder path where Python expects a file path.

This is a common beginner error when working with open(), file paths, or folder loops. The fix is usually simple: check the path, confirm whether it points to a file or a directory, and use the right operation for that path.

KeyboardInterrupt Exception in Python Explained

Tue, 09 Jun 2026 00:00:00 +0000

KeyboardInterrupt Exception in Python Explained

KeyboardInterrupt is a Python exception that happens when you stop a running program from the keyboard. In most cases, this means you pressed Ctrl+C in the terminal.

This page explains what KeyboardInterrupt means, when it appears, and how to handle it safely. It is usually not a bug in your code. Instead, it means the program was interrupted by the user.

Quick fix #

If you want your program to stop cleanly when the user presses Ctrl+C, wrap the code in a try-except block:

KeyError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

KeyError in Python: Causes and Fixes

A KeyError in Python usually happens when you try to read a dictionary value using a key that does not exist.

This error is very common when working with dictionaries, JSON data, and API responses. The good news is that it is usually easy to fix once you know why it happens.

Quick fix #

data = {"name": "Ana"}

# Safe access
print(data.get("age")) # None
print(data.get("age", 0)) # 0

# Check before access
if "age" in data:
 print(data["age"])
else:
 print("Key not found")

Use dict.get() when a key may be missing, or check with in before using square brackets.

KeyError vs IndexError in Python Explained

Tue, 09 Jun 2026 00:00:00 +0000

KeyError vs IndexError in Python Explained

KeyError and IndexError both happen when your code tries to access something that is not available.

The difference is simple:

KeyError is about a missing dictionary key
IndexError is about a list or tuple position that does not exist

If you can quickly tell whether you are working with a dictionary or a sequence like a list, you can usually fix the problem fast.

KeyError when accessing dictionary values (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

KeyError when accessing dictionary values (Fix)

A KeyError happens when you try to access a dictionary value using a key that does not exist.

This usually happens with square bracket access like data["age"]. If the key is missing, Python stops and raises an error.

This page shows what the error means, why it happens, and how to fix it safely.

Quick fix #

data = {"name": "Ana"}

# Safe access
value = data.get("age")
print(value) # None

# Or check first
if "age" in data:
 print(data["age"])
else:
 print("Key not found")

Use dict.get() when a key might be missing, or check with in before using square brackets.

KeyError: key not found in dictionary (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

KeyError: key not found in dictionary (Fix)

A KeyError happens when you try to read a dictionary key that is not there.

This usually happens when you use square brackets, like data["age"], but the dictionary does not contain "age". Python raises an error because dictionary keys must match exactly.

This guide shows what the error means, why it happens, and simple ways to fix it.

Quick fix #

data = {"name": "Sam"}

# Safe access
value = data.get("age")
print(value) # None

# Or check first
if "age" in data:
 print(data["age"])
else:
 print("Key not found")

Use dict.get() when a key might be missing, or check with in before using square brackets.

KeyError: popitem(): dictionary is empty (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

KeyError: popitem(): dictionary is empty (Fix)

Fix the Python error "KeyError: popitem(): dictionary is empty". This error happens when you call popitem() on a dictionary that has no items left.

This page explains what the error means, shows a small example that causes it, and gives simple ways to avoid it.

Quick fix #

Check that the dictionary is not empty before calling popitem():

data = {}

if data:
 key, value = data.popitem()
else:
 print("Dictionary is empty")

An empty dictionary is False, so if data: is a simple way to avoid this error.

MemoryError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

MemoryError in Python: Causes and Fixes

MemoryError means Python tried to create or grow an object, but there was not enough memory available.

This usually happens when a program creates very large lists, strings, dictionaries, or reads too much data into memory at once. The fix is often not just “use more RAM.” In many cases, the better solution is to change how the program handles data.

Quick fix #

A common fix is to avoid creating very large lists when you only need to loop through values.

ModuleNotFoundError: No module named X (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ModuleNotFoundError: No module named X (Fix)

ModuleNotFoundError: No module named 'X' means Python tried to import a module but could not find it.

This usually happens because:

the package is not installed
it is installed in the wrong Python environment
the import name is wrong
a local file is hiding the real package

This guide helps you find the cause quickly and fix it step by step.

Quick fix #

python -m pip install requests

Replace requests with the missing module name.

NameError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

NameError in Python: Causes and Fixes

A NameError in Python means you used a name that Python cannot find.

That name might be:

A variable
A function
A class
An imported module

This error is common for beginners because Python only knows names that were already created, assigned, or imported. If the name does not exist in the current scope, Python raises NameError.

Quick fix #

x = 10
print(x)

A NameError happens when Python sees a variable, function, or module name that does not exist in the current scope.

NameError: global name not defined (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

NameError: global name not defined (Fix)

Fix the Python error “NameError: global name not defined” by finding the missing or misspelled name and making sure it exists before you use it.

Quick fix #

message = "Hello"
print(message)

A NameError happens when Python cannot find a variable, function, or module name. Define it first, spell it correctly, and use the right scope.

What this error means #

Python raises this error when it tries to use a name that does not exist in the current scope.

NameError: name is not defined (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

NameError: name is not defined (Fix)

Fix the Python error NameError: name is not defined. This page explains what the error means, why it happens, and the most common ways to correct it.

Quick fix #

user_name = "Sam"
print(user_name)

This error happens when Python sees a name that has not been created yet, is misspelled, or is outside the current scope.

What this error means #

NameError means Python found a variable, function, or module name it does not know.

NotADirectoryError: [Errno 20] Not a directory (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

NotADirectoryError: [Errno 20] Not a directory (Fix)

NotADirectoryError: [Errno 20] Not a directory happens when Python expects a folder path, but your code gives it a file path instead.

This usually appears with functions like os.listdir(), os.chdir(), and os.scandir(). These functions work with directories, not files.

Quick fix #

Use os.path.isdir() before calling a function that expects a directory:

import os

path = "notes.txt"

if os.path.isdir(path):
 print(os.listdir(path))
else:
 print("This path is not a directory:", path)

What this does:

OSError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

OSError in Python: Causes and Fixes

OSError is a general Python error for operating system related problems.

You will often see it when your code works with:

files
folders
paths
permissions

For beginners, the most important thing to know is this:

OSError usually means something is wrong with the path, file, folder, or access
the error message after OSError usually tells you what the real problem is

A quick way to start debugging is to check whether the path actually exists before using it.

OverflowError: numerical result out of range (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

OverflowError: numerical result out of range (Fix)

OverflowError: numerical result out of range means a calculation produced a number that is too large for Python to handle in that specific operation.

This error is common with floating-point math and functions from the math module. It is less common with normal Python integers.

If you are trying to fix it quickly, start by checking whether your input has become extremely large before the failing calculation.

PermissionError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

PermissionError in Python: Causes and Fixes

PermissionError means Python tried to access a file or folder, but your user account was not allowed to do it.

This usually happens when you:

open a protected file
write to a restricted folder
try to rename or delete something you do not control
pass a folder path to open() by mistake
use a file that another program is already using

A common message looks like this:

PermissionError: [Errno 13] Permission denied (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

PermissionError: [Errno 13] Permission denied (Fix)

PermissionError: [Errno 13] Permission denied means Python asked the operating system to access a file, folder, or other resource, but the operating system refused.

This usually happens when:

your program does not have permission to read or write something
the path points to a folder instead of a file
you are trying to save in a protected location
another program is locking the file

The good news is that this error is often easy to fix once you check the path, file type, and location.

RecursionError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

RecursionError in Python: Causes and Fixes

RecursionError happens when a function keeps calling itself too many times.

In Python, recursion means a function calls itself to solve a smaller version of the same problem. This can be useful, but the function must have a clear way to stop. If it never stops, or if it goes too deep, Python raises RecursionError.

Quick fix #

def countdown(n):
 if n <= 0: # base case
 return
 print(n)
 countdown(n - 1)

countdown(5)

Output:

RecursionError: maximum recursion depth exceeded (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

RecursionError: maximum recursion depth exceeded (Fix)

RecursionError: maximum recursion depth exceeded means Python stopped your program because a function called itself too many times.

This usually happens with recursive functions. A recursive function is a function that calls itself. Python allows recursion, but it also has a safety limit so your program does not keep running forever and using too much memory.

If you want the quick fix first: check that your function has a base case, and make sure every recursive call moves toward that stopping point.

RuntimeError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

RuntimeError in Python: Causes and Fixes

RuntimeError is a general Python exception that happens while your program is running.

For beginners, this error can feel vague because the name does not tell you exactly what went wrong. The important clue is usually the message after RuntimeError and the traceback line that points to the problem.

This guide explains what RuntimeError means, why it happens, and how to debug it using simple real examples.

StopIteration Exception in Python Explained

Tue, 09 Jun 2026 00:00:00 +0000

StopIteration Exception in Python Explained

StopIteration happens when an iterator has no more values to return.

This does not always mean something is broken. In Python, StopIteration is a normal signal used to say, “there are no more items.”

Beginners usually see it when:

calling next() too many times
using a while True loop with an iterator
reusing an iterator that is already finished
raising StopIteration manually inside a generator

If you use a for loop, Python usually handles this for you automatically. The exception becomes visible when you call next() yourself and do not handle the end of the iterator.

SyntaxError: EOL while scanning string literal (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

SyntaxError: EOL while scanning string literal (Fix)

This error means Python found the start of a string, but never found the end of it.

In simple terms, you opened a string with a quote, but the closing quote is missing or incorrect. Because this is a syntax error, your code will not run until you fix it.

Quick fix #

name = "Alice"
print(name)

message = 'Hello world'
print(message)

This error usually happens when a string starts with a quote but does not end with the matching quote on the same line.

SyntaxError: indentation error (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

SyntaxError: indentation error (Fix)

This page helps beginners fix Python indentation-related syntax errors. It explains what the error means, why it happens, how to find the problem line, and how to correct it safely.

Quick fix #

if True:
 print("Correctly indented")

Python uses indentation to define code blocks. After a line ending with a colon, indent the next line consistently.

What this error means #

Python uses indentation to show which lines belong inside a block of code.

SyntaxError: invalid character in identifier (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

SyntaxError: invalid character in identifier (Fix)

SyntaxError: invalid character in identifier means Python found a character in your code that does not belong there.

This usually happens when code contains a character that looks normal but is not the normal Python version. Common examples include curly quotes, an em dash, or a hidden Unicode symbol copied from a website, PDF, or document.

This page shows what the error means, what causes it, how to find the bad character, and how to fix it.

SyntaxError: invalid syntax (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

SyntaxError: invalid syntax (Fix)

SyntaxError: invalid syntax means Python could not understand part of your code.

This is one of the most common beginner errors. It usually happens because something is missing, extra, or written in the wrong form.

The tricky part is this: Python often points to the place where it noticed the problem, not the place where the mistake actually started. That is why you should always check the highlighted line and the line just before it.

SyntaxError: missing colon (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

SyntaxError: missing colon (Fix)

Fix the Python error SyntaxError: missing colon. This page helps beginners find where the colon is missing, understand why Python needs it, and correct the code quickly.

Quick fix #

Add a colon at the end of lines that start a block, such as if, elif, else, for, while, def, class, try, except, finally, with, and match/case.

if age > 18:
 print("Adult")

for item in [1, 2, 3]:
 print(item)

def greet(name):
 print("Hello", name)

class Person:
 pass

If you add the colon, also make sure the next line is indented.

SyntaxError: unexpected EOF while parsing (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

SyntaxError: unexpected EOF while parsing (Fix)

SyntaxError: unexpected EOF while parsing means Python reached the end of your file before the code was complete.

This usually happens when something is missing, such as:

a closing quote
a closing parenthesis
a closing bracket
a closing brace
the rest of an unfinished statement

This page will help you find the missing part, fix the syntax, and understand why Python shows this error.

TypeError vs ValueError in Python Explained

Tue, 09 Jun 2026 00:00:00 +0000

TypeError vs ValueError in Python Explained

TypeError and ValueError are two common Python errors that beginners often mix up.

This page explains when Python raises TypeError and when it raises ValueError. It will help you tell them apart, read error messages more clearly, and choose the right fix.

Quick answer #

try:
 number = int(user_input)
except TypeError:
 print("Wrong type was passed")
except ValueError:
 print("Right type function, but bad value")

Use TypeError when the kind of object is wrong.

TypeError: 'bool' object is not iterable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'bool' object is not iterable` (Fix)

This error happens when Python expects something it can loop over, unpack, or check membership in, but gets True or False instead.

A boolean is only a single value:

True
False

It is not a collection like a list, string, tuple, set, or dictionary.

This guide shows what the error means, why it happens, and how to fix it based on what your variable should actually contain.

TypeError: 'dict' object is not callable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'dict' object is not callable` (Fix)

Fix the Python error TypeError: 'dict' object is not callable. This page explains what the error means, the most common causes, and how to correct your code with simple examples.

Quick fix #

This error often happens when you use parentheses () with a dictionary. Use square brackets [] to access a value by key.

my_dict = {'a': 1}

# Wrong
# value = my_dict('a')

# Correct
value = my_dict['a']
print(value)

Output:

TypeError: 'float' object cannot be interpreted as an integer (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'float' object cannot be interpreted as an integer` (Fix)

Fix the Python error TypeError: 'float' object cannot be interpreted as an integer. This error happens when Python needs a whole number, but your code gives it a float instead.

This page shows what the error means, where beginners usually see it, and the safest ways to fix it.

Quick fix #

count = 5.0

for i in range(int(count)):
 print(i)

Output:

TypeError: 'function' object is not iterable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'function' object is not iterable` (Fix)

Fix the Python error TypeError: 'function' object is not iterable. This error usually means Python expected something it could loop over, but you gave it a function itself instead of the value returned by that function.

In most cases, the fix is simple: call the function with parentheses.

Quick fix #

def get_numbers():
 return [1, 2, 3]

for n in get_numbers():
 print(n)

This error often happens when you loop over a function name instead of the value returned by the function. Add parentheses if you meant to call the function.

TypeError: 'int' object is not iterable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'int' object is not iterable` (Fix)

Fix the Python error TypeError: 'int' object is not iterable. This page explains what the error means, why it happens, and the most common ways to correct your code.

Quick fix #

number = 5

# Wrong
for item in number:
 print(item)

# Right: loop over a range
for item in range(number):
 print(item)

An integer is a single number, not a collection. If you want to loop a certain number of times, use range(). If you meant to loop over values, make sure the variable is a list, tuple, string, or another iterable.

TypeError: 'list' object is not callable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'list' object is not callable` (Fix)

Fix the Python error TypeError: 'list' object is not callable. This page shows what the error means, the most common causes, and simple ways to correct your code.

Quick fix #

numbers = [1, 2, 3]
print(numbers[0]) # correct: use square brackets for indexing

# not numbers(0)

This error usually happens when you use round brackets () on a list, or when you overwrite a built-in function name like list.

TypeError: 'module' object is not callable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'module' object is not callable` (Fix)

This error happens when Python sees a module where it expected something it can call with parentheses.

Beginners often run into this after writing code like math(16) or json(text). The problem is that math and json are modules. They contain functions and classes, but the module itself is not a function.

Quick fix #

import math

# Wrong:
# result = math(16)

# Right:
result = math.sqrt(16)
print(result)

Output:

TypeError: 'NoneType' object is not iterable (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'NoneType' object is not iterable` (Fix)

Fix the Python error TypeError: 'NoneType' object is not iterable. This page explains what it means, why it happens, how to find where None came from, and simple ways to fix it.

Quick fix #

items = get_items()

if items is None:
 items = []

for item in items:
 print(item)

Use this only when an empty list makes sense. The real fix is to find out why the value is None.

TypeError: 'str' object cannot be interpreted as an integer (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: `'str' object cannot be interpreted as an integer` (Fix)

Fix the Python error TypeError: 'str' object cannot be interpreted as an integer. This page explains what the error means, common causes, and the fastest ways to correct your code.

Quick fix #

text = "5"
number = int(text)

for i in range(number):
 print(i)

This error happens when Python expects an integer, but you give it a string instead. Convert the string first if it contains a number.

TypeError: can only concatenate str (not "int") to str (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: can only concatenate str (not “int”) to str (Fix)

This error happens when Python tries to join a string and an integer with +.

In Python, + can join strings only when both values are strings. If one value is text and the other is a number, Python raises a TypeError.

Quick fix #

name = "Age: "
age = 25
print(name + str(age))

# or
print(f"Age: {age}")

Convert the integer to a string before concatenation, or use an f-string for cleaner output.

TypeError: cannot unpack non-iterable object (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: cannot unpack non-iterable object (Fix)

This error happens when Python tries to split one value into multiple variables, but that value is not something Python can unpack.

For example, Python can unpack a tuple like (1, 2) into a and b. But it cannot unpack a single integer like 5.

Quick fix #

value = 5
# Wrong:
# a, b = value

# Fix 1: assign to one variable
number = value

# Fix 2: unpack an actual iterable
pair = (1, 2)
a, b = pair
print(a, b)

Output:

TypeError: list indices must be integers or slices (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: list indices must be integers or slices (Fix)

Fix the Python error TypeError: list indices must be integers or slices, not .... This error happens when you try to access a list with the wrong kind of value inside square brackets.

This page explains:

what the error means
why it happens
the most common ways to fix it
how to debug it quickly

Quick fix #

numbers = [10, 20, 30]
index = 1
print(numbers[index])

# If the index comes from input, convert it first:
user_index = int(input("Enter index: "))
print(numbers[user_index])

List positions must be integers like 0 or 1, or slices like [1:3]. Strings, floats, and other lists cannot be used as list indices.

TypeError: missing required positional argument (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: missing required positional argument (Fix)

This error happens when Python expects an argument, but your code does not provide it.

It usually appears when you call a function or method with too few values. The message often tells you exactly which parameter is missing.

Quick fix #

def greet(name):
 print("Hello", name)

greet("Sam") # pass the required argument

If a function expects one or more required positional arguments, you must provide them when calling it unless the function defines default values.

TypeError: sequence item 0 expected str instance (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: sequence item 0 expected str instance (Fix)

This error usually appears when you use str.join() on a list or other sequence that contains at least one non-string value.

join() only works with strings. If your data contains integers, None, floats, booleans, or other types, Python raises a TypeError.

The good news is that this is usually easy to fix:

find the non-string values
convert them to strings
or remove values that should not be joined

Quick fix #

items = ["a", 1, "b"]
result = " ".join(map(str, items))
print(result)

Output:

TypeError: unexpected keyword argument (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

TypeError: unexpected keyword argument (Fix)

This error happens when you call a function, method, or class constructor with a keyword name that it does not accept.

In Python, a keyword argument is a named argument like name="Sam". If the function expects name but you pass username, Python raises a TypeError.

The good news is that this is usually easy to fix:

Use the exact parameter name the function expects
Or pass the value without a keyword if positional arguments are allowed
Or update your own function definition if needed

Quick fix #

def greet(name):
 print("Hello", name)

greet(name="Sam") # works
# greet(username="Sam") # TypeError: unexpected keyword argument 'username'

Use the exact parameter name from the function definition or documentation.

UnboundLocalError vs NameError Explained

Tue, 09 Jun 2026 00:00:00 +0000

UnboundLocalError vs NameError Explained

UnboundLocalError and NameError can look very similar at first.

Both happen when Python has a problem with a variable name. But they do not mean the same thing.

This page helps you quickly tell the difference:

NameError means Python cannot find the name at all
UnboundLocalError means Python treats the name as a local variable, but you used it before it got a value

If you are new to Python variables and scope, this difference can be confusing. The examples below show exactly what each error means and how to fix it.

UnboundLocalError: local variable referenced before assignment (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

UnboundLocalError: local variable referenced before assignment (Fix)

Fix the Python error UnboundLocalError: local variable referenced before assignment. This page explains what the error means, why Python raises it inside functions, and the safest ways to fix it.

Quick fix #

count = 10

def show_count():
 print(count) # works because we only read the global value

show_count()

If you assign to a variable anywhere inside a function, Python treats it as local in that function. Use a parameter, return value, or global/nonlocal only when appropriate.

UnicodeDecodeError: 'utf-8' codec can't decode byte (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

UnicodeDecodeError: `'utf-8' codec can't decode byte` (Fix)

If you see a Python error like this:

UnicodeDecodeError: 'utf-8' codec can't decode byte ...

Python is trying to read data as UTF-8 text, but the bytes do not match valid UTF-8.

This usually happens when:

you open a text file with the wrong encoding
a CSV file came from Excel or another Windows program
you decode bytes from a file, download, or API using the wrong encoding
the file is actually binary, not text

In most cases, the fix is to open the file with the correct encoding instead of relying on the default.

UnicodeEncodeError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

UnicodeEncodeError in Python: Causes and Fixes

UnicodeEncodeError happens when Python tries to convert text into bytes, but the target encoding cannot represent one or more characters.

This often appears when:

writing text to a file
printing text to a terminal
sending text to another system
calling .encode() with the wrong encoding

For beginners, the fastest fix is usually to use UTF-8 explicitly.

Quick fix #

text = "café ☕"

with open("output.txt", "w", encoding="utf-8") as file:
 file.write(text)

Most fixes start by using UTF-8 explicitly. The error often happens when Python uses a narrower encoding like ascii or cp1252.

ValueError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

ValueError in Python: Causes and Fixes

ValueError is a common Python error for beginners.

It means a function received a value of the correct type, but the actual content of that value is not valid for the operation.

For example, int() can convert strings to integers. But if the string does not contain a valid whole number, Python raises ValueError.

Quick fix #

text = "abc"

try:
 number = int(text)
except ValueError:
 print("Input must be a valid number")

Use try-except when a value might have the right type but the wrong content, such as converting non-numeric text with int().

ValueError when parsing input in Python (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError when parsing input in Python (Fix)

ValueError often happens when your program reads text with input() and then tries to convert that text into a number.

This usually affects code that uses int() or float(). For example, the user might type letters instead of digits, leave the input blank, or enter a decimal when your code expects a whole number.

This page shows:

what the error means
how to reproduce it
simple ways to fix it
how to prevent it in beginner-friendly code

Quick fix #

user_text = input("Enter a number: ").strip()

try:
 number = int(user_text)
 print("You entered:", number)
except ValueError:
 print("Please enter a whole number only.")

Use try-except when converting input with int() or float(). strip() also helps remove accidental spaces.

ValueError: could not convert string to float (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: could not convert string to float (Fix)

This error happens when you call float() with text that is not a valid number.

It often appears when you read input from a user, a file, a CSV, or an API. The fix is usually to inspect the string, clean it if needed, and handle bad input safely.

Quick fix #

text = input("Enter a number: ").strip()
text = text.replace(",", "")

try:
 number = float(text)
 print(number)
except ValueError:
 print("Please enter a valid number, such as 3.14 or 10")

Use strip() to remove extra spaces, clean the input if needed, and catch ValueError when the text is not a valid decimal number.

ValueError: empty separator (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: empty separator (Fix)

This page helps beginners fix the Python error ValueError: empty separator. It explains why it happens, shows a small example that causes it, and gives simple ways to solve it.

Quick fix #

text = "apple,banana,orange"
parts = text.split(",") # use a real separator
print(parts)

words = "one two three".split() # no argument splits on whitespace
print(words)

Output:

['apple', 'banana', 'orange']
['one', 'two', 'three']

Do not pass an empty string to split(). Use a real separator like "," or leave the argument out to split on whitespace.

ValueError: invalid literal for int() with base 10 (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: invalid literal for int() with base 10 (Fix)

This error happens when Python tries to convert a value to an integer with int(), but the value does not look like a valid whole number.

This page shows:

what the error means
common examples that cause it
why it happens
simple ways to fix it safely

If you want a broader explanation of exceptions, see Python errors and exceptions explained.

Quick fix #

Use this when you expect a whole number from text input:

ValueError: math domain error (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: math domain error (Fix)

ValueError: math domain error happens when you pass a value to a function in Python’s math module that is outside the valid input range.

This usually happens with functions like:

math.sqrt()
math.log()
math.log10()
math.asin()
math.acos()

For example, math.sqrt(-1) fails because the math module expects a real number, and -1 is not a valid input for a real square root.

Quick fix #

import math

x = -1

if x >= 0:
 print(math.sqrt(x))
else:
 print("x must be 0 or greater")

This error happens when you pass a value that is outside the valid range for a math function, such as math.sqrt(-1) or math.log(0).

ValueError: not enough values to unpack (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: not enough values to unpack (Fix)

This error happens when Python tries to unpack values into multiple variables, but there are fewer values than expected.

A common message looks like this:

ValueError: not enough values to unpack (expected 2, got 1)

In this guide, you will learn what this means, why it happens, and how to fix it in common cases like lists, function returns, loops, and split().

Quick fix #

Make sure the number of variables matches the number of values.

ValueError: substring not found (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: substring not found (Fix)

ValueError: substring not found means Python could not find the piece of text you asked for inside a string.

This error usually appears when you use string methods like index() that expect a match. If the substring is missing, Python raises an error instead of returning a special value.

This page shows:

what the error means
why it happens
examples that cause it
simple ways to fix it

Quick fix #

If the substring may be missing, check first before calling index():

ValueError: too many values to unpack (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ValueError: too many values to unpack (Fix)

ValueError: too many values to unpack happens when Python tries to assign more values than your variables can hold.

This usually appears when:

you unpack a list or tuple into too few variables
a for loop expects the wrong number of values
a function returns more values than expected
split() gives you more parts than you planned for

The fix is usually simple: make the number of variables match the number of values, or use starred unpacking to collect extras.

ZeroDivisionError in Python: Causes and Fixes

Tue, 09 Jun 2026 00:00:00 +0000

ZeroDivisionError in Python: Causes and Fixes

ZeroDivisionError happens when Python tries to divide a number by 0.

This is a common beginner error. It usually means the value on the right side of /, //, or % became zero before the calculation ran.

In this guide, you will learn:

what ZeroDivisionError means
the common reasons it happens
how to prevent it
how to debug the value that became zero

Quick fix #

If the divisor might be 0, check it before dividing:

ZeroDivisionError: division by zero (Fix)

Tue, 09 Jun 2026 00:00:00 +0000

ZeroDivisionError: division by zero (Fix)

ZeroDivisionError: division by zero happens when Python tries to divide by 0.

This page shows what the error means, why it happens, and the simplest ways to prevent or handle it.

Quick fix #

Check the value before dividing. If zero is possible, handle that case first.

denominator = 0

if denominator != 0:
 result = 10 / denominator
 print(result)
else:
 print("Cannot divide by zero")

If the denominator is 0, the program avoids the division and prints a clear message instead.