[Tut] ModuleNotFoundError: No Module Named ‘gRPC’ in Python

[xSicKxBot]

ModuleNotFoundError: No Module Named ‘gRPC’ in Python

4/5 – (1 vote)



Quick Fix: Python raises the

Code:

ImportError: No module named 'grpc'

when it cannot find the library

Code:

grpc

. The most frequent source of this error is that you haven’t installed

Code:

grpc

explicitly with

Code:

pip install grpcio

. Alternatively, you may have different Python versions on your computer, and

Code:

grpc

is not installed for the particular version you’re using.

In most cases, you actually want to

Code:

pip install grpcio

and not

Code:

grpc

. If you really want to install

Code:

grpcio

, replace all occurrences of

Code:

pip install grpc

(and variants) with

Code:

pip install grpcio

.

Here are some examples that may work depending on your environment:

Code:

python -m pip install grpcio sudo pip install grpcio pip.exe install grpcio

Also, make sure to install

Code:

grpcio-tools

:

Code:

pip install grpcio-tools

Problem Formulation

You’ve just learned about the awesome capabilities of the

Code:

grpc

library and you want to try it out, so you start your code with the following statement:

Code:

import grpc

This is supposed to import the gRPC library into your (virtual) environment. However, it only throws the following

Code:

ImportError: No module named grpc

:

Code:

>>> import grpc Traceback (most recent call last): File "<pyshell#6>", line 1, in <module> import grpc ModuleNotFoundError: No module named 'grpc'

By the way, this graphic shows the purpose of gRPC and what it is:



Solution Idea 1: Install Library grpc

The most likely reason is that Python doesn’t provide

Code:

grpc

in its standard library. You need to install it first!

Before being able to import the

Code:

grpc

module, you need to install it using Python’s package manager

Code:

pip

. Make sure pip is installed on your machine.

To fix this error, you can run the following command in your Windows shell:

Code:

$ pip install grpc

or

Code:

$ pip install grpcio

This simple command installs

Code:

grpc

in your virtual environment on Windows, Linux, and MacOS. It assumes that your

Code:

pip

version is updated. If it isn’t, use the following two commands in your terminal, command line, or shell (there’s no harm in doing it anyways):

Code:

$ python -m pip install – upgrade pip $ pip install grpcio

Note: Don’t copy and paste the

Code:

$

symbol. This is just to illustrate that you run it in your shell/terminal/command line.

Solution Idea 2: Fix the Path

The error might persist even after you have installed the

Code:

grpc

library. This likely happens because

Code:

pip

is installed but doesn’t reside in the path you can use. Although

Code:

pip

may be installed on your system the script is unable to locate it. Therefore, it is unable to install the library using

Code:

pip

in the correct path.

To fix the problem with the path in Windows follow the steps given next.

Step 1: Open the folder where you installed Python by opening the command prompt and typing

Code:

where python

Step 2: Once you have opened the

Code:

Python

folder, browse and open the

Code:

Scripts

folder and copy its location. Also verify that the folder contains the

Code:

pip

file.



Step 3: Now open the

Code:

Scripts

directory in the command prompt using the

Code:

cd

command and the location that you copied previously.



Step 4: Now install the library using

Code:

pip install grpcio

command. Here’s an analogous example:



After having followed the above steps, execute our script once again. And you should get the desired output.

Other Solution Ideas

• The
  Code:

  ModuleNotFoundError
  may appear due to relative imports. You can learn everything about relative imports and how to create your own module in this article.
  
  
• You may have mixed up Python and pip versions on your machine. In this case, to install
  Code:

  grpc
  for Python 3, you may want to try
  Code:

  python3 -m pip install grpcio
  or even
  Code:

  pip3 install grpcio
  instead of
  Code:

  pip install grpcio
  
  
• If you face this issue server-side, you may want to try the command
  Code:

  pip install – user grpcio
  
  
• If you’re using Ubuntu, you may want to try this command:
  Code:

  sudo apt install grpcio
  
  
• You can also check out this article to learn more about possible problems that may lead to an error when importing a library.
  

Understanding the “import” Statement

Code:

import grpc

In Python, the

Code:

import

statement serves two main purposes:

• Search the module by its name, load it, and initialize it.
  
  
• Define a name in the local namespace within the scope of the
  Code:

  import
  statement. This local name is then used to reference the accessed module throughout the code.
  

What’s the Difference Between ImportError and ModuleNotFoundError?

What’s the difference between

Code:

ImportError

and

Code:

ModuleNotFoundError

?

Python defines an error hierarchy, so some error classes inherit from other error classes. In our case, the

Code:

ModuleNotFoundError

is a subclass of the

Code:

ImportError

class.

You can see this in this screenshot from the docs:



You can also check this relationship using the

Code:

issubclass()

built-in function:

Code:

>>> issubclass(ModuleNotFoundError, ImportError) True

Specifically, Python raises the

Code:

ModuleNotFoundError

if the module (e.g.,

Code:

grpc

) cannot be found. If it can be found, there may be a problem loading the module or some specific files within the module. In those cases, Python would raise an

Code:

ImportError

.

If an import statement cannot import a module, it raises an

Code:

ImportError

. This may occur because of a faulty installation or an invalid path. In Python 3.6 or newer, this will usually raise a

Code:

ModuleNotFoundError

.

Related Videos

The following video shows you how to resolve the

Code:

ImportError

:



The following video shows you how to import a function from another folder—doing it the wrong way often results in the

Code:

ModuleNotFoundError

:



How to Fix “ModuleNotFoundError: No module named ‘grpc’” in PyCharm

If you create a new Python project in PyCharmand try to import the

Code:

grpc

library, it’ll raise the following error message:

Code:

Traceback (most recent call last): File "C:/Users/.../main.py", line 1, in <module> import grpc ModuleNotFoundError: No module named 'grpc' Process finished with exit code 1

The reason is that each PyCharm project, per default, creates a virtual environment in which you can install custom Python modules. But the virtual environment is initially empty—even if you’ve already installed

Code:

grpc

on your computer!

Here’s a screenshot exemplifying this for the

Code:

pandas

library. It’ll look similar for

Code:

grpc

.



The fix is simple: Use the PyCharm installation tooltips to install Pandas in your virtual environment—two clicks and you’re good to go!

First, right-click on the

Code:

pandas

text in your editor:



Second, click “

Code:

Show Context Actions

” in your context menu. In the new menu that arises, click “Install Pandas” and wait for PyCharm to finish the installation.

The code will run after your installation completes successfully.

As an alternative, you can also open the

Code:

Terminal

tool at the bottom and type:

Code:

$ pip install grpcio

If this doesn’t work, you may want to set the Python interpreter to another version using the following tutorial: https://www.jetbrains.com/help/pycharm/2...oject.html

You can also manually install a new library such as

Code:

grpc

in PyCharm using the following procedure:

• Open
  Code:

  File > Settings > Project
  from the PyCharm menu.
  
  
• Select your current project.
  
  
• Click the
  Code:

  Python Interpreter
  tab within your project tab.
  
  
• Click the small
  Code:

  +
  symbol to add a new library to the project.
  
  
• Now type in the library to be installed, in your example Pandas, and click
  Code:

  Install Package
  .
  
  
• Wait for the installation to terminate and close all popup windows.
  

Here’s an analogous example:



Here’s a full guide on how to install a library on PyCharm.

• How to Install a Library on PyCharm