Skip to main content

How to Solve "ModuleNotFoundError: No module named 'openai'" in Python

The error ModuleNotFoundError: No module named 'openai' indicates that the openai Python library, used for interacting with OpenAI's APIs, is not installed in your current Python environment, or that Python can not find the package.

This guide provides step-by-step instructions to install the openai package and troubleshoot common installation and environment issues.

Installing the openai Package

The standard way to install openai is using pip, Python's package installer. Open a terminal or command prompt and run:

pip install openai
  • Multiple Python Versions: If you have multiple Python versions, you may need to use pip3:

    pip3 install openai
  • Permissions Errors: If you get permission errors (often on Linux/macOS), try installing for the current user, or, use a virtual environment:

    pip install openai --user  # Install for the current user only
  • python -m pip: If pip isn't directly in your PATH, use this:

    python -m pip install openai  # Or python3 -m pip, py -m pip
  • Conda: If you are using anaconda, run:

    conda install -c conda-forge openai

Verifying the Installation

After installing, verify that openai is installed correctly by running a simple Python script or entering the interpreter:

import openai

print(openai.__version__) # Check the installed version

If this runs without a ModuleNotFoundError, the installation was successful. If you get an error, proceed to the troubleshooting section.

Troubleshooting ModuleNotFoundError

Virtual Environments (Essential)

Always use virtual environments for your Python projects:

  1. Create: python3 -m venv venv (or python -m venv venv, or py -m venv venv)

  2. Activate:

    • Linux/macOS: source venv/bin/activate

    • Windows (cmd): venv\Scripts\activate.bat

    • Windows (PowerShell): venv\Scripts\Activate.ps1

      PowerShell might require you to run: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

  3. Install: pip install openai (inside the activated environment).

Your terminal prompt should change (e.g., (venv) $).

Multiple Python Versions

Ensure you're using the correct pip (or pip3, pip3.x, python -m pip) for your intended Python version. Check with python --version.

IDE Configuration (VS Code, PyCharm)

Configure your IDE (VS Code, PyCharm, etc.) to use the correct interpreter/environment..

Jupyter Notebook

Install within a notebook cell:

!pip install openai

Ensure your Jupyter kernel uses the correct environment.

Naming Conflicts

Never name your files or directories openai.py or openai.

Reinstalling openai

pip uninstall openai
pip install openai

Sometimes a simple reinstall will do the trick. You can also try upgrading:

pip install openai --upgrade

Installation Instructions for Specific Environments

Windows

  • Open Command Prompt or PowerShell.
  • Use pip install openai (or py -m pip install openai).

macOS / Linux:

  • Open your Terminal
  • Use pip3 install openai

Anaconda:

  • Use conda install -c conda-forge openai.

Jupyter Notebook (within a cell):

!pip install openai
note

The ! tells the Jupyter Notebook to run the following command as a shell command.

Handling "Import 'openai' could not be resolved" (Pylance - VS Code)

  • Check interpreter in VS Code.
  • Restart VS Code.
  • You can disable the Pylance warning by adding the # type: ignore comment:
     import openai # type: ignore

Conclusion

The ModuleNotFoundError: No module named 'openai' error is usually easily resolved by installing the openai package in the correct Python environment.

Always use virtual environments, be mindful of multiple Python versions, and double-check your IDE/Jupyter configuration.

This guide has provided a complete, step-by-step approach to installation, verification, and troubleshooting, allowing you to quickly get started with the OpenAI API.