Modulenotfounderror: no module named flask

In this article, we will discuss the solutions on how to solve the modulenotfounderror no module named flask.

Furthermore, we will troubleshoot this error on Windows, Mac, and Linux.

In Python language, the frequent error that the programmer encountered is “modulenotfounderror no module named flask“.

The error appears if the python interpreter cannot find the flask module in your virtual environment.

What is ModuleNotFoundError?

The ModuleNotFoundError occur when a module cannot be found in python environment. The module package name is incorrect, for that you need to check the name of the module you imported.

Why modulenotfounderror no module named ‘flask’ occur?

The modulenotfounderror no module named ‘flask’ occur because if you try to import a module which is not exist. On the other hand the module is not installed in a correct environment path variable. Also, it will occur if you try to import a package module , which is appropriate to imprint the directory as python package.

For example

We assume that we will named the script main.py with the following code:

from flask import Flask

app = Flask(__name__)

@app.route("/")
def python_flask():
    return "<p>Flask, No module name Error!</p>"

If you execute the script above using the python, the output will shows an error:

To solve this error, you need to install the flask module with the use of the command pip to install the module for Python.

How to solve the no module named flask?

Error Can Occur Due to a Few Reasons

• Flask is not installed: If you have not installed Flask in your Python environment, you will get this error. You can install Flask using pip, the Python package manager, by running the command pip install flask in your terminal or command prompt.
• Virtual environment issues: When you are using a virtual environment, it’s possible that the Flask module is not installed in the python environment. Make sure you activate the virtual environment before you installed the Flask
• Python path issues: If the Flask is installed in an incorrect environment variable, So that’s why the Python interpreter cannot find it. You can check if Flask is installed by executing the command pip list in your PowerShell terminal or command prompt. If Flask is installed yet you are still getting the module error, you can try adding the path to the Flask installation directory to the PYTHONPATH environment variable.
• Typos in import statements: Make sure you have spelled the module name correctly and haven’t make any syntax errors in your import statements. Alternatively, you can check that you are using the correct capitalization for the module name.

Diagnostic checklist for “No module named ‘flask'”

• Verify pip install target. Run pip show flask — if not installed, run pip install flask.
• Check the active Python interpreter. which python (mac/Linux) or where python (Windows). Both pip and python must point to the same environment.
• Check virtual environment activation. If you use venv/conda, activate before installing: source .venv/bin/activate.
• Rule out uppercase/lowercase. Python imports are case-sensitive: import PyPDF2 not import pypdf2.
• Rule out the pip-vs-package-name mismatch. Some packages install under a different name than you import (e.g. pip install beautifulsoup4 → import bs4).

Installing flask — Python web framework

# Standard install in a virtual environment
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install flask

# For FastAPI with the ASGI server
pip install "fastapi[all]"

# For Django with all common extras
pip install django djangorestframework

Common causes for missing web-framework modules

• Wrong virtual environment. Web projects use per-project venvs. Always activate before installing.
• Docker vs local install. If your app runs in Docker, install inside the container, not on the host.
• Missing ASGI/WSGI server. FastAPI needs uvicorn. Flask/Django need gunicorn in production.
• Version conflicts. Django and DRF must be compatible versions (check Django release notes).

Working code example

import flask
print(flask.__version__)

# Quick "hello world" for Flask
# from flask import Flask
# app = Flask(__name__)
# @app.route("/")
# def hi(): return "hello"

Best practices

• Use a virtual environment for every project. Never install Django globally.
• Pin all versions in requirements.txt or pyproject.toml. Frameworks break with API changes.
• Add a Dockerfile to make setup reproducible across machines and CI.

Conclusion

By addressing one or more of these issues, you can resolve the ModuleNotFoundError: No module named ‘flask’ error and successfully use Flask in your Python application. With the use of the above solutions the error will be resolved completely.

Adones Evangelista

Programmer & Technical Writer at PIES IT Solution

Adones Evangelista is a programmer and writer at PIES IT Solution, author of over 900 tutorials and error-fix guides at itsourcecode.com. Specializes in JavaScript, Django, Laravel, and Python error debugging covering ValueError, TypeError, AttributeError, ModuleNotFoundError, and RuntimeError, plus C/C++ and PHP capstone projects for BSIT students.

Expertise: JavaScript · Python · Django · Laravel · Error Debugging · C/C++
 · View all posts by Adones Evangelista →