How to Solve Python ModuleNotFoundError: no module named ‘iniconfig’

by | Programming, Python, Tips

A common error you may encounter when using Python is modulenotfounderror: no module named ‘iniconfig’.

This error occurs if you do not install iniconfig before importing it into your program or installing the library in the wrong environment.

You can install iniconfig in Python 3 with python3 -m pip install iniconfig.

Or conda install -c conda-forge iniconfig for conda environments.

This tutorial goes through the exact steps to troubleshoot this error for the Windows, Mac and Linux operating systems.

What is ModuleNotFoundError?

The ModuleNotFoundError occurs when the module you want to use is not present in your Python environment. There are several causes of the modulenotfounderror:

The module’s name is incorrect, in which case you have to check the name of the module you tried to import. Let’s try to import the re module with a double e to see what happens:

import ree
ModuleNotFoundError                       Traceback (most recent call last)
1 import ree

ModuleNotFoundError: No module named 'ree'

To solve this error, ensure the module name is correct. Let’s look at the revised code:

import re


You may want to import a local module file, but the module is not in the same directory. Let’s look at an example package with a script and a local module to import. Let’s look at the following steps to perform from your terminal:

mkdir example_package

cd example_package

mkdir folder_1

cd folder_1


Note that we use Vim to create the file in this example. You can use your preferred file editor, such as Emacs or Atom. In, we will import the re module and define a simple function that prints the re version:

import re

def print_re_version():


Close the, then complete the following commands from your terminal:

cd ../


Inside, we will try to import the module we created.

import module

if __name__ == '__main__':


Let’s run python from the terminal to see what happens:

Traceback (most recent call last):
  File "", line 1, in ≺module≻
    import module
ModuleNotFoundError: No module named 'module'

To solve this error, we need to point to the correct path to, which is inside folder_1. Let’s look at the revised code:

import folder_1.module as mod

if __name__ == '__main__':


When we run python, we will get the following result:


You can also get the error by overriding the official module you want to import by giving your module the same name.

Lastly, you can encounter the modulenotfounderror when you import a module that is not installed in your Python environment.

What is iniconfig?

iniconfig is an INI-file parser module

The simplest way to install iniconfig is to use the package manager for Python called pip. The following installation instructions are for the major Python version 3.

Always Use a Virtual Environment to Install Packages

It is always best to install new libraries within a virtual environment. You should not install anything into your global Python interpreter when you develop locally. You may introduce incompatibilities between packages, or you may break your system if you install an incompatible version of a library that your operating system needs. Using a virtual environment helps compartmentalize your projects and their dependencies. Each project will have its environment with everything the code needs to run. Most ImportErrors and ModuleNotFoundErrors occur due to installing a library for one interpreter and trying to use the library with another interpreter. Using a virtual environment avoids this. In Python, you can use virtual environments and conda environments. We will go through how to install iniconfig with both.

How to Install iniconfig on Windows Operating System

First, you need to download and install Python on your PC. Ensure you select the install launcher for all users and Add Python to PATH checkboxes. The latter ensures the interpreter is in the execution path. Pip is automatically on Windows for Python versions 2.7.9+ and 3.4+.

You can check your Python version with the following command:

python3 --version

You can install pip on Windows by downloading the installation package, opening the command line and launching the installer. You can install pip via the CMD prompt by running the following command.


You may need to run the command prompt as administrator. Check whether the installation has been successful by typing.

pip --version
virtualenv env

You can activate the environment by typing the command:

# Activate on Windows


# Activate on Windows (cmd.exe)


# Activate on Windows (PowerShell)


You will see “env” in parenthesis next to the command line prompt. You can install iniconfig within the environment by running the following command from the command prompt.

python3 -m pip install iniconfig

We use python -m pip to execute pip using the Python interpreter we specify as Python. Doing this helps avoid ImportError when we try to use a package installed with one version of Python interpreter with a different version. You can use the command which python to determine which Python interpreter you are using.

How to Install iniconfig on Mac Operating System using pip

Open a terminal by pressing command (⌘) + Space Bar to open the Spotlight search. Type in terminal and press enter. To get pip, first ensure you have installed Python3:

python3 --version
Python 3.8.8

Download pip by running the following curl command:

curl -o

The curl command allows you to specify a direct download link. Using the -o option sets the name of the downloaded file.

Install pip by running:


To install iniconfig, first, create the virtual environment:

python3 -m venv env

Then activate the environment using:

source env/bin/activate 

You will see “env” in parenthesis next to the command line prompt. You can install iniconfig within the environment by running the following command from the command prompt.

python3 -m pip install iniconfig

How to Install iniconfig on Linux Operating Systems

All major Linux distributions have Python installed by default. However, you will need to install pip. You can install pip from the terminal, but the installation instructions depend on the Linux distribution you are using. You will need root privileges to install pip. Open a terminal and use the commands relevant to your Linux distribution to install pip.

Installing pip for Ubuntu, Debian, and Linux Mint

sudo apt install python-pip3

Installing pip for CentOS 8 (and newer), Fedora, and Red Hat

sudo dnf install python-pip3

Installing pip for CentOS 6 and 7, and older versions of Red Hat

sudo yum install epel-release

sudo yum install python-pip3

Installing pip for Arch Linux and Manjaro

sudo pacman -S python-pip

Installing pip for OpenSUSE

sudo zypper python3-pip

iniconfig installation on Linux with Pip

To install iniconfig, first, create the virtual environment:

python3 -m venv env

Then activate the environment using:

source env/bin/activate 

You will see “env” in parenthesis next to the command line prompt.

Once you have activated your virtual environment, you can install iniconfig using:

python3 -m pip install iniconfig

Installing iniconfig Using Anaconda

Anaconda is a distribution of Python and R for scientific computing and data science. You can install Anaconda by going to the installation instructions. Once you have installed Anaconda, you can create a virtual environment and install iniconfig.

To create a conda environment you can use the following command:

conda create -n project python=3.8

You can specify a different Python 3 version if you like. Ideally, choose the latest version of Python. Next, you will activate the project container. You will see “project” in parentheses next to the command line prompt.

source activate project

Now you’re ready to install iniconfig using conda.

Once you have installed Anaconda and created your conda environment, you can install iniconfig using the following command:

conda install -c conda-forge iniconfig

Check iniconfig Version

Once you have successfully installed iniconfig, you can check its version. If you used pip to install iniconfig, you can use pip show from your terminal.

python3 -m pip show iniconfig
Name: iniconfig
Version: 1.1.1
Summary: iniconfig: brain-dead simple config-ini parsing

If you used conda to install iniconfig, you could check the version using the following command:

conda list -f iniconfig
# Name                    Version                   Build  Channel
iniconfig                 1.1.1              pyh9f0ad1d_0    conda-forge

Using iniconfig

Let’s look at an example of using iniconfig to read an INI file called example.ini.

serveraliveinterval = 45
compression = yes
compressionlevel = 9
forwardx11 = yes

user = ab

port = 50022
forwardx11 = no
import iniconfig
ini = iniconfig.IniConfig("example.ini")
[('serveraliveinterval', '45'),
 ('compression', 'yes'),
 ('compressionlevel', '9'),
 ('forwardx11', 'yes')]


Congratulations on reading to the end of this tutorial.

Go to the online courses page on Python to learn more about Python for data science and machine learning.

For further reading on missing modules in Python, go to the articles:

Have fun and happy researching!

Research Scientist at Moogsoft | + posts

Suf is a research scientist at Moogsoft, specializing in Natural Language Processing and Complex Networks. Previously he was a Postdoctoral Research Fellow in Data Science working on adaptations of cutting-edge physics analysis techniques to data-intensive problems in industry. In another life, he was an experimental particle physicist working on the ATLAS Experiment of the Large Hadron Collider. His passion is to share his experience as an academic moving into industry while continuing to pursue research. Find out more about the creator of the Research Scientist Pod here and sign up to the mailing list here!