Installation

pip install pywebview

This will install pywebview with default dependencies for each platform.

On Linux you have to explicitly choose between QT and GTK.

pip install pywebview[gtk]

or

# This will install PyQT6
pip install pywebview[qt]

Other QT related options are pywebview[qt5], pywebview[pyside2] and pywebview[pyside6]

Other optional dependencies are pywebview[android], pywebview[cef] and pywebview[ssl]. CEF is available only for Windows. ssl option installs a cryptography package, which is needed for using https in local HTTP server.

Dependencies

Windows

pythonnet (requires > .NET 4.0)

To use with the latest Chromium you need WebView2 Runtime. If you plan to distribute your software, check out distribution guidelines too.

To use with CEF you need cefpython

QT can be used on Windows as well.

macOS

pyobjc

PyObjC comes preinstalled with the Python bundled in macOS. For a stand-alone Python installation you have to install it separately. You do not need the entire PyObjC package, these packages suffice

pyobjc-core
pyobjc-framework-Cocoa
pyobjc-framework-Quartz
pyobjc-framework-WebKit
pyobjc-framework-security

You can also use QT on macOS.

Linux

pip install pywebview[qt] should take care of QT dependencies. If it does not work or you would like to use GTK, you may try these recipes.

To install QtWebChannel on Debian-based systems (more modern, preferred)

sudo apt install python3-pyqt5 python3-pyqt5.qtwebengine python3-pyqt5.qtwebchannel libqt5webkit5-dev

To install QtWebKit (legacy, but available for more platforms).

sudo apt install python3-pyqt5 python3-pyqt5.qtwebkit python-pyqt5 python-pyqt5.qtwebkit libqt5webkit5-dev

PyGObject is used with GTK. To install dependencies on Ubuntu, use

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-webkit2-4.1

For other distributions, consult the PyGObject documentation

Note that WebKit2 version 2.22 or greater is required.

Warning

Starting from Ubuntu Disco Dingo pywebview can be installed via apt on Debian based system as python3-webview or python-pywebview. Ubuntu's distribution lags a few versions behind. If you wish to stay up-to-date, consider installing via pip.

Android

For Android development, refer to Kivy's packaging instructions for Android.