Skip to main content

How to Resolve "ModuleNotFoundError: No module named 'colorama'" in Python

The ModuleNotFoundError: No module named 'colorama' is a common Python error indicating that the Python interpreter can not find the colorama library when your script tries to import it.

This usually means the package isn't installed correctly in the specific Python environment you are using. This guide provides step-by-step solutions to fix this error.

Understanding the Error​

This error means that when Python executes import colorama or from colorama import ..., it searches through its known locations for modules and can not find one named colorama.

Solution 1: Install colorama using pip (Most Common)​

The colorama package is a third-party library and needs to be installed using pip, Python's package installer.

Open your terminal or command prompt and run:

pip install colorama

Variations (Choose the one appropriate for your setup):

# If you primarily use Python 3 and 'pip' might point to Python 2
pip3 install colorama

# If pip/pip3 are not in your system PATH
python -m pip install colorama
python3 -m pip install colorama

# On Windows, 'py' launcher might be available
py -m pip install colorama

Troubleshooting Common Installation Problems:​

If pip install colorama gives an error or the ModuleNotFoundError persists after installation, check these points:

  • Using the Correct pip: If you have both Python 2 and Python 3 installed, pip might be linked to Python 2. Modern packages like colorama require Python 3. Ensure you're using pip3 or python3 -m pip to install for your Python 3 environment. Check versions with python --version and pip --version (or pip3 --version).

  • Working with Virtual Environments (Crucial!): This is the most common reason for the error. You might have installed colorama globally but are running your script within a virtual environment (or vice-versa).

    • Always activate your virtual environment before installing packages. 
      # Create (if needed, replace 'venv' with your desired name)
      python3 -m venv venv

      # Activate:
      # Linux/macOS:
      source venv/bin/activate
      # Windows CMD:
      .\venv\Scripts\activate.bat
      # Windows PowerShell: (May require Set-ExecutionPolicy RemoteSigned -Scope CurrentUser)
      .\venv\Scripts\Activate.ps1

      # NOW install inside the active environment:
      pip install colorama
    • Ensure your IDE (VS Code, PyCharm) is configured to use the Python interpreter from within your activated virtual environment.

  • Permissions Issues (--user or sudo): If installing outside a virtual environment, you might lack permission to modify system directories.

    • Recommended: Install for the current user only: 
      pip install colorama --user
    • Use with Caution: Use administrator/root privileges (not generally recommended for pip): 
      # Linux/macOS
      sudo pip install colorama
      # Windows: Run terminal/CMD as Administrator

  • Multiple Python Installations / IDE Configuration: If you have several Python versions installed, ensure:

    • You used the correct pip command corresponding to the Python version you intend to run your script with.
    • Your IDE (VS Code, PyCharm, etc.) is configured to use that exact Python interpreter (including the one inside a virtual environment if you're using one). In VS Code/PyCharm, use the "Select Interpreter" command.

  • Naming Conflicts (colorama.py): Make sure you haven't accidentally named one of your own Python files colorama.py in your project directory. This would "shadow" the installed package, causing Python to import your file instead. Rename your file if necessary. Also, avoid using colorama as a variable name before the import.

Verifying Installation (pip show)​

After attempting installation, verify it was successful and see where it was installed:

pip show colorama
# Or: pip3 show colorama
# Or: python3 -m pip show colorama

If the command shows package information (Name, Version, Location, etc.), it's installed in the environment pip is associated with. If it says "WARNING: Package(s) not found," it's not installed correctly in that environment.

Platform/Tool Specific Installation Notes:​

  • Windows: Use Command Prompt (CMD) or PowerShell. Run as Administrator if you encounter permission errors when installing globally (though using virtual environments or --user is preferred). The py -m pip install colorama command is often reliable.
  • macOS / Linux: Use the Terminal application. Use pip3 or python3 -m pip. Use sudo if installing system-wide and encountering permission errors (again, venvs or --user are better).
  • VS Code: Use the integrated terminal (Ctrl + `` ). Ensure the terminal is using the same Python interpreter selected for your workspace (check the bottom status bar).
  • PyCharm: Use the integrated terminal (Alt+F12) or the Python Packages tool window (File > Settings > Project: [Your Project] > Python Interpreter > + icon). Ensure the correct project interpreter is selected.
  • Anaconda: Use the Anaconda Prompt or terminal within an activated conda environment. The preferred command is usually: 
    conda install -c anaconda colorama
    # Or sometimes simply:
    conda install colorama
    # You can also use pip within a conda environment:
    pip install colorama
  • Jupyter Notebook: You can install from a notebook cell using !pip: 
    !pip install colorama
    # Or for a specific user installation:
    # !pip install colorama --user
    Restart the kernel after installation for the changes to take effect.

Using colorama After Installation​

Once installed correctly, you can import and use it in your Python script:

from colorama import init, Fore, Back, Style

# Initialize colorama (important on Windows)
init()

print(Fore.RED + 'This text is red.' + Style.RESET_ALL)
print(Back.GREEN + Fore.BLACK + 'This has a green background and black text.' + Style.RESET_ALL)
print(Style.BRIGHT + 'This text is bright.' + Style.RESET_ALL)
print('This text is back to normal.')

# Deinitialize (optional, cleans up on Windows)
# from colorama import deinit
# deinit()

Conclusion​

The ModuleNotFoundError: No module named 'colorama' almost always means the colorama package is missing from the specific Python environment where your code is running.

  • The primary solution is to install it using pip install colorama within the correct, activated environment.
  • Pay close attention to virtual environments, the specific pip command used (pip vs. pip3), and potential naming conflicts or permission issues.
  • Verifying the installation with pip show colorama helps confirm success.

Table of Contents