---
id: pywebview
version: "6.2.1"
license: BSD 3-Clause License Copyright (c) 2014-2017, Roman Sirokov All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# pywebview — Build GUI for your Python program with JavaScript, HTML, and CSS

License: permissive · Maintenance: active · Downloads: 1.7M/mo

## What it is and what it does

pywebview is a lightweight wrapper around native webview components that lets you build desktop GUI applications using HTML, CSS, and JavaScript while keeping the logic in Python. It uses the platform's native rendering engine—WinForms on Windows, Cocoa on macOS, and Qt or GTK on Linux—so you don't bundle a separate browser engine, keeping executable size small. The package includes a built-in HTTP server for serving your UI, two-way communication between Python and JavaScript, DOM support, and native window management (menus, dialogs, window control).

It's designed for developers who want to leverage web technologies for UI but keep their application logic in Python. You write your interface in HTML/CSS/JavaScript and call Python functions from the frontend, or update the DOM from Python. The framework handles the platform-specific details, so the same code runs on Windows, macOS, and Linux with native look and feel.

Use it for:

- Build a cross-platform desktop application with a web-based UI without bundling a heavy GUI toolkit.
- Create a Python tool with an HTML/CSS interface for configuration, monitoring, or data visualization.
- Develop a native-looking desktop app that reuses existing web components or React code.
- Wrap a Python backend service with a lightweight GUI that communicates via Python-JavaScript bridge.
- Prototype or ship a desktop application quickly using familiar web technologies while keeping the executable small.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

pywebview wraps native webview components to display HTML/CSS/JavaScript content in desktop GUI windows, with built-in HTTP server, Python-JavaScript communication, and native window controls.

Yes, if you want to build a cross-platform desktop GUI in Python using web technologies without heavy toolkit overhead. The package is actively maintained, has no known vulnerabilities, and uses a permissive BSD license. Install friction is low, though you may need platform-specific system libraries. It's well-suited for developers comfortable with both Python and web technologies.

## Install

pip install pywebview
uv add pywebview
poetry add pywebview

## Installing pywebview

Before you install: Low install friction; ships as a pure-Python wheel. Runtime dependencies are platform-specific (pythonnet on Windows, pyobjc frameworks on macOS, QtPy on Linux), so actual installation may require system libraries—check the installation guide for your platform.

License in practice: BSD 3-Clause License permits commercial and private use with minimal restrictions; you may use, modify, and distribute pywebview provided you retain the copyright notice and disclaimer.

Quickstart:

pip install pywebview

import pywebview
pywebview.create_window('Hello world', 'https://pywebview.flowrl.com/hello')
pywebview.start()

Platform-specific system libraries may be required (e.g., GTK/Qt development headers on Linux); see installation guide. Requires Python >=3.8.

Verify before relying:

- Whether the built-in HTTP server is suitable for production use or intended only for development.
- Performance characteristics and memory footprint compared to other desktop webview frameworks.
- Specific DOM manipulation capabilities and their scope beyond the examples shown.

## Package facts

- License: BSD 3-Clause License Copyright (c) 2014-2017, Roman Sirokov All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

desktop GUI with HTML and JavaScript, native webview wrapper Python, build desktop app with web technologies, Python GUI using browser rendering, cross-platform desktop application framework, HTML CSS JavaScript desktop window, Python to JavaScript bridge, desktop-gui, cross-platform, webview

[View on SkillFed](https://skillfed.io/packages/pywebview) · [View on PyPI](https://pypi.org/project/pywebview/)