Importerror: cannot import name ‘iterable’ from ‘collections’

Are you encountering reads “ImportError: cannot import name ‘iterable’ from collections“?

This error means that the code is trying to import the “iterable” module from the “collections” package, but it cannot find it.

Obviously, there is a version mismatch between the Python version and the package being imported.

So in this article, we determined how to fix this error…

What is Importerror: cannot import name ‘iterable’ from ‘collections’?

The error “ImportError: cannot import name ‘iterable’ from ‘collections‘” means that there was an attempt to import the ‘iterable’ module from the ‘collections’ module in Python, but the interpreter was unable to find it.

Moreover, the error can occur if the version of Python being used is older than the one that introduced the ‘iterable’ module, or if there is an issue with the Python installation or environment.

More specifically, Python 3.10 removed the ‘iterable’ abstract class from the ‘collections’ module.

Now, the iterable class can be imported from ‘collections.abc’ instead of ‘collections’.

How to fix this cannot import name ‘iterable’ from ‘collections’

As mentioned above the quickest way to fix the error is to import ‘Iterable’ class from ‘collections.abc’ rather than ‘collections’.

From this import statement:

from collections import Iterable

# Use Iterable class as usual

To this import statement.

from collections.abc import Iterable

# Use Iterable class as usual

Other Solution to fix the error

Here are other solutions you can consider when the given above does not fix it.

📌 Upgrade Python

If you are using an outdated version of Python, the first solution is to upgrade to the latest version. This will ensure that your Python version supports the “iterable” module.

📌 Upgrade package

If you are using an outdated version of the “collections” package, you can upgrade it using pip, the package manager for Python.

You can use the following command to upgrade the package:

pip install --upgrade collections

📌 Uninstall conflicting packages

If you have multiple versions of the “collections” package installed in your system, you can uninstall the conflicting packages using pip.

You can use the following command to uninstall the package:

pip uninstall collections

Once you have uninstalled the conflicting packages, you can reinstall the package using the following command:

pip install collections

Anyway, here are other fixed errors you can consider when somehow you might encounter them.

• Importerror: no module named site
• Importerror: cannot import name dataclass_transform

Conclusion

To conclude what we have explained about “ImportError: cannot import name ‘iterable’ from collections‘” error in Python, the first thing you should do is to check your Python version and ensure that you have the latest version installed.

You should also ensure that you have the latest version of the “collections” package installed, and if you have multiple versions of the package installed, you should uninstall the conflicting packages.

I hope this article has helped you fix the error.

Until next time! 😊

Why ImportError happens on collections

collections ImportErrors are almost always from Python 3.10 removing legacy import paths that had already been deprecated. The classic: from collections import Callable fails since 3.10.

Common triggers

• Abstract base classes moved. Callable, Iterable, Mapping, MutableMapping moved from collections to collections.abc in Python 3.3. Removed from the old location in 3.10.
• Third-party library not yet updated. Old libraries still import from the deprecated path.
• Typo. deque is lowercase; Deque raises ImportError.

Diagnostic pattern

# BAD (Python 3.10+)
from collections import Callable   # ImportError
from collections import Mapping    # ImportError

# GOOD — use collections.abc
from collections.abc import Callable
from collections.abc import Mapping, MutableMapping

# Common collections types (correct locations)
from collections import Counter, defaultdict, deque, OrderedDict, namedtuple
from collections.abc import Iterable, Sequence, Mapping, MutableMapping, Callable

Best practices

• Import ABCs from collections.abc, not collections directly.
• Upgrade legacy dependencies that fail on Python 3.10+.
• Prefer typing.* for type hints. from typing import Callable is the modern way for annotations.

Glay Eliver

Programmer & Technical Writer at PIES IT Solution

Glay Eliver is a programmer and writer at PIES IT Solution, author of over 600 tutorials at itsourcecode.com. Specializes in JavaScript tutorials, Microsoft Office how-tos (Excel, Word, PowerPoint), and Python error debugging covering ImportError, TypeError, AttributeError, ModuleNotFoundError, and JavaScript ReferenceError. Authored several of the site’s highest-traffic Excel and MS Office reference articles.

Expertise: JavaScript · MS Excel · MS Word · MS PowerPoint · Python · Python ImportError · Python TypeError · Python AttributeError · ModuleNotFoundError · JavaScript ReferenceError · Pygame
 · View all posts by Glay Eliver →