One error you might encounter when working with Excel files in Python is:
ModuleNotFoundError: No module named 'openpyxl'
This error occurs when Python can’t find the openpyxl
library in the current environment.
In this tutorial, I will show you an example that causes this error and how to fix it in practice.
How to reproduce the error
Suppose you want to use the openpyxl
module to create an Excel Workbook and a Sheet as follows:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws1 = wb.create_sheet("Sheet")
But you get the following error when running the code:
Traceback (most recent call last):
File "main.py", line 1, in <module>
from openpyxl import Workbook
ModuleNotFoundError: No module named 'openpyxl'
To my knowledge, the ModuleNotFoundError
happens when Python can’t find the module you’re trying to import.
The openpyxl
module is not bundled with Python, so you need to install it first.
How to fix this error
To resolve this error, you need to install the openpyxl
library using the pip install
command:
pip install openpyxl
# For pip3:
pip3 install openpyxl
Once the module is installed, you should be able to run the code that imports openpyxl
without receiving the error.
Install commands for other environments
The install command might differ depending on what environment you used to run the Python code.
Here’s a list of common install commands in popular Python environments to install the openpyxl
module:
# if you don't have pip in your PATH:
python -m pip install openpyxl
python3 -m pip install openpyxl
# Windows
py -m pip install openpyxl
# Anaconda
conda install openpyxl
# Jupyter Notebook
!pip install openpyxl
Once the module is installed, you should be able to run the code without receiving this error.
Other common causes for this error
If you still see the error even after installing the module, it means that the openpyxl
module can’t be found in your Python environment.
There are several reasons why this error can happen:
- You may have multiple versions of Python installed on your system, and you are using a different version of Python than the one where openpyxl is installed.
- You might have openpyxl installed in a virtual environment, and you are not activating the virtual environment before running your code.
- Your IDE uses a different version of Python from the one that has openpyxl
- The package is not installed in PyCharm
Let’s see how to fix these errors in practice.
1. You have multiple versions of Python
If you have multiple versions of Python installed on your system, you need to make sure that you are using the specific version where the openpyxl module is available.
You can test this by running the which -a python
or which -a python3
command from the terminal:
$ which -a python3
/opt/homebrew/bin/python3
/usr/bin/python3
In the example above, there are two versions of Python installed on /opt/homebrew/bin/python3
and /usr/bin/python3
.
Suppose you run the following steps in your project:
- Install openpyxl with
pip
using/usr/bin/
Python version - Install Python using Homebrew, you have Python in
/opt/homebrew/
- Then you run
import openpyxl
in your code
The steps above will cause the error because openpyxl is installed in /usr/bin/
, and your code is probably executed using Python from /opt/homebrew/
path.
To solve this error, you need to run the pip install openpyxl
command again so that openpyxl is installed and accessible by the active Python version.
2. Python virtual environment is active
Another scenario that could cause this error is you may have openpyxl installed in a virtual environment.
Python venv
package allows you to create a virtual environment where you can install different versions of packages required by your project.
If you are installing openpyxl
inside a virtual environment, then the module won’t be accessible outside of that environment.
You can see if a virtual environment is active or not by looking at your prompt in the terminal.
When a virtual environment is active, the name of that environment will be shown inside parentheses as shown below:
In the picture above, the name of the virtual environment (demoenv)
appears, indicating that the virtual environment is currently active.
If you run pip install
while the virtual environment is active, then the package is installed only for that environment
Likewise, any package installed outside of that virtual environment won’t be accessible from the virtual environment. The solution is to run the pip install
command on the environment you want to use.
If you want to install openpyxl globally, then turn off the virtual environment by running the deactivate
command before running the pip install
command.
3. IDE using a different Python version
Finally, the IDE from where you run your Python code may use a different Python version when you have multiple versions installed.
For example, you can check the Python interpreter used in VSCode by opening the command palette (CTRL + Shift + P
for Windows and ⌘ + Shift + P
for Mac) then run the Python: Select Interpreter
command.
You should see all available Python versions listed as follows:
You need to use the same version where you installed openpyxl so that the module can be found when you run the code from VSCode.
Once done, you should be able to import openpyxl without receiving any errors.
4. You see this error in PyCharm
If you’re using PyCharm as your IDE, then this error might occur because the package is not installed in the Python interpreter used by PyCharm.
This is because PyCharm creates a new virtual environment for each project you create using the IDE.
To resolve this error, you can install the package using PyCharm’s terminal.
For more information, you can see the guide to install and uninstall packages in PyCharm.
Conclusion
In summary, the ModuleNotFoundError: No module named 'openpyxl'
occurs when the openpyxl
library is not installed in your Python environment. To resolve this error, you need to run the pip install openpyxl
command.
If you already have the module installed, make sure you are using the correct version of Python, check if the virtual environment is active if you have one, and check for the Python version used by your IDE.
By following these steps, you should be able to import the openpyxl
module in your code successfully.
I hope you find this tutorial helpful. Until next time! 👋
I am running Windows 7 and using Python 2.7.
I have installed openpyxl using easy_install. It looks like the installation was successful. I changed the directory and fired up Python.
>>> import openpyxl
>>>
So, this should mean that Python is able to find openpyxl. However, when I execute a simple test program excell_tutorial1.py and run it, I get the following:
Traceback (most recent call last):
File "C:/Python27/playground/excell_tutorial1.py", line 7, in <module>
from openpyxl import Workbook
ImportError: No module named openpyxl
Very confusing! It could find it in prompt line but not in the program!
import os, sys
the_module ="C:\\Python27\\Lib\\site-packages\\openpyxl-2.3.3-py2.7.egg\\openpyxl"
if the_module not in sys.path:
sys.path.append(the_module)
if the_module in sys.path:
print sys.path.index(the_module)
print sys.path[18]
so, this gives me:
18
C:\Python27\Lib\site-packages\openpyxl-2.3.3-py2.7.egg\openpyxl
Anyone can think of what the problem might be?
Much appreciated
asked Jan 22, 2016 at 17:22
3
I had the same problem solved using instead of pip or easy install one of the following commands :
sudo apt-get install python-openpyxl
sudo apt-get install python3-openpyxl
The sudo command also works better for other packages.
answered Nov 6, 2016 at 20:21
rainerrainer
3,3055 gold badges34 silver badges50 bronze badges
2
While not quite what you ran into here (since you state that you are using python 2.7), for those who run into this issue and are using python 3, you may be unintentionally installing to python 2 instead. To force the install to python 3 (instead of 2) use pip3 instead.
See this thread for more info:
No module named ‘openpyxl’ — Python 3.4 — Ubuntu
answered Sep 8, 2016 at 16:50
Try deleting all openpyxl material from C:\Python27\Lib\site-packages\
Once you do that try reinstalling it using pip. (This what worked for me)
answered Feb 17, 2016 at 1:06
At times this can be a simple permission issue. As it was in my case. I installed it in my local directory with my login.
python ./setup.py install
but some of the other user were not able to import the module.
They were getting this error:
ImportError: No module named openpyxl
Hence I simply gave exe permission to ‘others’
chmod -R 755
That solves the problem at least in my case.
answered Aug 22, 2016 at 10:13
marksmarks
454 bronze badges
Go to the directory where pip is installed, for eg.C:\Python27\Scripts and open cmd (simply type cmd in address bar ). Now run the command «pip install openpyxl». It will install the package itself. Hope this will solve your problem.
answered Jun 27, 2018 at 13:35
Rohit GawasRohit Gawas
2673 silver badges8 bronze badges
Try this:
!pip install openpyxl
RobC
23.1k20 gold badges75 silver badges80 bronze badges
answered Sep 11, 2019 at 11:00
1
I had the same issue on 3.8.2
I found out that python was installed in two locations on my machine (probably py and python, just a guess)
Here:
C:\Users<userAccount>\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.8\LocalCache\local-packages\Python38
and Here:
C:\Python38
I deleted the one in my C drive and everything is working well now. I would double check to see where your packages are getting installed first, before deleting. Which ever one is being used, keep that one.
For this case, check to see where this package got installed:
C:\Users\<userAccount>\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.8\LocalCache\local-packages\Python38\site-packages\openpyxl
keep that directory.
patti_jane
3,3135 gold badges21 silver badges26 bronze badges
answered Apr 15, 2020 at 18:17
What worked for me was to open the terminal as an administrator, cd to the ‘scripts’ file of where python (different for each version) is stored, and then install using pip:
cd C:\Users\Salfa\AppData\Local\Programs\Python\Python39\Scripts
pip install openpyxl
This resolved the problem for me.
answered Jul 26, 2022 at 17:09
Уведомления
- Начало
- » Python для новичков
- » Не могу запустить openpyxl
#1 Фев. 14, 2017 20:48:56
Не могу запустить openpyxl
Добрый вечер, всем!
Надеюсь, поможете
Скачал книгу Автоматизация рутинных задач с помощью Python
Там нужно запустить openpyxl
В PythonShell пишу
import openpyxl
Мне выдает ошибку:
Traceback (most recent call last):
File “<pyshell#0>”, line 1, in <module>
import openpyxl
ImportError: No module named openpyxl
CMD показывает, что python 27 установлен и когда пишу pip install openpyxl — пишет, что есть такой в папке Anaconda…
В Path, вроде, тоже все прописал.
https://i.stack.imgur.com/3NnlT.png
Чего не хватает, не могу понять, где недочет
Помогите, пожалуйста!!!!
Офлайн
- Пожаловаться
#2 Фев. 14, 2017 22:01:33
Не могу запустить openpyxl
Antonpython
CMD показывает, что python 27 установлен
1. Запускайте интерпретатор не Python 2.7, а Python 3.5, который по умолчанию должен быть инсталлирован в папку C:\Python35
2. Путь к python.exe для Python 3.5 (C:\Python35) должен быть прописан в PATH, а у вас, как видно на скриншоте, прописан только для Python 2.7 (C:\Python27).
3. Модуль openpyxl, возможно, требуется обновить до последней версии. Это делается командой pip install -U openpyxl
4. На вашем скриншоте в переменной PATH заметна явная ошибка — написано C:\Python35\Sripts, должно быть C:\Python35\Scripts.
Отредактировано old_monty (Фев. 14, 2017 22:26:47)
Офлайн
- Пожаловаться
#3 Фев. 15, 2017 00:35:25
Не могу запустить openpyxl
Вроде, ошибок не возникает, спасибо!
Однако, когда пишу
>>> import openpyxl
>>> wb = openpyxl.load_workbook(‘example.xslx’)
Получается текст…
Traceback (most recent call last):
File “<pyshell#5>”, line 1, in <module>
wb = openpyxl.load_workbook(‘example.xslx’)
File “C:\Users\Anton\AppData\Local\Programs\Python\Python36\lib\site-packages\openpyxl\reader\excel.py”, line 152, in load_workbook
archive = _validate_archive(filename)
File “C:\Users\Anton\AppData\Local\Programs\Python\Python36\lib\site-packages\openpyxl\reader\excel.py”, line 115, in _validate_archive
archive = ZipFile(filename, ‘r’, ZIP_DEFLATED)
File “C:\Users\Anton\AppData\Local\Programs\Python\Python36\lib\zipfile.py”, line 1082, in __init__
self.fp = io.open(file, filemode)
FileNotFoundError: No such file or directory: ‘example.xslx’
>>>
Не поможете с этим?)
Офлайн
- Пожаловаться
#4 Фев. 15, 2017 04:54:22
Не могу запустить openpyxl
Antonpython
example.xslx
где находится данный файл?
укажите полный путь до файла
Отредактировано Vigi (Фев. 15, 2017 04:55:16)
Офлайн
- Пожаловаться
#5 Фев. 15, 2017 15:59:52
Не могу запустить openpyxl
Antonpython
При вызове openpyxl.load_workbook(‘example.xslx’) указывайте полный путь к файлу example.xlsx, как уже вам правильно советовал Vigi. Либо скопируйте файл example.xslx в текущий рабочий каталог. Узнать, какой каталог является текущим рабочим каталогом можно с помощью функции getcwd() из модуля os. Или можно не выходя из Python перейти в тот каталог, где фактически находится example.xlsx, с помощью функции chdir() того же модуля. У вас должно получиться примерно так:
>>> import os >>> os.getcwd() 'C:\\Users\\Anton' >>> os.chdir(r"C:\users\Anton\Desktop") >>> os.getcwd() 'C:\\users\\Anton\\Desktop'
Офлайн
- Пожаловаться
#6 Фев. 15, 2017 20:50:12
Не могу запустить openpyxl
>>> import openpyxl
>>> os.chdir(r“C:\Users\Anton\Desktop\Python”)
>>> wb = openpyxl.load_workbook(‘example.xslx’)
Traceback (most recent call last):
File “<pyshell#23>”, line 1, in <module>
wb = openpyxl.load_workbook(‘example.xslx’)
File “C:\Users\Anton\AppData\Local\Programs\Python\Python36\lib\site-packages\openpyxl\reader\excel.py”, line 152, in load_workbook
archive = _validate_archive(filename)
File “C:\Users\Anton\AppData\Local\Programs\Python\Python36\lib\site-packages\openpyxl\reader\excel.py”, line 115, in _validate_archive
archive = ZipFile(filename, ‘r’, ZIP_DEFLATED)
File “C:\Users\Anton\AppData\Local\Programs\Python\Python36\lib\zipfile.py”, line 1082, in __init__
self.fp = io.open(file, filemode)
FileNotFoundError: No such file or directory: ‘example.xslx’
>>>
Поменял директорию
Добавил туда example.xslx
Не взлетело
Подскажите, что сделать, чтобы все открылось?)
Отредактировано Antonpython (Фев. 15, 2017 20:50:41)
Офлайн
- Пожаловаться
#7 Фев. 15, 2017 21:12:40
Не могу запустить openpyxl
Antonpython
Поменял директорию
Добавил туда example.xslx
Не взлетело
Странно. Я специально проделал все эти действия в винде, и у меня сразу же все взлетело.
Может, надо наоборот, сначала скопировать файл example.xlsx в нужную директорию, потом переходить в нее, когда файл в ней уже точно есть. Или вообще никуда не переходить, просто положить файл в свой текущий рабочий каталог, который определяется через os.getcwd(), и находясь в нем, запускать Python.
Поправка: имя файла у меня в предыдущем сообщении было указано с ошибкой, а вы просто эту ошибку повторили при наборе команды. Не example.xslx он называется, а example.xlsx
Отредактировано old_monty (Фев. 15, 2017 21:31:46)
Офлайн
- Пожаловаться
#8 Фев. 16, 2017 19:42:49
Не могу запустить openpyxl
Спасибо огромное, у меня зрение прост садится) Смешная ситуация
Взлетело!!!!!!!!!!!!!!!!!!
Спасибо!
Двигаюсь дальше.
Офлайн
- Пожаловаться
- Начало
- » Python для новичков
- » Не могу запустить openpyxl
Are you stuck at the “ModuleNotFoundError: no module named openpyxl” error? People beginning with Python often get stuck when they start to work with the openpyxl library. This is an industry-wide problem that pops up on screens of many coders starting out with Python.
This often happens due to version errors between Python and Openpyxl or due to incorrect installation. Unable to find the right solution can be a head-scratching problem, that’s why in this article we will be going through the most common errors coders encounter with openpyxl and derive solutions to each of those errors.
What is openpyxl?
The absence of a Python library to read Open XML formats created the need for openpyxl which is the current industry standard Python library to read and write excel format files.
The formats supported are: xlsx/xlsm/xltx/xltm.
Most of the time, errors encountered with openpyxl are caused due to incorrect installation. And these errors can get resolved with a simple reinstallation. Let’s look at the correct way to install openpyxl.
Installing openpyxl through package managers
By using pip
The most simple way to install any Python library is by using pip. Pip is a system software written in Python that installs and manages your Python libraries through an open-source library. Installing through pip requires knowledge of your Python version.
If you are using Python2, the syntax to install any library is:
pip install 'package_name'
Using just ‘pip’ will install any Python package for Python2 versions.
To install it for Python3, write:
Note: In newer versions of pip, mainly versions north of 3.0, pip installs packages for Python3 by default when just ‘pip’ is typed. This anomaly is found in the most newer versions of Python, and in case you are encountering it, it is advisable to degrade your Python version.
In case you have more than one Python version in your system and you are not sure if vanilla pip3 will fetch the correct version, you can use this syntax instead:
python3 -m pip install --user xlsxwriter
By using Conda
Many coders prefer using Conda over pip, for its virtual environment features. If you want to install openpyxl using Conda, type the following syntax:
conda install -c anaconda openpyxl
OR
The second syntax is mainly for the latest Conda versions (Conda 4.7.6 or higher)
Installing as per your OS
Let’s look at the different ways to install based on which operating system you use!
1. Windows
If you are using windows then the following packages are required to read and write excel files. To install them, type the following syntax:
pip install openpyxl pip install --user xlsxwriter pip install xlrd==1.2.0
2. Ubuntu
Linux distributions are better-suited to Python, but you may still run into some errors due to system bugs or bad installation. The safe and correct way to install openpyxl in Ubuntu is to do the following.
Type the syntax below in your terminal:
For Python2:
sudo apt-get install python-openpyxl
For Python3:
sudo apt-get install python3-openpyxl
The above case is similar to the example at the top. A lot of times, incorrect installation is caused due to the installation of openpyxl for Python2 into the systems with Python3.
Knowing your Python versions can solve most of the problem hands-on, and if the problem still persists then degrading your python version and reinstalling packages is another option.
Script path error
Many times, even after a correct installation, openpyxl may throw ‘modulenotfounderror’. It does not matter what installation manager you used, as the package gets installed correctly but the package manager installs it in some other directory. This mainly happens for a few reasons:
- Your Python scripts are kept in a different directory and your package manager installs them in a different one.
- A recent update might have changed the name or path of the directory
- A Manual installation might have created more than one script folder
- Your system cannot identify the correct script directory.
To resolve this issue, use the following syntax in the terminal:
import sys sys.append(full path to the site-package directory)
Note: The above code redirects Python to search for import packages from the given path directory. It’s not a permanent solution but rather a turnaround method.
Completely eradicating this issue is a lengthy process as it requires identifying all the script directories and adding them to ‘path’ (The path of script directory where packages are installed). To avoid errors like this, it is important that we identify and remember where our scripts are getting installed. Knowing where the displacement has happened can solve half the problems, and the other half can get solved by installing packages that are compatible with your python version.
Conclusion
In this article, we have learned about the errors people face with openpyxl and the different ways through which it can get solved. These methods do not just work for openpyxl, but many python library packages that show ‘filenotfounderror‘. Most of the time, errors occur due to incompatible versions, bad installations, or installation in the wrong directory.
Modulenotfounderror: no module named openpyxl error occurs when openpyxl module is either not installed or misconfigured with the system path. There are many situations where we install openpyxl in any virtual environment but run the application or code base in a different virtual environment or globally. Since the installed openpyxl is pointed with a different interpreter and not available in any other virtual environment. This time the currently selected interpreter will throw the same error. Anyways In this article, How can we install openpyxl differently and fix this modulenotfounderror.
We will install this openpyxl module with pip, conda, and source code. In each section, we will also try to cover the variation.
Method 1: pip for installation openpyxl –
Use this command to install openpyxl.
pip install openpyxl
We can specify the version detail along with the command to avoid compatibility issues if any with the latest version. Since the above one will install the latest stable version of openpyxl.
pip install openpyxl==3.0.9
You have to also check the version of python before using the pip or pip3 command. If the version is 3.xx then use pip3 command and if it 2.xx then use pip command.
If Admin privileges are required to run this command in Linux or a similar OS then add sudo keyword along with it. Also if you are on Windows-based OS then launch the cmd in admin mode and rerun the above command.
Method 2: conda for installation openpyxl –
If you have Anaconda installed in the system and you want to use conda ( default package manager ) then use the below command to install openpyxl.
conda install -c anaconda openpyxl
Method 3: Installation through source code –
In this step, we will first download the source code for openpyxl implementation in Python. Now we need to run –
python setup.py install
It will build the file locally and then we have to place it into site-packages folder before we import the package. It will fix the above error.
Thanks
Data Science Learner Team
Join our list
Subscribe to our mailing list and get interesting stuff and updates to your email inbox.
We respect your privacy and take protecting it seriously
Thank you for signup. A Confirmation Email has been sent to your Email Address.
Something went wrong.