You can solve the error ModuleNotFoundError: no module named ‘google.cloud’ by installing the product-specific google-cloud-* package needed for your application. For example, if you want to install the Python client for Google AutoML using pip:
# Linux/ MacOS python3 -m pip install virtualenv virtualenv venv source venv/bin/activate python3 -m pip install google-cloud-automl # Windows python3 -m pip install virtualenv virtualenv venv source venv\Scripts\activate python3 -m pip install google-cloud-automl
And if you want to install the Google AutoML using conda:
conda create -n project python=3.8 conda activate py38 conda install -c conda-forge google-cloud-storage
This tutorial goes through the exact steps to troubleshoot this error for the Windows, Mac and Linux operating systems.
How to Solve Python ModuleNotFoundError: no module named ‘google.cloud’
Let’s look at an example to reproduce the error:
import google.cloud.storage
Let’s run the code to see the result:
--------------------------------------------------------------------------- ModuleNotFoundError Traceback (most recent call last) Input In [1], in <cell line: 1>() ----> 1 import google.cloud.storage ModuleNotFoundError: No module named 'google.cloud.storage'
The Python interpreter cannot find the storage module in the environment.
What is Google Cloud
Google Cloud has a set of Python idiomatic clients for Google Cloud Platform services. The packages are consistently named google-cloud-*, where the asterisk stands in place for the name of the package you want to install.
The simplest way to install google-cloud-* packages 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 google-cloud-* packages with both.
How to Install Google Cloud Storage API 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.
python get-pip.py
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 env\Scripts\activate # Activate on Windows (cmd.exe) env\Scripts\activate.bat # Activate on Windows (PowerShell) env\Scripts\Activate.ps1
You will see “env” in parenthesis next to the command line prompt. You can install google-cloud-storage within the environment by running the following command from the command prompt.
python3 -m pip install google-cloud-storage
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 Google Cloud Storage API 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 https://bootstrap.pypa.io/get-pip.py -o get-pip.py
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:
python3 get-pip.py
To install google-cloud-storage, 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 google-cloud-storage within the environment by running the following command from the command prompt.
python3 -m pip install google-cloud-storage
How to Install Google Cloud Storage API 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
google-cloud-storage Installation on Linux with Pip
To install google-cloud-storage, 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 google-cloud-storage using:
python3 -m pip install google-cloud-storage
Installing Google Cloud Storage API 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 google-cloud-storage.
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 google-cloud-storage using conda.
Once you have installed Anaconda and created your conda environment, you can install google-cloud-storage using the following command:
conda install -c conda-forge google-cloud-storage
Check Google Cloud Storage API Version
Once you have successfully installed google-cloud-storage, you can check its version. If you used pip to install google-cloud-storage, you can use pip show from your terminal.
python3 -m pip show google-cloud-storage
Name: google-cloud-storage Version: 2.5.0 Summary: Google Cloud Storage API client library Home-page: https://github.com/googleapis/python-storage
You can also check the version of google-cloud-storage by importing the module and printing the __version__ attribute.
from google.cloud import storage print(storage.__version__)
2.5.0
If you used conda to install google-cloud-storage, you could check the version using the following command:
conda list -f google-cloud-storage
# Name Version Build Channel google-cloud-storage 2.4.0 pyh6c4a22f_0 conda-forge
Summary
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:
- How to Solve Python ModuleNotFoundError: no module named ‘urllib3’
- How to Solve Python ModuleNotFoundError: no module named ‘google’
Have fun and happy researching!