Skip to main content

How to Install PyQt6 for GUI Development in Python

PyQt6 is a comprehensive set of Python bindings for Qt 6, a powerful cross-platform C++ framework for creating graphical user interfaces (GUIs) and applications. To develop desktop applications with Python and Qt 6, you first need to install the PyQt6 package into your Python environment.

This guide provides detailed instructions on how to install PyQt6 using pip across various operating systems (Windows, macOS, Linux) and within common development tools like VS Code, PyCharm, and Jupyter Notebooks.

What is PyQt6?​

PyQt6 provides Python bindings for the Qt 6 set of C++ libraries. It allows Python developers to leverage the extensive capabilities of Qt for building sophisticated desktop applications with rich graphical user interfaces. Key features include a wide range of widgets, layout management, signals and slots for event handling, multimedia support, database integration, and much more.

Installation Prerequisites (General)​

  • Python: PyQt6 requires a compatible version of Python (typically Python 3.6+ or as specified by the latest PyQt6 release). Check the official PyQt6 documentation or its PyPI page for current Python version support.
  • Pip: Ensure pip (Python's package installer) is installed and up-to-date in your Python environment (python -m pip install --upgrade pip).
  • Build Tools (Sometimes, but less common for PyQt6 wheels): PyQt6 is usually distributed as pre-compiled binary wheels, meaning you typically don't need C++ compilers installed on your system. However, if a wheel isn't available for your specific Python version/OS/architecture, pip might attempt a source build, which would then require a C++ compiler and Qt development libraries. This is less common for standard PyQt6 installations.

Primary Installation Method: Using Pip*​

The most common and straightforward way to install PyQt6 is using pip.

# Standard pip install for PyQt6
pip install PyQt6

# If you use Python 3 and might have Python 2 pip on PATH:
pip3 install PyQt6

# To ensure you use pip associated with a specific python interpreter (recommended):
python -m pip install PyQt6
python3 -m pip install PyQt6
py -m pip install PyQt6     # Windows Python Launcher

# If you encounter permission errors when installing globally (not recommended):
pip install PyQt6 --user    # Installs to user site-packages
sudo pip3 install PyQt6     # Linux/macOS global install (use with extreme caution)

This command will download and install PyQt6 and its core dependencies from the Python Package Index (PyPI). PyQt6-sip (for managing bindings) and PyQt6-Qt6 (containing the Qt libraries) are typically installed as dependencies.

Platform-Specific Pip Installation​

The core command is pip install PyQt6, but accessing the terminal varies.

Windows (Command Prompt / PowerShell)​

  1. Open Command Prompt (type cmd in search) or PowerShell.
  2. Run: 
    pip install PyQt6
    # Or for more specificity, especially with multiple Python versions:
    # py -m pip install PyQt6
  3. If installing globally and facing permission issues (not recommended), run as Administrator or use the --user flag. Using virtual environments is the best practice.

macOS / Linux (Terminal)​

  1. Open your Terminal application.
  2. Run: 
    pip3 install PyQt6 # Usually best for Python 3
    # Or:
    # python3 -m pip install PyQt6
  3. If installing globally and facing permission issues (not recommended), use sudo pip3 install PyQt6 or the --user flag. Virtual environments are strongly preferred.

IDE and Notebook Specific Installation​

Visual Studio Code (Integrated Terminal)​

  1. Open the integrated terminal (Ctrl+` or View -> Terminal).
  2. Crucially, ensure the correct Python interpreter (especially your virtual environment's interpreter) is selected for your workspace. VS Code often shows this in the bottom status bar, and the terminal should automatically use it.
  3. Run: pip install PyQt6

PyCharm (Terminal / Package Manager GUI)​

  • Terminal: Open the Terminal tool window (Alt+F12). Ensure it's using your project's configured interpreter (often a venv). Run: pip install PyQt6.
  • Package Manager GUI:
    1. File -> Settings (or PyCharm -> Preferences) -> Project: [Your_Project_Name] -> Python Interpreter.
    2. Click the + icon.
    3. Search for PyQt6.
    4. Select it and click "Install Package".

Anaconda / Conda Environments (Note on Availability)​

As of my last update, installing PyQt6 directly via conda install pyqt6 from the default Anaconda channels might not always provide the latest version or might have different dependencies compared to PyPI. It's often recommended to use pip within an active Conda environment for packages like PyQt6 if a suitable Conda package isn't readily available or up-to-date.

  1. Open Anaconda Prompt or your terminal (with Conda in PATH).
  2. Activate your target environment: conda activate your_env_name
  3. Install using pip (recommended within Conda for PyQt6): 
    pip install PyQt6
    note

    You can check if a Conda package for pyqt (note: pyqt not pyqt6 for conda install name for Qt5, for Qt6 pyqt from conda-forge or pip install pyqt6 is used) exists on channels like conda-forge: conda install -c conda-forge pyqt but for PyQt6 specifically, pip is common.

Jupyter Notebook / Lab​

  • Method 1 (Recommended - Install Before Starting): Activate the correct Python environment (venv or conda) in your terminal, run pip install PyQt6, then start Jupyter. The notebook should automatically use that environment's kernel.
  • Method 2 (Install from Notebook Cell): 
    # In a code cell:
    !pip install PyQt6

    # OR (if using a conda environment as the kernel and prefer conda):
    !conda install -c conda-forge pyqt -y # This is for PyQt5, check Open3D method for PyQt6
    note

    Important: After installing via !pip or !conda, you must restart the kernel (Kernel menu -> Restart Kernel...) for the notebook to recognize the newly installed PyQt6 package. Note that using PyQt6 GUIs directly within a standard Jupyter Notebook cell can be complex and might require specific backends or workarounds (e.g., %gui qt). Jupyter is primarily for data analysis and non-GUI tasks, while PyQt6 is for standalone desktop GUIs.

Isolating project dependencies in a virtual environment is crucial to avoid conflicts and manage package versions effectively, especially for complex libraries like PyQt6.

  1. Create (in your project folder):

    python3 -m venv pyqt6_env   # Example name, or use 'python' or 'py'

  2. Activate:

    # Linux/macOS:
    source pyqt6_env/bin/activate
    # Windows CMD:
    # pyqt6_env\Scripts\activate.bat
    # Windows PowerShell:
    # pyqt6_env\Scripts\Activate.ps1

  3. Install PyQt6:

    # Prompt shows (pyqt6_env)
    pip install --upgrade pip   # Good practice
    pip install PyQt6

Verifying the Installation (pip show PyQt6)​

After installation, verify it in the same terminal/environment where you intend to use it:

pip show PyQt6

This command will display information about the installed PyQt6 package, including its version and location, or indicate if it's not found in the current environment.

Troubleshooting ModuleNotFoundError: No module named 'PyQt6'​

If you've run pip install PyQt6 but still encounter ModuleNotFoundError when trying import PyQt6 or from PyQt6.QtWidgets import QApplication:

  • Environment Mismatch: You installed PyQt6 in one Python environment but are trying to run your script/notebook using a different environment.
    • Solution: Ensure your script, IDE interpreter, or Jupyter kernel is configured to use the exact same Python environment where PyQt6 was successfully installed. Activating the correct virtual environment is key.
  • Incorrect pip: You might have used a pip command associated with a different Python installation.
    • Solution: Always use python -m pip install ... or python3 -m pip install ... (or py -m pip ... on Windows) to ensure pip corresponds to the active python interpreter.
  • Typo in Import: The main package is PyQt6, and modules within it are typically imported like from PyQt6.QtWidgets import ... or from PyQt6.QtCore import ....
  • Restart: After installation, especially if done while an IDE or Jupyter kernel was running, restart the IDE/kernel.

Conclusion​

Installing PyQt6 is generally straightforward using pip install PyQt6.

  • The most important factor for avoiding ModuleNotFoundError and ensuring a smooth development experience is to manage your Python environments effectively, preferably using virtual environments (venv or Conda environments).
  • Always install packages into, and run your code from, the same activated environment.
  • If issues arise, verify the installation location with pip show PyQt6 and ensure your script/IDE is using the correct Python interpreter.

Table of Contents