trame-vtklocal

Local Rendering using VTK.wasm to match server side rendering pipeline on the client side. The current code base is still at its infancy but we aim to make it the default implementation for local rendering using VTK/ParaView with trame. This WASM capability is starting to be available with VTK 9.4 but major improvement are happening in VTK 9.6.

Additional documentation can be found on vtk-wasm documentation.

VTK 9.4, 9.5 and 9.6 are compatible with trame-vtklocal>=0.16,<1 while trame-vtklocal>=1 will only be compatible with VTK 10. What we envision with VTK 10 is the completion of the main work with WASM and WebGPU. We will take that opportunity to cleanup the code in trame-vtklocal by removing legacy setup that were needed for VTK 9.4 and 9.5.

A simple demo can be executed like so

# Using the local repository file
uv run ./examples/demo/widget.py

# Or from the url
uv run https://raw.githubusercontent.com/Kitware/trame-vtklocal/refs/heads/master/examples/demo/widget.py

To get the following

License

This library is OpenSource and follow the Apache Software License

Installation

# to install VTK yourself
pip install trame-vtklocal

# for the latest VTK capabilities
pip install "vtk>=9.6" --pre --index-url https://wheels.vtk.org

Development

Build and install the Vue components

cd vue-components
npm i
npm run build
cd -

Install the library

# Create venv and install all dependencies
uv sync --all-extras --dev

# Activate environment
source .venv/bin/activate

# Install commit analysis
pre-commit install
pre-commit install --hook-type commit-msg

Optionally, you can develop with bleeding edge VTK by following these steps. Make sure you’ve these tools

git
CMake
Ninja
Python
NodeJS >= 24.0.1: https://nodejs.org/en/download/package-manager
Emscripten SDK version 4.0.20: See https://emscripten.org/docs/getting_started/downloads.html#download-and-install

# Compile VTK for wasm32 architecture using emscripten. Build artifacts can be found in dev/vtk/build/wasm
python ./utils/build_vtk.py -u https://gitlab.kitware.com/vtk/vtk.git -b master -t wasm32 -c RelWithDebInfo

# Compile VTK with python wrappings using system C++ compiler. Build artifacts can be found in dev/vtk/build/py
python ./utils/build_vtk.py -u https://gitlab.kitware.com/vtk/vtk.git -b master -t py -c RelWithDebInfo

# Windows: Set environment variables
./utils/dev_environment.ps1 -b master -c RelWithDebInfo

# Unix: Set environment variables
source ./utils/dev_environment.sh -b master -c RelWithDebInfo

Running examples

uv sync --all-extras --dev

# Activate environment
source .venv/bin/activate

# regular trame app
python ./examples/vtk/cone.py

Some example are meant to test and validate WASM rendering. Some will default for remote rendering but if you want to force them to use WASM just run export USE_WASM=1 before executing them.

Example gallery

The examples below live in examples/vtk. Click a screenshot to open its source.

cone.py

Minimal cone with resolution slider.

axes_actor.py

Orientation axes rendered next to a cone.

glyph.py

vtkGlyph3D with switchable glyph sources.

lut.py

Lookup table and color map editing.

silhouette.py

vtkPolyDataSilhouette outlines.

volume.py

Volume rendering with selectable mapper.

flow.py

Contours and streamlines of a flow dataset.

file_viewer.py

Load and display VTP / VTM files.

invoke.py

Call VTK methods on the client-side objects.

actor_picker.py

Pick actors from the browser.

actor_highlight

Highlight the actor under the cursor.

many_actors.py

Stress test with many independent actors.

render_benchmark.py

Many-actor render benchmark on a process plant scene.

wasm64_large_mesh.py

Mesh above 4 GiB requiring the wasm64 runtime.

border_widget.py

vtkBorderWidget over a sphere.

widgets_box.py

vtkBoxWidget2 transforming an actor.

widgets_camera.py

vtkCameraOrientationWidget.

widgets_plane_clip.py

Interactive plane clipping.

widgets_plane_slice.py

Interactive plane slicing (uses wasm64 for 64-bit ids).

Two examples are kept as known limitations and have no screenshot:

balloon_widget.py: vtkBalloonWidget
charts_scatter.py: vtkChartXY scatter plot

Progress events

The client-side VtkLocal component emits a progress event while wasm sync is happening. This can be used to keep a global loader visible until the first sync completes.

from trame.widgets import vtklocal, vuetify

state.app_loading = True
state._vtklocal_seen_active = False

def on_vtklocal_progress(event):
    if event.get("active"):
        state._vtklocal_seen_active = True
        state.app_loading = True
    elif state._vtklocal_seen_active:
        state.app_loading = False

with vuetify.VOverlay(v_model=("app_loading",), absolute=True):
    vuetify.VProgressCircular(indeterminate=True, size=64)

view = vtklocal.LocalView(
    render_window,
    progress=(on_vtklocal_progress, "[$event]"),
)

If you are using the Vue component directly, you can override the built-in loader with the loader slot.

<vtk-local>
  <template #loader="{ progress, wasmLoading, statePercent, hashPercent }">
    <div v-if="wasmLoading">Loading wasm...</div>
    <div v-else>
      States: {{ progress.state.current }}/{{ progress.state.total }}
      Blobs: {{ progress.hash.current }}/{{ progress.hash.total }}
    </div>
  </template>
</vtk-local>

SharedArrayBuffer

To enable SharedArrayBuffer within trame you can just set the following on the server. This option is not required anymore but still available if needed.

server.http_headers.shared_array_buffer = True

This will download the threaded WASM version. Otherwise, the non-threaded version will be used as it does not require SharedArrayBuffer.

VTK.wasm vs trame-vtklocal

This repository trame-vtklocal focus on providing a web component that is capable of mirroring a vtkRenderWindow defined on the server side. This include a JavaScript section for the browser and a Python section for the server.

The server include a definition of a custom network protocol over our WebSocket (wslink/trame) and some helper class to ease the vtkRenderWindow binding with a web component in the browser. While the Python package include a Vue.js component for a seamless integration with trame, we also publish a npm package. That pure JavaScript library let you still use the trame infrastructure on the server side but with your own stack on the client side. A usage example of that pure JavaScript option is covered in that directory.

For the pure Python trame usage, you can find the documented API.

By design there is a nice separation between VTK.wasm and trame-vtklocal which should make trame-vtklocal fairly independent of VTK.wasm version. But since we are still building capabilities, when the C++ API expend, we will also expand the Python/JavaScript component properties/methods. Hopefully we should be able to evolve trame-vtklocal with some reasonable fallback when the version of VTK is not in par with what is exposed in trame-vtklocal.

Also most the testing of VTK.wasm is in VTK repository as many validation can be done in pure C++ or Python. Then we have the WASM module API with its node/chrome testing.

The documented API of vtkWasmSceneManager and vtkObjectManager parent of vtkWasmSceneManager

For the moment we rely on manual testing for when we change the network and/or API at the trame-vtklocal by going over a specific set of examples.

Currently the WASM implementation is used in the following set of projects:

Pan3D: Pan3D aims to be an utility package for viewing and processing a wide variety of multidimensional datasets. Any dataset that can be interpreted with xarray can be explored and rendered with Pan3D.

Professional Support

Training: Learn how to confidently use trame from the expert developers at Kitware.
Support: Our experts can assist your team as you build your web application and establish in-house expertise.
Custom Development: Leverage Kitware’s 25+ years of experience to quickly build your web application.

Metadata

Release files for trame-vtklocal 1.6.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trame-vtklocal 1.6.3
File	Size	Uploaded
trame_vtklocal-1.6.3.tar.gz	88.6 kB	Sep 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for trame-vtklocal 1.6.3
File	Interpreter	ABI	Platform	Reset
trame_vtklocal-1.6.3-py3-none-any.whl 94.4 kB Sep 21, 2026	Python 3	none	any	Details

Total release size: 182.9 kB

Release files / trame_vtklocal-1.6.3.tar.gz

Download URL	trame_vtklocal-1.6.3.tar.gz
Size	88.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`89b6beb117987352b1a36e4bd27b69718a86b61f45dd513e2c4c210f2ec35a36`
BLAKE2b-256 checksum How to use checksums	`8ef037533e917408f7fd8b195ec25bd17e03e056dafc224e778814d981e9ca19`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Kitware/trame-vtklocal
Publishing commit: github.com/Kitware/trame-vtklocal/tree/78ccd25da2a2c564080634a33443cf42a8064041

Workflow

Publishing configuration: github.com/Kitware/trame-vtklocal/blob/78ccd25da2a2c564080634a33443cf42a8064041/.github/workflows/test_and_release.yml
Publishing logs: github.com/Kitware/trame-vtklocal/actions/runs/35636616663/attempts/1

Artifact

Subject: trame_vtklocal-1.6.3.tar.gz
SHA-256 checksum: 89b6beb117987352b1a36e4bd27b69718a86b61f45dd513e2c4c210f2ec35a36 Verifying attestations

Release files / trame_vtklocal-1.6.3-py3-none-any.whl

Download URL	trame_vtklocal-1.6.3-py3-none-any.whl
Size	94.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`22b85413b7fe3ac09f5bf7a669ac7c03bfcacbf7de727b62b63d6dcaa4b4c341`
BLAKE2b-256 checksum How to use checksums	`f644dd058ed18de0ce706f8b5962ddc06b3dd4fc6f72962965c9ca83cedf4e21`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Kitware/trame-vtklocal
Publishing commit: github.com/Kitware/trame-vtklocal/tree/78ccd25da2a2c564080634a33443cf42a8064041

Workflow

Publishing configuration: github.com/Kitware/trame-vtklocal/blob/78ccd25da2a2c564080634a33443cf42a8064041/.github/workflows/test_and_release.yml
Publishing logs: github.com/Kitware/trame-vtklocal/actions/runs/35636616663/attempts/1

Artifact

Subject: trame_vtklocal-1.6.3-py3-none-any.whl
SHA-256 checksum: 22b85413b7fe3ac09f5bf7a669ac7c03bfcacbf7de727b62b63d6dcaa4b4c341 Verifying attestations