pyvistaqt

library0.11.4pypypi✓ verified 86d ago

PyVistaQt provides a Qt-based plotting backend for PyVista, enabling embedded 3D visualization in PyQt5/PySide2/PyQt6/PySide6 applications. Current version: 0.11.4. Release cadence: irregular, with occasional minor/patch updates.

data

pip install pyvistaqt

github ↗package ↗

INSTALL

IMPORT

SIG · PYVISTAQT

pyvistaqt

datapythonv0.11.4

Install

14.3s avg

Import

130ms

Disk

611MB

Pass rate

7/ 10

Env Coverage7 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.11.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 14.8s

py 3.11

✓ —

✓ 14.5s

py 3.12

✓ —

✓ 13.4s

py 3.13

✕ build_error

✓ 13.6s

py 3.9

✕ build_error

✓ 15s

611MB installed

● package 611MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

BackgroundPlotter

✓ from pyvistaqt import BackgroundPlotter

Main class for embedding a PyVista plotter in a Qt widget.

QtInteractor

✓ from pyvistaqt import QtInteractor

Alternative name for the plotter widget, same as BackgroundPlotter.

MultiPlotter

✓ from pyvistaqt import MultiPlotter

Manages multiple plotters in a grid layout.

Create a Qt window with a 3D view of a cube using the BackgroundPlotter.

import pyvista as pv from pyvistaqt import BackgroundPlotter plotter = BackgroundPlotter() mesh = pv.Cube() plotter.add_mesh(mesh, color='red') plotter.show()

Debug

Known issues

breakingVersion 0.11.0 dropped support for Python 3.9; requires Python >=3.10.

fix

Upgrade to Python 3.10+ or stay on pyvistaqt <=0.10.2.

affects: >=0.11.0

breakingVersion 0.11.0 removed the `pyvistaqt.MainWindow` class; use `BackgroundPlotter` instead.

fix

Replace any 'MainWindow' usage with 'BackgroundPlotter'.

affects: >=0.11.0

gotchaImporting pyvistaqt before setting the Qt API can cause 'ImportError: No Qt bindings available'.

fix

Set the Qt API via environment variable (e.g., os.environ['QT_API'] = 'pyqt5') before importing pyvistaqt, or install a Qt binding (PyQt5, PySide2, PyQt6, PySide6) first.

affects: all

deprecatedThe `threaded` parameter in `BackgroundPlotter` is deprecated since v0.10.0; use `off_screen` and `auto_update` instead.

fix

Remove `threaded` and set `off_screen=False` and `auto_update=True` for similar behavior.

affects: >=0.10.0

Errors

Common errors & fixes

No module named 'PyQt5'

Missing Qt binding.

fix

Install a Qt binding: pip install PyQt5 (or PySide2, PyQt6, PySide6).

ImportError: Could not import pyvistaqt. You must have a Qt binding installed (e.g., PyQt5).

No Qt binding found or API not set correctly.

fix

Install a Qt binding (e.g., pip install PyQt5) and/or set the QT_API environment variable before importing pyvistaqt.

AttributeError: module 'pyvistaqt' has no attribute 'MainWindow'

MainWindow was removed in v0.11.0.

fix

Use BackgroundPlotter instead of MainWindow.

RuntimeError: This program needs access to the screen. Please run with a virtual display or use off_screen.

Running without a display (e.g., on a headless server) and not setting off_screen=True.

fix

Set `plotter = BackgroundPlotter(off_screen=True)` or run with a virtual display (xvfb).

Upgrade

Version history

0.11.4latest on PyPI · released Apr 3, 2026

Audit

Dependencies

pyvistarequiredCore dependency: all PyVista mesh/plotting logic.

PyQt5optionalDefault Qt backend (or alternative: PySide2, PyQt6, PySide6).

Agent activity

18 hits · last 30 days

node

Resources

githubhttps://github.com/pyvista/pyvistaqt ↗

packagehttps://pypi.org/project/pyvistaqt/ ↗