
If you're getting a ModuleNotFoundError: No module named azure, it's frustrating. This error occurs when Python can't find the Azure module, which is required for various Azure-related tasks.
The error message is usually straightforward, but it doesn't provide a clear solution. To troubleshoot this issue, let's explore some common causes.
Typically, this error is caused by a missing or incorrectly installed Azure SDK. The Azure SDK is a set of libraries that provides access to Azure services. If it's not installed or installed incorrectly, Python won't be able to find the Azure module.
One common reason for this error is that the Azure SDK is not installed for the correct Python version. The Azure SDK is available for Python 3.6 and later versions. If you're using an earlier version of Python, you won't be able to install the Azure SDK.
For another approach, see: Azure Azure-common Python Module
Problem Formulation
To fix a modulenotfounderror no module named azure, let's start with problem formulation. This is where you identify the root cause of the error, which in this case is a missing module.
Running a specific command in your Windows shell can help resolve the issue. You can run the following command: it's not specified in the article, but it's likely a command related to installing or importing the azure module.
The key is to isolate the problem and understand what's causing the error. By doing so, you can take targeted steps to resolve it.
Fixing ModuleNotFoundError in PyCharm
Fixing ModuleNotFoundError in PyCharm is a common issue that can be frustrating, but the solution is surprisingly simple.
Each PyCharm project creates a virtual environment where you can install custom Python modules, but this virtual environment is initially empty.
To fix the issue, you can use the PyCharm installation tooltips to install the missing library. For example, if you're trying to import the azure-identity library, you can right-click on the library name in your editor and select "Show Context Actions" to install it.
Alternatively, you can open the Terminal tool at the bottom and type the library name to install it.
Here's an interesting read: Windows Azure Active Directory Module for Windows Powershell
If you prefer a more manual approach, you can also install a new library using the following procedure:
- Open File > Settings > Project from the PyCharm menu.
- Select your current project.
- Click the Python Interpreter tab within your project tab.
- Click the small + symbol to add a new library to the project.
- Now type in the library to be installed and click Install Package.
- Wait for the installation to terminate and close all popup windows.
Remember, the key is to install the library within the virtual environment of your PyCharm project.
Diagnose and Troubleshoot
Diagnosing a ModuleNotFoundError can be a frustrating experience, but there are some common root causes to look out for. If your agent pool isn't running on Ubuntu, packages may not be restored correctly from the build step.
Make sure your deployment template requires an Ubuntu environment for both build and deployment. This can be a simple fix, but it's essential to get right.
If your function app isn't at the root of the source repository, be aware that the pip install step must reference the correct location to create the .python_packages folder. This location is case sensitive, so pay close attention to the command, such as pip install --target="./FunctionApp1/.python_packages/lib/site-packages" -r ./FunctionApp1/requirements.txt.
Here are some key things to check in your deployment template:
- The agent pool must be running on Ubuntu.
- The pip install step references the correct location for the .python_packages folder.
- The template generates a deployment package that can be loaded into /home/site/wwwroot.
Diagnose

Diagnosing the root cause of an issue is the first step to resolving it. The Diagnose ModuleNotFoundError section details potential root causes of module-related errors.
This section helps you identify which of the following is the likely root cause: incorrect module name, missing module, or duplicate module. After figuring out the likely root cause, you can go to the related mitigation.
Package Conflict
Package conflicts can be a real pain to deal with. They can occur when a package you're using isn't compatible with another package you have installed.
One potential cause of package conflicts is a conflict between customer-defined dependencies and Python built-in modules when your functions run in an App Service plan. This can cause Sync triggers to fail.
If you've installed a package that conflicts with another package, you might see an error message stating that the package isn't compatible with another module. For example, if you installed azure-storage, you must uninstall it first before installing azure 4.0.0.
Related reading: When Was Azure Launched
The PyPi documentation might also clarify the incompatible modules, so be sure to check it out.
In some cases, the conflict might be due to a package being installed but not properly uninstalled. For instance, if you installed azure 1.x/2.x and didn't uninstall azure-storage, you'll need to uninstall azure-storage first.
Functions Not Found After Deployment
If you've deployed your Python functions and they're still not found, it's likely due to a common build issue.
The agent pool must be running on Ubuntu to guarantee that packages are restored correctly from the build step. Make sure your deployment template requires an Ubuntu environment for build and deployment.
If your function app isn't at the root of the source repo, you need to specify the correct location for the .python_packages folder in the pip install step. This location is case sensitive, so be careful with your command.
To generate a deployment package that can be loaded into /home/site/wwwroot, you need to use the ArchiveFiles task in Azure Pipelines.
Here are the key things to check:
- The agent pool is running on Ubuntu.
- The pip install step references the correct location for the .python_packages folder.
- The deployment package is generated using the ArchiveFiles task.
By checking these things, you should be able to resolve issues with your Python functions not being found after deployment.
Common Issues
One of the most common issues that can cause a modulenotfounderror no module named azure is an incorrect or outdated Azure SDK installation.
The Azure SDK is a collection of libraries and tools that allow developers to work with Azure services.
If the Azure SDK is not installed or is outdated, you may encounter issues when trying to import the azure module.
Make sure to check the Python version and ensure it matches the version specified in the Azure SDK documentation.
A mismatch between the Python version and the Azure SDK version can cause import errors.
Ensure that the azure module is installed using pip, the Python package manager.
If the azure module is not installed, you can install it using pip install azure.
Also, ensure that there are no conflicting packages installed that may be causing the import error.
You can check for conflicting packages by running pip freeze and looking for duplicate packages.
Recommended read: Install Powershell for Azure
Other Solution Ideas
If you're still getting the ModuleNotFoundError after trying the previous solutions, don't worry, there are a few more things you can try.
You might have mixed up Python and pip versions on your machine. Try running python3 -m pip install azure-identity or even pip3 install azure-identity instead of pip install azure-identity.
If you're facing this issue server-side, you can try installing azure-identity using pip install --user azure-identity.
If you're using Ubuntu, you can try installing azure-identity using the command sudo apt install azure-identity.
If you're still stuck, you can check out our in-depth guide on installing azure-identity here.
Alternatively, you can also check out this article to learn more about possible problems that may lead to an error when importing a library.
Sources
- https://learn.microsoft.com/en-sg/answers/questions/1629770/azure-function-gives-exception-modulenotfounderror
- https://blog.finxter.com/fixed-modulenotfounderror-no-module-named-azure-identity/
- https://blog.finxter.com/fixed-modulenotfounderror-no-module-named-azure-core/
- https://learn.microsoft.com/en-us/answers/questions/1464886/resolving-module-not-found-error-in-azure-synapse
- https://learn.microsoft.com/en-us/azure/azure-functions/recover-python-functions
Featured Images: pexels.com